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
| DPI | The render resolution |
|---|---|
| Page | Číslo stránky číslované od jedničky, která se má vykreslit |
| FileName | The destination BMP file |
| Threshold | 0 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ů |
| Despeckle | 0 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
| 0 | Stránku se nepodařilo vykreslit, volby byly mimo rozsah, nebo se nepodařilo zapsat výstupní soubor |
|---|---|
| 1 | Soubor 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