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 | 具有显式 scheme 的 ASCII RFC 3986 URI，用于获取同一 ICC 配置文件 |
| OutputConditionIdentifier | 必需的生产条件标识符 |
| OutputCondition | 可选的人类可读条件 |
| Info | 可选的附加描述 |
| RegistryName | 可选的注册表 URI |
| ProfileName | 必需的 ICC 配置文件描述 |
| ColorantNames | 可选的以分号分隔的颜色名；对于 n 颜色配置文件，省略的名称会从 ICC colorantTableTag 读取，而提供的名称和顺序必须与该标记匹配 |
返回值
成功时返回 1；目标或 URI 无效、ICC 输出设备配置文件不可读或格式错误、配置文件色彩空间不受支持、缺少必需文本或颜色元数据不匹配时返回 0
备注
该方法验证 ICC 头、声明大小、输出设备类和着色剂表，然后写入带有 /URLs、16 字节 MD5 /CheckSum、4 字节 /ICCVersion 与 /ProfileCS 字符串、/ProfileName 和可选 /ColorantTable 的 /DestOutputProfileRef
GRAY、RGB 和 CMYK 配置文件支持 PDF/X-6p 模式 5；2CLR 至 FCLR 配置文件支持 PDF/X-6n 模式 6
该调用要求 PDF 2.0，并替换所选范围内的第一个输出意图
另请参阅
AddOutputIntentProfileReferenceURL, GetEffectivePageOutputIntentJSON, SetPDFXMode, SetPageOutputIntent