DotRemoveCommand Class

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

Object Model

Syntax

C#
Visual Basic
WinRT C#
Java
Objective-C
WinRT JavaScript
C++

public class DotRemoveCommand : Leadtools.ImageProcessing.RasterCommand, Leadtools.ImageProcessing.IRasterCommand

'Declaration

Public Class DotRemoveCommand 
   Inherits Leadtools.ImageProcessing.RasterCommand
   Implements Leadtools.ImageProcessing.IRasterCommand

'Usage

Dim instance As DotRemoveCommand

public sealed class DotRemoveCommand : Leadtools.ImageProcessing.IRasterCommand

@interface LTDotRemoveCommand : LTRasterCommand

public class DotRemoveCommand extends RasterCommand

function Leadtools.ImageProcessing.Core.DotRemoveCommand()

public ref class DotRemoveCommand : public Leadtools.ImageProcessing.RasterCommand, Leadtools.ImageProcessing.IRasterCommand

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.

In Silverlight versions of LEADTOOLS, this image processing command will fail if the image data for the RasterImage object is stored internally using a Silverlight WriteableBitmap object. For more information, refer to Image Processing Command Limitations in Silverlight.

Example

Run the DotRemoveCommand on an image.

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

Copy Code

Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.ImageProcessing.Core

Public WithEvents dotRemoveCommandCallback_S1 As DotRemoveCommand
   
Public Sub DotRemoveCommandExample()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True
   Dim leadImage As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "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)

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

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

using Leadtools;
using Leadtools.Codecs;
using Leadtools.ImageProcessing.Core;

      
public void DotRemoveCommandExample()
{
   // Load an image
   RasterCodecs codecs = new RasterCodecs();
   codecs.ThrowExceptionsOnInvalidImages = true;
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "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);

}

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;
   }
}

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

function DotRemoveCommandExample() {
   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 DotRemoveCommand();
         command.addEventListener("dotremove", DotRemoveEvent_S1);
         command.flags = DotRemoveCommandFlags.useSize;
         command.maximumDotHeight = 10;
         command.maximumDotWidth = 10;
         command.minimumDotHeight = 1;
         command.minimumDotWidth = 1;

         command.run(image);
      }
   });
}

function DotRemoveEvent_S1(e) {
   console.error("Size   " + e.boundingRectangle.width + "," + e.boundingRectangle.height + " Bounds "
      + e.boundingRectangle.x + "," + e.boundingRectangle.y + "," + e.boundingRectangle.width + "," + e.boundingRectangle.height
      + "     WhiteCount " + e.whiteCount + "    BlackCount " + e.blackCount, " DotRemove Event");

   with (Leadtools.ImageProcessing.Core) {
      //Do not remove the speck if it contains any white pixels
      if (e.whiteCount > 0) {
         e.status = RemoveStatus.noRemove;
      }
      else {
         e.status = RemoveStatus.remove;
      }
   }
}

using Leadtools;
using Leadtools.Codecs;
using Leadtools.ImageProcessing.Core;

      
public async Task DotRemoveCommandExample()
{
   // 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
   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);

}

private void DotRemoveEvent_S1(object sender, DotRemoveCommandEventArgs e)
{
   Debug.WriteLine("Size   " + e.BoundingRectangle.Width + e.BoundingRectangle.Height + "Bounds" 
      + e.BoundingRectangle.X + ","+ e.BoundingRectangle.Y + ","+ e.BoundingRectangle.Width + ","+ e.BoundingRectangle.Height + ","
      + "     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;
   }
}

using Leadtools;
using Leadtools.Examples;
using Leadtools.Codecs;
using Leadtools.ImageProcessing.Core;

public void DotRemoveCommandExample(RasterImage image, Stream outStream)
{
   // 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);

   // Save result image
   RasterCodecs codecs = new RasterCodecs();
   codecs.Save(image, outStream, RasterImageFormat.CcittGroup4, 1);
   image.Dispose();
}

private void DotRemoveEvent_S1(object sender, DotRemoveCommandEventArgs e)
{
   Debug.WriteLine("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", MessageBoxButton.OK );

   //Do not remove the speck if it contains any white pixels
   if (e.WhiteCount > 0)
   {
      e.Status = RemoveStatus.NoRemove;
   }
   else
   {
      e.Status = RemoveStatus.Remove;
   }
}

Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.ImageProcessing.Core

Public Sub DotRemoveCommandExample(ByVal image As RasterImage, ByVal outStream As Stream)
   ' Prepare the command
   Dim command As DotRemoveCommand = New DotRemoveCommand()
   AddHandler command.DotRemove, AddressOf DotRemoveEvent_S1
   command.Flags = DotRemoveCommandFlags.UseSize
   command.MaximumDotHeight = 10
   command.MaximumDotWidth = 10
   command.MinimumDotHeight = 1
   command.MinimumDotWidth = 1
   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 DotRemoveEvent_S1(ByVal sender As Object, ByVal e As DotRemoveCommandEventArgs)
   Debug.WriteLine("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", MessageBoxButton.OK)

   '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

Requirements

Target Platforms

Reference

DotRemoveCommand Members
Leadtools.ImageProcessing.Core Namespace
Cleaning Up 1-Bit Images
SmoothCommand Class
BorderRemoveCommand Class
LineRemoveCommand Class
InvertedTextCommand Class
InvertedPageCommand Class
HolePunchRemoveCommand Class
HighQualityRotateCommand Class
MinimumCommand Class
MaximumCommand Class
Leadtools.ImageProcessing.Effects.RegionHolesRemovalCommand