IWICBitmapFrameEncode_SetPalette

インデックス付きピクセルフォーマット用の IWICPalette を設定する。

IWICBitmapFrameEncode_SetPalette this, pIPalette

this : [comobj] IWICBitmapFrameEncode インターフェースの COM オブジェクト変数
pIPalette : [comobj] 型: IWICPalette* インデックス付きピクセルフォーマットに使用する IWICPalette。エンコーダがサポートするピクセルフォーマットを反映するためにパレットを変更する場合がある。

(プラグイン / モジュール : com_misc.dll)

解説

インデックス付きピクセルフォーマット用の IWICPalette を設定する。

[戻り値]
型: HRESULT このメソッドが成功した場合は S_OK を返す。それ以外の場合は HRESULT エラーコードを返す。

[備考]

このメソッドは、ピクセルフォーマットが非インデックスピクセルフォーマットに設定されたフレームで呼び出されても失敗しない。ターゲットピクセルフォーマットが非インデックスフォーマットの場合、パレットは無視される。グローバルパレットを設定するために
IWICBitmapEncoder::SetPalette
を既に呼び出している場合、このメソッドは現在のフレームに対してそのパレットをオーバーライドする。パレットは
WritePixels/WriteSource の最初の呼び出し前に指定する必要がある。そうすることで、WriteSource
はソース画像をエンコーダのピクセルフォーマットに変換する際に指定されたパレットを使用する。パレットが指定されていない場合、WriteSource
の最初の呼び出し時にパレットが生成される。

情報