Funzione SHGetInverseCMAP (shlwapi.h)

Articolo
03/05/2024

[Questa funzione è disponibile tramite Windows XP e Windows Server 2003. Potrebbe essere modificato o non disponibile nelle versioni successive di Windows.]

Recupera il mapping della tabella dei colori inversa per la tavolozza halftone.

Sintassi

LWSTDAPI SHGetInverseCMAP(
  [out] BYTE  *pbMap,
  [in]  ULONG cbMap
);

Parametri

[out] pbMap

Tipo: BYTE*

Puntatore a una matrice di BYTEche riceve il mapping della tabella dei colori inversa o un puntatore a un LPBYTE che riceve un puntatore a una copia memorizzata nella cache del mapping della tabella dei colori inversa, a seconda del valore del parametro cbMap .

[in] cbMap

Tipo: ULONG

Dimensioni del buffer a cui punta pbMap, che ne definisce anche il contenuto. Vengono riconosciuti due valori.

(sizeof(BYTE*))

Il buffer a cui punta pbMap riceve un puntatore a una copia memorizzata nella cache della tabella della mappa colori inversa.

(32768)

Il buffer a cui punta pbMap riceve una copia della tabella della mappa colori inversa. Il buffer deve avere dimensioni esattamente pari a 32.768 byte.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

La tabella di mapping dei colori inversa è una tabella di 32.768 byte. Contiene gli indici dei colori nella tavolozza mezzotona. Ogni indice viene archiviato in una posizione nel buffer che corrisponde a un particolare valore RGB espresso in formato 555. Questi abbinamenti consentono di trovare un colore nella tavolozza halftone, che è una stretta approssimazione del colore originale.

Ad esempio, il metodo per determinare un colore nella tavolozza halftone che rappresenta un'approssimazione stretta per il colore #306040 è il seguente:

Scomporre il colore nei componenti rosso, verde e blu. In questo caso, il componente rosso è 0x30, il componente verde è 0x60 e il componente blu è 0x40.
Riassemblare il colore in formato 555. La formula per ridurre un colore RGB a 24 bit in formato 555 è illustrata qui.
```
((red / 8) << 10) + ((blue / 8) << 5) + (green / 8)
```
In questo esempio, il valore in formato 555 è ((0x30 / 8) 10) << + ((0x60 / 8) << 5) + (0x40 / 8) = 6536.
Il valore di indice archiviato nella posizione 6536 nella tabella della mappa dei colori inversa è l'indice del colore nella tavolozza halftone che rappresenta un'approssimazione ragionevole del colore #306040.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 5.0 o successiva)

Vedi anche

CreateHalftonePalette

GetNearestColor

Condividi tramite