Standaardvariabelen
Belangrijk
Het moderne afdrukplatform is de voorkeursmiddel van Windows om te communiceren met printers. U wordt aangeraden om de Microsoft IPP inbox klasse driver te gebruiken, samen met PSA (Print Support Apps), om de afdrukervaring in Windows 10 en 11 aan te passen voor de ontwikkeling van printerapparaten.
Zie Modern printplatform en de Print-ontwerphandleiding voor appsvoor meer informatie.
De GPD-taal definieert een set standaardvariabelen waarnaar kan worden verwezen binnen opdrachtreeksen, met behulp van de opdrachtreeksindeling. Het Unidrv-stuurprogramma wijst waarden toe aan deze variabelen. Vanuit het oogpunt van een GPD-bestand zijn de variabelen alleen-lezen.
Alle standaardvariabelen worden opgeslagen als DWORD-gehele getallen.
De volgende printeropdracht vermelding geeft de opdrachttekenreeks die wordt verzonden naar een HP LaserJet 4P wanneer een blok rastergegevens gereed is:
*Command: CmdSendBlockData: "<1B>*b" %d{NumOfDataBytes} "W"
De volgende tabel bevat alle standaardvariabelen, in alfabetische volgorde.
| Naam van standaardvariabele | Waarde | Opmerkingen |
|---|---|---|
| BlueValue | Blauw onderdeel van de huidige kleur. | Geldig voor gebruik in opdrachtreeksen CmdDefinePaletteEntry (zie GreenValue, RedValue). |
| CurrentFontID | Identificatienummer van het huidige gedownloade zachte lettertype. | Geldig als de huidige afdruktaak gedownloade zachte lettertypen bevat. |
| CurrentPaletteIndex | Huidige index in het kleurenpalet. | Geldig voor gebruik in commando-strings CmdSelectPaletteEntry (zie ook GreenValue, RedValue). |
| CursorOriginX | X-coördinaat van cursoroorsprong, in hoofdeenheden. | Geldig wanneer een afdruktaak wordt uitgevoerd. |
| CursorOriginY | Y-coördinaat van de oorsprong van de cursor, in hoofdeenheden. | Geldig wanneer een afdruktaak wordt uitgevoerd. |
| DestX- | X-coördinaat van cursorbestemming in hoofdeenheden ten opzichte van de oorsprong van de cursor. | Geldig voor gebruik in cmdXMoveAbsolute-opdrachtreeksen. |
| DestXRel- | X-coördinaat van cursorbestemming in hoofdeenheden ten opzichte van de huidige cursorpositie. | Geldig voor gebruik in CmdXMoveRelLeft- en CmdXMoveRelRight-opdrachtreeksen. |
| DestY | Y-coördinaat van cursorbestemming in hoofdeenheden ten opzichte van de oorsprong van de cursor. | Geldig voor gebruik in cmdYMoveAbsolute-opdrachtreeksen. |
| DestYRel- | Y-coördinaat van cursorbestemming, in hoofdeenheden, ten opzichte van de huidige cursorpositie. | Geldig voor gebruik in CmdYMoveRelUp en CmdYMoveRelDown-opdrachtreeksen. |
| FontBold | Ingesteld op één als het huidige lettertype vet is of anders nul. | Geldig wanneer een lettertype is opgegeven. |
| FontHeight | Hoogte, in hoofdeenheden, van het huidige lettertype. | Geldig wanneer een lettertype is opgegeven. |
| FontItalic- | Ingesteld op één als het huidige lettertype cursief is of anders nul is. | Geldig wanneer een lettertype is opgegeven. |
| FontMaxWidth | Ingesteld op de maximale tekenverhoging van alle glyphs in het lettertype. | Geldig wanneer een lettertype is opgegeven. |
| FontStrikeThru | Ingesteld op één als doorhalen is ingeschakeld voor het huidige lettertype, anders nul. | Geldig wanneer een lettertype is opgegeven. |
| FontUnderLine | Ingesteld op één als het huidige lettertype is onderstreept of anders nul. | Geldig wanneer een lettertype is opgegeven. |
| FontWidth | Breedte, in hoofdeenheden, van het huidige lettertype. | Geldig wanneer een lettertype is opgegeven. |
| GraphicsXRes- | Huidige horizontale resolutie voor afbeeldingen, in DPI. | Geldig wanneer een afdruktaak wordt uitgevoerd. |
| GraphicsYRes | Huidige verticale resolutie voor afbeeldingen, in DPI. | Geldig wanneer een afdruktaak wordt uitgevoerd. |
| GrayPercentage | Grijsniveau (percentage) dat moet worden gebruikt voor grijze opvulling. | Geldig voor gebruik in cmdRectGrayFill-opdrachtreeksen. |
| GreenValue | Groen onderdeel van de huidige kleur. | Geldig voor gebruik in CmdDefinePaletteEntry-opdrachtreeksen (zie BlueValue, RedValue). |
| LinefeedSpacing | De hoeveelheid verticale ruimte, in hoofdeenheden, die een lijnfeed vertegenwoordigt. | Geldig voor gebruik in CmdSetLineSpacing-opdrachtreeksen. |
| NextFontID | Identificatienummer van het volgende zachte lettertype dat moet worden gedownload. | Geldig voor gebruik in cmdSetFontID-opdrachtreeksen. |
| NextGlyph | De twee-bytecode van de volgende glyph die u wilt downloaden. | Geldig voor gebruik in cmdSetCharCode-opdrachtreeksen. |
| AantalKopieën | Het aantal exemplaren dat door de gebruiker is aangevraagd. | Geldig wanneer een afdruktaak wordt uitgevoerd. |
| NumOfDataBytes- | Het aantal bytes aan rastergegevens dat gereed is voor overdracht. | Geldig voor gebruik in een CmdSendXXXData-opdrachtreeks. Als gegevens worden gecomprimeerd, is de waarde het aantal bytes na compressie. |
| Paginanummer | Het nummer van de pagina die momenteel wordt afgedrukt. Houd er rekening mee dat dit niet noodzakelijkerwijs overeenkomt met het paginanummer van de toepassing, maar het aantal keren dat DrvSendPage- is aangeroepen. Deze waarde wordt geïnitialiseerd door DrvStartDoc- en wordt verhoogd door DrvSendPage. Als bijvoorbeeld N-up = 4 is geselecteerd, wordt PageNumber alleen verhoogd tot 2 wanneer de vijfde pagina van het document wordt afgedrukt. Als een document bijvoorbeeld in omgekeerde volgorde (terug naar voor) wordt afgedrukt, wordt de PageNumber standaardvariabele nog steeds gerapporteerd dat de eerste pagina wordt afgedrukt als pagina 1, ook al is dit de laatste pagina van het document. Dit gedrag is nodig om de functie voor automatisch dubbelzijdig afdrukken goed te ondersteunen. De OEM moet PageNumber alleen gebruiken om te bepalen of de huidige pagina de voor- of achterkant is. | Geldig wanneer een afdruktaak wordt uitgevoerd. |
| PaletteIndexToProgram | Indexeer in het kleurenpalet voor de volgende vermelding in het programma. | Geldig voor gebruik in cmdDefinePaletteEntry-opdrachtreeksen. (Zie ook RedValue, GreenValue, BlueValue, CurrentPaletteIndex). |
| PatternBrushID | Identificatienummer van een gedownload patroonborstel. | Geldig voor gebruik met CmdDownloadPattern- en CmdSelectPattern-opdrachtreeksen. |
| PatternBrushSize | Grootte, in bytes, van het huidige patroonpenseel. | Geldig voor gebruik met cmdDownloadPattern-opdrachtreeks. |
| PatternBrushType | Type van het huidige patroonborstel. Waarde kan zijn: 2: Arceringspatroon 3: Patroon voor kruislingse arcering 4: Door de gebruiker gedefinieerd patroon. | Geldig voor gebruik met CmdDownloadPattern- en CmdSelectPattern-opdrachtreeksen. |
| FysPapierLengte | Lengte van het papier dat momenteel in gebruik is, in portretmodus, in y-mastereenheden. | Geldig wanneer een afdruktaak wordt uitgevoerd. |
| PhysPaperWidth- | De breedte in staande modus, in hoofdeenheden, van het papier dat op dit moment wordt gebruikt. | Geldig wanneer een afdruktaak wordt uitgevoerd. |
| PrintDirInCCDegrees | De hoeveelheid draaiing, gemeten tegen de klok in, in graden. | Geldig wanneer het stuurprogramma de opdrachtreeks CmdSetSimpleRotation of CmdSetAnyRotation verzendt. |
| RasterDataHeightInPixels | Hoogte, in pixels, van de afbeelding die wordt vertegenwoordigd door de huidige gegevens. | Geldig voor gebruik in een CmdSendXXXData-opdrachtreeks en in cmdSetSrcBmpHeight-opdrachtreeksen. Met compressie wordt deze waarde niet gewijzigd. |
| RastergegevensbreedteInBytes | Het aantal bytes dat is opgenomen in een scanregel. | Geldig voor gebruik in een CmdSendXXXData-opdrachtreeks en in CmdSetSrcBmpWidth-opdrachtreeksen. Met compressie wordt deze waarde niet gewijzigd. |
| RectXSize | Breedte van rechthoek, in x-mastereenheden. | Geldig voor gebruik in CmdSetRectWidth-opdrachtreeksen. |
| RectYSize | Lengte van rechthoek, in y-mastereenheden. | Geldig voor gebruik in cmdSetRectHeight-opdrachtreeksen. |
| RedValue | Rode component van de huidige kleur. | Geldig voor gebruik in opdrachtreeksen CmdDefinePaletteEntry (zie GreenValue, BlueValue). |
| TextXRes | Huidige horizontale resolutie voor tekst, in DPI. | Geldig wanneer een afdruktaak wordt uitgevoerd. |
| TextYRes | Huidige verticale resolutie voor tekst, in DPI. | Geldig wanneer een afdruktaak wordt uitgevoerd. |