Metode IWICBitmapFrameEncode::SetPalette (wincodec.h)

Mengatur IWICPalette untuk format piksel terindeks.

Sintaks

HRESULT SetPalette(
  [in] IWICPalette *pIPalette
);

Parameter

[in] pIPalette

Jenis: IWICPalette*

IWICPalette yang digunakan untuk format piksel terindeks.

Encoder dapat mengubah palet untuk mencerminkan format piksel yang didukung encoder.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini tidak gagal jika dipanggil pada bingkai yang format pikselnya diatur ke format piksel yang tidak diindeks. Jika format piksel target adalah format yang tidak diindeks, palet akan diabaikan.

Jika Anda sudah memanggil IWICBitmapEncoder::SetPalette untuk mengatur palet global, metode ini akan mengambil alih palet tersebut untuk bingkai saat ini.

Palet harus ditentukan sebelum panggilan pertama Anda ke WritePixels/WriteSource. Melakukannya akan menyebabkan WriteSource menggunakan palet yang ditentukan saat mengonversi gambar sumber ke format piksel encoder. Jika tidak ada palet yang ditentukan, palet akan dihasilkan pada panggilan pertama ke WriteSource.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2, Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	wincodec.h
Pustaka	Windowscodecs.lib
DLL	Windowscodecs.dll