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 и наследуется Form XObject от состояния графики, действующего на его операторе TPDFlibContentGraphicsState.BlackPointCompensationON и 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