RecolorPage
颜色
描述
将所选页面移入一种颜色空间
语法
Delphi
Function TPDFlib.RecolorPage(TargetSpace: Integer): Integer;参数
| TargetSpace | 1 灰度,2 RGB,3 CMYK |
|---|
返回值
| Count | 此页面转换了多少种颜色 |
|---|---|
| 0 | 无需转换,或者 TargetSpace 不在 1 至 3 范围内。页面将保留其原始字节 |
备注
该转换采用普通设备运算,而非色彩管理运算:仅声明 DeviceRGB 的文档没有可供转换的配置文件。RGB 按 ITU-R BT.601 的亮度权重转换为灰度,CMYK 则按 ISO 32000-1 §8.6.4.4 所述方式转换,这也是查看器在屏幕上显示 CMYK 文档时已执行的方式
通过 ICCBased、Separation、Indexed 或 Pattern 色彩空间设置的颜色保持不变,在没有其配置文件的情况下读取其分量会改变页面外观而非保持原貌,因此此类文档仅直接命名设备色彩空间的部分会被转换
此调用不会转换图像:图像可绘制在多个页面上,因此在此处转换会更改调用方未指定的页面。使用 RecolorDocument 也可转换图像
几何、文本、裁剪及其他所有运算符都会原样写回
页面'的图层会在处理前连接,因为在一个图层上设置的颜色在下一个图层中仍然有效,分开读取会丢失这一点
示例
PDF.SelectPage(1);
PDF.RecolorPage(1); // this page in grey