IWICBitmapFrameEncode：：SetPalette 方法 (wincodec.h)

設定索引圖元格式的 IWICPalette 。

語法

HRESULT SetPalette(
  [in] IWICPalette *pIPalette
);

參數

[in] pIPalette

類型： IWICPalette*

要用於索引圖元格式的 IWICPalette 。

編碼器可能會變更調色盤，以反映編碼器支援的圖元格式。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

如果在圖元格式設定為非索引圖元格式的畫面上呼叫，這個方法不會失敗。 如果目標圖元格式是非索引格式，則會忽略調色盤。

如果您已經呼叫 IWICBitmapEncoder：：SetPalette 來設定全域調色盤，這個方法會覆寫目前框架的調色盤。

第一次呼叫 WritePixels/WriteSource 之前，必須先指定調色盤。 這麼做會導致 WriteSource 在將來源影像轉換成編碼器像素格式時使用指定的調色盤。 如果未指定調色盤，則會在第一次呼叫 WriteSource 時產生調色盤。

規格需求