Variables standard

Important

Nous vous recommandons d’utiliser le pilote de classe de boîte de réception IPP de Microsoft, ainsi que les applications de support d’impression (PSA), pour personnaliser l’expérience d’impression dans Windows 10 et 11 pour le développement de périphériques d’imprimante.

Pour plus d’informations, consultez le Guide de conception de l’application de support d’impression.

Le langage GPD définit un ensemble de variables standard qui peuvent être référencées dans des chaînes de commande, à l’aide du format de chaîne de commande. Le pilote Unidrv affecte des valeurs à ces variables. Du point de vue d’un fichier GPD, les variables sont en lecture seule.

Toutes les variables standard sont stockées sous forme d’entiers DWORD.

L’entrée de commande d’imprimante suivante spécifie la chaîne de commande qui est envoyée à un HP LaserJet 4P lorsqu’un bloc de données raster est prêt :

*Command: CmdSendBlockData: "<1B>*b" %d{NumOfDataBytes} "W"

Le tableau suivant contient toutes les variables standard, dans l’ordre alphabétique.

Nom de la variable standard	Valeur	Commentaires
BlueValue	Composant bleu de la couleur actuelle.	Valide pour une utilisation dans les chaînes de commande CmdDefinePaletteEntry (voir GreenValue, RedValue).
CurrentFontID	Numéro d’identification de la police logicielle actuellement téléchargée.	Valide si le travail d’impression actuel inclut des polices réversibles téléchargées.
CurrentPaletteIndex	Index actuel dans la palette de couleurs.	Valide pour une utilisation dans les chaînes de commande CmdSelectPaletteEntry (voir GreenValue, RedValue).
CursorOriginX	Coordonnée X de l’origine du curseur, en unités master.	Valide chaque fois qu’un travail d’impression est en cours.
CursorOriginY	Coordonnée Y de l’origine du curseur, en unités master.	Valide chaque fois qu’un travail d’impression est en cours.
DestX	Coordonnée X de la destination du curseur, en unités master, par rapport à l’origine du curseur.	Valide pour une utilisation dans les chaînes de commande CmdXMoveAbsolute.
DestXRel	Coordonnée X de la destination du curseur, en unités master, par rapport à la position actuelle du curseur.	Valide pour une utilisation dans les chaînes de commande CmdXMoveRelLeft et CmdXMoveRelRight.
DestY	Coordonnée Y de la destination du curseur, en unités master, par rapport à l’origine du curseur.	Valide pour une utilisation dans les chaînes de commande CmdYMoveAbsolute.
DestYRel	Coordonnée Y de la destination du curseur, en unités master, par rapport à la position actuelle du curseur.	Valide pour une utilisation dans les chaînes de commande CmdYMoveRelUp et CmdYMoveRelDown.
FontBold	Définissez sur un si la police actuelle est en gras, ou zéro dans le cas contraire.	Valide lorsqu’une police a été spécifiée.
FontHeight	Hauteur, en unités master, de la police actuelle.	Valide lorsqu’une police a été spécifiée.
Italique	Définissez sur un si la police actuelle est en italique, ou zéro dans le cas contraire.	Valide lorsqu’une police a été spécifiée.
FontMaxWidth	Définissez sur l’incrément de caractères maximal de tous les glyphes de la police.	Valide lorsqu’une police a été spécifiée.
FontStrikeThru	Définissez la valeur 1 si le code barré est activé pour la police actuelle, ou zéro dans le cas contraire.	Valide lorsqu’une police a été spécifiée.
FontUnderLine	Définissez sur un si la police actuelle est soulignée, ou zéro dans le cas contraire.	Valide lorsqu’une police a été spécifiée.
FontWidth	Largeur, en unités master, de la police actuelle.	Valide lorsqu’une police a été spécifiée.
GraphicsXRes	Résolution horizontale actuelle pour les graphiques, en PPP.	Valide chaque fois qu’un travail d’impression est en cours.
GraphicsYRes	Résolution verticale actuelle pour les graphiques, en PPP.	Valide chaque fois qu’un travail d’impression est en cours.
GrayPercentage	Niveau de gris (pourcentage) à utiliser pour le remplissage gris.	Valide pour une utilisation dans les chaînes de commande CmdRectGrayFill.
GreenValue	Composant vert de la couleur actuelle.	Valide pour une utilisation dans les chaînes de commande CmdDefinePaletteEntry (voir BlueValue, RedValue).
LinefeedSpacing	Quantité d’espace vertical, en unités master, représentant un flux de lignes.	Valide pour une utilisation dans les chaînes de commande CmdSetLineSpacing.
NextFontID	Numéro d’identification de la police réversible suivante à télécharger.	Valide pour une utilisation dans les chaînes de commande CmdSetFontID.
NextGlyphe	Code de deux octets du glyphe suivant à télécharger.	Valide pour une utilisation dans les chaînes de commande CmdSetCharCode.
NumOfCopies	Nombre de copies demandées par l’utilisateur.	Valide chaque fois qu’un travail d’impression est en cours.
NumOfDataBytes	Nombre d’octets de données raster prêtes à être transférées.	Valide pour une utilisation dans toute chaîne de commande CmdSendXXXData. Si les données sont compressées, la valeur est le nombre d’octets après la compression.
PageNumber	Numéro de la page en cours d’impression. Notez que cela ne correspond pas nécessairement au numéro de page de l’application, mais plutôt au nombre de fois que DrvSendPage a été appelé. Cette valeur est initialisée par DrvStartDoc et incrémentée par DrvSendPage. Par exemple, si N-up = 4 est sélectionné, PageNumber est incrémenté à 2 uniquement lorsque la cinquième page du document est imprimée. Autre exemple, si un document est imprimé dans l’ordre inverse (retour au début), la variable standard PageNumber signale toujours la première page à imprimer en tant que page 1, même s’il s’agit de la dernière page du document. Ce comportement est nécessaire pour prendre correctement en charge la fonctionnalité de duplexage automatique. L’OEM doit utiliser PageNumber uniquement pour déterminer si la page active est le côté avant ou arrière.	Valide chaque fois qu’un travail d’impression est en cours.
PaletteIndexToProgram	Indexez dans la palette de couleurs de l’entrée suivante à programmer.	Valide pour une utilisation dans les chaînes de commande CmdDefinePaletteEntry. (Voir également RedValue, GreenValue, BlueValue, CurrentPaletteIndex).
PatternBrushID	Numéro d’identification d’un pinceau de modèle téléchargé.	Valide pour une utilisation avec les chaînes de commande CmdDownloadPattern et CmdSelectPattern.
PatternBrushSize	Taille, en octets, du pinceau de modèle actuel.	Valide pour une utilisation avec la chaîne de commande CmdDownloadPattern.
PatternBrushType	Type du pinceau de modèle actuel. La valeur peut être : 2 : modèle de trame de fond 3 : modèle de hachure croisée 4 : modèle défini par l’utilisateur.	Valide pour une utilisation avec les chaînes de commande CmdDownloadPattern et CmdSelectPattern.
PhysPaperLength	Longueur en mode portrait, en unités y master, du papier actuellement utilisé.	Valide chaque fois qu’un travail d’impression est en cours.
PhysPaperWidth	Largeur en mode portrait, en master unités, du papier actuellement utilisé.	Valide chaque fois qu’un travail d’impression est en cours.
PrintDirInCCDegrees	Quantité de rotation, mesurée dans le sens inverse des aiguilles d’une montre, en degrés.	Valide lorsque le pilote envoie la chaîne de commande CmdSetSimpleRotation ou CmdSetAnyRotation.
RasterDataHeightInPixels	Hauteur, en pixels, de l’image représentée par les données actuelles.	Valide pour une utilisation dans n’importe quelle chaîne de commande CmdSendXXXData et dans les chaînes de commande CmdSetSrcBmpHeight. La compression ne modifie pas cette valeur.
RasterDataWidthInBytes	Nombre d’octets contenus dans une ligne d’analyse.	Valide pour une utilisation dans n’importe quelle chaîne de commande CmdSendXXXData et dans les chaînes de commande CmdSetSrcBmpWidth. La compression ne modifie pas cette valeur.
RectXSize	Largeur du rectangle, en unités x-master.	Valide pour une utilisation dans les chaînes de commande CmdSetRectWidth.
RectYSize	Longueur du rectangle, en unités y master.	Valide pour une utilisation dans les chaînes de commande CmdSetRectHeight.
RedValue	Composant rouge de la couleur actuelle.	Valide pour une utilisation dans les chaînes de commande CmdDefinePaletteEntry (voir GreenValue, BlueValue).
TextXRes	Résolution horizontale actuelle pour le texte, en PPP.	Valide chaque fois qu’un travail d’impression est en cours.
TextYRes	Résolution verticale actuelle pour le texte, en PPP.	Valide chaque fois qu’un travail d’impression est en cours.