ImageRegion Property (InvertedTextCommand)

This property is updated with a shallow copy of the image that also has a region that contains the removed inverted text.

Syntax

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

public RasterImage ImageRegion {get;}

'Declaration
 
Public ReadOnly Property ImageRegion As RasterImage

'Usage
 
Dim instance As InvertedTextCommand
Dim value As RasterImage
 
value = instance.ImageRegion

public RasterImage ImageRegion {get;}

 get_ImageRegion();

public:
property RasterImage^ ImageRegion {
   RasterImage^ get();
}

Property Value

A shallow copy of the image that also has a region that contains the removed inverted text.

Remarks

If InvertedTextCommandFlags.SingleRegion| InvertedTextCommandFlags.LeadRegion has been set in the Flags property, then when InvertedTextCommand returns, this property is updated with a shallow copy of the image that also has a region that contains the removed inverted text. So set the InvertedTextCommandFlags.SingleRegion| InvertedTextCommandFlags.LeadRegion flags. Dispose of the region when it is no longer needed.

Example

Visual Basic
C#
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Public WithEvents invertedTextCommand_S3 As InvertedTextCommand
Public Sub ImageRegionPropertyExample()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

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

   ' Prepare the command
   invertedTextCommand_S3 = New InvertedTextCommand
   invertedTextCommand_S3.Flags = InvertedTextCommandFlags.UseDpi Or InvertedTextCommandFlags.LeadRegion Or InvertedTextCommandFlags.SingleRegion
   invertedTextCommand_S3.MaximumBlackPercent = 95
   invertedTextCommand_S3.MinimumBlackPercent = 70
   invertedTextCommand_S3.MinimumInvertHeight = 500
   invertedTextCommand_S3.MinimumInvertWidth = 5000
   invertedTextCommand_S3.Run(leadImage)

End Sub

Private Sub InvertedTextCommand_InvertedText_S3(ByVal sender As Object, ByVal e As InvertedTextCommandEventArgs) Handles invertedTextCommand_S3.InvertedText
   MessageBox.Show("Size " + "( " + e.BoundingRectangle.Left.ToString() + ", " + e.BoundingRectangle.Top.ToString() + ") - " + "( " + e.BoundingRectangle.Right.ToString() + ", " + e.BoundingRectangle.Bottom.ToString() + ")" + _
      Chr(13) + " Black Count " + e.BlackCount.ToString() + _
      Chr(13) + " White Count " + e.WhiteCount.ToString())
   e.Status = RemoveStatus.Remove
End Sub

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class

public void ImageRegionPropertyExample()
   {
      // Load an image
      RasterCodecs codecs = new RasterCodecs();
      codecs.ThrowExceptionsOnInvalidImages = true;

      RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Clean.tif"));

      // Prepare the command
      InvertedTextCommand command = new InvertedTextCommand();
      command.InvertedText += new EventHandler<InvertedTextCommandEventArgs>(InvertedTextEvent_S3);
      command.Flags = InvertedTextCommandFlags.UseDpi | InvertedTextCommandFlags.SingleRegion | InvertedTextCommandFlags.LeadRegion;
      command.MaximumBlackPercent = 95;
      command.MinimumBlackPercent = 70;
      command.MinimumInvertHeight = 500;
      command.MinimumInvertWidth  = 5000;
      command.Run(image);

   }

   private void InvertedTextEvent_S3(object sender, InvertedTextCommandEventArgs e)
   {
      MessageBox.Show("Size "           + "( " + e.BoundingRectangle.Left + ", " + e.BoundingRectangle.Top + ") - " + "( " + e.BoundingRectangle.Right + ", " + e.BoundingRectangle.Bottom + ")" +
         "\n Black Count " + e.BlackCount.ToString() + 
         "\n White Count " + e.WhiteCount.ToString());
      e.Status = RemoveStatus.Remove;
   }

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

function ImageRegionPropertyExample() {
   var codecs = new Leadtools.Codecs.RasterCodecs();
   codecs.throwExceptionsOnInvalidImages = true;

   // Load the image
   var srcFileName = "Assets\\clean.tif";
   return Tools.AppInstallFolder().getFileAsync(srcFileName).then(function (loadFile) {
      return codecs.loadAsync(Leadtools.LeadStreamFactory.create(loadFile));
   }).then(function (image) {
      // Prepare the command
      with (Leadtools.ImageProcessing.Core) {
         var command = new InvertedTextCommand();
         command.addEventListener("invertedtext", InvertedTextEvent_S3);
         command.flags = InvertedTextCommandFlags.useDpi | InvertedTextCommandFlags.singleRegion | InvertedTextCommandFlags.leadRegion;
         command.maximumBlackPercent = 95;
         command.minimumBlackPercent = 70;
         command.minimumInvertHeight = 500;
         command.minimumInvertWidth = 5000;
         command.run(image);
      }
   });
}

