←Select platform

ExtractMessageCommand Class

Summary

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.

Syntax
C#
VB
C++
public class ExtractMessageCommand : RasterCommand 
Public Class ExtractMessageCommand  
   Inherits RasterCommand 
public ref class ExtractMessageCommand : public RasterCommand   

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-bit and 48-bits images, and 8-bit 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.

Example

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

C#
VB
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Effects; 
 
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"; 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing.Effects 
 
Public Sub ExtractMessageCommandExample() 
   Dim codecs As New RasterCodecs() 
   codecs.ThrowExceptionsOnInvalidImages = True 
 
   Dim leadImage As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1.CMP")) 
 
   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 

Requirements

Target Platforms

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.ImageProcessing.Effects Assembly