Struktur LOGCOLORSPACEW (wingdi.h)

Artikel
03/08/2023

Struktur LOGCOLORSPACE berisi informasi yang menentukan ruang warna logis.

Sintaks

typedef struct tagLOGCOLORSPACEW {
  DWORD         lcsSignature;
  DWORD         lcsVersion;
  DWORD         lcsSize;
  LCSCSTYPE     lcsCSType;
  LCSGAMUTMATCH lcsIntent;
  CIEXYZTRIPLE  lcsEndpoints;
  DWORD         lcsGammaRed;
  DWORD         lcsGammaGreen;
  DWORD         lcsGammaBlue;
  WCHAR         lcsFilename[MAX_PATH];
} LOGCOLORSPACEW, *LPLOGCOLORSPACEW;

Anggota

lcsSignature

Tanda tangan ruang warna. Saat ini, anggota ini harus selalu diatur ke LCS_SIGNATURE.

lcsVersion

Nomor versi; harus 0x400.

lcsSize

Ukuran struktur ini, dalam byte.

lcsCSType

Jenis ruang warna. Anggota bisa menjadi salah satu nilai berikut.

Nilai	Makna
LCS_CALIBRATED_RGB	Nilai warna dikalibrasi nilai RGB. Nilai diterjemahkan menggunakan titik akhir yang ditentukan oleh anggota lcsEndpoints sebelum diteruskan ke perangkat.
LCS_sRGB	Nilai warna adalah nilai adalah nilai sRGB.
LCS_WINDOWS_COLOR_SPACE	Nilai warna adalah nilai warna warna default Windows.

Jika LCS_CALIBRATED_RGB tidak ditentukan, anggota lcsEndpoints diabaikan.

lcsIntent

Metode pemetaan gamut. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Niat	Nama ICC	Makna
LCS_GM_ABS_ COLORIMETRIC	Cocok	Colorimetric Absolut	Pertahankan titik putih. Cocokkan warna dengan warna terdekatnya di gamut tujuan.
LCS_GM_ BISNIS	Graphic	Saturasi	Menjaga kejenuhan. Digunakan untuk bagan bisnis dan situasi lain di mana warna yang tidak terkait diperlukan.
LCS_GM_ GRAFIS	Bukti	Colorimetric Relatif	Pertahankan kecocokan colorimetric. Digunakan untuk desain grafis dan warna bernama.
LCS_GM_ GAMBAR	Gambar	Persepsi	Pertahankan kontras. Digunakan untuk foto dan gambar alami.

lcsEndpoints

Titik akhir merah, hijau, biru.

lcsGammaRed

Skala koordinat merah.

lcsGammaGreen

Skala koordinat hijau.

lcsGammaBlue

Skala koordinat biru.

lcsFilename[MAX_PATH]

String yang dihentikan null yang memberi nama file profil warna. Anggota ini biasanya diatur ke nol, tetapi dapat digunakan untuk mengatur ruang warna agar persis seperti yang ditentukan oleh profil warna. Ini berguna untuk perangkat yang memasukkan nilai warna untuk printer tertentu, atau saat menggunakan pencocok warna gambar yang dapat diinstal. Jika profil warna ditentukan, semua anggota lain dari struktur ini harus diatur ke nilai yang wajar, bahkan jika nilainya tidak sepenuhnya akurat.

Keterangan

Seperti palet, tetapi tidak seperti pena dan kuas, pointer harus diteruskan saat membuat LogColorSpace.

Jika anggota lcsCSType diatur ke LCS_sRGB atau LCS_WINDOWS_COLOR_SPACE, anggota lain dari struktur ini diabaikan, dan WCS menggunakan ruang warna sRGB. Anggota lcsEndpoints,lcsGammaRed, lcsGammaGreen, dan lcsGammaBlue digunakan untuk menggambarkan ruang warna logis. Anggota lcsEndpoints adalah CIEXYZTRIPLE yang berisi nilai x, y, dan z dari titik akhir RGB ruang warna.

Format bit DWORD yang diperlukan untuk lcsGammaRed, lcsGammaGreen, dan lcsGammaBlue adalah bilangan bulat titik tetap 8,8 yang digeser ke kiri oleh 8 bit. Ini berarti 8 bit bilangan bulat diikuti oleh 8 bit pecahan. Dengan mempertimbangkan pergeseran bit, format DWORD 32-bit yang diperlukan adalah:

00000000nnnnnnnnffffffffff000000000

Setiap kali anggota lcsFilename berisi nama file dan anggota lcsCSType diatur ke LCS_CALIBRATED_RGB, WCS mengabaikan anggota lain dari struktur ini. Ini menggunakan ruang warna dalam file sebagai ruang warna yang dirujuk oleh struktur LOGCOLORSPACE ini.

Hubungan antara nilai tri-stimulus X,Y,Z dan nilai kromatikitas x,y,z adalah sebagai berikut:

x = X/(X+Y+Z)

y = Y/(X+Y+Z)

z = Z/(X+Y+Z)

Jika anggota lcsCSType diatur ke LCS_sRGB atau LCS_WINDOWS_COLOR_SPACE, anggota lain dari struktur ini diabaikan, dan ICM menggunakan ruang warna sRGB. Aplikasi masih harus menginisialisasi sisa struktur karena CreateProfileFromLogColorSpace mengabaikan anggota lcsCSType dan menggunakan lcsEndpoints, lcsGammaRed, lcsGammaGreen, lcsGammaBlue anggota untuk membuat profil, yang mungkin tidak diinisialisasi jika LCS_sRGB atau LCS_WINDOWS_COLOR_SPACE ruang warna.

Catatan

Header wingdi.h mendefinisikan LOGCOLORSPACE sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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

Lihat juga

Bagikan melalui