Partager via


Méthode IWICBitmapFrameEncode ::SetColorContexts (wincodec.h)

Définit un nombre donné de profils IWICColorContext sur le cadre.

Syntaxe

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

Paramètres

[in] cCount

Type : UINT

Nombre de profils IWICColorContext à définir.

[in] ppIColorContext

Type : IWICColorContext**

Pointeur vers un pointeur IWICColorContext contenant les profils de contexte de couleur à définir sur le cadre.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

  • BMPLa définition de contextes de couleur n’est pas prise en charge. Cette fonction retourne WINCODEC_ERR_UNSUPPORTEDOPERATION.
  • PNGLa définition d’un seul contexte de couleur est prise en charge, et d’autres contextes de couleur sont ignorés. Ce contexte doit être un FICHIER WICColorContextProfile et est utilisé pour encoder les blocs iCCP, gAMA et cHRM dans le fichier PNG.
  • JPEG, TIFF, JPEG-XRLa configuration d’un seul WICColorContextProfile et d’un WICColorContextExifColorSpace est prise en charge. Les utilisateurs ne doivent pas fournir plus d’un de chaque type de contexte de couleur, car tous les contextes de chaque type, sauf le dernier, seront ignorés. Au format JPEG, WICColorContextProfile est encodé en bloc de métadonnées ICC JPEG APP2.

    Dans TIFF et JPEG-XR, le fichier WICColorContextProfile est encodé en bloc de métadonnées de profil ICC IFD (balise IFD 0x8773). Dans les trois formats, WICColorContextExifColorSpace est encodé en bloc de métadonnées d’espace de couleurs EXIF (balise EXIF 0xA001).

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP avec SP2, Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête wincodec.h
Bibliothèque Windowscodecs.lib