ConvertTo1BppAT(Int32,Int32) Method

In This Topic

Converts a GdPicture image to a 1-bit (black and white) bitmap using a variant of the Otsu adaptive thresholding method. This method is particularly efficient on documents with contrasted foreground and background.

Syntax

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

'Declaration
 
Public Overloads Function ConvertTo1BppAT( _
   ByVal ImageID As Integer, _
   ByVal Threshold As Integer _
) As GdPictureStatus

public GdPictureStatus ConvertTo1BppAT( 
   int ImageID,
   int Threshold
)

public function ConvertTo1BppAT( 
    ImageID: Integer;
    Threshold: Integer
): GdPictureStatus;

public function ConvertTo1BppAT( 
   ImageID : int,
   Threshold : int
) : GdPictureStatus;

public: GdPictureStatus ConvertTo1BppAT( 
   int ImageID,
   int Threshold
)

public:
GdPictureStatus ConvertTo1BppAT( 
   int ImageID,
   int Threshold
)

Parameters

ImageID: GdPicture image identifier.
Threshold: Thresholding for determining the foreground. Must be a value between 0 and 100. Suggested value is 50. Higher is the Thresold value darker should be the resulting image.

Return Value

A member of the GdPictureStatus enumeration.

Remarks

This method requires the Image Documents component to run.

Example

Converting the image to black and white using a variant of the Otsu adaptive thresholding methods.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    // LoadInMemory parameter is set to true in order to be able to update the input file.
    int imageID = gdpictureImaging.CreateGdPictureImageFromFile("image.tif", true);
 
    //Convert to black and white.
    gdpictureImaging.ConvertTo1BppAT(imageID, 45);
    gdpictureImaging.SaveAsTIFF(imageID, "image.tif", TiffCompression.TiffCompressionAUTO);
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
FxBlackNWhite(Int32,BitonalReduction) Method
FxBlackNWhiteT Method
ConvertTo1Bpp(Int32) Method
ConvertTo1BppSauvola(Int32,Single) Method
ConvertTo1BppBradley Method