Leadtools.ImageProcessing.Color Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
AutoBinaryCommand Class
See Also  Members   Example 



Applies binary segmentation to the image using an automatically calculated threshold based on a two-peak method of statistical analysis of the histogram. This command is available in the Document/Medical Toolkits.

Syntax

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

Example

Run the AutoBinaryCommand on an image and apply automatic binary segmentation on it.

Visual BasicCopy Code
Public Sub AutoBinaryCommandExample()
   RasterCodecs.Startup()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

   Dim leadImage As RasterImage = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "Master.jpg")

   ' Prepare the command
   Dim command As AutoBinaryCommand = New AutoBinaryCommand
   'Apply Auto Binary Segment.
   command.Run(leadImage)
   codecs.Save(leadImage, LeadtoolsExamples.Common.ImagesPath.Path + "Result.jpg", RasterImageFormat.Jpeg, 24)

   RasterCodecs.Shutdown()
End Sub
C#Copy Code
public void AutoBinaryCommandExample() 
{ 
   // Load an image 
   RasterCodecs.Startup(); 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "Master.jpg"); 
 
   // Prepare the command 
   AutoBinaryCommand command = new AutoBinaryCommand(); 
   //Apply Auto Binary Segment. 
   command.Run(image); 
   codecs.Save(image, LeadtoolsExamples.Common.ImagesPath.Path + "Result.jpg", RasterImageFormat.Jpeg, 24); 
 
   RasterCodecs.Shutdown(); 
}

Remarks

  • The image is transformed into a binary image using a threshold calculated automatically based on statistical features of the image. Best results are obtained with grayscale images.
  • This command supports 12 and 16-bit grayscale and 48 and 64-bit color images. Support for 12 and 16-bit grayscale and 48 and 64-bit color images is available only in the Document/Medical toolkits.
  • If the image has a region, the effect will be applied on the region only.
  • This command does not support signed data images.
  • This command does not support 32-bit grayscale images.
Use the AutoBinaryCommand when you simply want to apply binary segmentation to the bitmap using an automatically calculated threshold based on a two-peak method of statistical analysis on its histogram. Use the DynamicBinaryCommand to convert an image into a black and white image without changing its bits per pixel. Use the AutoBinarizeCommand if you want:
  • Automatic pre-processing
  • Pre-processing to include background elimination
  • Pre-processing to include color leveling
  • To perform automatic, percentile or median thresholding
  • To manually specify a threshold value
For more information, refer to Processing an Image.
For more information, refer to Removing Noise.

Inheritance Hierarchy

System.Object
   Leadtools.ImageProcessing.RasterCommand
      Leadtools.ImageProcessing.Color.AutoBinaryCommand

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