Bitmap::Metode ConvertFormat (gdiplusheaders.h)

Metode Bitmap::ConvertFormat mengonversi bitmap ke format piksel tertentu. Data piksel asli dalam bitmap digantikan oleh data piksel baru.

Sintaks

Status ConvertFormat(
  [in] PixelFormat  format,
  [in] DitherType   dithertype,
  [in] PaletteType  palettetype,
  [in] ColorPalette *palette,
  [in] REAL         alphaThresholdPercent
);

Parameter

[in] format

Jenis: PixelFormat

Konstanta format piksel yang menentukan format piksel baru.

[in] dithertype

Jenis: DitherType

Elemen enumerasi DitherType yang menentukan algoritma dithering. Dalam kasus di mana konversi tidak mengurangi kedalaman bit data piksel, lewati DitherTypeNone.

[in] palettetype

Jenis: PaletteType

Elemen enumerasi PaletteType yang menentukan palet standar yang akan digunakan untuk dithering. Jika Anda mengonversi ke format yang tidak diindeks, parameter ini diabaikan. Dalam hal ini, berikan elemen enumerasi PaletteType apa pun, misalnya PaletteTypeCustom.

[in] palette

Jenis: ColorPalette*

Penunjuk ke struktur ColorPalette yang menentukan palet yang indeksnya disimpan dalam data piksel bitmap yang dikonversi. Palet ini (disebut palet aktual) tidak harus memiliki jenis yang ditentukan oleh parameter palettetype . Parameter palettetype menentukan palet standar yang dapat digunakan oleh salah satu algoritma dithering yang diurutkan atau spiral. Jika palet aktual memiliki jenis selain yang ditentukan oleh parameter palettetype , maka metode Bitmap::ConvertFormat melakukan konversi warna terdekat dari palet standar ke palet aktual.

[in] alphaThresholdPercent

Jenis: NYATA

Angka riil dalam rentang 0 hingga 100 yang menentukan piksel mana dalam bitmap sumber yang akan dipetakan ke warna transparan dalam bitmap yang dikonversi. Nilai 0 menentukan bahwa tidak ada piksel sumber yang dipetakan ke warna transparan. Nilai 100 menentukan bahwa piksel apa pun yang tidak sepenuhnya buram akan dipetakan ke warna transparan. Nilai t menentukan bahwa piksel sumber apa pun yang kurang dari t persen dari sepenuhnya buram akan memetakan ke warna transparan. Perhatikan bahwa agar ambang alfa efektif, palet harus memiliki warna transparan. Jika palet tidak memiliki warna transparan, piksel dengan nilai alfa di bawah ambang batas akan memetakan ke warna yang paling cocok (0, 0, 0, 0), biasanya hitam.

Menampilkan 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

Bitmap::InitializePalette