AddAlternateImage
Bildhantering, valfritt innehåll
Beskrivning
Lägger till eller uppdaterar en alternativ representation av en basbilds image XObject enligt ISO 32000-1 §8.9.5.4
Alternativa bilder kan ge en högupplöst utskriftsrepresentation eller en optional content-styrd visningsrepresentation utan att duplicera sidinnehåll
Syntax
Function TPDFlib.AddAlternateImage(BaseImageID, AlternateImageID: Integer; DefaultForPrinting: Boolean; OptionalContentID: Integer= 0): Integer;Parametrar
| BaseImageID | Bilden som sidresurser och content stream-Do-operatorer använder |
|---|---|
| AlternateImageID | Det image XObject som ska fogas som variant |
| DefaultForPrinting | Markerar den här varianten som föredragen utskriftsbild och rensar den flaggan från andra varianter av samma basbild |
| OptionalContentID | En valfri OCG- eller OCMD-handle som styr val av denna variant, eller 0 för inget optional content-villkor |
Returvärde
Returnerar det 1-baserade alternativindexet, inklusive befintligt index när samma bild uppdateras, eller 0 när valideringen misslyckas
Anmärkningar
Basen och alternativet måste vara olika bildobjekt i det valda dokumentet
/Alternates
Att skicka en OCG eller OCMD höjer den minsta PDF-versionen till 1.5; i annat fall är minimiversionen PDF 1.3
Basen och alternativet måste vara olika bildobjekt i det valda dokumentetEn bild som redan används som alternativ kan inte äga sin egen /Alternates-array, och en bild som äger alternativ kan inte fästas som ett annat alternativAtt skicka en OCG eller OCMD höjer minimiversionen för PDF till 1.5; i övrigt är minimiversionen PDF 1.3
Alla PDF/A-lägen avvisar operationen eftersom ISO 19005 förbjuder /OC i bilddictionarysNär basbilden har en /OC-post visar den inbyggda renderaren basen medan den är synlig och väljer i övrigt den första synliga alternativet vars post har
Exempel
BaseImageID := PDF.AddImageFromFile('preview.png', 0);
PrintImageID := PDF.AddImageFromFile('print-600dpi.tif', 0);
AlternateIndex := PDF.AddAlternateImage(BaseImageID, PrintImageID, True);Se även
AlternateImageCount, GetAlternateImageInfo, RemoveAlternateImage, SetImageOptional, TPDFlibAlternateImageInfo