AddAlternateImage
Tratamiento de imágenes, contenido opcional
Descripción
Añade o actualiza una representación alternativa de un XObject de imagen base según se define en ISO 32000-1 §8.9.5.4
Las imágenes alternativas pueden proporcionar una representación de impresión de alta resolución o una representación de visualización controlada por contenido opcional sin duplicar el contenido de la página
Sintaxis
Function TPDFlib.AddAlternateImage(BaseImageID, AlternateImageID: Integer; DefaultForPrinting: Boolean; OptionalContentID: Integer= 0): Integer;Parámetros
| BaseImageID | La imagen utilizada por los recursos de página y los operadores Do del flujo de contenido |
|---|---|
| AlternateImageID | XObject de imagen que se adjuntará como variante |
| DefaultForPrinting | Marca esta variante como imagen de impresión preferida y borra esa marca de las demás variantes de la misma imagen base |
| OptionalContentID | Un identificador opcional de OCG u OCMD que controla la selección de esta variante, o 0 si no hay ninguna condición de contenido opcional |
Valor devuelto
Devuelve el índice alternativo con base uno, incluido el índice existente cuando se actualiza la misma imagen, o 0 cuando falla la validación
Observaciones
La imagen base y la alternativa deben ser objetos de imagen distintos del documento seleccionado
Una imagen ya utilizada como alternativa no puede poseer su matriz /Alternates, y una imagen con alternativas no puede adjuntarse como otra alternativa
Pasar un OCG u OCMD eleva la versión mínima de PDF a 1.5; en caso contrario, la versión mínima es PDF 1.3
Todos los modos PDF/A rechazan la operación porque ISO 19005 prohíbe /Alternates en los diccionarios de imagen
Cuando la imagen base tiene una entrada /OC, el renderizador integrado muestra la base mientras esté visible y, en caso contrario, selecciona la primera alternativa visible cuya entrada tenga /OC
Ejemplo
BaseImageID := PDF.AddImageFromFile('preview.png', 0);
PrintImageID := PDF.AddImageFromFile('print-600dpi.tif', 0);
AlternateIndex := PDF.AddAlternateImage(BaseImageID, PrintImageID, True);Véase también
AlternateImageCount, GetAlternateImageInfo, RemoveAlternateImage, SetImageOptional, TPDFlibAlternateImageInfo