AddAlternateImage
Afbeeldingsverwerking, optionele content
Beschrijving
Voegt één alternatieve representatie van een basisafbeelding-XObject toe of werkt die bij, zoals gedefinieerd in ISO 32000-1 §8.9.5.4
Alternate images kunnen een weergave met hoge resolutie voor afdrukken of een weergave die door optionele content wordt gestuurd leveren, zonder pagina-inhoud te dupliceren
Syntaxis
Function TPDFlib.AddAlternateImage(BaseImageID, AlternateImageID: Integer; DefaultForPrinting: Boolean; OptionalContentID: Integer= 0): Integer;Parameters
| BaseImageID | De afbeelding die door paginaresources en contentstream Do-operators wordt gebruikt |
|---|---|
| AlternateImageID | De image XObject die als variant moet worden gekoppeld |
| DefaultForPrinting | Markeert deze variant als voorkeursafbeelding voor afdrukken en haalt die vlag bij andere varianten van dezelfde basisafbeelding weg |
| OptionalContentID | Een optionele OCG- of OCMD-handle die de selectie van deze variant stuurt, of 0 voor geen optional-content-voorwaarde |
Retourwaarde
Geeft de alternatieve index terug (beginnend bij 1), inclusief de bestaande index wanneer dezelfde afbeelding wordt bijgewerkt, of 0 wanneer validatie mislukt
Opmerkingen
De basis- en de alternatieve afbeelding moeten verschillende afbeeldingsobjecten in het geselecteerde document zijn
Een afbeelding die al als alternatief wordt gebruikt, kan geen eigen /Alternates-array hebben, en een afbeelding die alternatieven bezit, kan niet als nog een alternatief worden gekoppeld
Een OCG of OCMD doorgeven verhoogt de minimale PDF-versie naar 1.5; anders is de minimale versie PDF 1.3
Alle PDF/A-modussen wijzen de bewerking af omdat ISO 19005 /Alternates in afbeeldingswoordenboeken verbiedt
Alle PDF/A-modi weigeren de bewerking omdat ISO 19005 /OC in afbeeldingswoordenboeken verbiedt Heeft de basisafbeelding een /OC-entry, dan toont de ingebouwde renderer de basis zolang die zichtbaar is en kiest anders de eerste zichtbare alternatief waarvan de entry heeft
Voorbeeld
BaseImageID := PDF.AddImageFromFile('preview.png', 0);
PrintImageID := PDF.AddImageFromFile('print-600dpi.tif', 0);
AlternateIndex := PDF.AddAlternateImage(BaseImageID, PrintImageID, True);Zie ook
AlternateImageCount, GetAlternateImageInfo, RemoveAlternateImage, SetImageOptional, TPDFlibAlternateImageInfo