AddAlternateImage
Processamento de imagens, conteúdo opcional
Descrição
Adiciona ou atualiza uma representação alternativa de um Image XObject base, conforme definido na ISO 32000-1 §8.9.5.4
As imagens alternativas podem fornecer uma representação de impressão de alta resolução ou uma representação de visualizaçã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 utilizada pelos recursos da página e pelos operadores Do do fluxo de conteúdo |
|---|---|
| AlternateImageID | O XObject de imagem a anexar como variante |
| DefaultForPrinting | Marca esta variante como imagem de impressão preferida e limpa esse sinalizador das outras variantes da mesma imagem de base |
| OptionalContentID | Um identificador OCG ou OCMD opcional que controla a seleção desta variante, ou 0 para não impor qualquer condição de conteúdo opcional |
Valor devolvido
Devolve o índice de base 1 da alternativa, incluindo o índice existente quando a mesma imagem é atualizada, ou 0 quando a validação falha
Observações
A imagem base e a alternativa têm de ser objetos de imagem diferentes no documento selecionado
Uma imagem já utilizada como alternativa não pode ter a sua própria matriz /Alternates, e uma imagem que tenha alternativas não pode ser anexada como outra alternativa
A passagem de um OCG ou OCMD eleva a versão mínima de 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 norma ISO 19005 proíbe /Alternates nos dicionários de imagem
Quando a imagem base tem uma entrada /OC, o compositor incorporado apresenta a base enquanto estiver visível e, caso contrário, seleciona a primeira alternativa visível cuja entrada tenha /OC
Exemplo
BaseImageID := PDF.AddImageFromFile('preview.png', 0);
PrintImageID := PDF.AddImageFromFile('print-600dpi.tif', 0);
AlternateIndex := PDF.AddAlternateImage(BaseImageID, PrintImageID, True);Consulte também
AlternateImageCount, GetAlternateImageInfo, RemoveAlternateImage, SetImageOptional, TPDFlibAlternateImageInfo