AddAlternateImage
Traitement des images, contenu facultatif
Description
Ajoute ou met à jour une représentation alternative d'un objet XObject image de base selon ISO 32000-1 §8.9.5.4
Les images de remplacement peuvent fournir une représentation haute résolution pour l'impression ou un affichage contrôlé par contenu facultatif sans dupliquer le contenu
Syntaxe
Function TPDFlib.AddAlternateImage(BaseImageID, AlternateImageID: Integer; DefaultForPrinting: Boolean; OptionalContentID: Integer= 0): Integer;Paramètres
| BaseImageID | L'image utilisée par les ressources de page et les opérateurs Do du flux de contenu |
|---|---|
| AlternateImageID | Image XObject à joindre comme variante |
| DefaultForPrinting | Marque cette variante comme image d'impression préférée et efface cet indicateur des autres variantes de la même image de base |
| OptionalContentID | Un handle OCG ou OCMD facultatif qui contrôle la sélection de cette variante, ou 0 sans condition de contenu facultatif |
Valeur de retour
Renvoie l'indice de remplacement à base 1, y compris l'indice existant lorsque la même image est mise à jour, ou 0 si la validation échoue
Remarques
La base et l'alternative doivent être des objets image différents dans le document sélectionné
Une image déjà utilisée comme remplacement ne peut posséder son propre tableau /Alternates, et une image qui en possède ne peut être associée comme autre remplacement
La transmission d'un OCG ou OCMD relève la version PDF minimale à 1.5 ; sinon, la version minimale est PDF 1.3
Tous les modes PDF/A rejettent l'opération, car ISO 19005 interdit /Alternates dans les dictionnaires d'image
Si l'image de base comporte /OC, le moteur intégré l'affiche lorsqu'elle est visible ; sinon il sélectionne le premier remplacement visible dont l'entrée comporte /OC
Exemple
BaseImageID := PDF.AddImageFromFile('preview.png', 0);
PrintImageID := PDF.AddImageFromFile('print-600dpi.tif', 0);
AlternateIndex := PDF.AddAlternateImage(BaseImageID, PrintImageID, True);Voir aussi
AlternateImageCount, GetAlternateImageInfo, RemoveAlternateImage, SetImageOptional, TPDFlibAlternateImageInfo