Fungsi CMTranslateColors (icm.h)

Artikel
02/27/2024

Menerjemahkan array warna dari ruang warna sumber ke ruang warna tujuan menggunakan transformasi warna.

Sintaks

BOOL CMTranslateColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPCOLOR      lpaOutputColors,
  COLORTYPE    ctOutput
);

Parameter

hcmTransform

Menentukan transformasi warna yang akan digunakan.

lpaInputColors

Menunjuk ke array struktur COLOR untuk diterjemahkan.

nColors

Menentukan jumlah elemen dalam array.

ctInput

Menentukan jenis warna input.

lpaOutputColors

Menunjuk ke buffer tempat array struktur COLOR yang diterjemahkan akan ditempatkan.

ctOutput

Menentukan jenis warna output.

Mengembalikan nilai

Jika fungsi ini berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi ini gagal, nilai yang dikembalikan adalah FALSE. CMM harus memanggil SetLastError untuk mengatur kesalahan terakhir ke nilai kesalahan valid yang ditentukan dalam Winerror.h.

Keterangan

Setiap CMM diperlukan untuk mengekspor fungsi ini.

Jika jenis warna input dan output tidak kompatibel dengan transformasi warna, fungsi ini akan gagal.

Perhatikan bahwa fungsi ini harus mendukung terjemahan di tempat. Artinya, setiap kali jejak memori output kurang dari atau sama dengan jejak memori input, fungsi ini harus dapat menerjemahkan warna bitmap bahkan jika buffer sumber dan tujuan sama.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	icm.h

Bagikan melalui