Metodo ID2D1DeviceContext::CreateColorContext (d2d1_1.h)

Crea un contesto di colore.

Sintassi

HRESULT CreateColorContext(
                 D2D1_COLOR_SPACE  space,
  [in, optional] const BYTE        *profile,
                 UINT32            profileSize,
  [out]          ID2D1ColorContext **colorContext
);

Parametri

space

Tipo: D2D1_COLOR_SPACE

Spazio del contesto di colore da creare.

[in, optional] profile

Tipo: const BYTE*

Buffer contenente i byte del profilo ICC utilizzati per inizializzare il contesto del colore quando lo spazio è D2D1_COLOR_SPACE_CUSTOM. Per altri tipi, il parametro viene ignorato e deve essere impostato su NULL.

profileSize

Tipo: UINT32

Dimensioni in byte di Profile.

[out] colorContext

Tipo: ID2D1ColorContext**

Quando termina, questo metodo contiene l'indirizzo di un puntatore a un nuovo oggetto contesto colore.

Valore restituito

Tipo: HRESULT

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Commenti

Il nuovo contesto di colore può essere usato in D2D1_BITMAP_PROPERTIES1 per inizializzare il contesto del colore di una bitmap creata.

Quando lo spazio è D2D1_COLOR_SPACE_CUSTOM, è necessario specificare profile e profileSize . In caso contrario, questi parametri devono essere impostati rispettivamente su NULL e zero. Quando lo spazio è D2D1_COLOR_SPACE_CUSTOM, viene controllato il campo del modello dell'intestazione del profilo per determinare se il profilo è sRGB o scRGB e lo spazio dei colori viene aggiornato rispettivamente. In caso contrario, lo spazio rimane personalizzato.

Requisiti

Vedi anche

D2D1_BITMAP_PROPERTIES1

D2D1_COLOR_SPACE

ID2D1Bitmap1

ID2D1DeviceContext