Struktur LOGCOLORSPACEA (wingdi.h)
Struktur LOGCOLORSPACE berisi informasi yang menentukan ruang warna logis.
Sintaks
typedef struct tagLOGCOLORSPACEA {
DWORD lcsSignature;
DWORD lcsVersion;
DWORD lcsSize;
LCSCSTYPE lcsCSType;
LCSGAMUTMATCH lcsIntent;
CIEXYZTRIPLE lcsEndpoints;
DWORD lcsGammaRed;
DWORD lcsGammaGreen;
DWORD lcsGammaBlue;
CHAR lcsFilename[MAX_PATH];
} LOGCOLORSPACEA, *LPLOGCOLORSPACEA;
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_ |
Cocok | Colorimetric Absolut | Pertahankan titik putih. Cocokkan warna dengan warna terdekatnya di gamut tujuan. |
LCS_GM_ |
Graphic | Saturasi | Menjaga kejenuhan. Digunakan untuk bagan bisnis dan situasi lain di mana warna yang tidak terkait diperlukan. |
LCS_GM_ |
Bukti | Colorimetric Relatif | Pertahankan kecocokan colorimetric. Digunakan untuk desain grafis dan warna bernama. |
LCS_GM_ |
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk