RenderPageToMonochromeFileEx

Rendering and printing, Image handling, Optimisation

Popis

Renders a page to a 1-bit BMP file with optional threshold conversion and isolated black-pixel cleanup

Use this function before CCITT or JBIG2 workflows when scanned or rendered content needs deterministic monochrome preparation

Syntaxe

Delphi

Function TPDFlib.RenderPageToMonochromeFileEx(DPI: Double; Page: Integer; Const FileName: WideString; Threshold, Despeckle: Integer): Integer;

Parametry

DPIThe render resolution
PageČíslo stránky číslované od jedničky, která se má vykreslit
FileNameThe destination BMP file
Threshold0 ponechá zastaralou cestu GDI rastru, je-li i Despeckle 0; jinak hodnoty 1 až 255 volí šedý práh používaný u černých pixelů
Despeckle0 vypne čištění; hodnoty 1 až 8 odstraní černé pixely s menším počtem sousedních černých pixelů v okolní oblasti 3x3

Return values

0Stránku se nepodařilo vykreslit, volby byly mimo rozsah, nebo se nepodařilo zapsat výstupní soubor
1Soubor BMP s 1 bitem byl zapsán

Poznámky

RenderPageToMonochromeFile volá tuto funkci s Threshold a Despeckle nastavenými na 0, takže zůstává předchozí GDI halftone chování

Když se úklid požaduje s Threshold nastaveným na 0, funkce použije před aplikací úklidového průchodu práh 128