Struttura GDIINFO (winddi.h)

La struttura GDIINFO descrive le funzionalità grafiche di un determinato dispositivo.

Sintassi

typedef struct _GDIINFO {
  ULONG     ulVersion;
  ULONG     ulTechnology;
  ULONG     ulHorzSize;
  ULONG     ulVertSize;
  ULONG     ulHorzRes;
  ULONG     ulVertRes;
  ULONG     cBitsPixel;
  ULONG     cPlanes;
  ULONG     ulNumColors;
  ULONG     flRaster;
  ULONG     ulLogPixelsX;
  ULONG     ulLogPixelsY;
  ULONG     flTextCaps;
  ULONG     ulDACRed;
  ULONG     ulDACGreen;
  ULONG     ulDACBlue;
  ULONG     ulAspectX;
  ULONG     ulAspectY;
  ULONG     ulAspectXY;
  LONG      xStyleStep;
  LONG      yStyleStep;
  LONG      denStyleStep;
  POINTL    ptlPhysOffset;
  SIZEL     szlPhysSize;
  ULONG     ulNumPalReg;
  COLORINFO ciDevice;
  ULONG     ulDevicePelsDPI;
  ULONG     ulPrimaryOrder;
  ULONG     ulHTPatternSize;
  ULONG     ulHTOutputFormat;
  ULONG     flHTFlags;
  ULONG     ulVRefresh;
  ULONG     ulBltAlignment;
  ULONG     ulPanningHorzRes;
  ULONG     ulPanningVertRes;
  ULONG     xPanningAlignment;
  ULONG     yPanningAlignment;
  ULONG     cxHTPat;
  ULONG     cyHTPat;
  LPBYTE    pHTPatA;
  LPBYTE    pHTPatB;
  LPBYTE    pHTPatC;
  ULONG     flShadeBlend;
  ULONG     ulPhysicalPixelCharacteristics;
  ULONG     ulPhysicalPixelGamma;
} GDIINFO, *PGDIINFO;

Members

ulVersion

Specifica il numero di versione del driver. L'ordinamento dei byte di ulVersion ha il formato seguente.

I 16 bit di ordine elevato devono essere impostati su zero. I bit da 8 a 15 specificano il numero di versione del sistema operativo Microsoft per cui è progettato il driver. I 4 bit di ordine elevato di questo intervallo specificano il numero principale della versione, i 4 bit di ordine basso contengono il numero secondario della versione. I 8 bit bassi di ulVersion specificano il numero di versione del driver di visualizzazione; questo valore deve essere incrementato per ogni versione del file binario del driver di visualizzazione.

Il programma Display in Pannello di controllo indica il numero di versione contenuto in ulVersion, insieme ad altre informazioni specifiche del driver.

ulTechnology

Specifica la tecnologia del dispositivo. Questo membro può essere uno dei valori elencati nella tabella seguente.

ulHorzSize

Specifica la larghezza della superficie fisica. Un valore positivo indica che la larghezza è in unità di millimetri, mentre un valore negativo indica che la larghezza è in unità di micrometri.

ulVertSize

Specifica l'altezza della superficie fisica. Un valore positivo indica che l'altezza è in unità di millimetri, mentre un valore negativo indica che l'altezza è in unità di micrometri.

ulHorzRes

Specifica la larghezza in pixel della superficie fisica (dispositivi di visualizzazione) o della superficie stampabile (stampanti).

Vedere anche ulDesktopHorzRes.

ulVertRes

Specifica l'altezza in pixel della superficie fisica (dispositivi di visualizzazione) o della superficie stampabile (stampanti).

cBitsPixel

Specifica il numero di bit adiacenti in ogni piano di colore. Il numero totale di bit per pixel è il prodotto di cBitsPixel e cPlanes.

cPlanes

Specifica il numero di piani di colore.

ulNumColors

Per i dispositivi palettizzati , ulNumColors specifica il numero di voci nella tavolozza dei colori predefinita. Per i dispositivi non multilalettizzati (che non includono stampanti), ulNumColors è impostato su -1.

flRaster

È riservato e deve essere impostato su zero.

ulLogPixelsX

Specifica la risoluzione della larghezza del dispositivo in pixel logici per pollice.

Per le stampanti, questo membro deve essere impostato sulla risoluzione della stampante in dpi.

Per le visualizzazioni, questo membro deve essere impostato su 96.

ulLogPixelsY

Specifica la risoluzione dell'altezza del dispositivo in pixel logici per pollice.

Per le stampanti, questo membro deve essere impostato sulla risoluzione della stampante in dpi.

