Funzione EngCreatePalette (winddi.h)

Articolo
03/09/2024

La funzione EngCreatePalette invia una richiesta a GDI per creare una tavolozza RGB.

Sintassi

ENGAPI HPALETTE EngCreatePalette(
  [in] ULONG iMode,
  [in] ULONG cColors,
  [in] ULONG *pulColors,
  [in] FLONG flRed,
  [in] FLONG flGreen,
  [in] FLONG flBlue
);

Parametri

[in] iMode

Specifica la modalità di definizione della tavolozza. Questo parametro può essere uno dei valori seguenti:

Valore	Significato
PAL_BITFIELDS	La tavolozza è definita dai parametri flRed, flGreen e flBlue .
PAL_BGR	Il dispositivo accetta direttamente i colori RGB, con B (blu) come byte meno significativo.
PAL_CMYK	Il dispositivo accetta direttamente i colori CMYK, con C (ciano) come byte meno significativo.
PAL_INDEXED	Una matrice di colori RGB viene fornita con cColors e pulColors.
PAL_RGB	Il dispositivo accetta direttamente i colori RGB, con R (rosso) come byte meno significativo.

[in] cColors

Se il parametro iMode è PAL_INDEXED, cColors specifica il numero di colori forniti nella matrice a cui punta pulColors. In caso contrario, questo parametro deve essere zero.

[in] pulColors

Puntatore all'inizio di una matrice di valori ULONG se iMode è PAL_INDEXED. I 3 byte bassi di ogni ULONG definiscono i colori RGB nella tavolozza.

[in] flRed

Se il parametro iMode è PAL_BITFIELDS, i parametri flRed, flGreen e flBlue sono maschere che mostrano quali bit corrispondono a rosso, verde e blu. Ogni maschera deve essere costituita da bit contigui e non deve sovrapporsi ad altre maschere. Tutte le combinazioni di campi di bit sono supportate da GDI.

[in] flGreen

[in] flBlue

Valore restituito

Il valore restituito è un handle per la nuova tavolozza se la funzione ha esito positivo. In caso contrario, è zero e viene registrato un codice di errore.

Commenti

Il driver può associare la nuova tavolozza a un dispositivo restituendo un puntatore alla tavolozza nella struttura DEVINFO .

Una tavolozza PAL_INDEXED associata al dispositivo deve avere la prima voce di indice impostata su nero (rosso = 0, verde = 0, blu = 0) e l'ultima voce impostata su bianco (255, 255, 255). Tutte le altre voci devono essere impostate in modo che le voci i cui indici siano complementari tra loro abbiano colori che contrastano notevolmente. Ad esempio, se la voce 0x9 di una tavolozza di 16 voci è impostata su verde puro (0,255,0), la voce 0x6 (=~0x9) deve essere impostata su un colore che contrasta bene con il verde, ad esempio viola scuro (128,0,128). L'impostazione delle voci in questo modo consente alle operazioni raster XOR di comportarsi ragionevolmente. È consigliabile eliminare la tavolozza quando non è più necessaria usando EngDeletePalette.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Universale
Intestazione	winddi.h (include Winddi.h)
Libreria	Win32k.lib
DLL	Win32k.sys

Vedi anche

DEVINFO

DrvSetPalette

EngDeletePalette

Condividi tramite