Fungsi DrvDitherColor (winddi.h)

Artikel
03/13/2024

Fungsi DrvDitherColor meminta perangkat untuk membuat kuas yang dialihkan terhadap palet perangkat.

Sintaks

ULONG DrvDitherColor(
  [in]      DHPDEV dhpdev,
  [in]      ULONG  iMode,
  [in]      ULONG  rgb,
  [in, out] ULONG  *pul
);

Parameter

[in] dhpdev

Tangani ke struktur PDEV yang menjelaskan perangkat fisik terhadap yang paletnya warna yang ditentukan harus diteruskan.

[in] iMode

Menentukan palet yang akan dialihkan. Parameter ini bisa menjadi salah satu nilai berikut:

Nilai	Makna
DM_DEFAULT	Driver harus membuat dither untuk ruang warna asli dan default perangkat. Misalnya, jika perangkat berjalan pada 16bpp, dither yang dihasilkan harus dalam format 16bpp.
DM_MONOCHROME	Driver harus membuat dither untuk ruang warna monokrom; artinya, dither harus dikembalikan sebagai bitmap 1bpp.

[in] rgb

Menentukan warna RGB yang akan dialihkan.

[in, out] pul

Arahkan ke lokasi memori yang menerima informasi dithering. Memori harus dialokasikan untuk bitmap format standar dengan dimensi kuas terlarut cxDither oleh cyDither. Dimensi ini adalah anggota struktur DEVINFO . Format bitmap ditentukan oleh anggota iDitherFormat dari struktur DEVINFO.

Mengembalikan nilai

Nilai yang dikembalikan DCR_DRIVER jika nilai dither telah dihitung oleh driver, DCR_SOLID jika mesin harus menggunakan perkiraan warna solid terbaik dari warna, atau DCR_HALFTONE jika mesin harus membuat perkiraan halftone untuk driver.

Keterangan

Hasil dari dither adalah sekumpulan indeks warna perangkat yang disimpan dalam pul. Kuas yang dibuat menggunakan warna-warna ini untuk polanya harus menjadi perkiraan yang baik dari rgb warna yang diberikan.

DrvDitherColor adalah fungsi opsional yang dipanggil hanya jika cxDither dan cyDither bukan nol. Driver perangkat monokrom, termasuk sebagian besar printer raster, harus menggunakan parameter iMode untuk memberi tahu GDI cara mendapatkan pola skala abu-abu yang baik.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	winddi.h (termasuk Winddi.h)

Lihat juga

DEVINFO

DrvEnablePDEV

Bagikan melalui