Per le visualizzazioni, questo membro deve essere impostato su 96.

flTextCaps

Specifica un flag che descrive le funzionalità di testo di Windows 3.1. Se il driver TC_SCROLLBLT flag si trova in questo membro, indica che la console deve eseguire lo scorrimento del testo ridisegnando l'intera schermata, usando la funzione DrvTextOut fornita dal driver anziché le funzioni DrvBitBlt o DrvCopyBits . Il driver deve impostare questo flag se i trasferimenti da schermo a bit a schermo sono lenti. Se questo flag non è impostato, il driver richiede implicitamente che la console esegua lo scorrimento del testo attraverso DrvBitBlt/DrvCopyBits.

ulDACRed

ulDACGreen

ulDACBlue

Specifica il numero di bit di applicazione livello dati per il colore specificato.

ulAspectX

Specifica la larghezza relativa di un pixel del dispositivo, compreso nell'intervallo da uno a 1000.

ulAspectY

Specifica l'altezza relativa di un pixel del dispositivo, nell'intervallo da uno a 1000.

ulAspectXY

Specifica la radice quadrata della somma dei quadrati di ulAspectX e ulAspectY.

xStyleStep

Specifica il numeratore di avanzamento dello stile per le linee x-major, dx. Per ulteriori informazioni, vedere la sezione Osservazioni seguenti e Linee cosmetiche con stile.

yStyleStep

Specifica il numeratore di avanzamento dello stile per linee y-major, dy. Per ulteriori informazioni, vedere la sezione Osservazioni seguenti e Linee cosmetiche con stile.

denStyleStep

Specifica il denominatore di avanzamento dello stile D. Per ulteriori informazioni, vedere la sezione Osservazioni seguenti e Linee cosmetiche con stile.

ptlPhysOffset

Specifica una struttura POINTL che contiene le dimensioni, in pixel, del margine non scrivibile di una superficie.

szlPhysSize

Specifica una struttura SIZEL che contiene le dimensioni, in pixel, dell'intera superficie, inclusi i margini non scrivibili. Una struttura SIZEL è identica a una struttura SIZE .

ulNumPalReg

Specifica il numero di registri della tavolozza per un dispositivo indicizzato.

ciDevice

Struttura COLORINFO che definisce i colori del dispositivo nello spazio delle coordinate CIE.

ulDevicePelsDPI

Per le stampanti, specifica il numero di pixel (o punti o ugelli) per pollice se i pixel sono disposti affiancati senza sovrapposizione o spazio tra. Ad esempio, se la dimensione di un pixel è 0,001 pollici, questo valore è uguale a 0,001 diviso per 0,001. Se il membro è zero, il halftoning GDI calcola questo numero in base al presupposto che tutti i pixel siano connessi senza sovrapposizione.

Poiché la dimensione fisica del punto per la maggior parte delle stampanti è maggiore della dimensione del punto misurata, GDI usa questo valore per approssimare il numero di punti fisici che è possibile posizionare, in base alle dimensioni della cella (dimensioni del modello). Viene quindi eseguita una regressione del log per determinare qual è la più lineare; ovvero, dove devono essere posizionati i punti per la migliore copertura per ottimizzare la copertura dei pixel del dispositivo sovrapposti (guadagno punto).

Per le visualizzazioni, questo membro deve essere impostato su zero.

ulPrimaryOrder

Specifica l'ordine di bit dei colori primari o dei numeri del piano del dispositivo per l'output della mezzatona. Questo membro può essere uno dei valori elencati nella tabella seguente.

ulHTPatternSize

Specifica le dimensioni del pattern halftone. I valori che terminano con AxBM sono varianti dei modelli AxB . In altre parole, SIZEAxB e SIZE_AxB_M differiscono per i pixel illuminati in un motivo A x B. Questo membro può essere uno dei valori seguenti:

HT_PATSIZE_2x2

HT_PATSIZE_2x2_M

HT_PATSIZE_4x4

HT_PATSIZE_4x4_M

HT_PATSIZE_6x6

HT_PATSIZE_6x6_M

HT_PATSIZE_8x8

HT_PATSIZE_8x8_M

HT_PATSIZE_10x10

HT_PATSIZE_10x10_M

HT_PATSIZE_12x12

HT_PATSIZE_12x12_M

HT_PATSIZE_14x14

HT_PATSIZE_14x14_M

HT_PATSIZE_16x16

HT_PATSIZE_16x16_M

HT_PATSIZE_SUPERCELL

HT_PATSIZE_SUPERCELL_M

