Struktur COLORINFO (winddi.h)

Artikel
08/27/2023

Struktur COLORINFO mendefinisikan warna perangkat dalam ruang koordinat CIE .

Sintaks

typedef struct _COLORINFO {
  CIECHROMA Red;
  CIECHROMA Green;
  CIECHROMA Blue;
  CIECHROMA Cyan;
  CIECHROMA Magenta;
  CIECHROMA Yellow;
  CIECHROMA AlignmentWhite;
  LDECI4    RedGamma;
  LDECI4    GreenGamma;
  LDECI4    BlueGamma;
  LDECI4    MagentaInCyanDye;
  LDECI4    YellowInCyanDye;
  LDECI4    CyanInMagentaDye;
  LDECI4    YellowInMagentaDye;
  LDECI4    CyanInYellowDye;
  LDECI4    MagentaInYellowDye;
} COLORINFO, *PCOLORINFO;

Anggota

Red

Green

Blue

Cyan

Magenta

Yellow

AlignmentWhite

Tentukan struktur CIECHROMA yang masing-masing mendefinisikan koordinat x, koordinat y, dan koordinat Y (luminance) dari warna bernama.

Anggota Cyan dapat memiliki arti khusus untuk printer monokrom. Cyan.Y harus diatur ke 65534 (0xFFFE) untuk mengaktifkan semua ukuran pola halftone skala abu-abu. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

RedGamma

GreenGamma

BlueGamma

Adalah koreksi gamma perangkat tampilan yang memungkinkan perangkat tampilan menampilkan warna di antara warna utama dengan akurasi. Nilai anggota ini harus berkisar antara 0 hingga 6,5535, yang berarti bahwa angka yang benar-benar disimpan dalam anggota ini harus dalam rentang 0 hingga 65535. Untuk informasi selengkapnya tentang anggota ini dan jenis data ini, lihat bagian Keterangan berikut ini.

MagentaInCyanDye

YellowInCyanDye

CyanInMagentaDye

YellowInMagentaDye

CyanInYellowDye

MagentaInYellowDye

Digunakan untuk mencetak perangkat untuk menggambarkan kemurnian warna dan konsentrasi. Nilai harus antara nol dan satu, yang berarti bahwa angka yang benar-benar disimpan dalam anggota ini harus dalam rentang 0 hingga 10000. Untuk informasi selengkapnya tentang jenis data ini, lihat bagian Keterangan berikut ini.

Keterangan

Jenis LDECI4 digunakan untuk mewakili angka riil ke empat tempat desimal. Misalnya, (LDECI4) 10000 mewakili angka riil 1.0000, dan (LDECI4) -12345 mewakili -1,2345.

Untuk printer monokrom, jika Anda mengatur luminance untuk anggota Cyan (yaitu, Cyan.Y) ke 65534 (0xFFFE), Anda dapat memilih salah satu ukuran pola halftone yang tersedia. Untuk memilih ukuran pola halftone untuk printer monokrom, atur anggota ulHTPatternSize dari struktur GDIINFO ke ukuran pola halftone yang Anda inginkan. Jika Cyan.Y tidak diatur ke 65534 (0xFFFE), ukuran pola halftone selain HT_PATSIZE_8x8_M atau HT_PATSIZE_8x8 dikonversi ke HT_PATSIZE_DEFAULT.

Mengatur anggota RedGamma, BlueGamma, dan GreenGamma dari struktur ini ke 0xFFFF dapat memengaruhi manajemen warna pada printer ketika Image Color Management (ICM) dinonaktifkan. Dalam situasi ini, modul halftone GDI beralih dari melakukan manajemen warnanya sendiri menjadi tidak ada, yang berpotensi menyebabkan perubahan signifikan dalam output printer yang dihasilkan. Ketika ICM diaktifkan (dan RedGamma, BlueGamma, dan GreenGamma diatur ke 0XFFFF), tidak ada perbedaan dalam output warna. Untuk informasi selengkapnya, lihat Manajemen Warna untuk Printer.

Nilai apa pun dalam struktur COLORINFO yang berada di luar rentang yang ditentukan default ke nilai NTSC.