SetOutputIntentProfileReference
Konformität, Farbmanagement
Beschreibung
Erstellt oder ersetzt einen Dokument- oder Seiten-Output-Intent für PDF 2.0, der auf ein externes ICC-Profil verweist, ohne die Profilbytes einzubetten
Syntax
Delphi
Function SetOutputIntentProfileReference(PageNumber: Integer; Const ProfileFileName, ProfileURL, OutputConditionIdentifier, OutputCondition, Info, RegistryName, ProfileName, ColorantNames: WideString): Integer;Parameter
| PageNumber | 0 für den Catalog-Output-Intent oder eine 1-basierte Seitennummer für einen expliziten Seiten-Output-Intent |
|---|---|
| ProfileFileName | Lokale ICC-Datei, die zur Validierung des Profils und zur Ableitung seiner Referenzmetadaten verwendet wird; die Bytes werden nicht eingebettet |
| ProfileURL | ASCII-URI nach RFC 3986 mit explizitem Schema zum Abrufen desselben ICC-Profils |
| OutputConditionIdentifier | Erforderlicher Produktionsbedingungs-Bezeichner |
| OutputCondition | Optionale, für Menschen lesbare Bedingung |
| Info | Optionale zusätzliche Beschreibung |
| RegistryName | Optionale Registrierungs-URI |
| ProfileName | Erforderliche ICC-Profilbeschreibung |
| ColorantNames | Optionale, durch Semikolons getrennte Farbmittelnamen; bei einem Profil mit n Farbmitteln werden ausgelassene Namen aus dem ICC-colorantTableTag gelesen, während angegebene Namen und deren Reihenfolge mit diesem Tag übereinstimmen müssen |
Rückgabewert
1 bei Erfolg, oder 0 bei ungültigem Ziel, ungültiger URI, unlesbarem oder fehlerhaftem ICC-Ausgabegeräteprofil, nicht unterstütztem Profil-Farbraum, fehlendem Pflichttext oder nicht übereinstimmenden Farbmittel-Metadaten
Anmerkungen
Die Methode validiert den ICC-Header, die deklarierte Größe, die Ausgabegeräteklasse und die Farbmitteltabelle und schreibt dann /DestOutputProfileRef mit /URLs, einer 16-Byte-MD5-/CheckSum, den Vier-Byte-Zeichenketten /ICCVersion und /ProfileCS, /ProfileName und einer optionalen /ColorantTable
GRAY-, RGB - und CMYK-Profile unterstützen den PDF/X-6p-Modus 5; Profile von 2CLR bis FCLR unterstützen den PDF/X-6n-Modus 6
Der Aufruf erfordert PDF 2.0 und ersetzt den ersten Output Intent im ausgewählten Bereich
Siehe auch
AddOutputIntentProfileReferenceURL, GetEffectivePageOutputIntentJSON, SetPDFXMode, SetPageOutputIntent