LEADTOOLS Image Processing (Leadtools.ImageProcessing.Effects assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
ExtractMessageCommand Class
See Also  Members  
Leadtools.ImageProcessing.Effects Namespace : ExtractMessageCommand Class



Extracts a message (text or file) from the image, if the image has an embedded message. This command is available in the Document/Medical Toolkits.

Object Model

ExtractMessageCommand Class

Syntax

Visual Basic (Declaration) 
Public Class ExtractMessageCommand 
   Inherits Leadtools.ImageProcessing.RasterCommand
   Implements IRasterCommand 
Visual Basic (Usage)Copy Code
Dim instance As ExtractMessageCommand
C# 
public class ExtractMessageCommand : Leadtools.ImageProcessing.RasterCommand, IRasterCommand  
C++/CLI 
public ref class ExtractMessageCommand : public Leadtools.ImageProcessing.RasterCommand, IRasterCommand  

Example

Run the ExtractMessageCommand on an image by loading an image that has an embedded message and extracts the message from it.

Visual BasicCopy Code
Public Sub ExtractMessageCommandExample()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

   Dim leadImage As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Master.jpg"))

   Dim addmessagecommand As AddMessageCommand = New AddMessageCommand
   addmessagecommand.Message = "LEAD Technologies, Inc."
   ' Add the above message to image in the default position and with the default password.
   addmessagecommand.Run(leadImage)
   ' Prepare the command

   Dim command As ExtractMessageCommand = New ExtractMessageCommand

   ' set password and start properties values same as AddMessageCommand values.
   command.Password = Nothing
   command.Start = New LeadPoint(0, 0)
   command.Directory = LEAD_VARS.ImagesDir

   ' Extract the message from the image in the default position and with the default password.
   command.Run(leadImage)
   codecs.Save(leadImage, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 24)


   If (Not (IsNothing(command.Message))) Then
      MessageBox.Show(command.Message, "Extracted Message")
   ElseIf (Not (IsNothing(command.FileName))) Then
      MessageBox.Show(command.FileName, "Extracted File")
   End If

End Sub

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class
C#Copy Code
public void ExtractMessageCommandExample()
   {
      // Load an image
      RasterCodecs codecs = new RasterCodecs();
      codecs.ThrowExceptionsOnInvalidImages = true;

      RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"));

      // Prepare the command
      AddMessageCommand addmessageCommand = new AddMessageCommand();
      addmessageCommand.Password = null;
      addmessageCommand.Start = new LeadPoint(0, 0);
      addmessageCommand.Message = "LEAD Technologies, Inc.";
      // Add the above message to image in the default position and with the default password.
      addmessageCommand.Run(image);

      // Prepare the command
      ExtractMessageCommand command = new ExtractMessageCommand();

      // set password and start properties values same as AddMessageCommand values.
      command.Password    = null;
      command.Start = new LeadPoint(0, 0);
      command.Directory   = Path.Combine(LEAD_VARS.ImagesDir, "");

      // Extract the message from the image in the default position and with the default password.
      command.Run(image);
      codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 24);

      if(command.Message != null && command.Message.Length != 0)
         MessageBox.Show(command.Message, "Extracted Message");
      else  if (command.FileName != null && command.FileName.Length != 0)
         MessageBox.Show(command.FileName, "Extracted File");


   }

static class LEAD_VARS
{
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}
SilverlightCSharpCopy Code
SilverlightVBCopy Code

Remarks

  • This command is used to extract the message that was added to the image by the AddMessageCommand.
  • Before calling this command, set the password, the starting point, and the directory using the same information used for these when the message was added.
  • This command can extract a message from any type of lossless image format such as bmp, tiff, lossless jpeg, and so forth. If used with lossy format types the message may be corrupted or lost.
  • This method supports 24- and 48-bits images, and 8- and 16-bits grayscale images.
  • Support for 16-bit grayscale and 48-bit color images is available only in the Document/Medical toolkits.
  • This command does not support 32-bit grayscale images.

Inheritance Hierarchy

System.Object
   Leadtools.ImageProcessing.RasterCommand
      Leadtools.ImageProcessing.Effects.ExtractMessageCommand

Requirements

Target Platforms: Silverlight 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7, MAC OS/X (Intel Only)

See Also