Struktur XLATEOBJ (winddi.h)
Struktur XLATEOBJ digunakan untuk menerjemahkan indeks warna dari satu palet ke palet lainnya.
Sintaks
typedef struct _XLATEOBJ {
ULONG iUniq;
FLONG flXlate;
USHORT iSrcType;
USHORT iDstType;
ULONG cEntries;
ULONG *pulXlate;
} XLATEOBJ;
Anggota
iUniq
Pengidentifikasi cache yang memungkinkan driver mengenali struktur XLATEOBJ yang sebelumnya telah di-cache. Jika anggota ini nol, driver tidak boleh menyimpan struktur XLATEOBJ.
flXlate
Bendera yang menentukan petunjuk tentang terjemahan. Anggota ini bisa berupa kombinasi apa pun dari nilai berikut:
| Nilai | Makna |
|---|---|
| XO_DEVICE_ICM | ICM diaktifkan pada perangkat. Driver harus menerjemahkan warna sesuai dengan transformasi warna yang dibuat oleh DrvIcmCreateColorTransform. Driver harus memanggil XLATEOBJ_hGetColorTransform untuk mendapatkan handel transformasi warna. Bit ini saling eksklusif dari XO_HOST_ICM. |
| XO_FROM_CMYK | Sebagai hasil dari terjemahan ICM, indeks sumber diterjemahkan ke format warna CMYK 32-bit. Ketika bit ini diatur, iSrcType, iDstType, cEntries, dan pulXlate harus diabaikan. |
| XO_HOST_ICM | ICM dilakukan oleh mesin grafis, sehingga warna dalam tabel warna ini dikoreksi ke permukaan target. Bit ini diatur oleh GDI sebagai informasi untuk driver: tidak ada tindakan yang diperlukan oleh driver. Bit ini saling eksklusif dari XO_DEVICE_ICM. |
| XO_TABLE | Tabel disediakan untuk menerjemahkan indeks sumber ke indeks target. |
| XO_TO_MONO | Indeks sumber diterjemahkan ke format monokrom dengan properti khusus yang semua indeks petakan ke nol, kecuali satu. Driver dapat menggunakan ini untuk mempercepat transfer blok. |
| XO_TRIVIAL | Indeks sumber dapat digunakan sebagai indeks target. |
iSrcType
Sudah usang. Gunakan XLATEOBJ_cGetPalette untuk mengkueri format sumber.
iDstType
Sudah usang. Gunakan XLATEOBJ_cGetPalette untuk mengkueri format tujuan.
cEntries
Menentukan jumlah entri dalam array yang ditujukkan oleh anggota pulXlate . Pengindeksan ke dalam pulXlate dengan nilai yang lebih besar dari cEntries menghasilkan pelanggaran akses memori.
pulXlate
Penunjuk ke array entri terjemahan.
Keterangan
Palet tujuan selalu milik permukaan tujuan dari beberapa operasi gambar. Palet sumber adalah palet yang dipilih aplikasi atau palet dari permukaan lain.
Struktur XLATEOBJ digunakan untuk menerjemahkan indeks warna yang mengacu pada palet sumber ke indeks untuk palet tujuan. Indeks yang dihasilkan mengidentifikasi warna yang cocok dengan warna sumber sedekat mungkin.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | winddi.h (termasuk Winddi.h) |