Bagikan melalui

Struktur DDCOLORCONTROL (ddraw.h)

  • Artikel

Struktur DDCOLORCONTROL menentukan kontrol warna yang terkait dengan objek ekstensi port video (VPE) Microsoft DirectDraw.

Sintaks

typedef struct _DDCOLORCONTROL {
  DWORD dwSize;
  DWORD dwFlags;
  LONG  lBrightness;
  LONG  lContrast;
  LONG  lHue;
  LONG  lSaturation;
  LONG  lSharpness;
  LONG  lGamma;
  LONG  lColorEnable;
  DWORD dwReserved1;
} *LPDDCOLORCONTROL, DDCOLORCONTROL;

Anggota

dwSize

Menentukan ukuran dalam byte struktur DDCOLORCONTROL ini.

dwFlags

Menunjukkan sekumpulan bendera yang menentukan anggota struktur apa yang berisi data yang valid. Ketika struktur dikembalikan oleh DdVideoPortColorControl, itu juga menunjukkan opsi apa yang didukung oleh objek VPE. Anggota ini bisa menjadi bitwise ATAU dari nilai yang tercantum dalam tabel berikut.

Bendera Makna

DDCOLOR_BRIGHTNESS

Anggota lBrightness berisi data yang valid.

DDCOLOR_CONTRAST

Anggota lContrast berisi data yang valid.

DDCOLOR_COLORENABLE

Anggota lColorEnable berisi data yang valid.

DDCOLOR_GAMMA

Anggota lGamma berisi data yang valid.

DDCOLOR_HUE

Anggota lHue berisi data yang valid.

DDCOLOR_SATURATION

Anggota lSaturation berisi data yang valid.

DDCOLOR_SHARPNESS

Anggota lSharpness berisi data yang valid.

lBrightness

Menentukan intensitas luminance (Black Level), dalam unit IRE*100. Anggota ini dapat berkisar antara 0 hingga 10.000, dengan nilai default 750 (7,5 IRE).

lContrast

Menentukan perbedaan relatif antara nilai luminans intensitas yang lebih tinggi dan lebih rendah, dalam unit IRE*100. Anggota ini dapat berkisar antara 0 hingga 20.000, dengan nilai default 10.000 (100 IRE). Nilai kontras yang lebih tinggi menyebabkan nilai luminance yang lebih gelap cenderung ke hitam, dan menyebabkan nilai luminance yang lebih terang cenderung ke arah putih. Nilai kontras yang lebih rendah menyebabkan semua nilai luminance bergerak ke arah nilai luminance tengah.

lHue

Menentukan hubungan fase komponen chrominance. Hue ditentukan dalam derajat, dengan rentang yang valid -180 hingga 180. Defaultnya adalah 0 derajat.

lSaturation

Menentukan intensitas warna, dalam unit IRE*100. Anggota ini dapat berkisar antara 0 hingga 20.000, dengan nilai default 10.000 (100 IRE).

lSharpness

Menentukan ketajaman dalam unit arbitrer. Rentang yang valid adalah 0 hingga 10, dengan nilai default 5.

lGamma

Mengontrol jumlah koreksi gamma yang diterapkan pada nilai luminance. Rentang yang valid adalah 1 hingga 500 unit gamma, dengan default 1.

lColorEnable

Menentukan bendera yang menunjukkan apakah warna digunakan. Jika anggota ini nol, warna tidak digunakan; jika 1, maka warna digunakan. Nilai default adalah 1.

dwReserved1

Dicadangkan untuk penggunaan sistem, dan harus diabaikan.

Persyaratan

Persyaratan Nilai
Header ddraw.h

Lihat juga