AddAlternateImage
Manejo de imágenes, contenido opcional
Descripción
Agrega o actualiza una representación alternativa de un XObject de imagen base, según 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 | El XObject de imagen que se debe adjuntar como variante |
| DefaultForPrinting | Marca esta variante como la imagen de impresión preferida y borra esa marca de otras variantes de la misma imagen base |
| OptionalContentID | Un identificador OCG u OCMD opcional que controla la selección de esta variante, o 0 si no hay condición de contenido opcional |
Valor devuelto
Devuelve el índice alternativo basado en 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 diferentes en el documento seleccionado
Una imagen ya usada como alternativa no puede tener su propio arreglo /Alternates, y una imagen que posee alternativas no puede adjuntarse como otra alternativa
Pasar un OCG u OCMD eleva la versión mínima de PDF a 1.5; de lo 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 diccionarios de imagen
Cuando la imagen base tiene una entrada /OC, el renderizador integrado muestra la base mientras está visible y, de otro modo, selecciona la primera alternativa visible cuya entrada tiene /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