RecolorPage

色彩

描述

把所選頁面轉換到單一色彩空間

Function TPDFlib.RecolorPage(TargetSpace: Integer): Integer;

TargetSpace	`1` grey, `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