Struktur COLORADJUSTMENT (wingdi.h)

Artikel
03/13/2024

Struktur COLORADJUSTMENT mendefinisikan nilai penyesuaian warna yang digunakan oleh fungsi StretchBlt dan StretchDIBits saat mode stretch adalah HALFTONE. Anda dapat mengatur nilai penyesuaian warna dengan memanggil fungsi SetColorAdjustment .

Sintaks

typedef struct tagCOLORADJUSTMENT {
  WORD  caSize;
  WORD  caFlags;
  WORD  caIlluminantIndex;
  WORD  caRedGamma;
  WORD  caGreenGamma;
  WORD  caBlueGamma;
  WORD  caReferenceBlack;
  WORD  caReferenceWhite;
  SHORT caContrast;
  SHORT caBrightness;
  SHORT caColorfulness;
  SHORT caRedGreenTint;
} COLORADJUSTMENT, *PCOLORADJUSTMENT, *LPCOLORADJUSTMENT;

Anggota

caSize

Ukuran struktur dalam byte.

caFlags

Menentukan bagaimana gambar output harus disiapkan. Anggota ini dapat diatur ke NULL atau kombinasi apa pun dari nilai berikut.

Nilai	Makna
CA_NEGATIVE	Menentukan bahwa negatif dari gambar asli harus ditampilkan.
CA_LOG_FILTER	Menentukan bahwa fungsi logaritma harus diterapkan pada kepadatan akhir warna output. Ini akan meningkatkan kontras warna ketika luminance rendah.

caIlluminantIndex

Jenis sumber cahaya standar tempat gambar dilihat. Anggota ini dapat diatur ke salah satu nilai berikut.

Nilai	Makna
ILLUMINANT_DEVICE_DEFAULT	Default perangkat. Standar yang digunakan oleh perangkat output.
ILLUMINANT_A	Lampu Tungsten.
ILLUMINANT_B	Sinar matahari siang.
ILLUMINANT_C	NTSC siang hari.
ILLUMINANT_D50	Sidik jari normal.
ILLUMINANT_D55	Cetak kertas obligasi.
ILLUMINANT_D65	Standar siang hari. Standar untuk CRTs dan gambar.
ILLUMINANT_D75	Cahaya matahari utara.
ILLUMINANT_F2	Lampu putih dingin.
ILLUMINANT_TUNGSTEN	Sama seperti ILLUMINANT_A.
ILLUMINANT_DAYLIGHT	Sama seperti ILLUMINANT_C.
ILLUMINANT_FLUORESCENT	Sama seperti ILLUMINANT_F2.
ILLUMINANT_NTSC	Sama seperti ILLUMINANT_C.

caRedGamma

Menentukan nilai koreksi gamma daya n^th untuk primer merah warna sumber. Nilai harus dalam rentang dari 2500 hingga 65.000. Nilai 10.000 berarti tidak ada koreksi gamma.

caGreenGamma

Menentukan nilai koreksi gamma daya n^th untuk primer hijau warna sumber. Nilai harus dalam rentang dari 2500 hingga 65.000. Nilai 10.000 berarti tidak ada koreksi gamma.

caBlueGamma

Menentukan nilai koreksi gamma daya n^th untuk primer biru warna sumber. Nilai harus dalam rentang dari 2500 hingga 65.000. Nilai 10.000 berarti tidak ada koreksi gamma.

caReferenceBlack

Referensi hitam untuk warna sumber. Warna apa pun yang lebih gelap dari ini diperlakukan sebagai hitam. Nilai harus dalam rentang dari 0 hingga 4000.

caReferenceWhite

Referensi putih untuk warna sumber. Warna apa pun yang lebih terang dari ini diperlakukan sebagai putih. Nilai harus dalam rentang dari 6000 hingga 10.000.

caContrast

Jumlah kontras yang akan diterapkan ke objek sumber. Nilai harus dalam rentang dari -100 hingga 100. Nilai 0 berarti tidak ada penyesuaian kontras.

caBrightness

Jumlah kecerahan yang akan diterapkan ke objek sumber. Nilai harus dalam rentang dari -100 hingga 100. Nilai 0 berarti tidak ada penyesuaian kecerahan.

caColorfulness

Jumlah warna-warni yang akan diterapkan ke objek sumber. Nilai harus dalam rentang dari -100 hingga 100. Nilai 0 berarti tidak ada penyesuaian warna-warni.

caRedGreenTint

Jumlah penyesuaian warna merah atau hijau yang akan diterapkan ke objek sumber. Nilai harus dalam rentang dari -100 hingga 100. Angka positif menyesuaikan ke arah angka merah dan negatif menyesuaikan ke arah hijau. Nol berarti tidak ada penyesuaian warna.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	wingdi.h (sertakan Windows.h)