Bitmap.ConvertFormat Metode

Definisi

Ruang nama:

System.Drawing

Rakitan:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v11.0.0-preview.5.26302.115

Overload

Nama	Deskripsi
ConvertFormat(PixelFormat)	Mengonversi bitmap ke yang ditentukan format. Data piksel asli diganti dengan format baru.
ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single)	Mengonversi bitmap ke yang ditentukan format menggunakan yang diberikan ditherType. Data piksel asli diganti dengan format baru.

ConvertFormat(PixelFormat)

Sumber:

Bitmap.cs

Mengonversi bitmap ke yang ditentukan format. Data piksel asli diganti dengan format baru.

public:
 void ConvertFormat(System::Drawing::Imaging::PixelFormat format);

public void ConvertFormat(System.Drawing.Imaging.PixelFormat format);

member this.ConvertFormat : System.Drawing.Imaging.PixelFormat -> unit

Public Sub ConvertFormat (format As PixelFormat)

Parameter

format

PixelFormat

Format piksel baru.

Keterangan

Untuk format, Format16bppGrayScale tidak didukung.

ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single)

Sumber:

Bitmap.cs

Mengonversi bitmap ke yang ditentukan format menggunakan yang diberikan ditherType. Data piksel asli diganti dengan format baru.

public void ConvertFormat(System.Drawing.Imaging.PixelFormat format, System.Drawing.Imaging.DitherType ditherType, System.Drawing.Imaging.PaletteType paletteType = System.Drawing.Imaging.PaletteType.Custom, System.Drawing.Imaging.ColorPalette? palette = default, float alphaThresholdPercent = 0);

member this.ConvertFormat : System.Drawing.Imaging.PixelFormat * System.Drawing.Imaging.DitherType * System.Drawing.Imaging.PaletteType * System.Drawing.Imaging.ColorPalette * single -> unit

Public Sub ConvertFormat (format As PixelFormat, ditherType As DitherType, Optional paletteType As PaletteType = System.Drawing.Imaging.PaletteType.Custom, Optional palette As ColorPalette = Nothing, Optional alphaThresholdPercent As Single = 0)

Parameter

format

PixelFormat

Format piksel baru.

ditherType

DitherType

Algoritma dithering.

paletteType

PaletteType

Jenis palet yang digunakan saat format piksel diindeks.

palette

ColorPalette

Penunjuk ke ColorPalette yang menentukan palet yang indeksnya disimpan dalam data piksel bitmap yang dikonversi. Ini harus ditentukan untuk format piksel terindeks.

alphaThresholdPercent

Single

Angka riil dalam rentang 0 hingga 100 yang menentukan piksel mana dalam bitmap sumber yang akan dipetakan ke warna transparan dalam bitmap yang dikonversi.

Keterangan

Untuk format, Format16bppGrayScale tidak didukung.

Untuk ditherType, teruskan None saat konversi tidak mengurangi kedalaman bit data piksel. Ini harus Solid atau ErrorDiffusion jika paletteType adalah Custom atau FixedBlackAndWhite.

paletteType diabaikan untuk format piksel yang tidak diindeks.

palette (disebut palet aktual) tidak harus memiliki jenis yang ditentukan oleh paletteType parameter . 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 paletteType parameter, maka ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single) melakukan konversi warna terdekat dari palet standar ke palet aktual.

Untuk alphaThresholdPercent, 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 memetakan 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 batas 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.

paletteType dan palette benar-benar hanya memiliki relevansi dengan format piksel terindeks. Anda dapat meneruskan ColorPalette untuk format piksel yang tidak diindeks, tetapi tidak berdampak pada transformasi dan akan efektif hanya memanggil Palette untuk mengatur palet saat konversi selesai.