Standard-Variablen
Wichtig
Die Modern Print-Plattform ist die von Windows bevorzugte Methode zur Kommunikation mit Druckern. Wir empfehlen die Verwendung des Microsoft IPP-Treibers für die Posteingangsklasse zusammen mit Print Support Apps (PSA), um das Druckverhalten in Windows 10 und 11 für die Entwicklung von Druckergeräten anzupassen.
Weitere Informationen finden Sie unter Modern Print-Plattform und der Anleitung zum Design der Print-Support-App.
Die GPD-Sprache definiert einen Satz von Standardvariablen, auf die mithilfe des Befehlszeichenfolgenformats in Befehlszeichenfolgen verwiesen werden kann. Der Unidrv-Treiber weist diesen Variablen Werte zu. Aus Sicht einer GPD-Datei sind die Variablen schreibgeschützt.
Alle Standardvariablen werden als DWORD-Ganzzahlen gespeichert.
Der folgende Druckerbefehlseintrag gibt die Befehlszeichenfolge an, die an einen HP LaserJet 4P gesendet wird, wenn ein Block von Rasterdaten bereit ist:
*Command: CmdSendBlockData: "<1B>*b" %d{NumOfDataBytes} "W"
Die folgende Tabelle enthält alle Standardvariablen in alphabetischer Reihenfolge.
Standardvariablenname | Wert | Kommentare |
---|---|---|
BlueValue | Blauanteil der aktuellen Farbe. | Gültig für die Verwendung in CmdDefinePaletteEntry-Befehlszeichenfolgen (siehe GreenValue, RedValue). |
CurrentFontID | Identifikationsnummer der aktuellen heruntergeladenen Softschriftart. | Gültig, wenn der aktuelle Druckauftrag heruntergeladene Schriftarten enthält. |
CurrentPaletteIndex | Aktueller Index in der Farbpalette. | Gültig für die Verwendung in CmdSelectPaletteEntry-Befehlszeichenfolgen (siehe GreenValue, RedValue). |
CursorOriginX | X-Koordinate des Cursorursprungs in Mastereinheiten. | Gültig, wenn ein Druckauftrag ausgeführt wird. |
CursorOriginY | Y-Koordinate des Cursorursprungs in Mastereinheiten. | Gültig, wenn ein Druckauftrag ausgeführt wird. |
DestX | X-Koordinate des Cursorziels in Mastereinheiten relativ zum Cursorursprung. | Gültig für die Verwendung in CmdXMoveAbsolute-Befehlszeichenfolgen. |
DestXRel | X-Koordinate des Cursorziels in Mastereinheiten relativ zur aktuellen Cursorposition. | Gültig für die Verwendung in CmdXMoveRelLeft- und CmdXMoveRelRight-Befehlszeichenfolgen. |
DestY | Y-Koordinate des Cursorziels in Mastereinheiten relativ zum Cursorursprung. | Gültig für die Verwendung in CmdYMoveAbsolute-Befehlszeichenfolgen. |
DestYRel | Y-Koordinate des Cursorziels in Mastereinheiten relativ zur aktuellen Cursorposition. | Gültig für die Verwendung in CmdYMoveRelUp und CmdYMoveRelDown-Befehlszeichenfolgen. |
SchriftFett | Legen Sie diese Option auf eine fest, wenn die aktuelle Schriftart fett oder null ist. | Gültig, wenn eine Schriftart angegeben wurde. |
FontHeight | Höhe in Mastereinheiten der aktuellen Schriftart. | Gültig, wenn eine Schriftart angegeben wurde. |
FontItalic | Legen Sie diese Option auf eine fest, wenn die aktuelle Schriftart kursiv oder null ist. | Gültig, wenn eine Schriftart angegeben wurde. |
FontMaxWidth | Legen Sie den Wert auf die maximale Zeicheninkrementierung aller Glyphen in der Schriftart fest. | Gültig, wenn eine Schriftart angegeben wurde. |
FontStrikeThru | Legen Sie diese Option auf eine Fest, wenn "Durchgestrichen" für die aktuelle Schriftart oder andernfalls "Null" aktiviert ist. | Gültig, wenn eine Schriftart angegeben wurde. |
FontUnderLine | Legen Sie diese Option auf eine fest, wenn die aktuelle Schriftart unterstrichen oder null ist. | Gültig, wenn eine Schriftart angegeben wurde. |
FontWidth | Breite in Mastereinheiten der aktuellen Schriftart. | Gültig, wenn eine Schriftart angegeben wurde. |
GraphicsXRes | Aktuelle horizontale Auflösung für Grafiken in DPI. | Gültig, wenn ein Druckauftrag ausgeführt wird. |
GraphicsYRes | Aktuelle vertikale Auflösung für Grafiken in DPI. | Gültig, wenn ein Druckauftrag ausgeführt wird. |
GrayPercentage | Graustufe (Prozentsatz), der für graue Füllung verwendet werden soll. | Gültig für die Verwendung in CmdRectGrayFill-Befehlszeichenfolgen. |
GreenValue | Grünanteil der aktuellen Farbe. | Gültig für die Verwendung in CmdDefinePaletteEntry-Befehlszeichenfolgen (siehe BlueValue, RedValue). |
LinefeedSpacing | Der vertikale Abstand in Mastereinheiten, der einen Zeilenfeed darstellt. | Gültig für die Verwendung in CmdSetLineSpacing-Befehlszeichenfolgen. |
NextFontID | Identifikationsnummer der nächsten soften Schriftart, die heruntergeladen werden soll. | Gültig für die Verwendung in CmdSetFontID-Befehlszeichenfolgen. |
NextGlyph | Der Zwei-Byte-Code der nächsten Glyphe, die heruntergeladen werden soll. | Gültig für die Verwendung in CmdSetCharCode-Befehlszeichenfolgen. |
NumOfCopies | Anzahl der vom Benutzer angeforderten Kopien. | Gültig, wenn ein Druckauftrag ausgeführt wird. |
NumOfDataBytes | Anzahl der Bytes von Rasterdaten, die für die Übertragung bereit sind. | Gültig für die Verwendung in einer beliebigen CmdSendXXXData-Befehlszeichenfolge. Wenn Daten komprimiert werden, ist der Wert die Anzahl der Bytes nach der Komprimierung. |
PageNumber | Die Anzahl der aktuell gedruckten Seite. Beachten Sie, dass dies nicht unbedingt der Seitenzahl der Anwendung entspricht, sondern die Anzahl der Aufrufe von DrvSendPage. Dieser Wert wird von DrvStartDoc initialisiert und von DrvSendPage erhöht. Wenn z. B. N-up = 4 ausgewählt ist, wird PageNumber nur dann auf 2 erhöht, wenn die fünfte Seite des Dokuments gedruckt wird. Ein weiteres Beispiel: Wenn ein Dokument in umgekehrter Reihenfolge (zurück nach vorne) gedruckt wird, meldet die Standardvariable PageNumber weiterhin, dass die erste Seite als Seite 1 gedruckt wird, obwohl dies die letzte Seite des Dokuments ist. Dieses Verhalten ist erforderlich, um das Feature für die automatische Duplexfunktion ordnungsgemäß zu unterstützen. Der OEM sollte PageNumber nur verwenden, um zu bestimmen, ob die aktuelle Seite die Vorder- oder Rückseite ist. | Gültig, wenn ein Druckauftrag ausgeführt wird. |
PaletteIndexToProgram | Index in der Farbpalette für den nächsten Programmeintrag. | Gültig für die Verwendung in CmdDefinePaletteEntry-Befehlszeichenfolgen. (Siehe auch RedValue, GreenValue, BlueValue, CurrentPaletteIndex). |
PatternBrushID | Identifikationsnummer eines heruntergeladenen Musterpinsels. | Gültig für die Verwendung mit CmdDownloadPattern- und CmdSelectPattern-Befehlszeichenfolgen. |
PatternBrushSize | Größe des aktuellen Musterpinsels in Bytes. | Gültig für die Verwendung mit cmdDownloadPattern-Befehlszeichenfolge. |
PatternBrushType | Typ des aktuellen Musterpinsels. Wert kann sein: 2: Schattierungsmuster 3: Schraffurmuster 4: Benutzerdefiniertes Muster. | Gültig für die Verwendung mit CmdDownloadPattern- und CmdSelectPattern-Befehlszeichenfolgen. |
PhysPaperLength | Die Länge des Hochformats in Y-Master-Einheiten des aktuell verwendeten Papiers. | Gültig, wenn ein Druckauftrag ausgeführt wird. |
PhysPaperWidth | Breite des aktuell verwendeten Papiers im Hochformat in Mastereinheiten. | Gültig, wenn ein Druckauftrag ausgeführt wird. |
PrintDirInCCDegrees | Drehungsmenge, gemessen gegen den Uhrzeigersinn, in Grad. | Gültig, wenn der Treiber entweder die Befehlszeichenfolge "CmdSetSimpleRotation" oder "CmdSetAnyRotation" sendet. |
RasterDataHeightInPixels | Höhe des Bilds, das durch aktuelle Daten dargestellt wird, in Pixeln. | Gültig für die Verwendung in einer beliebigen CmdSendXXXData-Befehlszeichenfolge und in CmdSetSrcBmpHeight-Befehlszeichenfolgen. Die Komprimierung ändert diesen Wert nicht. |
RasterDataWidthInBytes | Die Anzahl der in einer Scanzeile enthaltenen Bytes. | Gültig für die Verwendung in einer beliebigen CmdSendXXXData-Befehlszeichenfolge und in CmdSetSrcBmpWidth-Befehlszeichenfolgen. Die Komprimierung ändert diesen Wert nicht. |
RectXSize | Rechteckbreite in x-Master-Einheiten. | Gültig für die Verwendung in CmdSetRectWidth-Befehlszeichenfolgen. |
RectYSize | Rechtecklänge in Y-Master-Einheiten. | Gültig für die Verwendung in CmdSetRectHeight-Befehlszeichenfolgen. |
RedValue | Rotanteil der aktuellen Farbe. | Gültig für die Verwendung in CmdDefinePaletteEntry-Befehlszeichenfolgen (siehe GreenValue, BlueValue). |
TextXRes | Aktuelle horizontale Auflösung für Text in DPI. | Gültig, wenn ein Druckauftrag ausgeführt wird. |
TextYRes | Aktuelle vertikale Auflösung für Text in DPI. | Gültig, wenn ein Druckauftrag ausgeführt wird. |