struktur D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES (d2d1.h)

Artikel
05/03/2025

Berisi titik awal dan titik akhir sumbu gradien untuk ID2D1LinearGradientBrush.

Sintaksis

typedef struct D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES {
  D2D1_POINT_2F startPoint;
  D2D1_POINT_2F endPoint;
} D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES;

Anggota

startPoint

Jenis: D2D1_POINT_2F

Di ruang koordinat kuas, titik awal sumbu gradien.

endPoint

Jenis: D2D1_POINT_2F

Di ruang koordinat kuas, titik akhir sumbu gradien.

Komentar

Gunakan metode ini saat membuat objek ID2D1LinearGradientBrush baru dengan metode CreateLinearGradientBrush. Untuk kenyamanan, Direct2D menyediakan D2D1::LinearGradientBrushProperties fungsi pembantu untuk membuat struktur D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES baru.

Ilustrasi berikut menunjukkan bagaimana gradien linier berubah saat Anda mengubah titik awal dan akhirnya. Untuk gradien pertama, titik awal diatur ke (0,0) dan titik akhir ke (150, 50); ini menciptakan gradien diagonal yang dimulai di sudut kiri atas dan meluas ke sudut kanan bawah area yang dicat. Saat Anda mengatur titik awal ke (0, 25) dan titik akhir ke (150, 25), gradien horizontal dibuat. Demikian pula, mengatur titik awal ke (75, 0) dan titik akhir ke (75, 50) membuat gradien vertikal. Mengatur titik awal ke (0, 50) dan titik akhir ke (150, 0) membuat gradien diagonal yang dimulai di sudut kiri bawah dan meluas ke sudut kanan atas area yang dicat.

Ilustrasi empat gradien dengan sumbu yang berbeda

Contoh

Contoh berikut menggunakan metode CreateLinearGradientBrush untuk membuat ID2D1LinearGradientBrush (m_pLinearGradientBrush). Ini menggunakan metode D2D1::LinearGradientBrushProperties helper untuk membuat struktur D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES yang berisi titik awal (0, 0) dan titik akhir (150, 150) dan meneruskannya ke metode CreateLinearGradientBrush.

// The line that determines the direction of the gradient starts at
// the upper-left corner of the square and ends at the lower-right corner.

if (SUCCEEDED(hr))
{
    hr = m_pRenderTarget->CreateLinearGradientBrush(
        D2D1::LinearGradientBrushProperties(
            D2D1::Point2F(0, 0),
            D2D1::Point2F(150, 150)),
        pGradientStops,
        &m_pLinearGradientBrush
        );
}

Untuk informasi selengkapnya tentang membuat dan menggunakan kuas gradien linier, lihat Cara Membuat topik Sikat Gradien Linear dan Gambaran Umum Brush .

Persyaratan

Syarat	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]
Header	d2d1.h

Lihat juga

Gambaran Umum Brush

Cara Membuat Sikat Gradien Linier

Bagikan melalui