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




Finds and removes dots and specks of various sizes. This method is available in the Document/Medical Toolkits.

Syntax

Visual Basic (Declaration) 
Public Class DotRemoveCommand 
   Inherits RasterCommand
   Implements IRasterCommand 
Visual Basic (Usage)Copy Code
Dim instance As DotRemoveCommand
C# 
public class DotRemoveCommand : RasterCommand, IRasterCommand  
Managed Extensions for C++ 
public __gc class DotRemoveCommand : public RasterCommand, IRasterCommand  
C++/CLI 
public ref class DotRemoveCommand : public RasterCommand, IRasterCommand  

Example

Visual BasicCopy Code
ImageProcessing.Core.DotRemoveCommand
   Public WithEvents dotRemoveCommandCallback_S1 As DotRemoveCommand
   Public Sub DotRemoveCommandExample()
      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_S1 = New DotRemoveCommand
      dotRemoveCommandCallback_S1.Flags = DotRemoveCommandFlags.UseSize
      dotRemoveCommandCallback_S1.MaximumDotHeight = 10
      dotRemoveCommandCallback_S1.MaximumDotWidth = 10
      dotRemoveCommandCallback_S1.MinimumDotHeight = 1
      dotRemoveCommandCallback_S1.MinimumDotWidth = 1

      dotRemoveCommandCallback_S1.Run(leadImage)

      RasterCodecs.Shutdown()
   End Sub

   Private Sub DotRemoveCommand_DotRemove_S1(ByVal sender As Object, ByVal e As DotRemoveCommandEventArgs) Handles dotRemoveCommandCallback_S1.DotRemove
      MessageBox.Show("Size " + Convert.ToString(e.BoundingRectangle.Width) + Convert.ToString(e.BoundingRectangle.Height) + "Bounds" _
               + Convert.ToString(e.BoundingRectangle.Left) + "," + Convert.ToString(e.BoundingRectangle.Top) + "," + Convert.ToString(e.BoundingRectangle.Right) + "," + Convert.ToString(e.BoundingRectangle.Bottom) + "," _
               + " WhiteCount" + Convert.ToString(e.WhiteCount) + " BlackCount" + Convert.ToString(e.BlackCount), "DotRemove Event")

      '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 
      public void DotRemoveCommandExample() 
      { 
         // 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_S1); 
         command.Flags            = DotRemoveCommandFlags.UseSize ; 
         command.MaximumDotHeight = 10; 
         command.MaximumDotWidth  = 10; 
         command.MinimumDotHeight = 1; 
         command.MinimumDotWidth  = 1; 
 
         command.Run(image); 
 
         RasterCodecs.Shutdown(); 
      } 
 
      private void DotRemoveEvent_S1(object sender, DotRemoveCommandEventArgs e) 
      { 
         MessageBox.Show("Size   " + e.BoundingRectangle.Width + e.BoundingRectangle.Height + "Bounds"  
            + e.BoundingRectangle.Left + ","+ e.BoundingRectangle.Top + ","+ e.BoundingRectangle.Right + ","+ e.BoundingRectangle.Bottom + "," 
            + "     WhiteCount" + e.WhiteCount + "    BlackCount"+ e.BlackCount,"DotRemove Event" ); 
 
         //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

  • This method finds and removes dots, specks, and blobs of various sizes in 1-bit documents. The dots, specks, and blobs may or may not be all black. The behavior of this method can be modified by using an Event Handler that handles the DotRemoveCommandEventArgs.
  • This method works only on 1-bit black and white images.
  • If a region is selected, only the selected region will be changed by this method. If no region is selected, the whole image will be processed.
  • This command does not support signed data images.
  • This command does not support 32-bit grayscale images.
For more information, refer to Cleaning Up 1-Bit Images.

Inheritance Hierarchy

System.Object
   Leadtools.ImageProcessing.RasterCommand
      Leadtools.ImageProcessing.Core.DotRemoveCommand

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