Bitmap::InitializePalette method (gdiplusheaders.h)

  • Artikel

Metode Bitmap::InitializePalette menginisialisasi palet warna standar, optimal, atau kustom.

Sintaks

Status InitializePalette(
  [in, out] ColorPalette *palette,
  [in]      PaletteType  palettetype,
  [in]      INT          optimalColors,
  [in]      BOOL         useTransparentColor,
  [in]      Bitmap       *bitmap
);

Parameter

[in, out] palette

Jenis: ColorPalette*

Penunjuk ke buffer yang berisi struktur ColorPalette diikuti oleh array nilai ARGB . Anda harus mengatur anggota Bendera dan Hitung dari struktur ColorPalette . Anggota Entri dari struktur ColorPalette adalah array dari satu nilai ARGB . Anda harus mengalokasikan memori untuk struktur ColorPalette dan untuk nilai ARGB tambahan di palet. Misalnya, jika palet memiliki 36 nilai ARGB , alokasikan buffer sebagai berikut: malloc(sizeof(ColorPalette) + 35*sizeof(ARGB)).

[in] palettetype

Jenis: PaletteType

Elemen enumerasi PaletteType yang menentukan jenis palet. Palet dapat memiliki salah satu dari beberapa jenis standar, atau dapat menjadi palet kustom yang Anda tentukan. Selain itu, metode Bitmap::InitializePalette dapat membuat palet optimal berdasarkan bitmap tertentu.

[in] optimalColors

Jenis: INT

Bilangan bulat yang menentukan jumlah warna yang ingin Anda miliki dalam palet optimal berdasarkan bitmap tertentu. Jika parameter ini lebih besar dari 0, parameter palettetype harus diatur ke PaletteTypeOptimal, dan parameter bitmap harus menunjuk ke objek Bitmap . Jika Anda membuat palet standar atau kustom daripada palet optimal, atur parameter ini ke 0.

[in] useTransparentColor

Jenis: BOOL

Nilai Boolean yang menentukan apakah akan menyertakan warna transparan dalam palet. Atur ke TRUE untuk menyertakan warna transparan; jika tidak FALSE.

[in] bitmap

Jenis: Bitmap*

Penunjuk ke objek Bitmap tempat palet optimal akan dibuat. Jika palettetype diatur ke PaletteTypeOptimal dan optimalColors diatur ke bilangan bulat positif, atur parameter ini ke alamat objek Bitmap . Jika tidak, atur parameter ini ke NULL.

Mengembalikan nilai

Jenis: Status

Jika metode berhasil, metode mengembalikan Ok, yang merupakan elemen dari enumerasi Status .

Jika metode gagal, metode mengembalikan salah satu elemen lain dari enumerasi Status .

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header gdiplusheaders.h (termasuk Gdiplus.h)
Pustaka Gdiplus.lib
DLL Gdiplus.dll

Lihat juga

Bitmap