GdPicture.NET.14.API~GdPicture14.GdPictureImaging~IsBlank(Int32,Single,Boolean)

IsBlank(Int32,Single,Boolean) Method

In This Topic

Detects if a GdPicture image or on an area of a GdPicture image defined by SetROI() method is blank, with option to account for margins.

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Overloads Function IsBlank( _
   ByVal ImageID As Integer, _
   ByVal Confidence As Single, _
   ByVal AccountForMargins As Boolean _
) As Boolean

public bool IsBlank( 
   int ImageID,
   float Confidence,
   bool AccountForMargins
)

public function IsBlank( 
    ImageID: Integer;
    Confidence: Single;
    AccountForMargins: Boolean
): Boolean;

public function IsBlank( 
   ImageID : int,
   Confidence : float,
   AccountForMargins : boolean
) : boolean;

public: bool IsBlank( 
   int ImageID,
   float Confidence,
   bool AccountForMargins
)

public:
bool IsBlank( 
   int ImageID,
   float Confidence,
   bool AccountForMargins
)

Parameters

ImageID: GdPicture image identifier.
Confidence: Confidence threshold in the range [0 - 100]. Suggested value is 99.5.
AccountForMargins: Specifies if the algorithm must drop the margins during the calculation (slower). Yields more accurate results for images with margins. Default value is true.

Return Value

True if it is a blank image, else False.

Remarks

Use the GetStat() method to check if this method has completed successfully.

Example

Removing the blank pages from a tiff document.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    // LoadInMemory parameter is set to true in order to be able to update the input file.
    int imageID = gdpictureImaging.TiffCreateMultiPageFromFile("multipage.tif", true);
    int pageCount = gdpictureImaging.TiffGetPageCount(imageID);
    int pageNo = 1;
    while (pageNo <= pageCount)
    {
        gdpictureImaging.TiffSelectPage(imageID, pageNo);
        if (gdpictureImaging.IsBlank(imageID, 95, false))
        {
            gdpictureImaging.TiffDeletePage(imageID, pageNo);
            pageCount--;
        }
        else
        {
            pageNo++;
        }
    }
    gdpictureImaging.TiffSaveMultiPageToFile(imageID, "multipage.tif", TiffCompression.TiffCompressionAUTO);
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}

Example

Removing the blank pages from a tiff document. using (GdPictureImaging gdpictureImaging = new GdPictureImaging()) { // LoadInMemory parameter is set to true in order to be able to update the input file. int imageID = gdpictureImaging.TiffCreateMultiPageFromFile("multipage.tif", true); int pageCount = gdpictureImaging.TiffGetPageCount(imageID); int pageNo = 1; while (pageNo <= pageCount) { gdpictureImaging.TiffSelectPage(imageID, pageNo); if (gdpictureImaging.IsBlank(imageID, 95, false)) { gdpictureImaging.TiffDeletePage(imageID, pageNo); pageCount--; } else { pageNo++; } } gdpictureImaging.TiffSaveMultiPageToFile(imageID, "multipage.tif", TiffCompression.TiffCompressionAUTO); gdpictureImaging.ReleaseGdPictureImage(imageID); }

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List