SauvolaBinarizeCommand Class

Summary

This function applies Sauvola binarizer to a bitmap. This class is available in the Document/Medical toolkits only.

Syntax

Objective-C

C++/CLI

Java

Python

public class SauvolaBinarizeCommand : RasterCommand

@interface LTSauvolaBinarizeCommand : LTRasterCommand

public class SauvolaBinarizeCommand 
    extends RasterCommand

public: 
   ref class SauvolaBinarizeCommand : RasterCommand

class SauvolaBinarizeCommand(RasterCommand):

Remarks

This command applies Sauvola binarization introduced in https://www.sciencedirect.com/science/article/abs/pii/S0031320399000552.
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).

Example

Java

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Core; 
 
public void SauvolaBinarizeCommandExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "glare.jpg")); 
   string destFileName = Path.Combine(LEAD_VARS.ImagesDir, "BinarizedImage.bmp"); 
 
   // Prepare the command 
   SauvolaBinarizeCommand command = new SauvolaBinarizeCommand(); 
 
   command.KFactor = 0.15; 
   command.RFactor = 128; 
   command.WindowSize = 55; 
 
   command.Run(image); 
 
    // Save it to disk 
    codecs.Save(image, destFileName, RasterImageFormat.Bmp, 24); 
} 
 
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.assertTrue; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.imageprocessing.core.SauvolaBinarizeCommand; 
 
 
public void sauvolaBinarizeCommandExample() { 
 
   final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
   String destFileName = combine(LEAD_VARS_IMAGES_DIR, "BinarizedImage.bmp"); 
 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.setThrowExceptionsOnInvalidImages(true); 
 
   RasterImage image = codecs.load(combine(LEAD_VARS_IMAGES_DIR, "glare.jpg")); 
 
   // Prepare the command 
   SauvolaBinarizeCommand command = new SauvolaBinarizeCommand(); 
 
   command.setKFactor(0.15); 
   command.setRFactor(128); 
   command.setWindowSize(55); 
 
   int change = command.run(image); 
   assertTrue(change != RasterImageChangedFlags.NONE); 
 
   // Save it to disk 
   codecs.save(image, destFileName, RasterImageFormat.BMP, 24); 
   System.out.println("Command run and image saved to " + destFileName); 
}