BlankPageDetectorCommand Class

Summary

Detects whether an image is a blank page. This command is available in the Document/Medical Toolkits.

Syntax

Objective-C

C++/CLI

Java

Python

public class BlankPageDetectorCommand : RasterCommand

@interface LTBlankPageDetectorCommand : LTRasterCommand

public class BlankPageDetectorCommand 
    extends RasterCommand

public ref class BlankPageDetectorCommand : public RasterCommand

class BlankPageDetectorCommand(RasterCommand):

Remarks

For various reasons, documents being scanned can contain a significant number of blank pages. Disk storage space for the scanned items can be reduced if such pages can be removed before the documents are stored. This command detects whether a page is blank and returns an accuracy value. It can detect blank pages (despite noise, bleed-through, or lines) with high precision and speed.

This command does not support 12- or 16-bit grayscale or 48- or 64-bit color images.
This command supports unsigned 8-bit data images, but not signed ones.
This command does not support 32-bit grayscale images.

Blank Page Function - Before

Blank Page Function - After

View additional platform support for this Blank Page function.

Example

Runs the BlankPageDetectorCommand on an image and determines whether it is blank.

Java

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Core; 
 
public void BlankPageDetectorCommandExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Clean.tif")); 
 
   // Prepare the command 
   BlankPageDetectorCommand command = new BlankPageDetectorCommand() 
   { 
      // The following properties can be left to their defaults or set to desired values: 
      LeftMargin = 0, 
      TopMargin = 0, 
      RightMargin = 0, 
      BottomMargin = 0, 
      MinimumTextSize = 0 
   }; 
 
   //Determine whether the image is a blank page 
   command.Flags = BlankPageDetectorCommandFlags.DetectNoisyPage; 
   command.Run(image); 
 
   MessageBox.Show(" Is Blank   : " + command.IsBlank + "\n Accuracy : " + (command.Accuracy * 1.0 / 100) + "%", "Blank Page Detection Results"); 
 
} 
 
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 blankPageDetectorCommandExample() { 
 
    final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
 
    // Load an image 
    RasterCodecs codecs = new RasterCodecs(); 
    codecs.setThrowExceptionsOnInvalidImages(true); 
    RasterImage image = codecs.load(combine(LEAD_VARS_IMAGES_DIR, "Clean.tif")); 
 
    // Prepare the command 
    BlankPageDetectorCommand command = new BlankPageDetectorCommand(); 
 
    // Determine whether the image is a blank page 
    command.setFlags(BlankPageDetectorCommandFlags.DETECT_NOISY_PAGE.getValue()); 
    command.run(image); 
    codecs.save(image, combine(LEAD_VARS_IMAGES_DIR, "Result.jpg"), RasterImageFormat.JPEG, 24); 
    System.out.printf( 
            "Command run and image saved to %1s%nBlank Page Detection Results: %nIs blank: %2s%nAccuracy: %3s%%%n", 
            combine(LEAD_VARS_IMAGES_DIR, "Result.jpg"), command.isBlank(), (command.getAccuracy() / 100.0)); 
    assertTrue(new File(combine(LEAD_VARS_IMAGES_DIR, "Result.jpg")).exists()); 
 
}