Fungsi SHGetInverseCMAP (shlwapi.h)

Artikel
03/02/2024

[Fungsi ini tersedia melalui Windows XP dan Windows Server 2003. Ini mungkin diubah atau tidak tersedia dalam versi Windows berikutnya.]

Mengambil pemetaan tabel warna terbalik untuk palet halftone.

Sintaks

LWSTDAPI SHGetInverseCMAP(
  [out] BYTE  *pbMap,
  [in]  ULONG cbMap
);

Parameter

[out] pbMap

Jenis: BYTE*

Penunjuk ke array BYTEyang menerima pemetaan tabel warna terbalik, atau penunjuk ke LPBYTE yang menerima penunjuk ke salinan cache pemetaan tabel warna terbalik, tergantung pada nilai parameter cbMap .

[in] cbMap

Jenis: ULONG

Ukuran buffer yang diacu oleh pbMap, yang juga mendefinisikan kontennya. Dua nilai dikenali.

(sizeof(BYTE*))

Buffer yang ditujukkan oleh pbMap menerima penunjuk ke salinan cache tabel peta warna terbalik.

(32768)

Buffer yang ditujukkan oleh pbMap menerima salinan tabel peta warna terbalik. Buffer harus berukuran tepat 32.768 byte.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Tabel pemetaan warna terbalik adalah tabel 32.768 byte. Ini berisi indeks warna di palet halftone. Setiap indeks disimpan pada posisi dalam buffer yang sesuai dengan nilai RGB tertentu yang dinyatakan dalam format 555. Pasangan ini memungkinkan Anda menemukan warna di palet halftone yang merupakan perkiraan dekat dari warna asli.

Misalnya, metode untuk menentukan warna di palet halftone yang merupakan perkiraan dekat untuk warna #306040 adalah sebagai berikut:

Menguraikan warna menjadi komponen merah, hijau, dan biru. Dalam hal ini, komponen merah 0x30, komponen hijau 0x60 dan komponen biru 0x40.
Menyusun ulang warna ke dalam format 555. Rumus untuk mengurangi warna RGB 24-bit menjadi format 555 diperlihatkan di sini.
```
((red / 8) << 10) + ((blue / 8) << 5) + (green / 8)
```
Dalam contoh ini, nilai dalam format 555 adalah ((0x30 / 8) 10) << + ((0x60 / 8) 5) << + (0x40 / 8) = 6536.
Nilai indeks yang disimpan di posisi 6536 dalam tabel peta warna terbalik adalah indeks warna di palet halftone yang merupakan perkiraan yang wajar untuk warna #306040.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 5.0 atau yang lebih baru)

Lihat juga

CreateHalftonePalette

GetNearestColor

Bagikan melalui