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

Définit la valeur IWICPalette pour les formats de pixels indexés.

Syntaxe

HRESULT SetPalette(
  [in] IWICPalette *pIPalette
);

Paramètres

[in] pIPalette

Type : IWICPalette*

IWICPalette à utiliser pour les formats de pixels indexés.

L’encodeur peut modifier la palette pour refléter les formats de pixels pris en charge par l’encodeur.

Valeur retournée

Type : HRESULT

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

Remarques

Cette méthode n’échoue pas si elle est appelée sur un cadre dont le format de pixel est défini sur un format de pixel non indexé. Si le format de pixel cible est un format non indexé, la palette est ignorée.

Si vous avez déjà appelé IWICBitmapEncoder ::SetPalette pour définir une palette globale, cette méthode remplace cette palette pour l’image actuelle.

La palette doit être spécifiée avant votre premier appel à WritePixels/WriteSource. Cela entraîne l’utilisation de la palette spécifiée par WriteSource lors de la conversion de l’image source au format de pixels d’encodeur. Si aucune palette n’est spécifiée, une palette est générée lors du premier appel à WriteSource.

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
DLL	Windowscodecs.dll