FlattenTransparency
Document manipulation, Rendering, PDF compatibility
Descrição
Substitui cada página selecionada por uma única imagem raster opaca que preserva a aparência renderizada enquanto remove a transparência do conteúdo de página alcançável
Sintaxe
Delphi
Function TPDFlib.FlattenTransparency(Const PageRange: WideString; DPI: Double; BackgroundColor: Cardinal; Options: Integer): Integer;Parâmetros
| PageRange | Page range expression, or an empty string for every page |
|---|---|
| DPI | Resolução raster de 36 a 1200 pontos por polegada |
| BackgroundColor | Opaque raster background as a COLORREF value |
| Options | Bitwise combination of PDF_FLATTEN_TRANSPARENCY_KEEP_ANNOTATIONS and PDF_FLATTEN_TRANSPARENCY_GARBAGE_COLLECT, or PDF_FLATTEN_TRANSPARENCY_DEFAULT |
Return values
Retorna o número de páginas substituídas, ou 0 quando a validação ou a renderização falha antes que qualquer página seja substituída
Observações
A opção padrão renderiza anotações e campos de formulário na imagem de substituição, remove seus objetos interativos e coleta objetos inalcançáveis, de modo que uma versão de PDF mais antiga compatível possa ser selecionada depois
PDF_FLATTEN_TRANSPARENCY_KEEP_ANNOTATIONS preserves annotation and form objects and excludes them from the raster pass so they are not drawn twice
Rotated pages are written with their visual dimensions and a zero rotation,
UserUnit is folded into the media-box dimensions, and inherited auxiliary page boxes are removed
Processing is page-streamed to bound peak raster memory, supports progress and cancellation, and may return a partial page count after a later-page failure or cancellation
A coleta de lixo invalida IDs de imagens, capturas, estados gráficos e outros recursos removidos inacessíveis, portanto adquira novos IDs após esta chamada quando a opção de coleta de lixo for usada
Veja também
RenderPageTileToStream, SetInformation, FlattenAnnotsOnPageRange