Atributos de cor

Importante

Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft, juntamente com o PSA (Aplicativos de Suporte para Impressão), para personalizar a experiência de impressão em Windows 10 e 11 para o desenvolvimento de dispositivos de impressora.

Para obter mais informações, consulte o Guia de design do aplicativo de suporte para impressão.

Atributos de cor são atributos gerais de impressão que especificam características para controlar a impressão de cores.

A tabela a seguir lista os atributos de cor.

Nome do atributo	Parâmetro de atributos	Comentários
ChangeColorModeOnDoc?	TRUE ou FALSE. Indica se o modo de cor de uma impressora pode ser alterado entre páginas de um documento sem efeitos colaterais.	Opcional. Se não for especificado, o valor padrão será TRUE. O Unidrv usa esse valor para otimizar a velocidade de impressão. Para obter mais informações, consulte o texto que segue esta tabela.
CyanInMagentaDye	Valor numérico, de 0 a 1000, indicando o percentual de contaminação por ciano no corante magenta. O valor é o percentual de contaminação vezes 100. Por exemplo, 8,4% de contaminação é especificada como 840 e 10% é 1000.	Opcional. Se não for especificado, um valor padrão fornecido por Unidrv será usado.
CyanInYellowDye	Valor numérico, de 0 a 1000, indicando a porcentagem de contaminação por ciano no corante amarelo. O valor é o percentual de contaminação vezes 100. Por exemplo, 8,4% de contaminação é especificada como 840 e 10% é 1000.	Opcional. Se não for especificado, um valor padrão fornecido por Unidrv será usado.
EnableGDIColorMapping	TRUE ou FALSE. Indica se a GDI deve executar o mapeamento de gama da exibição para o espaço de cores da impressora.	Opcional. Se não for especificado, o valor padrão será FALSE. Se TRUE, Unidrv definirá o sinalizador HT_FLAG_DO_DEVCLR_XFORM na estrutura GDIINFO .
MagentaInCyanDye	Valor numérico, de 0 a 1000, indicando o percentual de contaminação magenta no corante ciano. O valor é o percentual de contaminação vezes 100. Por exemplo, 8,4% de contaminação é especificada como 840 e 10% é 1000.	Opcional. Se não for especificado, um valor padrão fornecido por Unidrv será usado.
MagentaInYellowDye	Valor numérico, de 0 a 1000, indicando o percentual de contaminação magenta no corante amarelo. O valor é o percentual de contaminação vezes 100. Por exemplo, 8,4% de contaminação é especificada como 840 e 10% é 1000.	Opcional. Se não for especificado, um valor padrão fornecido por Unidrv será usado.
YellowInCyanDye	Valor numérico, de 0 a 1000, indicando o percentual de contaminação amarela no corante ciano. O valor é o percentual de contaminação vezes 100. Por exemplo, 8,4% de contaminação é especificada como 840 e 10% é 1000.	Opcional. Se não for especificado, um valor padrão fornecido por Unidrv será usado.
YellowInMagentaDye	Valor numérico, de 0 a 1000, indicando o percentual de contaminação amarela no corante magenta. O valor é o percentual de contaminação vezes 100. Por exemplo, 8,4% de contaminação é especificada como 840 e 10% é 1000.	Opcional. Se não for especificado, um valor padrão fornecido por Unidrv será usado.

Quando o atributo de cor *ChangeColorModeOnDoc? é definido como TRUE, a otimização de cores é habilitada. Quando esse atributo é definido como FALSE, nenhuma otimização é executada. Quando a otimização de cores está habilitada, a cor no arquivo de spool faz com que o arquivo de spool seja reproduzido em cores. A falta de cor no arquivo de spool faz com que o arquivo de spool seja reproduzido em monocromático.

Se você estiver criando um plug-in de renderização Unidrv para gerar marcas d'água coloridas, a otimização de cores fará com que as marcas d'água coloridas sejam impressas em preto e branco quando são impressas em documentos em preto e branco. Para garantir que as marcas d'água coloridas imprimam corretamente com documentos de cor e preto e branco, desabilite a otimização de cores.

A otimização de cor controlada pelo atributo de cor *ChangeColorModeOnDoc? também pode ser controlada definindo o membro dwColorOptimization das estruturas de ATTRIBUTE_INFO_2 ou ATTRIBUTE_INFO_3 . A otimização de cores também pode ser controlada usando a função GdiEndPageEMF .

Para obter exemplos dos atributos de cor listados nesta página, consulte os arquivos GPD de exemplo.