Standardvariabler
Viktig
Den moderna utskriftsplattformen är Windows bästa sätt att kommunicera med skrivare. Vi rekommenderar att du använder Microsofts IPP-drivrutin för inkorgsklass tillsammans med Print Support Apps (PSA) för att anpassa utskriftsupplevelsen i Windows 10 och 11 för enhetsutveckling av skrivare.
För mer information, se Modern print platform och Print support app design guide.
GPD-språket definierar en uppsättning standardvariabler som kan refereras i kommandosträngar med hjälp av kommandosträngsformatet. Unidrv-drivrutinen tilldelar värden till dessa variabler. Ur en GPD-fils perspektiv är variablerna skrivskyddade.
Alla standardvariabler lagras som DWORD-heltal.
Följande skrivarkommando anger kommandosträngen som skickas till en HP LaserJet 4P när ett block med rasterdata är klart:
*Command: CmdSendBlockData: "<1B>*b" %d{NumOfDataBytes} "W"
Följande tabell innehåller alla standardvariabler i alfabetisk ordning.
| Standardvariabelnamn | Värde | Kommentarer |
|---|---|---|
| BlueValue | Den blå komponenten i den aktuella färgen. | Giltigt för användning i CmdDefinePaletteEntry-kommandosträngar (se GreenValue, RedValue). |
| CurrentFontID | Identifieringsnummer för det aktuella nedladdade mjuka teckensnittet. | Giltigt om det aktuella utskriftsjobbet innehåller nedladdade mjuka teckensnitt. |
| CurrentPaletteIndex | Aktuellt index för färgpaletten. | Giltigt för användning i CmdSelectPaletteEntry-kommandosträngar (se GreenValue, RedValue). |
| CursorOriginX | X-koordinat för markörens ursprung i huvudenheter. | Giltigt när ett utskriftsjobb pågår. |
| CursorOriginY | Y-koordinat för markörens ursprung i huvudenheter. | Giltigt när ett utskriftsjobb pågår. |
| DestX | X-koordinat för markörens mål, i huvudenheter, i förhållande till markörens ursprung. | Giltigt för användning i CmdXMoveAbsolute-kommandosträngar. |
| DestXRel | X-koordinat för markörens mål, i huvudenheter, i förhållande till den aktuella markörens position. | Giltigt för användning i kommandosträngarna CmdXMoveRelLeft och CmdXMoveRelRight. |
| DestY | Y-koordinat för markörens mål, i huvudenheter, i förhållande till markörens ursprung. | Giltigt för användning i CmdYMoveAbsolute-kommandosträngar. |
| DestYRel | Y-koordinat för markörens mål, i huvudenheter, i förhållande till den aktuella markörens position. | Giltigt för användning i kommandosträngarna CmdYMoveRelUp och CmdYMoveRelDown. |
| FontBold | Ange till ett om det aktuella teckensnittet är fetstilt, eller annars noll. | Giltigt när ett teckensnitt har angetts. |
| FontHeight | Höjd, i huvudenheter, för det aktuella teckensnittet. | Giltigt när ett teckensnitt har angetts. |
| FontItalic | Ange till ett om det aktuella teckensnittet är kursivt eller noll annars. | Giltigt när ett teckensnitt har angetts. |
| FontMaxWidth | Ange till maximal teckenökning för alla tecken i teckensnittet. | Giltigt när ett teckensnitt har angetts. |
| FontStrikeThru | Ställ in till ett om genomstrykning är aktiverat för det aktuella teckensnittet, eller noll annars. | Giltigt när ett teckensnitt har angetts. |
| FontUnderLine | Ange till ett om det aktuella teckensnittet är understruket, eller annars noll. | Giltigt när ett teckensnitt har angetts. |
| FontWidth | Bredd, i huvudenheter, på det aktuella teckensnittet. | Giltigt när ett teckensnitt har angetts. |
| GraphicsXRes | Aktuell vågrät upplösning för grafik, i DPI. | Giltigt när ett utskriftsjobb pågår. |
| GraphicsYRes | Aktuell lodrät upplösning för grafik i DPI. | Giltigt när ett utskriftsjobb pågår. |
| GrayPercentage | Grå nivå (procent) som ska användas för grå fyllning. | Giltigt för användning i CmdRectGrayFill-kommandosträngar. |
| GreenValue | Grön komponent i den aktuella färgen. | Giltigt för användning i CmdDefinePaletteEntry-kommandosträngar (se BlueValue, RedValue). |
| Radmatningsavstånd | Mängden lodrätt utrymme, i huvudenheter, som representerar en linjefeed. | Giltigt för användning i CmdSetLineSpacing-kommandosträngar. |
| NästaTeckensnittsID | Identifieringsnummer för nästa mjuka teckensnitt som ska laddas ned. | Giltigt för användning i CmdSetFontID-kommandosträngar. |
| NextGlyph | Tvåbyteskoden för nästa glyf som ska laddas ned. | Giltigt för användning i CmdSetCharCode-kommandosträngar. |
| AntalKopior | Antal kopior som begärs av användaren. | Giltigt när ett utskriftsjobb pågår. |
| AntalDatabajtar | Antal byte med rasterdata som är redo för överföring. | Giltigt för användning i valfri CmdSendXXXData-kommandosträng. Om data komprimeras är värdet antalet byte efter komprimering. |
| Sidnummer | Antalet sidor som skrivs ut. Observera att detta inte nödvändigtvis motsvarar programmets sidnummer, utan snarare antalet gånger DrvSendPage- har anropats. Det här värdet initieras av DrvStartDoc och ökas av DrvSendPage. Om T.ex. N-up = 4 är markerat, ökas PageNumber endast till 2 när den femte sidan i dokumentet skrivs ut. Ett annat exempel är att om ett dokument skrivs ut i omvänd ordning (framifrån) rapporterar PageNumber standardvariabel fortfarande den första sidan som ska skrivas ut som sida 1, även om det här är dokumentets sista sida. Det här beteendet krävs för att stödja funktionen för automatisk duplexering korrekt. OEM-tillverkaren bör endast använda PageNumber för att avgöra om den aktuella sidan är på framsidan eller baksidan. | Giltigt när ett utskriftsjobb pågår. |
| PaletteIndexToProgram | Indexera till färgpaletten för nästa post i programmet. | Giltigt för användning i CmdDefinePaletteEntry-kommandosträngar. (Se även RedValue, GreenValue, BlueValue, CurrentPaletteIndex). |
| PatternBrushID | Identifieringsnummer för en nedladdad mönsterborste. | Giltigt för användning med kommandosträngarna CmdDownloadPattern och CmdSelectPattern. |
| PatternBrushSize | Storlek, i byte, på den aktuella mönsterpenseln. | Giltigt för användning med Kommandosträngen CmdDownloadPattern. |
| PatternBrushType | Typ av aktuell mönsterborste. Värdet kan vara: 2: Skuggningsmönster 3: Korskläckningsmönster 4: Användardefinierat mönster. | Giltigt för användning med kommandosträngarna CmdDownloadPattern och CmdSelectPattern. |
| PhysPaperLength | Längden av det papper som används i stående läge, i y-master enheter. | Giltigt när ett utskriftsjobb pågår. |
| PhysPaperWidth | Bredden i stående läge, i huvudenheter, av papperet som för närvarande används. | Giltigt när ett utskriftsjobb pågår. |
| PrintDirInCCDegrees | Rotationsmängd, mätt motsols, i grader. | Giltigt när drivrutinen skickar kommandosträngen CmdSetSimpleRotation eller CmdSetAnyRotation. |
| RasterDataHeightInPixels | Höjd, i bildpunkter, på bilden som representeras av aktuella data. | Giltigt för användning i valfri CmdSendXXXData-kommandosträng och i CmdSetSrcBmpHeight-kommandosträngar. Komprimering ändrar inte det här värdet. |
| RasterDataWidthInBytes | Antal byte som finns i en genomsökningsrad. | Giltigt för användning i valfri CmdSendXXXData-kommandosträng och i CmdSetSrcBmpWidth-kommandosträngar. Komprimering ändrar inte det här värdet. |
| RectXSize | Rektangelbredd i x-master-enheter. | Giltigt för användning i CmdSetRectWidth-kommandosträngar. |
| RectYSize | Rektangellängd, i y-master-enheter. | Giltigt för användning i CmdSetRectHeight-kommandosträngar. |
| RedValue | Röd komponent i den aktuella färgen. | Giltigt för användning i CmdDefinePaletteEntry-kommandosträngar (se GreenValue, BlueValue). |
| TextXRes | Aktuell vågrät upplösning för text i DPI. | Giltigt när ett utskriftsjobb pågår. |
| TextYRes | Aktuell lodrät upplösning för text i DPI. | Giltigt när ett utskriftsjobb pågår. |