ImageAttributes::Metode ClearThreshold (gdiplusimageattributes.h)

Artikel
08/24/2023

Metode ImageAttributes::ClearThreshold menghapus nilai ambang batas untuk kategori tertentu.

Sintaks

Status ClearThreshold(
  [in, optional] ColorAdjustType type
);

Parameter

[in, optional] type

Jenis: ColorAdjustType

Elemen enumerasi ColorAdjustType yang menentukan kategori yang ambangnya dibersihkan. Nilai defaultnya adalah ColorAdjustTypeDefault.

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 .

Keterangan

Ambang adalah nilai dari 0 hingga 1 yang menentukan titik cutoff untuk setiap komponen warna. Misalnya, ambang diatur ke 0,7, dan misalkan Anda merender warna yang komponen merah, hijau, dan birunya adalah 230, 50, dan 220. Komponen merah, 230, lebih besar dari 0,7×255, sehingga komponen merah akan diubah menjadi 255 (intensitas penuh). Komponen hijau, 50, kurang dari 0,7×255, sehingga komponen hijau akan diubah menjadi 0. Komponen biru, 220, lebih besar dari 0,7×255, sehingga komponen biru akan diubah menjadi 255.

Objek ImageAttributes mempertahankan pengaturan warna dan skala abu-abu untuk lima kategori penyesuaian: default, bitmap, kuas, pena, dan teks. Misalnya, Anda dapat menentukan ambang batas untuk kategori default, ambang yang berbeda untuk kategori bitmap, dan masih ambang batas yang berbeda untuk kategori pena.

Pengaturan penyesuaian warna dan abu-abu default berlaku untuk semua kategori yang tidak memiliki pengaturan penyesuaian sendiri. Misalnya, jika Anda tidak pernah menentukan pengaturan penyesuaian apa pun untuk kategori pena, maka pengaturan default berlaku untuk kategori pena.

Segera setelah Anda menentukan pengaturan penyesuaian warna atau skala abu-abu untuk kategori tertentu, pengaturan penyesuaian default tidak lagi berlaku untuk kategori tersebut. Misalnya, Anda menentukan ambang batas dan nilai gamma untuk kategori default. Jika Anda mengatur ambang batas untuk kategori pena dengan memanggil ImageAttributes::SetThreshold, ambang default tidak akan berlaku untuk pena. Jika nanti Anda menghapus ambang pena dengan memanggil ImageAttributes::ClearThreshold, kategori pena tidak akan kembali ke ambang default; sebaliknya, kategori pena tidak akan memiliki ambang batas. Demikian pula, kategori pena tidak akan kembali ke nilai gamma default; sebaliknya, kategori pena tidak akan memiliki nilai gamma.

Persyaratan


Klien minimum yang didukung	Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	gdiplusimageattributes.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll