Metodo IWICBitmapFrameEncode::SetColorContexts (wincodec.h)

Imposta un determinato numero di profili IWICColorContext sul frame.

Sintassi

HRESULT SetColorContexts(
  [in] UINT             cCount,
  [in] IWICColorContext **ppIColorContext
);

Parametri

[in] cCount

Tipo: UINT

Numero di profili IWICColorContext da impostare.

[in] ppIColorContext

Tipo: IWICColorContext**

Puntatore a un puntatore A un puntatore IWICColorContext contenente i profili dei contesti di colore da impostare sulla cornice.

Valore restituito

Tipo: HRESULT

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

Commenti

• BMPL'impostazione dei contesti di colore non è supportata. Questa funzione restituirà WINCODEC_ERR_UNSUPPORTEDOPERATION.
• PNGL'impostazione al massimo di un contesto di colore è supportata e verranno ignorati contesti di colore aggiuntivi. Questo contesto deve essere un file WICColorContextProfile e viene usato per codificare iCCP, gAMA e blocchi cHRM nel file PNG.
• JPEG, TIFF, JPEG-XRLa configurazione di un file WICColorContextProfile e una WICColorContextExifColorSpace è supportata. Gli utenti non devono fornire più di un tipo di contesto di colore, come tutto il contesto di ogni tipo verrà ignorato. In JPEG, il file WICColorContextProfile viene codificato in blocco di metadati JPEG APP2 ICC.

  In TIFF e JPEG-XR il file WICColorContextProfile viene codificato nel blocco di metadati del profilo IFD (tag IFD 0x8773). In tutti e tre i formati, il codice WICColorContextExifColorSpace viene codificato nel blocco di metadati dello spazio dei colori EXIF (tag EXIF 0xA001).

Requisiti