SetOutputIntentProfileReference
合規性、色彩管理
描述
建立或取代參照外部 ICC 設定檔的文件層級或頁面層級 PDF 2.0 輸出意圖,而不內嵌設定檔位元組
語法
Delphi
Function SetOutputIntentProfileReference(PageNumber: Integer; Const ProfileFileName, ProfileURL, OutputConditionIdentifier, OutputCondition, Info, RegistryName, ProfileName, ColorantNames: WideString): Integer;參數
| PageNumber | 0 表示 Catalog 輸出意圖,或以 1 為起始的頁碼表示明確的頁面輸出意圖 |
|---|---|
| ProfileFileName | 用於驗證設定檔並衍生其參照中繼資料的本機 ICC 檔案;檔案位元組不會內嵌 |
| ProfileURL | 具有明確配置的 ASCII RFC 3986 URI,用於擷取同一個 ICC 設定檔 |
| OutputConditionIdentifier | 必要的生產條件識別碼 |
| OutputCondition | 選用的人類可讀條件說明 |
| Info | 選用的補充描述 |
| RegistryName | 選用的登錄 URI |
| ProfileName | 必要的 ICC 設定檔描述 |
| ColorantNames | 選用的分號分隔色彩名稱;對於 n 色彩設定檔,省略的名稱會從 ICC colorantTableTag 讀取,而提供的名稱與順序必須與該標籤相符 |
傳回值
成功時為 1;目標無效、URI 無效、ICC 輸出裝置設定檔無法讀取或格式錯誤、設定檔色彩空間不受支援、缺少必要文字,或色彩中繼資料不符時為 0
備註
此方法驗證 ICC 標頭、宣告大小、輸出設備類別與著色劑表,然後寫出帶 /URLs 的 /DestOutputProfileRef、16 位元組的 MD5 /CheckSum、四個位元組的 /ICCVersion 與 /ProfileCS 字串、/ProfileName,以及選配的 /ColorantTable
GRAY、RGB 與 CMYK 描述檔支援 PDF/X-6p 模式 5;2CLR 到 FCLR 描述檔支援 PDF/X-6n 模式 6
此呼叫需要 PDF 2.0,並替換所選範圍的第一個輸出意圖
另請參閱
AddOutputIntentProfileReferenceURL, GetEffectivePageOutputIntentJSON, SetPDFXMode, SetPageOutputIntent