←Select platform

AutoBinarizeCommand Class

Summary

This function applies binary segmentation to a bitmap automatically. This class is available in the Document/Medical toolkits only.

Syntax

Java

Objective-C

WinRT C#

C++

public class AutoBinarizeCommand : Leadtools.Imageprocessing.Leadtools.ImageProcessing.RasterCommand, Leadtools.Imageprocessing.Leadtools.ImageProcessing.IRasterCommand

Public Class AutoBinarizeCommand  
   Inherits Leadtools.Imageprocessing.Leadtools.ImageProcessing.RasterCommand 
   Implements Leadtools.Imageprocessing.Leadtools.ImageProcessing.IRasterCommand

public sealed class AutoBinarizeCommand : Leadtools.Imageprocessing.Leadtools.ImageProcessing.IRasterCommand

@interface LTAutoBinarizeCommand : LTRasterCommand

public class AutoBinarizeCommand extends RasterCommand

function Leadtools.ImageProcessing.Core.AutoBinarizeCommand()

public ref class AutoBinarizeCommand : public Leadtools.Imageprocessing.Leadtools.ImageProcessing.RasterCommand, Leadtools.Imageprocessing.Leadtools.ImageProcessing.IRasterCommand

Remarks

This function is useful for improving recognition results (OCR, Barcode, OMR, ICR).
This command does not support 12-bit or 16-bit grayscale or 48-bit or 64-bit color images (Exception: Image format not recognized).
This command supports unsigned data images, but not signed ones.
This command does not support 32-bit grayscale images.

Options:

Automatic pre-processing
Pre-processing using background elimination
Pre-processing using color leveling
Perform automatic, percentile or median threshold
Manually specify a threshold value

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

Runs the AutoBinarizeCommand on an image and converts it to a black and white image.

WinRT C#

Silverlight C#

Silverlight VB

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing.Core 
 
    
Public Sub AutoBinarizeCommandExample() 
   ' Load an image 
   Dim codecs As RasterCodecs = New RasterCodecs() 
   codecs.ThrowExceptionsOnInvalidImages = True 
   Dim image As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Sample.mrc")) 
 
   Dim command As AutoBinarizeCommand = New AutoBinarizeCommand() 
   command.Run(image) 
 
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 AutoBinarizeCommandExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Sample.mrc")); 
 
   AutoBinarizeCommand command = new AutoBinarizeCommand(); 
   command.Run(image); 
 
} 
 
static class LEAD_VARS 
{ 
public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
}

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Core; 
 
       
public async Task AutoBinarizeCommandExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
   string srcFileName = @"Assets\IMAGE1.CMP"; 
   StorageFile loadFile = await Tools.AppInstallFolder.GetFileAsync(srcFileName); 
   RasterImage image = await codecs.LoadAsync(LeadStreamFactory.Create(loadFile)); 
 
   AutoBinarizeCommand command = new AutoBinarizeCommand(); 
   command.Run(image); 
 
}

using Leadtools; 
using Leadtools.Examples; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Core; 
 
public void AutoBinarizeCommandExample(RasterImage image, Stream outStream) 
{ 
   AutoBinarizeCommand command = new AutoBinarizeCommand(); 
   command.Run(image); 
   // Save result image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.Save(image, outStream, RasterImageFormat.Jpeg, 24); 
   image.Dispose(); 
}

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing.Core 
 
Public Sub AutoBinarizeCommandExample(ByVal image As RasterImage, ByVal outStream As Stream) 
   Dim command As AutoBinarizeCommand = New AutoBinarizeCommand() 
   command.Run(image) 
   ' Save result image 
   Dim codecs As RasterCodecs = New RasterCodecs() 
   codecs.Save(image, outStream, RasterImageFormat.Jpeg, 24) 
   image.Dispose() 
End Sub