FlattenTransparency

Manipulowanie dokumentem, renderowanie, zgodność PDF

Opis

Zastępuje każdą wybraną stronę jednym nieprzezroczystym obrazem rastrowym, który zachowuje renderowany wygląd, usuwając przezroczystość z osiągalnej zawartości strony

Składnia

Delphi

Function TPDFlib.FlattenTransparency(Const PageRange: WideString; DPI: Double; BackgroundColor: Cardinal; Options: Integer): Integer;

Parametry

PageRange	Wyrażenie zakresu stron albo pusty ciąg oznaczający wszystkie strony
DPI	Rozdzielczość rastrowa od 36 do 1200 punktów na cal
BackgroundColor	Nieprzezroczyste tło rastra jako wartość `COLORREF`
Options	Kombinacja bitowa `PDF_FLATTEN_TRANSPARENCY_KEEP_ANNOTATIONS` i `PDF_FLATTEN_TRANSPARENCY_GARBAGE_COLLECT` albo `PDF_FLATTEN_TRANSPARENCY_DEFAULT`

Wartości zwracane

Zwraca liczbę zastąpionych stron albo 0, gdy walidacja lub renderowanie nie powiedzie się przed zastąpieniem jakiejkolwiek strony

Uwagi

Opcja domyślna renderuje adnotacje i pola formularzy w obrazie zastępczym, usuwa ich obiekty interaktywne oraz zbiera obiekty nieosiągalne, dzięki czemu można następnie wybrać zgodną starszą wersję PDF

PDF_FLATTEN_TRANSPARENCY_KEEP_ANNOTATIONS zachowuje obiekty adnotacji i formularzy oraz wyklucza je z przebiegu rasteryzacji, aby nie zostały narysowane dwukrotnie

Obrócone strony są zapisywane z wymiarami wizualnymi i obrotem zerowym, UserUnit jest uwzględniany w wymiarach pola nośnika, a odziedziczone pomocnicze pola strony są usuwane

Przetwarzanie odbywa się strona po stronie, aby ograniczyć szczytowe użycie pamięci rastra, obsługuje postęp i anulowanie oraz może zwrócić częściową liczbę stron po błędzie lub anulowaniu na późniejszej stronie

Usuwanie elementów nieużywanych unieważnia identyfikatory nieosiągalnych obrazów, przechwyceń, stanów grafiki i innych usuniętych zasobów, dlatego po tym wywołaniu należy uzyskać nowe identyfikatory, jeśli użyto opcji usuwania elementów nieużywanych

Zobacz również

RenderPageTileToStream, SetInformation, FlattenAnnotsOnPageRange