SetBlackPointCompensation

图形、颜色

描述

通过 ExtGState /UseBlackPtComp 条目为后续绘制声明黑点补偿，定义见 ISO 32000-2 §8.6.5.9

语法

Delphi

Function TPDFlib.SetBlackPointCompensation(Mode: Integer): Integer;

参数

Mode	`0` 写入 `/Default` 并把决定留给 PDF 处理器，`1` 写入 `/ON`，`2` 写入 `/OFF`

返回值

0	模式无效、未选定文档，或文档使用 PDF/A 模式
1	该状态已应用到当前内容

备注

该键要求 PDF 2.0 并自动提升文档版本；PDF/A 模式拒绝该调用，因为其支持的 PDF 版本无法承载此状态

该状态遵循常规的 q/Q 保存与恢复语义，Form XObject 从其 Do 算子时生效的图形状态继承它

EnumPageContentStates 与 EnumPageContentStatesEx 通过 TPDFlibContentGraphicsState.BlackPointCompensation 暴露有效值；因此递归枚举能在每次调用时区分以 ON、OFF 或 Default 继承的 Form

当前渲染意图为 AbsoluteColorimetric 时，ISO 32000-2 要求在颜色转换期间把有效黑点补偿值按 OFF 处理，即使存储的图形状态值为 ON

相同模式共享一个缓存的 ExtGState 对象

示例

PDF.SetBlackPointCompensation(1); // ON for the proof-critical artwork
PDF.DrawBox(50, 50, 200, 120, 1);

另请参阅

EnumPageContentStates, EnumPageContentStatesEx, TPDFlibContentGraphicsState, SetOverprint, LoadOutputIntentProfile, SetBlendMode