RenderPageToMonochromeFileEx

Renderização e impressão, Manipulação de imagens, Otimização

Descrição

Renderiza uma página para um arquivo BMP de 1 bit, com conversão por threshold opcional e limpeza de pixels pretos isolados

Use esta função antes de fluxos CCITT ou JBIG2, quando conteúdo escaneado ou renderizado precisar de preparação monocromática determinística

Sintaxe

Delphi

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

Parâmetros

DPIThe render resolution
PageO número da página a renderizar, com base 1
FileNameThe destination BMP file
Threshold0 mantém o caminho legado de halftone do GDI quando Despeckle também é 0; caso contrário, valores de 1 a 255 selecionam o corte de tons de cinza usado para pixels pretos
Despeckle0 desabilita a limpeza; valores de 1 a 8 removem pixels pretos com menos pixels pretos vizinhos na área 3x3 ao redor

Valores retornados

0A página não pôde ser renderizada, as opções estavam fora do intervalo, ou o arquivo de saída não pôde ser gravado
1O arquivo BMP de 1 bit foi gravado

Observações

RenderPageToMonochromeFile chama esta função com Threshold e Despeckle definidos como 0, preservando o comportamento anterior de halftone do GDI

Quando a limpeza é pedida com Threshold definido como 0, a função usa um threshold de 128 antes de aplicar a passada de limpeza