Funzione DrvGradientFill (winddi.h)
La funzione DrvGradientFill ombreggiate le primitive specificate.
Sintassi
BOOL DrvGradientFill(
[in, out] SURFOBJ *psoDest,
[in] CLIPOBJ *pco,
[in, optional] XLATEOBJ *pxlo,
[in] TRIVERTEX *pVertex,
[in] ULONG nVertex,
[in] PVOID pMesh,
[in] ULONG nMesh,
[in] RECTL *prclExtents,
[in] POINTL *pptlDitherOrg,
[in] ULONG ulMode
);
Parametri
[in, out] psoDest
Puntatore alla struttura SURFOBJ che identifica la superficie su cui disegnare.
[in] pco
Puntatore a una struttura CLIPOBJ . Le routine di servizio CLIPOBJ_Xxx vengono fornite per enumerare l'area clip come set di rettangoli. Questa enumerazione limita l'area della destinazione modificata. Se possibile, GDI semplifica il ritaglio coinvolto.
[in, optional] pxlo
Puntatore a una struttura XLATEOBJ . Questo parametro deve essere ignorato dal driver.
[in] pVertex
Puntatore a una matrice di strutture TRIVERTEX, con ogni voce contenente informazioni sulla posizione e sul colore. La struttura TRIVERTEX è descritta nella documentazione di Microsoft Windows SDK.
[in] nVertex
Specifica il numero di strutture TRIVERTEX nella matrice a cui pVertex punta.
[in] pMesh
Puntatore a una matrice di strutture che definiscono la connettività degli elementi TRIVERTEX a cui pVertex punta.
Quando i rettangoli vengono disegnati, pMesh punta a una matrice di strutture GRADIENT_RECT, ognuna delle quali specifica due elementi TRIVERTEX che definiscono un rettangolo. Gli elementi TRIVERTEX possono rappresentare qualsiasi coppia diagonalmente opposta di vertici rettangoli. Il disegno rettangolo è esclusivo in basso a destra. Sia TRIVERTEX che GRADIENT_RECT sono definiti nella documentazione di Windows SDK.
Quando vengono disegnati triangoli, pMesh punta a una matrice di strutture GRADIENT_TRIANGLE, ognuna delle quali specifica i tre elementi TRIVERTEX che definiscono un triangolo. Il disegno del triangolo è esclusivo in basso a destra. GRADIENT_TRIANGLE è definito nella documentazione di Windows SDK.
[in] nMesh
Specifica il numero di elementi nella matrice a cui punta pMesh .
[in] prclExtents
Puntatore a una struttura RECTL che definisce l'area in cui si verifica il disegno sfumatura. I punti vengono specificati nel sistema di coordinate della superficie di destinazione. Questo parametro è utile per stimare le dimensioni delle operazioni di disegno.
[in] pptlDitherOrg
Puntatore a una struttura POINTL che definisce l'origine sulla superficie per la dithering. Il pixel superiore sinistro del modello dither è allineato a questo punto.
[in] ulMode
Specifica la modalità di disegno corrente e come interpretare la matrice a cui punta pMesh . Questo parametro può essere uno dei valori seguenti:
GRADIENT_FILL_RECT_H
Il parametro pMesh punta a una matrice di strutture GRADIENT_RECT. Ogni rettangolo deve essere ombreggiato da sinistra a destra. In particolare, i pixel in alto a sinistra e inferiore sinistro sono lo stesso colore, come sono i pixel in alto a destra e in basso a destra.
GRADIENT_FILL_RECT_V
Il parametro pMesh punta a una matrice di strutture GRADIENT_RECT. Ogni rettangolo deve essere ombreggiato dall'alto verso il basso. In particolare, i pixel in alto a sinistra e in alto a destra sono lo stesso colore, come sono i pixel in basso a sinistra e in basso a destra.
GRADIENT_FILL_TRIANGLE
Il parametro pMesh punta a una matrice di strutture GRADIENT_TRIANGLE.
I calcoli di riempimento sfumatura per ogni modalità sono documentati nella sezione Osservazioni.
Valore restituito
DrvGradientFill restituisceTRUE al successo. In caso contrario, restituisce FALSE e segnala un errore chiamando EngSetLastError.
Commenti
DrvGradientFill può essere implementato facoltativamente nei driver grafici. GDI non chiama mai questa funzione per le superfici palletizzate.
Il driver aggancia DrvGradientFill impostando il flag di HOOK_GRADIENTFILL quando chiama EngAssociateSurface o EngModifySurface. Se il driver ha collegato DrvGradientFill e viene chiamato per eseguire un'operazione che non supporta, il driver deve gestire l'operazione puntando i dati in una chiamata a EngGradientFill.
GDI non chiamerà DrvGradientFill per le superfici di destinazione 8bpp.
Le formule per calcolare il valore di colore in ogni pixel della primitiva dipendono da ulMode come indicato di seguito:
L'errore totale accumulato su tutti e tre i canali di colore non deve essere maggiore di otto (8). Per altre informazioni sull'errore consentito, vedere Effetti speciali nei driver di visualizzazione.
Il driver deve ignorare il valore alfa dei vertici, lasciando invariato il canale alfa per le superfici che supportano la fusione alfa.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | winddi.h (include Winddi.h) |