SetBlackPointCompensation

圖形、色彩

描述

依 ISO 32000-2 §8.6.5.9 的定義，透過 ExtGState /UseBlackPtComp 項目為後續繪圖宣告黑點補償

語法

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 公開有效值；遞迴列舉因此能區分每個呼叫點 Form 繼承到的 ON、OFF 或 Default

目前渲染意圖為 AbsoluteColorimetric 時，依 ISO 32000-2，即使圖形狀態儲存值為 ON，色彩轉換期間有效黑點補償值仍須視為 OFF

相同的模式共用同一份快取的 ExtGState 物件

範例

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

另請參閱

EnumPageContentStates, EnumPageContentStatesEx, TPDFlibContentGraphicsState, SetOverprint, LoadOutputIntentProfile, SetBlendMode