Variabili standard

Importante

È consigliabile usare il driver di classe posta in arrivo IPP di Microsoft, insieme a Print Support Apps (PSA), per personalizzare l'esperienza di stampa in Windows 10 e 11 per lo sviluppo di dispositivi della stampante.

Per altre informazioni, vedere la guida alla progettazione dell'app di supporto per la stampa.

Il linguaggio GPD definisce un set di variabili standard a cui è possibile fare riferimento all'interno delle stringhe di comando, usando il formato della stringa di comando. Il driver Unidrv assegna valori a queste variabili. Dal punto di vista di un file GPD, le variabili sono di sola lettura.

Tutte le variabili standard vengono archiviate come numeri interi DWORD.

La voce di comando della stampante seguente specifica la stringa di comando inviata a un HP LaserJet 4P quando un blocco di dati raster è pronto:

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

La tabella seguente contiene tutte le variabili standard, in ordine alfabetico.

Nome variabile standard	valore	Commenti
BlueValue	Componente blu del colore corrente.	Valido per l'uso nelle stringhe di comando CmdDefinePaletteEntry (vedere GreenValue, RedValue).
CurrentFontID	Numero di identificazione del tipo di carattere soft scaricato corrente.	Valido se il processo di stampa corrente include tipi di carattere soft scaricati.
CurrentPaletteIndex	Indice corrente nella tavolozza dei colori.	Valido per l'uso nelle stringhe di comando CmdSelectPaletteEntry (vedere GreenValue, RedValue).
CursorOriginX	Coordinata X dell'origine del cursore, in unità master.	Valido ogni volta che è in corso un processo di stampa.
CursorOriginY	Coordinata Y dell'origine del cursore, in unità master.	Valido ogni volta che è in corso un processo di stampa.
DestX	Coordinata X della destinazione del cursore, in unità master, rispetto all'origine del cursore.	Valido per l'uso nelle stringhe di comando CmdXMoveAbsolute.
DestXRel	Coordinata X della destinazione del cursore, in unità master, rispetto alla posizione corrente del cursore.	Valido per l'uso nelle stringhe di comando CmdXMoveRelLeft e CmdXMoveRelRight.
DestY	Coordinata Y della destinazione del cursore, in unità master, rispetto all'origine del cursore.	Valido per l'uso nelle stringhe di comando CmdYMoveAbsolute.
DestYRel	Coordinata Y della destinazione del cursore, in unità master, rispetto alla posizione corrente del cursore.	Valido per l'uso nelle stringhe di comando CmdYMoveRelUp e CmdYMoveRelDown.
FontBold	Impostare su uno se il tipo di carattere corrente è in grassetto o zero in caso contrario.	Valido quando è stato specificato un tipo di carattere.
FontHeight	Altezza, in unità master, del tipo di carattere corrente.	Valido quando è stato specificato un tipo di carattere.
CarattereCorsivo	Impostare su uno se il tipo di carattere corrente è in corsivo o zero in caso contrario.	Valido quando è stato specificato un tipo di carattere.
FontMaxWidth	Impostare sull'incremento massimo di caratteri di tutti i glifi nel tipo di carattere.	Valido quando è stato specificato un tipo di carattere.
FontStrikeThru	Impostare su uno se il barrato è abilitato per il tipo di carattere corrente o zero in caso contrario.	Valido quando è stato specificato un tipo di carattere.
FontUnderLine	Impostare su uno se il tipo di carattere corrente è sottolineato o zero in caso contrario.	Valido quando è stato specificato un tipo di carattere.
FontWidth	Larghezza, in unità master, del tipo di carattere corrente.	Valido quando è stato specificato un tipo di carattere.
GraphicsXRes	Risoluzione orizzontale corrente per la grafica, in DPI.	Valido ogni volta che è in corso un processo di stampa.
GraphicsYRes	Risoluzione verticale corrente per la grafica, in DPI.	Valido ogni volta che è in corso un processo di stampa.
GrayPercentage	Livello grigio (percentuale) da usare per il riempimento grigio.	Valido per l'uso nelle stringhe di comando CmdRectGrayFill.
GreenValue	Componente verde del colore corrente.	Valido per l'uso nelle stringhe di comando CmdDefinePaletteEntry (vedere BlueValue, RedValue).
LinefeedSpacing	Quantità di spazio verticale, in unità master, che rappresenta un avanzamento linea.	Valido per l'uso nelle stringhe di comando CmdSetLineSpacing.
NextFontID	Numero di identificazione del carattere soft successivo da scaricare.	Valido per l'uso nelle stringhe di comando CmdSetFontID.
NextGlyph	Codice a due byte del glifo successivo da scaricare.	Valido per l'uso nelle stringhe di comando CmdSetCharCode.
NumOfCopies	Numero di copie richieste dall'utente.	Valido ogni volta che è in corso un processo di stampa.
NumOfDataBytes	Numero di byte di dati raster pronti per il trasferimento.	Valido per l'uso in qualsiasi stringa di comando CmdSendXXXData. Se i dati vengono compressi, il valore è il numero di byte dopo la compressione.
PageNumber	Numero della pagina attualmente stampata. Si noti che questo non corrisponde necessariamente al numero di pagina dell'applicazione, ma piuttosto al numero di chiamate di DrvSendPage . Questo valore viene inizializzato da DrvStartDoc e viene incrementato da DrvSendPage. Ad esempio, se è selezionato N-up = 4, PageNumber viene incrementato a 2 solo quando viene stampata la quinta pagina del documento. Come altro esempio, se un documento viene stampato in ordine inverso (indietro all'inizio) la variabile standard PageNumber segnala comunque la prima pagina da stampare come pagina 1, anche se si tratta dell'ultima pagina del documento. Questo comportamento è necessario per supportare correttamente la funzionalità di auto-duplex. L'OEM deve usare PageNumber solo per determinare se la pagina corrente è il lato anteriore o posteriore.	Valido ogni volta che un processo di stampa è in corso.
PaletteIndexToProgram	Indice nella tavolozza dei colori per la voce successiva al programma.	Valido per l'uso nelle stringhe di comando CmdDefinePaletteEntry. Vedere anche RedValue, GreenValue, BlueValue, CurrentPaletteIndex.
PatternBrushID	Numero di identificazione di un pennello modello scaricato.	Valido per l'uso con stringhe di comando CmdDownloadPattern e CmdSelectPattern.
PatternBrushSize	Dimensioni, in byte, del pennello modello corrente.	Valido per l'uso con la stringa di comando CmdDownloadPattern.
PatternBrushType	Tipo del pennello di modello corrente. Il valore può essere: 2: Modello di ombreggiatura 3: Modello di tratteggio incrociato 4: Modello definito dall'utente.	Valido per l'uso con stringhe di comando CmdDownloadPattern e CmdSelectPattern.
PhysPaperLength	Lunghezza in modalità verticale, in unità master y, della carta attualmente in uso.	Valido ogni volta che un processo di stampa è in corso.
PhysPaperWidth	Larghezza in modalità verticale, in unità master, della carta attualmente in uso.	Valido ogni volta che un processo di stampa è in corso.
PrintDirInCCDegrees	Quantità di rotazione, misurata antiorario, in gradi.	Valido quando il driver invia la stringa di comando CmdSetSimpleRotation o CmdSetAnyRotation.
RasterDataHeightInPixels	Altezza, in pixel, dell'immagine rappresentata dai dati correnti.	Valido per l'uso in qualsiasi stringa di comando CmdSendXXXData e in Stringhe di comando CmdSetSrcBmpHeight. La compressione non modifica questo valore.
RasterDataWidthInBytes	Numero di byte contenuti in una riga di analisi.	Valido per l'uso in qualsiasi stringa di comando CmdSendXXXData e in Stringhe di comando CmdSetSrcBmpWidth. La compressione non modifica questo valore.
RectXSize	Larghezza rettangolo, in unità x master.	Valido per l'uso nelle stringhe di comando CmdSetRectWidth.
RectYSize	Lunghezza rettangolo, in unità master y.	Valido per l'uso nelle stringhe di comando CmdSetRectHeight.
RedValue	Componente rosso del colore corrente.	Valido per l'uso nelle stringhe di comando CmdDefinePaletteEntry (vedere GreenValue, BlueValue).
TextXRes	Risoluzione orizzontale corrente per il testo, in DPI.	Valido ogni volta che un processo di stampa è in corso.
TextYRes	Risoluzione verticale corrente per il testo, in DPI.	Valido ogni volta che un processo di stampa è in corso.