HT_PATSIZE_USER

HT_PATSIZE_MAX_INDEX

HT_PATSIZE_DEFAULT

ulHTOutputFormat

Specifica il formato di output preferito per halftone. HT_FORMAT_4BPP usa solo 8 colori di intensità completa mentre HT_FORMATP_IRGB usa tutti i 16 colori, inclusi i colori di mezza intensità. Si presuppone che venga usato un formato da 5 x 5 x 5 (5 bit per colore) per HT_FORMAT_16BPP. Questo membro può essere uno dei valori seguenti:

HT_FORMAT_1BPP

HT_FORMAT_4BPP

HT_FORMAT_4BPP_IRGB

HT_FORMAT_8BPP

HT_FORMAT_16BPP

HT_FORMAT_24BPP

HT_FORMAT_32BPP

flHTFlags

Specifica una combinazione di flag che descrivono il dispositivo. Questi flag sono necessari per il halftoning. Questo membro può essere una combinazione dei valori seguenti:

ulVRefresh

Frequenza di aggiornamento video per la modalità di visualizzazione corrente. Questo è il valore restituito dal driver miniport per la frequenza di aggiornamento per la modalità corrente.

Il programma Display in Pannello di controllo visualizza la frequenza di aggiornamento contenuta nel membro ulVRefresh.

ulBltAlignment

Questo membro indica l'allineamento x preferito per i trasferimenti di blocchi di bit nel dispositivo. Un valore pari a zero indica che i trasferimenti a blocchi di bit sono accelerati; qualsiasi altro numero nonnegative indica che i trasferimenti di blocchi di bit non sono accelerati e offrono l'allineamento orizzontale preferito come pixel multiplo.

Questo valore viene usato dal sistema per determinare l'allineamento predefinito per le posizioni delle finestre e viene usato anche per impostare il valore predefinito di trascinamento completo iniziale durante l'installazione. Un valore pari a zero indica che il trascinamento completo deve essere attivo per impostazione predefinita; qualsiasi valore diverso da zero indica che il trascinamento completo deve essere disattivato per impostazione predefinita.

ulPanningHorzRes

ulPanningVertRes

Deve essere ignorato dal driver e rimanere zero inizializzato.

xPanningAlignment

yPanningAlignment

Deve essere ignorato dal driver e rimanere zero inizializzato.

cxHTPat

cyHTPat

Specificare rispettivamente la larghezza e l'altezza, in pixel, del modello halftone fornito dall'utente. Il valore di cxHTPat deve trovarsi nell'intervallo HT_USERPAT_CX_MIN per HT_USERPAT_CX_MAX, inclusivo. Il valore di cyHTPat deve trovarsi nell'intervallo HT_USERPAT_CY_MIN da HT_USERPAT_CY_MAX, inclusivo. Queste costanti sono definite in winddi.h. Per altre informazioni, vedere la sezione Osservazioni seguenti.

pHTPatA

pHTPatB

pHTPatC

Puntare rispettivamente ai modelli di halftone definiti dall'utente per i colori primari A, B e C, come definito dal valore PRIMARY_ORDER_XXX nel membro ulPrimaryOrder . Ogni modello dither deve essere una matrice di byte bidimensionale valida di dimensioni cxHTPat by cyHTPat. Per altre informazioni, vedere la sezione Osservazioni seguenti.

flShadeBlend

Specifica un set di flag che indicano le funzionalità di ombreggiatura e fusione del dispositivo. I driver di visualizzazione devono ignorare questo membro e devono lasciarli impostati su zero. Per i driver della stampante, il valore che il driver inserisce in questo membro è il valore che GDI segnala quando un'applicazione chiama GetDeviceCaps(hdc, SHADEBLENDCAPS). La funzione GetDeviceCaps è descritta nella documentazione di Microsoft Window SDK.

ulPhysicalPixelCharacteristics

Specifica il modo in cui i frammenti di colore sono configurati per formare pixel nel dispositivo di visualizzazione. I frammenti di colore nel dispositivo di visualizzazione possono essere disposti in ordine RGB o in ordine BGR, completamente indipendente dall'ordinamento RGB nel buffer del frame. I frammenti di colore possono essere configurati in strisce orizzontali in cui tutti i frammenti in una riga sono lo stesso colore. In alternativa, i frammenti di colore possono essere configurati in strisce verticali, in cui tutti i frammenti in una colonna sono lo stesso colore. Lo striping verticale è preferito, poiché fornisce in modo efficace tre frammenti separati in una riga per ogni pixel, dando così una maggiore risoluzione orizzontale dei subpixel.

