AddAlternateImage
Manipulação de imagens, conteúdo opcional
Descrição
Adiciona ou atualiza uma representação alternativa de um XObject de imagem base, conforme definido na ISO 32000-1 §8.9.5.4
Imagens alternativas podem fornecer uma representação de impressão em alta resolução ou uma representação de exibição controlada por conteúdo opcional, sem duplicar o conteúdo da página
Sintaxe
Function TPDFlib.AddAlternateImage(BaseImageID, AlternateImageID: Integer; DefaultForPrinting: Boolean; OptionalContentID: Integer= 0): Integer;Parâmetros
| BaseImageID | A imagem usada pelos recursos de página e pelos operators Do de content stream |
|---|---|
| AlternateImageID | O XObject de imagem a anexar como variante |
| DefaultForPrinting | Marca esta variante como a imagem de impressão preferida e limpa esse flag das outras variantes da mesma imagem base |
| OptionalContentID | Um handle OCG ou OCMD opcional que controla a seleção desta variante, ou 0 para nenhuma condição de conteúdo opcional |
Valor retornado
Retorna o índice alternativo baseado em 1, incluindo o índice existente quando a mesma imagem é atualizada, ou 0 quando a validação falha
Observações
A imagem base e a alternativa devem ser objetos de imagem diferentes no documento selecionado
Uma imagem já usada como alternativa não pode ter seu próprio array /Alternates, e uma imagem que possui alternativas não pode ser anexada como outra alternativa
Informar um OCG ou OCMD eleva a versão mínima do PDF para 1.5; caso contrário, a versão mínima é PDF 1.3
Todos os modos PDF/A rejeitam a operação porque a ISO 19005 proíbe /Alternates em dicionários de imagem
Todos os modos PDF/A rejeitam a operação porque a ISO 19005 proíbe /OC em dicionários de imagem. Quando a imagem base tem uma entrada /OC, o renderer embutido exibe a base enquanto ela estiver visível e, caso contrário, seleciona a primeira alternativa visível cuja entrada tenha
Exemplo
BaseImageID := PDF.AddImageFromFile('preview.png', 0);
PrintImageID := PDF.AddImageFromFile('print-600dpi.tif', 0);
AlternateIndex := PDF.AddAlternateImage(BaseImageID, PrintImageID, True);Veja também
AlternateImageCount, GetAlternateImageInfo, RemoveAlternateImage, SetImageOptional, TPDFlibAlternateImageInfo
AnteriorNavegaçãoPróximomain>