ID2D1RenderTarget::FillOpacityMask(ID2D1Bitmap*,ID2D1Brush*,D2D1_OPACITY_MASK_CONTENT,constD2D1_RECT_F&,constD2D1_RECT_F&) metode (d2d1.h)

Menerapkan masker opasitas yang dijelaskan oleh bitmap yang ditentukan ke kuas dan menggunakan kuas itu untuk melukis wilayah target render.

Sintaks

void FillOpacityMask(
  [in]  ID2D1Bitmap               *opacityMask,
  [in]  ID2D1Brush                *brush,
        D2D1_OPACITY_MASK_CONTENT content,
  [ref] const D2D1_RECT_F &       destinationRectangle,
  [ref] const D2D1_RECT_F &       sourceRectangle
);

Parameter

[in] opacityMask

Jenis: ID2D1Bitmap*

Masker opasitas untuk diterapkan pada kuas. Nilai alfa setiap piksel di wilayah yang ditentukan oleh sourceRectangle dikalikan dengan nilai alfa kuas setelah kuas dipetakan ke area yang ditentukan oleh destinationRectangle.

[in] brush

Jenis: ID2D1Brush*

Kuas yang digunakan untuk mengecat wilayah target render yang ditentukan oleh destinationRectangle.

content

Jenis: D2D1_OPACITY_MASK_CONTENT

Jenis konten yang dikandung masker opasitas. Nilai digunakan untuk menentukan ruang warna di mana masker opasitas dipadukan.

Catatan Dimulai dengan Windows 8, D2D1_OPACITY_MASK_CONTENT tidak diperlukan. Lihat metode ID2D1DeviceContext::FillOpacityMask , yang tidak memiliki parameter D2D1_OPACITY_MASK_CONTENT .

 

[ref] destinationRectangle

Jenis: const D2D1_RECT_F

Wilayah target render untuk dicat, dalam piksel independen perangkat.

[ref] sourceRectangle

Jenis: const D2D1_RECT_F

Wilayah bitmap yang digunakan sebagai masker opasitas, dalam piksel independen perangkat.

Mengembalikan nilai

Tidak ada

Keterangan

Agar metode ini berfungsi dengan baik, target render harus menggunakan mode antialias D2D1_ANTIALIAS_MODE_ALIASED . Anda dapat mengatur mode antialias dengan memanggil metode ID2D1RenderTarget::SetAntialiasMode .

Metode ini tidak mengembalikan kode kesalahan jika gagal. Untuk menentukan apakah operasi menggambar (seperti FillOpacityMask) gagal, periksa hasil yang dikembalikan oleh metode ID2D1RenderTarget::EndDraw atau ID2D1RenderTarget::Flush .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	d2d1.h
Pustaka	D2d1.lib
DLL	D2d1.dll

Lihat juga

ID2D1RenderTarget