SetBlackPointCompensation

Gráficos, cor

Descrição

Declara a compensação de ponto preto para o desenho subsequente através de uma entrada ExtGState /UseBlackPtComp, conforme definido pela ISO 32000-2 §8.6.5.9

Sintaxe

Delphi

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

Parâmetros

Mode	`0` escreve `/Default` e deixa a decisão ao processador PDF, `1` escreve `/ON`, e `2` escreve `/OFF`

Valores devolvidos

0	O modo é inválido, nenhum documento está selecionado, ou o documento usa um modo PDF/A
1	O estado foi aplicado ao conteúdo atual

Observações

A chave exige PDF 2.0 e eleva automaticamente a versão do documento; os modos PDF/A recusam a chamada porque as respetivas versões PDF suportadas não podem transportar este estado

O estado segue a semântica normal de guardar e restaurar de q/Q e é herdado por um Form XObject do estado gráfico ativo no respetivo operador Do

EnumPageContentStates e EnumPageContentStatesEx expõem o valor efetivo através de TPDFlibContentGraphicsState.BlackPointCompensation; a enumeração recursiva distingue, por isso, um formulário herdado como ON, OFF ou Default em cada invocação

Quando a intenção de renderização atual é AbsoluteColorimetric, a ISO 32000-2 exige que o valor efetivo de compensação do ponto preto seja tratado como OFF durante a conversão de cor, mesmo que o valor do estado gráfico armazenado seja ON

Modos iguais partilham um único objeto ExtGState em cache

Exemplo

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

Consulte também

EnumPageContentStates, EnumPageContentStatesEx, TPDFlibContentGraphicsState, SetOverprint, LoadOutputIntentProfile, SetBlendMode