Standard-Variablen

  • Artikel

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.