Comandos de cores
Importante
A plataforma de impressão moderna é o meio preferido do Windows para se comunicar com as impressoras. Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft juntamente com PSA (Aplicativos de Suporte à Impressão) para personalizar a experiência de impressão no Windows 10 e 11 para o desenvolvimento de dispositivos de impressora.
Para obter mais informações, consulte Plataformade impressão moderna e o Guia de design do aplicativo de suporte de impressão.
Este tópico descreve os comandos de cores para impressão e contém as seguintes seções:
Comandos para selecionar cores primárias de fundo
Comandos para controlar paletas de impressora
Comandos para selecionar pincéis de padrão
Todos os comandos são especificados usando o formato de entrada de comando.
Comandos para selecionar cores primárias de fundo
Os comandos de impressora na tabela a seguir são usados por impressoras que não oferecem suporte a paletas de cores programáveis, como impressoras de cores planas (por exemplo, impressoras matriciais) e algumas impressoras de paleta (por exemplo, impressoras a jato de tinta antigas).
| Comando | Descrição | Comentários |
|---|---|---|
| CmdSelectBlackColor | Comando para selecionar a cor de fundo preta. | Opcional |
| CmdSelectBlueColor | Comando para selecionar a cor de fundo azul. | Opcional |
| CmdSelectCyanColor | Comando para selecionar a cor de fundo ciano. | Opcional |
| CmdSelectGreenColor | Comando para selecionar a cor de fundo verde. | Opcional |
| CmdSelectMagentaColor | Comando para selecionar a cor de fundo magenta. | Opcional |
| CmdSelectRedColor | Comando para selecionar a cor de fundo vermelha. | Opcional |
| CmdSelectYellowColor | Comando para selecionar a cor de fundo amarela. | Opcional |
| CmdSelectWhiteColor | Comando para selecionar a cor de fundo branca. | Opcional |
Comandos para controlar paletas de impressora
Os comandos de impressora na tabela a seguir são usados por impressoras que suportam paletas programáveis para impressão em primeiro plano (texto e vetor) e para impressão raster.
| Comando | Descrição | Comentários |
|---|---|---|
| CmdBeginPaletteDef | Comando para inicializar uma definição de paleta de cores. | Opcional. Se não for especificado, nenhuma inicialização de definições de paleta será necessária. |
| CmdEndPaletteDef | Comando para finalizar uma definição de paleta. | Opcional. Se não for especificado, nenhum comando será necessário para finalizar uma definição de paleta. O atributo Order pode ser especificado. Se não estiver, o atributo Order associado com o comando de seleção de opção executado mais recentemente para o recurso ColorMode será usado. |
| CmdBeginPaletteReDef | Comando para inicializar uma redefinição de paleta de cores. | Opcional. Se não for especificado, nenhuma inicialização de redefinições de paleta será necessária. |
| CmdEndPaletteReDef | Comando para finalizar uma redefinição de paleta. | Opcional. Se não for especificado, nenhum comando será necessário para finalizar uma redefinição de paleta. |
| CmdDefinePaletteEntry | Comando para definir uma entrada de paleta. | Obrigatório se a impressora suportar paletas. No modo 24 BPP, o Unidrv permite paletas para as quais PaletteSize é 1. Isso permite que os desenvolvedores de GPD implementem um comando de seleção de cores RGB direto para seus dispositivos. Para fazer isso, defina PaletteSize como 1 e especifique o comando selection color no comando CmdDefinePaletteEntry. O comando CmdSelectPaletteEntry também deve ser especificado, mas pode ser definido como um comando NULL. |
| CmdRedefinePaletteEntry | Comando para redefinir uma entrada de paleta. | Opcional. Se não for especificado, CmdDefinePaletteEntry será usado para redefinir as entradas da paleta. |
| CmdSelectPaletteEntry | Comando para selecionar uma entrada de paleta como a cor atual. | Obrigatório se a impressora suportar paletas. |
Comandos para selecionar pincéis de padrão
Os comandos de impressora na tabela a seguir são usados por impressoras que oferecem suporte ao download e à seleção de pincéis de padrão.
| Comando | Descrição | Comentários |
|---|---|---|
| CmdDownloadPattern | Comando para fornecer um padrão de pincel para a impressora. | Opcional. Se especificado, CmdSelectPattern também deve ser especificado. |
| CmdSelectBlackBrush | Comando para um pincel preto sólido como o pincel atual. | Necessário se a impressora suportar pincéis. |
| CmdSelectPattern | Comando para selecionar um padrão de pincel baixado. | Opcional. Se especificado, CmdDownloadPattern também deve ser especificado. |
| CmdSelectWhiteBrush | Comando para selecionar um pincel branco sólido como o pincel atual. | Opcional |