SetBlackPointCompensation

Grafika, kolor

Opis

Deklaruje kompensację czerni dla kolejnego rysowania przez wpis ExtGState /UseBlackPtComp zgodnie z definicją w ISO 32000-2 §8.6.5.9

Składnia

Delphi

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

Parametry

Mode	`0` zapisuje `/Default` i pozostawia decyzję procesorowi PDF, `1` zapisuje `/ON`, a `2` zapisuje `/OFF`

Wartości zwracane

0	Tryb jest nieprawidłowy, żaden dokument nie jest wybrany albo dokument używa trybu PDF/A
1	Stan został zastosowany do bieżącej treści

Uwagi

Klucz wymaga PDF 2.0 i sam podnosi wersję dokumentu; tryby PDF/A odrzucają wywołanie, bo ich obsługiwane wersje PDF nie mogą nieść tego stanu

Stan podąża za normalną semantyką zapisu i przywracania q/Q i jest dziedziczony przez Form XObject ze stanu grafiki aktywnego przy jego operatorze Do

EnumPageContentStates i EnumPageContentStatesEx eksponują wartość efektywną przez TPDFlibContentGraphicsState.BlackPointCompensation; rekurencyjna enumeracja rozróżnia więc Form dziedziczony jako ON, OFF albo Default przy każdym wywołaniu

Gdy bieżąca intencja renderowania to AbsoluteColorimetric, ISO 32000-2 wymaga, by efektywna wartość kompensacji czarnego punktu była traktowana jako OFF podczas konwersji barw, nawet jeśli zapisana wartość stanu grafiki to ON

Równe tryby współdzielą jeden podręczny obiekt ExtGState

Przykład

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

Zobacz również

EnumPageContentStates, EnumPageContentStatesEx, TPDFlibContentGraphicsState, SetOverprint, LoadOutputIntentProfile, SetBlendMode