Fungsi TranslateBitmapBits (icm.h)

Artikel
08/24/2023

Menerjemahkan warna bitmap yang memiliki format yang ditentukan sehingga menghasilkan bitmap lain dalam format yang diminta.

Sintaks

BOOL TranslateBitmapBits(
  HTRANSFORM    hColorTransform,
  PVOID         pSrcBits,
  BMFORMAT      bmInput,
  DWORD         dwWidth,
  DWORD         dwHeight,
  DWORD         dwInputStride,
  PVOID         pDestBits,
  BMFORMAT      bmOutput,
  DWORD         dwOutputStride,
  PBMCALLBACKFN pfnCallBack,
  LPARAM        ulCallbackData
);

Parameter

hColorTransform

Mengidentifikasi transformasi warna yang akan digunakan.

pSrcBits

Arahkan ke bitmap untuk diterjemahkan.

bmInput

Menentukan format bitmap input. Harus diatur ke salah satu nilai jenis enumerasi BMFORMAT .

Catatan

Fungsi ini tidak mendukung BM_XYZTRIPLETS atau BM_YxyTRIPLETS sebagai input.

dwWidth

Menentukan jumlah piksel per baris pemindaian dalam bitmap input.

dwHeight

Menentukan jumlah baris pemindaian dalam bitmap input.

dwInputStride

Menentukan jumlah byte dari awal satu baris pemindaian ke awal baris berikutnya dalam bitmap input; jika diatur ke nol, fungsi mengasumsikan bahwa garis pemindaian diisi sehingga selaras dengan DWORD.

pDestBits

Arahkan ke buffer untuk menempatkan bitmap yang diterjemahkan.

bmOutput

Menentukan format bitmap output. Harus diatur ke salah satu nilai jenis enumerasi BMFORMAT .

dwOutputStride

Menentukan jumlah byte dari awal satu baris pemindaian ke awal baris berikutnya dalam bitmap output; jika diatur ke nol, fungsi mengasumsikan bahwa garis pemindaian harus diisi agar selaras dengan DWORD.

pfnCallBack

Penunjuk ke fungsi panggilan balik yang disebut secara berkala oleh TranslateBitmapBits untuk melaporkan kemajuan dan memungkinkan proses panggilan untuk membatalkan terjemahan. (Lihat ICMProgressProcCallback )

ulCallbackData

Data diteruskan kembali ke fungsi panggilan balik, misalnya, untuk mengidentifikasi terjemahan yang melaporkan kemajuan.

Mengembalikan nilai

Jika fungsi ini berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi ini gagal, nilai yang dikembalikan adalah FALSE. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

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

Ketika salah satu dari titik mengambang BMFORMATs, BM_32b_scARGB atau BM_32b_scRGB digunakan, data warna yang diterjemahkan tidak boleh berisi NaN atau tak terbatas. NaN dan infinity tidak dianggap mewakili nilai komponen warna yang sah, dan hasil penerjemahan piksel yang berisi NaN atau infinity tidak berarti dalam istilah warna. Nilai NaN atau tak terbatas dalam data warna yang sedang diproses akan ditangani secara diam-diam, dan kesalahan tidak akan dikembalikan.

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
Pustaka	Mscms.lib
DLL	Mscms.dll

Bagikan melalui