AutoBinarizeCommand Class

Summary

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

Syntax

Objective-C

C++/CLI

Java

Python

public class AutoBinarizeCommand : RasterCommand

@interface LTAutoBinarizeCommand : LTRasterCommand

public class AutoBinarizeCommand 
    extends RasterCommand

public ref class AutoBinarizeCommand : public RasterCommand

class AutoBinarizeCommand(RasterCommand):

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

Auto Binarize Function - Before

Auto Binarize Function - After

View additional platform support for this Auto Binarize function.

Example

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

Java

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, "noisy_barcode.jpg")); 
 
   AutoBinarizeCommand command = new AutoBinarizeCommand(); 
   command.Flags = AutoBinarizeCommandFlags.UsePercentileThreshold | AutoBinarizeCommandFlags.DontUsePreProcessing; 
   command.Factor = 2000; // use 20% threshold 
   command.Run(image); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}

 
import java.io.File; 
import java.io.IOException; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
import static org.junit.Assert.*; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.imageprocessing.core.*; 
 
 
public void autoBinarizeCommandExample() { 
 
   // Load an image 
   final String LEAD_VARS_IMAGES_DIR = "c:\\LEADTOOLS23\\Resources\\Images"; 
   String outputFileName = combine(LEAD_VARS_IMAGES_DIR, "Result.mrc"); 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.setThrowExceptionsOnInvalidImages(true); 
 
   RasterImage image = codecs.load(combine(LEAD_VARS_IMAGES_DIR, "Sample.mrc")); 
   AutoBinarizeCommand command = new AutoBinarizeCommand(); 
 
   command.run(image); 
 
   codecs.save(image, outputFileName, RasterImageFormat.MRC, 0); 
 
   image.dispose(); 
   codecs.dispose(); 
 
   assertTrue(new File(outputFileName).exists()); 
   System.out.printf("File successfully saved to %s%n", outputFileName); 
}

Requirements

Target Platforms

AutoBinarizeCommand Class

See Also

Reference