RecolorPage
Cor
Descrição
Move a página selecionada para um único espaço de cor
Sintaxe
Delphi
Function TPDFlib.RecolorPage(TargetSpace: Integer): Integer;Parâmetros
| TargetSpace | 1 cinzento, 2 RGB, 3 CMYK |
|---|
Valores devolvidos
| Count | Quantas cores foram convertidas nesta página |
|---|---|
| 0 | Nada necessitava de conversão ou TargetSpace estava fora do intervalo de 1 a 3. A página conserva então os bytes originais |
Observações
A conversão utiliza aritmética normal de dispositivo, não gestão de cores: um documento que indique apenas DeviceRGB não contém um perfil através do qual efetuar a conversão. RGB é convertido em cinzento segundo os pesos de luminância de ITU-R BT.601 e CMYK é convertido conforme descrito na norma ISO 32000-1 §8.6.4.4, tal como um visualizador já faz ao apresentar um documento CMYK num ecrã
As cores definidas através de um espaço ICCBased, Separation, Indexed ou Pattern são mantidas. Ler os respetivos componentes sem o perfil alteraria a aparência da página em vez de a conservar, pelo que esse documento só é convertido nas partes que indicam diretamente um espaço de dispositivo
As imagens não são convertidas por esta chamada: uma imagem pode ser desenhada em mais do que uma página, pelo que a sua conversão aqui alteraria páginas não solicitadas pelo invocador. Utilize RecolorDocument para converter também as imagens
A geometria, o texto, o recorte e todos os outros operadores são novamente escritos sem alterações
As camadas d'a página são unidas antes da passagem, porque uma cor definida numa camada permanece em vigor na seguinte e a leitura separada perderia esse efeito
Exemplo
PDF.SelectPage(1);
PDF.RecolorPage(1); // this page in grey