AddAlternateImage
Bildverarbeitung, Optionale Inhalte
Beschreibung
Fügt gemäß ISO 32000-1 §8.9.5.4 eine alternative Darstellung eines Basis-Image-XObjects hinzu oder aktualisiert sie
Alternative Bilder können eine hochauflösende Druckdarstellung oder eine durch optionalen Inhalt gesteuerte Anzeigedarstellung bereitstellen, ohne Seiteninhalt zu duplizieren
Syntax
Function TPDFlib.AddAlternateImage(BaseImageID, AlternateImageID: Integer; DefaultForPrinting: Boolean; OptionalContentID: Integer= 0): Integer;Parameter
| BaseImageID | Das von Seitenressourcen und Do-Operatoren in Inhaltsstreams verwendete Bild |
|---|---|
| AlternateImageID | Das als Variante anzuhängende Bild-XObject |
| DefaultForPrinting | Markiert diese Variante als bevorzugtes Druckbild und entfernt dieses Flag von anderen Varianten desselben Basisbilds |
| OptionalContentID | Ein optionales OCG- oder OCMD-Handle, das die Auswahl dieser Variante steuert, oder 0 ohne optionale Inhaltsbedingung |
Rückgabewert
Gibt den einsbasierten Alternativindex einschließlich des vorhandenen Index bei Aktualisierung desselben Bilds oder 0 bei fehlgeschlagener Validierung zurück
Anmerkungen
Basis und Alternative müssen unterschiedliche Bildobjekte im ausgewählten Dokument sein
Ein bereits als Alternative verwendetes Bild darf kein eigenes /Alternates-Array besitzen, und ein Bild mit Alternativen kann nicht als weitere Alternative angefügt werden
Die Übergabe einer OCG oder OCMD hebt die PDF-Mindestversion auf 1.5 an; andernfalls ist die Mindestversion PDF 1.3
Alle PDF/A-Modi weisen den Vorgang ab, da ISO 19005 /Alternates in Bildwörterbüchern verbietet
Wenn das Basisbild einen Eintrag /OC besitzt, zeigt der integrierte Renderer die Basis an, solange sie sichtbar ist, und wählt andernfalls die erste sichtbare Alternative aus, deren Eintrag /OC enthält
Beispiel
BaseImageID := PDF.AddImageFromFile('preview.png', 0);
PrintImageID := PDF.AddImageFromFile('print-600dpi.tif', 0);
AlternateIndex := PDF.AddAlternateImage(BaseImageID, PrintImageID, True);Siehe auch
AlternateImageCount, GetAlternateImageInfo, RemoveAlternateImage, SetImageOptional, TPDFlibAlternateImageInfo