FlattenTransparency

Manipulação de documentos, Composição, Compatibilidade PDF

Descrição

Substitui cada página selecionada por uma imagem raster opaca que preserva o aspeto composto, enquanto remove a transparência do conteúdo alcançável da página

Sintaxe

Delphi

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

Parâmetros

PageRange	Expressão de intervalo de páginas, ou uma cadeia vazia para todas as páginas
DPI	Resolução raster de 36 a 1200 pontos por polegada
BackgroundColor	Fundo raster opaco como valor `COLORREF`
Options	Combinação bit a bit de `PDF_FLATTEN_TRANSPARENCY_KEEP_ANNOTATIONS` e `PDF_FLATTEN_TRANSPARENCY_GARBAGE_COLLECT`, ou `PDF_FLATTEN_TRANSPARENCY_DEFAULT`

Valores devolvidos

Devolve o número de páginas substituídas ou 0 quando a validação ou a composição falha antes de qualquer página ser substituída

Observações

A opção predefinida renderiza anotações e campos de formulário na imagem de substituição, remove os respetivos objetos interativos e recolhe objetos inacessíveis, permitindo selecionar posteriormente uma versão PDF compatível mais antiga

PDF_FLATTEN_TRANSPARENCY_KEEP_ANNOTATIONS preserva os objetos de anotação e formulário e exclui-os da passagem de rasterização para que não sejam desenhados duas vezes

As páginas rodadas são escritas com as respetivas dimensões visuais e rotação zero, UserUnit é incorporado nas dimensões da media-box e as caixas de página auxiliares herdadas são removidas

O processamento é transmitido por página para limitar o pico de memória raster, suporta progresso e cancelamento e pode devolver uma contagem parcial de páginas após falha ou cancelamento numa página posterior

A recolha de lixo invalida os ID de imagens, capturas, estados gráficos e outros recursos inacessíveis removidos, pelo que deve obter novos ID após esta chamada quando a opção de recolha de lixo for utilizada

Consulte também

RenderPageTileToStream, SetInformation, FlattenAnnotsOnPageRange