Variáveis padrão
Importante
A plataforma de impressão moderna é o meio preferencial 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.
A linguagem GPD define um conjunto de variáveis padrão que podem ser referenciadas em cadeias de caracteres de comando, usando o formato de cadeia de caracteres de comando. O driver Unidrv atribui valores a essas variáveis. Do ponto de vista de um arquivo GPD, as variáveis são somente leitura.
Todas as variáveis padrão são armazenadas como inteiros DWORD.
A seguinte entrada de comando da impressora especifica a string de comando que é enviada para uma HP LaserJet 4P quando um bloco de dados raster está pronto:
*Command: CmdSendBlockData: "<1B>*b" %d{NumOfDataBytes} "W"
A tabela a seguir contém todas as variáveis padrão, em ordem alfabética.
| Nome da variável padrão | Valor | Comentários |
|---|---|---|
| BlueValue | Componente azul da cor atual. | Válido para uso em cadeias de caracteres de comando CmdDefinePaletteEntry (consulte GreenValue, RedValue). |
| CurrentFontID | Número de identificação da fonte virtual baixada no momento. | Válido se o trabalho de impressão atual incluir fontes flexíveis baixadas. |
| CurrentPaletteIndex | Índice atual na paleta de cores. | Válido para uso em cadeias de caracteres de comando CmdSelectPaletteEntry (consulte GreenValue, RedValue). |
| CursorOriginX | Coordenada X da origem do cursor, em unidades mestre. | Válido sempre que um trabalho de impressão estiver em andamento. |
| CursorOriginY | Coordenada Y da origem do cursor, em unidades mestre. | Válido sempre que um trabalho de impressão estiver em andamento. |
| DestX | Coordenada X do destino do cursor, em unidades mestre, em relação à origem do cursor. | Válido para uso em cadeias de caracteres de comando CmdXMoveAbsolute. |
| DestXRel | Coordenada X do destino do cursor, em unidades mestre, em relação à posição atual do cursor. | Válido para uso em cadeias de caracteres de comando CmdXMoveRelLeft e CmdXMoveRelRight. |
| DestY | Coordenada Y do destino do cursor, em unidades mestre, em relação à origem do cursor. | Válido para uso em cadeias de caracteres de comando CmdYMoveAbsolute. |
| DestYRel | Coordenada Y do destino do cursor, em unidades mestre, em relação à posição atual do cursor. | Válido para uso em cadeias de caracteres de comando CmdYMoveRelUp e CmdYMoveRelDown. |
| FontBold | Defina como um se a fonte atual estiver em negrito ou zero caso contrário. | Válido quando uma fonte foi especificada. |
| FontHeight | Altura, em unidades mestras, da fonte atual. | Válido quando uma fonte foi especificada. |
| FontItalic | Defina como um se a fonte atual estiver em itálico ou zero caso contrário. | Válido quando uma fonte foi especificada. |
| FontMaxWidth | Defina como o incremento máximo de caracteres de todos os glifos na fonte. | Válido quando uma fonte foi especificada. |
| FontStrikeThru | Defina como um se o tachado estiver habilitado para a fonte atual ou zero caso contrário. | Válido quando uma fonte foi especificada. |
| FontUnderLine | Defina como um se a fonte atual estiver sublinhado, ou zero caso contrário. | Válido quando uma fonte foi especificada. |
| FontWidth | Largura, em unidades mestras, da fonte atual. | Válido quando uma fonte foi especificada. |
| GráficosXRes | Resolução horizontal atual para gráficos, em DPI. | Válido sempre que um trabalho de impressão estiver em andamento. |
| GráficosYRes | Resolução vertical atual para gráficos, em DPI. | Válido sempre que um trabalho de impressão estiver em andamento. |
| GrayPercentage | Nível de cinza (porcentagem) a ser usado para preenchimento de cinza. | Válido para uso em cadeias de caracteres de comando CmdRectGrayFill. |
| GreenValue | Componente verde da cor atual. | Válido para uso em cadeias de caracteres de comando CmdDefinePaletteEntry (consulte BlueValue, RedValue). |
| LinefeedSpacing | Quantidade de espaço vertical, em unidades mestras, representando um avanço de linha. | Válido para uso em cadeias de caracteres de comando CmdSetLineSpacing. |
| NextFontID | Número de identificação da próxima fonte flexível a ser baixada. | Válido para uso em cadeias de caracteres de comando CmdSetFontID. |
| NextGlyph | O código de dois bytes do próximo glifo a ser baixado. | Válido para uso em cadeias de caracteres de comando CmdSetCharCode. |
| NumOfCopies | Número de cópias solicitadas pelo usuário. | Válido sempre que um trabalho de impressão estiver em andamento. |
| NumOfDataBytes | Número de bytes de dados raster prontos para transferência. | Válido para uso em qualquer cadeia de caracteres de comando CmdSendXXXData. Se os dados forem compactados, o valor será o número de bytes após a compactação. |
| PageNumber | O número da página que está sendo impressa no momento. Observe que isso não corresponde necessariamente ao número da página do aplicativo, mas sim ao número de vezes que DrvSendPage foi chamado. Esse valor é inicializado por DrvStartDoc e incrementado por DrvSendPage. Por exemplo, se N-up = 4 for selecionado, PageNumber será incrementado para 2 somente quando a quinta página do documento estiver sendo impressa. Como outro exemplo, se um documento for impresso na ordem inversa (de trás para frente), a variável padrão PageNumber ainda relatará a primeira página a ser impressa como página 1, mesmo que esta seja a última página do documento. Esse comportamento é necessário para dar suporte adequado ao recurso de duplexação automática. O OEM deve usar PageNumber apenas para determinar se a página atual é a frente ou o verso. | Válido sempre que um trabalho de impressão estiver em andamento. |
| PaletteIndexToProgram | Indexe na paleta de cores para a próxima entrada a ser programada. | Válido para uso em cadeias de caracteres de comando CmdDefinePaletteEntry. (Veja também RedValue, GreenValue, BlueValue, CurrentPaletteIndex). |
| PatternBrushID | Número de identificação de um pincel de padrão baixado. | Válido para uso com cadeias de caracteres de comando CmdDownloadPattern e CmdSelectPattern. |
| PatternBrushSize | Tamanho, em bytes, do pincel de padrão atual. | Válido para uso com a cadeia de caracteres de comando CmdDownloadPattern. |
| PatternBrushType | Tipo do pincel de padrão atual. O valor pode ser: 2: Padrão de sombreamento 3: Padrão de hachura cruzada 4: Padrão definido pelo usuário. | Válido para uso com cadeias de caracteres de comando CmdDownloadPattern e CmdSelectPattern. |
| PhysPaperLength | Comprimento do modo retrato, em unidades y-master, do papel atualmente em uso. | Válido sempre que um trabalho de impressão estiver em andamento. |
| PhysPaperWidth | Largura do modo retrato, em unidades y-master, do papel atualmente em uso. | Válido sempre que um trabalho de impressão estiver em andamento. |
| PrintDirInCCDegrees | Quantidade de rotação, medida no sentido anti-horário, em graus. | Válido quando o driver envia a cadeia de caracteres de comando CmdSetSimpleRotation ou CmdSetAnyRotation . |
| RasterDataHeightInPixels | Altura, em pixels, da imagem representada pelos dados atuais. | Válido para uso em qualquer cadeia de caracteres de comando CmdSendXXXData e em cadeias de caracteres de comando CmdSetSrcBmpHeight. A compactação não modifica esse valor. |
| RasterDataWidthInBytes | Número de bytes contidos em uma linha de varredura. | Válido para uso em qualquer cadeia de caracteres de comando CmdSendXXXData e em cadeias de caracteres de comando CmdSetSrcBmpWidth. A compactação não modifica esse valor. |
| RectXSize | Largura do retângulo, em unidades x-master. | Válido para uso em cadeias de caracteres de comando CmdSetRectWidth. |
| RectYSize | Comprimento do retângulo, em unidades y-master. | Válido para uso em cadeias de caracteres de comando CmdSetRectHeight. |
| RedValue | Componente vermelho da cor atual. | Válido para uso em cadeias de caracteres de comando CmdDefinePaletteEntry (consulte GreenValue, BlueValue). |
| TextXRes | Resolução horizontal atual para texto, em DPI. | Válido sempre que um trabalho de impressão estiver em andamento. |
| TextYRes | Resolução vertical atual para texto, em DPI. | Válido sempre que um trabalho de impressão estiver em andamento. |