Leadtools.ImageProcessing.Core Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.12.10
ImageRegion Property
See Also  Example
Leadtools.ImageProcessing.Core Namespace > DotRemoveCommand Class : ImageRegion Property




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

Syntax

Visual Basic (Declaration) 
Public ReadOnly Property ImageRegion As RasterImage
Visual Basic (Usage)Copy Code
Dim instance As DotRemoveCommand
Dim value As RasterImage
 
value = instance.ImageRegion
C# 
public RasterImage ImageRegion {get;}
Managed Extensions for C++ 
public: __property RasterImage get_ImageRegion();
C++/CLI 
public:
property RasterImage ImageRegion {
   RasterImage get();
}

Return Value

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

Example

Visual BasicCopy Code
ImageProcessing.Core.DotRemoveCommand.ImageRegion
   Public WithEvents dotRemoveCommandCallback_S3 As DotRemoveCommand
   Public Sub ImageRegionPropertyExample()
      RasterCodecs.Startup()
      Dim codecs As New RasterCodecs()
      codecs.ThrowExceptionsOnInvalidImages = True

      Dim leadImage As RasterImage = codecs.Load("C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\Clean.tif")

      ' Prepare the command
      dotRemoveCommandCallback_S3 = New DotRemoveCommand
      dotRemoveCommandCallback_S3.Flags = DotRemoveCommandFlags.UseSize Or DotRemoveCommandFlags.SingleRegion Or DotRemoveCommandFlags.LeadRegion
      dotRemoveCommandCallback_S3.MaximumDotHeight = 10
      dotRemoveCommandCallback_S3.MaximumDotWidth = 10
      dotRemoveCommandCallback_S3.MinimumDotHeight = 1
      dotRemoveCommandCallback_S3.MinimumDotWidth = 1
      dotRemoveCommandCallback_S3.Run(leadImage)

      RasterCodecs.Shutdown()
   End Sub

   Private Sub DotRemoveCommand_DotRemove_S3(ByVal sender As Object, ByVal e As DotRemoveCommandEventArgs) Handles dotRemoveCommandCallback_S3.DotRemove
      ' Do not remove the speck if it contains any white pixels
      If (e.WhiteCount > 0) Then
         e.Status = RemoveStatus.NoRemove
      Else
         e.Status = RemoveStatus.Remove
      End If
   End Sub
C#Copy Code
ImageProcessing.Core.DotRemoveCommand.ImageRegion 
      public void ImageRegionPropertyExample() 
      { 
         // Load an image 
         RasterCodecs.Startup(); 
         RasterCodecs codecs = new RasterCodecs(); 
         codecs.ThrowExceptionsOnInvalidImages = true; 
 
         RasterImage image = codecs.Load(@"C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\Clean.tif"); 
 
         // Prepare the command 
         DotRemoveCommand command = new DotRemoveCommand(); 
         command.DotRemove += new EventHandler<DotRemoveCommandEventArgs>(DotRemoveEvent_S3); 
         command.Flags = DotRemoveCommandFlags.UseSize | DotRemoveCommandFlags.SingleRegion | DotRemoveCommandFlags.LeadRegion; 
         command.MaximumDotHeight = 10; 
         command.MaximumDotWidth = 10; 
         command.MinimumDotHeight = 1; 
         command.MinimumDotWidth = 1; 
 
         command.Run(image); 
 
         RasterCodecs.Shutdown(); 
      } 
 
      private void DotRemoveEvent_S3(object sender, DotRemoveCommandEventArgs e) 
      {                
         // Do not remove the speck if it contains any white pixels 
         if (e.WhiteCount > 0)  
         { 
            e.Status= RemoveStatus.NoRemove; 
         } 
         else  
         { 
            e.Status= RemoveStatus.Remove; 
         } 
      }

Remarks

If DotRemoveCommandFlags.SingleRegion| DotRemoveCommandFlags.LeadRegion has been set in Flags, then when DotRemoveCommand returns, this property is updated with a shallow copy of the image that also has a region that contains the removed dots. So set Flags to (DotRemoveCommandFlags.SingleRegion| DotRemoveCommandFlags.LeadRegion). It is the programmer's responsibility to dispose of the region when it is no longer needed.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also