Il membro ulPhysicalPixelCharacteristics deve essere impostato su uno dei valori visualizzati nella tabella seguente:

ulPhysicalPixelGamma

Specifica la gamma del dispositivo visualizzato. Questo membro deve essere impostato sulla gamma del pixel fisico, ridimensionato da un fattore pari a 1000 o su uno dei valori seguenti. Ad esempio, un valore gamma pari a 2,2 sarebbe rappresentato come 2200.

Commenti

GDI zero inizializza questa struttura prima di chiamare la funzione DrvEnablePDEV fornita dal driver.

I membri xStyleStep, yStyleStep e denStyleStep definiscono il modo in cui uno stile di linea cosmetica deve avanzare mentre disegna ogni pixel di una linea cosmetica. La quantità avanzata lungo lo stile per ogni pixel viene definita come frazione che dipende dal fatto che la linea sia in stile x o y. Se la linea è in stile x, lo stile avanza in base alla quantità frazionaria dx/D per ogni pixel spostato nella direzione x. In caso contrario, lo stile avanza da dy/D per ogni pixel spostato nella direzione y.

I punti nello stile linea predefinito PS_DOT sono ogni unità lunga. Se il driver definisce xStyleStep come uno e denStyleStep come 5, una linea orizzontale punteggiata è costituita da 5 pixel seguiti da 5 pixel-off, ripetuti.

Ognuno di questi tre numeri deve essere minore di 65536, anche se i membri dei limiti sono valori LONG. Questi passaggi di stile sono definiti dal driver per garantire che i punti e i trattini in una linea siano una dimensione piacevole sul dispositivo di output. I passaggi orizzontali e verticali possono essere diversi da corretti per le proporzioni nontriviali. Ad esempio, in un display EGA, i cui pixel sono superiori al 33% rispetto a quelli che sono wide, è possibile impostare:

pdevcaps->xStyleStep   =  3;    // For an EGA
pdevcaps->yStyleStep   =  4;
pdevcaps->denStyleStep = 12;

In questo caso, le linee tratteggiate orizzontalmente sono 4 pixel su 4 pixel, perché lo stile avanza da 3/12 o 1/4 per ogni pixel. Le linee tratteggiate verticali sono 3 pixel-on/3-pixel-off.

Le linee in stile sembrano migliori se i passaggi di stile x e y si dividono uniformemente nel denominatore di stile, come fanno nell'esempio precedente. Questo dà trattini e punti che sono sempre la stessa lunghezza.

GDI richiede queste informazioni in modo che le funzioni bitmap possano emulare esattamente ciò che il dispositivo esegue sulla propria superficie. Le applicazioni possono accedere a queste informazioni per determinare esattamente quali pixel verranno attivati per le linee in stile. Fare riferimento anche a Linee cosmetiche in stile.

I membri correlati a halftone, cxHTPat, cyHTPat, pHTPatA, pHTPatB e pHTPatC, possono essere usati in un plug-in di rendering OEM Unidrv per definire un modello di metàtone personalizzato costituito da uno o tre colori. Questi membri vengono controllati solo se il membro ulHTPatternSize è impostato su HT_PATSIZE_USER. In questo caso un OEM può usare questi membri per definire un modello di mezzatona personalizzato, in base ai dati archiviati in un file di risorse o generati da un modulo di personalizzazione OEM. I membri cxHTPat e cyHTPat definiscono le dimensioni di ognuna delle matrici di modelli a mezzatone bidimensionali. I membri pHTPatA, pHTPatB e pHTPatC puntano alle rispettive matrici di pattern per ogni colore. Se viene usata una sola matrice di pattern, pHTPatA, pHTPatB e pHTPatC punta a essa.

Ogni soglia di byte in una determinata posizione in un modello dither a metàtone determina se il pixel nella posizione del piano di output corrispondente sarà attivo o disattivato. Un valore di soglia zero in una posizione specifica nella matrice modello indica che la posizione del pixel corrispondente viene ignorata (è nera). I valori di soglia da 1 a 255 forniscono il modello dither con 255 livelli di grigio; se il valore pixel nel piano di output è maggiore o uguale al valore soglia per tale posizione, il pixel viene attivato. Un valore pixel minore del valore soglia corrispondente causa la disattivazione del pixel nel piano di output. Per altre informazioni, vedere Customd Halftoning in Personalizzazione dei driver di stampante Microsoft .

Requisiti

Vedi anche

CIECHROMA

COLORINFO

DrvBitBlt

DrvCopyBits

DrvEnablePDEV

DrvTextOut