IWICBitmapFrameEncode::SetPalette メソッド (wincodec.h)

インデックス付きピクセル形式の IWICPalette を設定します。

構文

HRESULT SetPalette(
  [in] IWICPalette *pIPalette
);

パラメーター

[in] pIPalette

種類: IWICPalette*

インデックス付きピクセル形式に使用する IWICPalette 。

エンコーダーは、エンコーダーがサポートするピクセル形式を反映するようにパレットを変更する場合があります。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

ピクセル形式がインデックスなしのピクセル形式に設定されているフレームで呼び出された場合、このメソッドは失敗しません。 ターゲット ピクセル形式がインデックスなしの形式の場合、パレットは無視されます。

グローバル パレットを設定するために IWICBitmapEncoder::SetPalette を既に呼び出した場合、このメソッドは現在のフレームのパレットをオーバーライドします。

WritePixels/WriteSource を初めて呼び出す前に、パレットを指定する必要があります。 これにより、ソース イメージをエンコーダー ピクセル形式に変換するときに 、WriteSource で指定されたパレットが使用されます。 パレットが指定されていない場合、 WriteSource の最初の呼び出しでパレットが生成されます。

要件