AddAlternateImage
Billedhåndtering, valgfrit indhold
Beskrivelse
Tilføjer eller opdaterer én alternativ repræsentation af et basis-image XObject som defineret i ISO 32000-1 §8.9.5.4
Alternative billeder kan levere en højopløselig gengivelse til udskrivning eller en visningsgengivelse, der styres af valgfrit indhold, uden at duplikere sideindhold
Syntaks
Function TPDFlib.AddAlternateImage(BaseImageID, AlternateImageID: Integer; DefaultForPrinting: Boolean; OptionalContentID: Integer= 0): Integer;Parametre
| BaseImageID | Billedet, der bruges af sideressourcer og Do-operatorer i indholdsstrømme |
|---|---|
| AlternateImageID | Det billed-XObject, der skal tilknyttes som en variant |
| DefaultForPrinting | Markerer denne variant som det foretrukne udskriftsbillede og fjerner markeringen fra andre varianter af det samme basisbillede |
| OptionalContentID | En valgfri OCG- eller OCMD-handle, der styrer valget af denne variant, eller 0 uden betingelse for valgfrit indhold |
Returværdi
Returnerer det 1-baserede alternative indeks, herunder det eksisterende indeks, når det samme billede opdateres, eller 0, når valideringen mislykkes
Bemærkninger
Basisbilledet og alternativet skal være forskellige billedobjekter i det valgte dokument
Et billede, der allerede bruges som et alternativ, kan ikke eje sit eget /Alternates-array, og et billede, der ejer alternativer, kan ikke tilknyttes som endnu et alternativ
Hvis en OCG eller OCMD angives, hæves den mindste PDF-version til 1.5; ellers er den mindste version PDF 1.3
Alle PDF/A-tilstande afviser handlingen, fordi ISO 19005 forbyder /Alternates i billedordbøger
Når grundbilledet har en /OC-post, viser den indbyggede gengiver grundbilledet, mens det er synligt, og vælger ellers det første synlige alternativ, hvis post har /OC
Eksempel
BaseImageID := PDF.AddImageFromFile('preview.png', 0);
PrintImageID := PDF.AddImageFromFile('print-600dpi.tif', 0);
AlternateIndex := PDF.AddAlternateImage(BaseImageID, PrintImageID, True);Se også
AlternateImageCount, GetAlternateImageInfo, RemoveAlternateImage, SetImageOptional, TPDFlibAlternateImageInfo