Struktur XLATEOBJ (winddi.h)

Artikel
03/13/2024

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.