Antarmuka ID2D1RadialGradientBrush (d2d1.h)

  • Artikel

Melukis area dengan gradien radial.

Warisan

Antarmuka ID2D1RadialGradientBrush mewarisi dari ID2D1Brush. ID2D1RadialGradientBrush juga memiliki jenis anggota berikut:

Metode

Antarmuka ID2D1RadialGradientBrush memiliki metode ini.

 
ID2D1RadialGradientBrush::GetCenter

Mengambil pusat elips gradien.
ID2D1RadialGradientBrush::GetGradientOriginOffset

Mengambil offset asal gradien relatif terhadap pusat elips gradien.
ID2D1RadialGradientBrush::GetGradientStopCollection

Mengambil ID2D1GradientStopCollection yang terkait dengan objek sikat gradien radial ini.
ID2D1RadialGradientBrush::GetRadiusX

Mengambil radius x elips gradien.
ID2D1RadialGradientBrush::GetRadiusy

Mengambil radius y dari elips gradien.
ID2D1RadialGradientBrush::SetCenter

Menentukan pusat elips gradien di ruang koordinat kuas.
ID2D1RadialGradientBrush::SetGradientOriginOffset

Menentukan offset asal gradien relatif terhadap pusat elips gradien.
ID2D1RadialGradientBrush::SetRadiusX

Menentukan radius x elips gradien, di ruang koordinat kuas.
ID2D1RadialGradientBrush::SetRadiusy

Menentukan radius y elips gradien, di ruang koordinat kuas.

Keterangan

ID2D1RadialGradientBrush mirip dengan ID2D1LinearGradientBrush karena keduanya memetakan kumpulan gradien berhenti ke gradien. Namun, gradien linier memiliki titik awal dan akhir untuk menentukan vektor gradien, sementara gradien radial menggunakan elips dan asal gradien untuk menentukan perilaku gradiennya. Untuk menentukan posisi dan ukuran elips, gunakan metode SetCenter, SetRadiusX, dan SetRadiusY untuk menentukan tengah, radius x, dan radius y elips. Asal gradien adalah pusat elips, kecuali offset gradien ditentukan dengan menggunakan metode SetGradientOriginOffset .

Kuas memetakan posisi stop gradien 0,0f dari asal gradien, dan posisi 1,0f dipetakan ke batas elips. Ketika asal gradien berada dalam elips, isi elips mengapit seluruh rentang [0, 1] gradien sikat berhenti. Jika asal gradien berada di luar batas elips, kuas masih berfungsi, tetapi gradiennya tidak terdefinisi dengan baik.

Titik awal dan titik akhir dijelaskan di ruang sikat dan dipetakan ke target render ketika kuas digunakan. Perhatikan bahwa koordinat awal dan akhir bersifat absolut, tidak relatif terhadap ukuran target render. Nilai (0, 0) memetakan ke sudut kiri atas target render, sementara nilai (1, 1) memetakan hanya satu piksel secara diagonal menjauh dari (0, 0). Jika ada transformasi sikat nonidentitas atau transformasi target render, elips sikat dan asal gradien juga diubah.

Dimungkinkan untuk menentukan elips yang tidak sepenuhnya mengisi area yang dicat. Ketika ini terjadi, D2D1_EXTEND_MODE dan pengaturan (ditentukan oleh kuas ID2D1GradientStopCollection) menentukan bagaimana area yang tersisa dicat.

Membuat Objek ID2D1RadialGradientBrush

Untuk membuat kuas gradien radial, gunakan metode ID2D1RenderTarget::CreateRadialGradientBrush dari target render tempat kuas akan digunakan. Kuas hanya dapat digunakan dengan target render yang membuatnya atau dengan target yang kompatibel untuk target render tersebut.

Sikat gradien radial adalah sumber daya yang bergantung pada perangkat: aplikasi Anda harus membuat sikat gradien radial setelah menginisialisasi target render yang akan digunakan kuas, dan membuat ulang kuas setiap kali target render perlu dibuat ulang. (Untuk informasi selengkapnya tentang sumber daya, lihat Gambaran Umum Sumber Daya.)

Contoh

Untuk contoh tentang cara membuat sikat gradien radial, lihat topik Cara Membuat Sikat Gradien Radial .

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

Lihat juga

Gambaran Umum Brush

Cara Membuat Sikat Gradien Radial

ID2D1Brush