function InvertedTextEvent_S3(e) {
   console.error("Size " + "( " + e.boundingRectangle.x + ", " + e.boundingRectangle.y + ") - " + "( " + e.boundingRectangle.width + ", " + e.boundingRectangle.height + ")" +
      "\n Black Count " + e.blackCount.toString() +
      "\n White Count " + e.whiteCount.toString());
   e.status = Leadtools.ImageProcessing.Core.RemoveStatus.remove;
}

[TestMethod]
public async Task ImageRegionPropertyExample()
{
   // Load an image
   RasterCodecs codecs = new RasterCodecs();
   codecs.ThrowExceptionsOnInvalidImages = true;
   // Load the image
   string srcFileName = @"Assets\Clean.tif";
   StorageFile loadFile = await Tools.AppInstallFolder.GetFileAsync(srcFileName);
   RasterImage image = await codecs.LoadAsync(LeadStreamFactory.Create(loadFile));

   // Prepare the command
   InvertedTextCommand command = new InvertedTextCommand();
   command.InvertedText += new EventHandler<InvertedTextCommandEventArgs>(InvertedTextEvent_S3);
   command.Flags = InvertedTextCommandFlags.UseDpi | InvertedTextCommandFlags.SingleRegion | InvertedTextCommandFlags.LeadRegion;
   command.MaximumBlackPercent = 95;
   command.MinimumBlackPercent = 70;
   command.MinimumInvertHeight = 500;
   command.MinimumInvertWidth  = 5000;
   command.Run(image);

}

private void InvertedTextEvent_S3(object sender, InvertedTextCommandEventArgs e)
{
   Debug.WriteLine("Size "           + "( " + e.BoundingRectangle.X + ", " + e.BoundingRectangle.Y + ") - " + "( " + e.BoundingRectangle.Width + ", " + e.BoundingRectangle.Height + ")" +
      "\n Black Count " + e.BlackCount.ToString() + 
      "\n White Count " + e.WhiteCount.ToString());
   e.Status = RemoveStatus.Remove;
}

public void ImageRegionPropertyExample(RasterImage image, Stream outStream)
{
   // Prepare the command
   InvertedTextCommand command = new InvertedTextCommand();
   command.InvertedText += new EventHandler<InvertedTextCommandEventArgs>(InvertedTextEvent_S3);
   command.Flags = InvertedTextCommandFlags.UseDpi | InvertedTextCommandFlags.SingleRegion | InvertedTextCommandFlags.LeadRegion;
   command.MaximumBlackPercent = 95;
   command.MinimumBlackPercent = 70;
   command.MinimumInvertHeight = 500;
   command.MinimumInvertWidth  = 5000;
   command.Run(image);
   // Save result image
   RasterCodecs codecs = new RasterCodecs();
   codecs.Save(image, outStream, RasterImageFormat.CcittGroup4, 1);
   image.Dispose();
}

private void InvertedTextEvent_S3(object sender, InvertedTextCommandEventArgs e)
{
   Debug.WriteLine("Size "           + "( " + e.BoundingRectangle.Left + ", " + e.BoundingRectangle.Top + ") - " + "( " + e.BoundingRectangle.Right + ", " + e.BoundingRectangle.Bottom + ")" +
      "\n Black Count " + e.BlackCount.ToString() + 
      "\n White Count " + e.WhiteCount.ToString());
   e.Status = RemoveStatus.Remove;
}

Public Sub ImageRegionPropertyExample(ByVal image As RasterImage, ByVal outStream As Stream)
   ' Prepare the command
   Dim command As InvertedTextCommand = New InvertedTextCommand()
   AddHandler command.InvertedText, AddressOf InvertedTextEvent_S3
   command.Flags = InvertedTextCommandFlags.UseDpi Or InvertedTextCommandFlags.SingleRegion Or InvertedTextCommandFlags.LeadRegion
   command.MaximumBlackPercent = 95
   command.MinimumBlackPercent = 70
   command.MinimumInvertHeight = 500
   command.MinimumInvertWidth = 5000
   command.Run(image)
   ' Save result image
   Dim codecs As RasterCodecs = New RasterCodecs()
   codecs.Save(image, outStream, RasterImageFormat.CcittGroup4, 1)
   image.Dispose()
End Sub

Private Sub InvertedTextEvent_S3(ByVal sender As Object, ByVal e As InvertedTextCommandEventArgs)
   Debug.WriteLine("Size " & "( " & e.BoundingRectangle.Left & ", " & e.BoundingRectangle.Top & ") - " & "( " & e.BoundingRectangle.Right & ", " _
                   & e.BoundingRectangle.Bottom & ")" & Constants.vbLf & " Black Count " & e.BlackCount.ToString() & Constants.vbLf & " White Count " _
                   & e.WhiteCount.ToString())
   e.Status = RemoveStatus.Remove
End Sub

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

InvertedTextCommand Class
InvertedTextCommand Members