RecolorPage
Cor
Descrição
Converte a página selecionada para um único espaço de cor
Sintaxe
Delphi
Function TPDFlib.RecolorPage(TargetSpace: Integer): Integer;Parâmetros
| TargetSpace | 1 grey, 2 RGB, 3 CMYK. |
|---|
Valores retornados
| Count | Quantas cores foram convertidas nesta página. |
|---|---|
| 0 | Nada precisava de conversão, ou TargetSpace estava fora de 1 a 3. A página então mantém os bytes originais dela. |
Observações
A conversão usa a aritmética comum de device, não gerenciada por perfil de cor: um documento que declara apenas DeviceRGB não carrega perfil nenhum pelo qual converter. RGB vira cinza pelos pesos de luminância do ITU-R BT.601, e CMYK converte como descrito na ISO 32000-1 §8.6.4.4 — que é o que um visualizador já faz ao exibir um documento CMYK na tela.
Cores definidas via espaço ICCBased, Separation, Indexed ou Pattern ficam como estão. Ler os componentes sem o perfil deles mudaria a aparência da página em vez de preservá-la, então tal documento é convertido apenas nas partes que nomeiam diretamente um device space.
Esta chamada não converte imagens: uma imagem pode ser desenhada em mais de uma página, então convertê-la aqui mudaria páginas sobre as quais o chamador não perguntou. Use RecolorDocument para converter também as imagens.
Geometria, texto, clipping e todos os demais operators são gravados de volta sem alteração.
As camadas da página são unidas antes da passada, porque uma cor definida em uma camada segue valendo na seguinte e lê-las separadamente perderia isso
Exemplo
PDF.SelectPage(1);
PDF.RecolorPage(1); // this page in grey