ConvertTo1BppSauvola(Int32,Single) Method

In This Topic

Converts a GdPicture image to a 1-bit (black and white) bitmap using the Sauvola local adaptive thresholding method. This method is particularly efficient on documents with poor contrast.

Syntax

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

'Declaration
 
Public Overloads Function ConvertTo1BppSauvola( _
   ByVal ImageID As Integer, _
   ByVal Factor As Single _
) As GdPictureStatus

public GdPictureStatus ConvertTo1BppSauvola( 
   int ImageID,
   float Factor
)

public function ConvertTo1BppSauvola( 
    ImageID: Integer;
    Factor: Single
): GdPictureStatus;

public function ConvertTo1BppSauvola( 
   ImageID : int,
   Factor : float
) : GdPictureStatus;

public: GdPictureStatus ConvertTo1BppSauvola( 
   int ImageID,
   float Factor
)

public:
GdPictureStatus ConvertTo1BppSauvola( 
   int ImageID,
   float Factor
)

Parameters

ImageID: GdPicture image identifier.
Factor: Factor of thresholding reduction. Must be a balue in tha range ]0 ; 1. Suggested value is 0.35. Higher is the factor value lighter should be the resulting image.

Return Value

A member of the GdPictureStatus enumeration.

Remarks

This method requires the Image Documents component to run.

Example

Converts selected image to a 1-bit BW indexed color image, and saves result into a TIF file.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    // Open an image file. An empty string allows the control to prompt for selecting a file.
    int imageID = gdpictureImaging.CreateGdPictureImageFromFile("");
 
    gdpictureImaging.ConvertTo1BppSauvola(imageID, 0.35f);
    gdpictureImaging.SaveAsTIFF(imageID, "output.tif", TiffCompression.TiffCompressionAUTO);
 
    // Release used resources.
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
FxBlackNWhite(Int32,BitonalReduction) Method
FxBlackNWhiteT Method
ConvertTo1Bpp(Int32) Method
ConvertTo1BppAT(Int32) Method