FlattenTransparency

Dokumentbehandling, gengivelse, PDF-kompatibilitet

Beskrivelse

Erstatter hver valgt side med ét uigennemsigtigt rasterbillede, der bevarer det gengivne udseende og samtidig fjerner gennemsigtighed fra tilgængeligt sideindhold

Syntaks

Delphi

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

Parametre

PageRange	Sideintervaludtryk eller en tom streng for alle sider
DPI	Rasteropløsning fra 36 til 1200 punkter pr. tomme
BackgroundColor	Uigennemsigtig rasterbaggrund som en `COLORREF`-værdi
Options	Bitvis kombination af `PDF_FLATTEN_TRANSPARENCY_KEEP_ANNOTATIONS` og `PDF_FLATTEN_TRANSPARENCY_GARBAGE_COLLECT` eller `PDF_FLATTEN_TRANSPARENCY_DEFAULT`

Returværdier

Returnerer antallet af erstattede sider eller 0, når validering eller gengivelse mislykkes, før nogen side erstattes

Bemærkninger

Standardindstillingen gengiver annotationer og formularfelter i erstatningsbilledet, fjerner deres interaktive objekter og indsamler objekter, der ikke længere kan nås, så en kompatibel ældre PDF-version kan vælges bagefter

PDF_FLATTEN_TRANSPARENCY_KEEP_ANNOTATIONS bevarer anmærknings- og formularobjekter og udelukker dem fra rastergennemgangen, så de ikke tegnes to gange

Roterede sider skrives med deres visuelle dimensioner og en rotation på nul, UserUnit indregnes i medieboksens dimensioner, og nedarvede ekstra sidebokse fjernes

Behandlingen streamer sidevis for at begrænse det maksimale rasterhukommelsesforbrug, understøtter status og annullering og kan returnere et delvist sideantal efter en fejl på en senere side eller annullering

Garbage collection ugyldiggør id'er for billeder, captures, grafiktilstande og andre fjernede ressourcer, der ikke længere kan nås, så hent nye id'er efter dette kald, når indstillingen for garbage collection bruges

Se også

RenderPageTileToStream, SetInformation, FlattenAnnotsOnPageRange