RenderPageToMonochromeFileEx

Renderowanie i drukowanie, Obsługa obrazów, Optymalizacja

Opis

Renderuje stronę do jednobitowego pliku BMP z opcjonalną konwersją progową i usuwaniem odizolowanych czarnych pikseli

Tej funkcji należy użyć przed przepływami pracy CCITT lub JBIG2, gdy zeskanowana albo wyrenderowana zawartość wymaga deterministycznego przygotowania monochromatycznego

Składnia

Delphi

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

Parametry

DPIRozdzielczość renderowania
PageNumer renderowanej strony liczony od jedynki
FileNameDocelowy plik BMP
ThresholdWartość 0 zachowuje starszą ścieżkę półtonów GDI, gdy Despeckle również wynosi 0; w przeciwnym razie wartości od 1 do 255 wybierają próg skali szarości używany dla czarnych pikseli
DespeckleWartość 0 wyłącza oczyszczanie; wartości od 1 do 8 usuwają czarne piksele mające mniej sąsiednich czarnych pikseli w otaczającym obszarze 3x3

Wartości zwracane

0Nie udało się wyrenderować strony, opcje były spoza zakresu albo nie można było zapisać pliku wyjściowego
1Zapisano jednobitowy plik BMP

Uwagi

Funkcja RenderPageToMonochromeFile wywołuje tę funkcję z parametrami Threshold i Despeckle ustawionymi na 0, zachowując wcześniejsze zachowanie półtonów GDI

Gdy żądane jest oczyszczanie, a Threshold ma wartość 0, funkcja przed zastosowaniem przebiegu oczyszczającego używa progu 128