struktur D2D1_RENDER_TARGET_PROPERTIES (d2d1.h)

Artikel
02/26/2024

Berisi opsi penyajian (perangkat keras atau perangkat lunak), format piksel, informasi DPI, opsi jarak jauh, dan persyaratan dukungan Direct3D untuk target render.

Sintaks

typedef struct D2D1_RENDER_TARGET_PROPERTIES {
  D2D1_RENDER_TARGET_TYPE  type;
  D2D1_PIXEL_FORMAT        pixelFormat;
  FLOAT                    dpiX;
  FLOAT                    dpiY;
  D2D1_RENDER_TARGET_USAGE usage;
  D2D1_FEATURE_LEVEL       minLevel;
} D2D1_RENDER_TARGET_PROPERTIES;

Anggota

type

Jenis: D2D1_RENDER_TARGET_TYPE

Nilai yang menentukan apakah target render harus memaksa penyajian perangkat keras atau perangkat lunak. Nilai D2D1_RENDER_TARGET_TYPE_DEFAULT menentukan bahwa target render harus menggunakan penyajian perangkat keras jika tersedia; jika tidak, ia menggunakan penyajian perangkat lunak. Perhatikan bahwa target render bitmap WIC tidak mendukung penyajian perangkat keras.

pixelFormat

Jenis: D2D1_PIXEL_FORMAT

Format piksel dan mode alfa dari target render. Anda dapat menggunakan fungsi D2D1::P ixelFormat untuk membuat format piksel yang menentukan bahwa Direct2D harus memilih format piksel dan mode alfa untuk Anda. Untuk daftar format piksel dan mode alfa yang didukung oleh setiap target render, lihat Format Piksel dan Mode Alfa yang Didukung.

dpiX

Jenis: FLOAT

DPI horizontal dari target render. Untuk menggunakan DPI default, atur dpiX dan dpiY ke 0. Untuk informasi lebih lanjut, lihat bagian Keterangan.

dpiY

Jenis: FLOAT

DPI vertikal dari target render. Untuk menggunakan DPI default, atur dpiX dan dpiY ke 0. Untuk informasi lebih lanjut, lihat bagian Keterangan.

usage

Jenis: D2D1_RENDER_TARGET_USAGE

Nilai yang menentukan bagaimana target render di-remoted dan apakah target tersebut harus kompatibel dengan GDI. Atur ke D2D1_RENDER_TARGET_USAGE_NONE untuk membuat target render yang tidak kompatibel dengan GDI dan menggunakan direct3D command-stream remoting jika tersedia.

minLevel

Jenis: D2D1_FEATURE_LEVEL

Nilai yang menentukan tingkat fitur Direct3D minimum yang diperlukan untuk penyajian perangkat keras. Jika tingkat minimum yang ditentukan tidak tersedia, target render menggunakan penyajian perangkat lunak jika anggota jenis diatur ke D2D1_RENDER_TARGET_TYPE_DEFAULT; jika jenis diatur ke D2D1_RENDER_TARGET_TYPE_HARDWARE, pembuatan target render gagal. Nilai D2D1_FEATURE_LEVEL_DEFAULT menunjukkan bahwa Direct2D harus menentukan apakah tingkat fitur Direct3D perangkat memadai. Bidang ini hanya digunakan saat membuat objek ID2D1HwndRenderTarget dan ID2D1DCRenderTarget .

Keterangan

Gunakan struktur ini saat membuat target render, atau gunakan dengan metode ID2D1RenderTarget::IsSupported untuk memeriksa properti yang didukung oleh target render yang ada.

Sebagai kenyamanan, Direct2D menyediakan fungsi pembantu D2D1::RenderTargetProperties untuk membuat struktur D2D1_RENDER_TARGET_PROPERTIES . Cara mudah untuk membuat struktur D2D1_RENDER_TARGET_PROPERTIES yang berfungsi untuk sebagian besar target render adalah dengan memanggil fungsi tanpa menentukan parameter apa pun. Melakukannya akan membuat struktur D2D1_RENDER_TARGET_PROPERTIES yang bidangnya diatur ke nilai default. Untuk informasi selengkapnya, lihat D2D1::RenderTargetProperties.

Tidak semua target render mendukung penyajian perangkat keras. Untuk daftar, lihat Gambaran Umum Target Render.

Menggunakan Pengaturan DPI Default

Untuk menggunakan DPI default, atur dpiX dan dpiY ke 0. DPI default bervariasi tergantung pada target render:

Untuk target render yang kompatibel, DPI default adalah DPI dari target render induk.
Untuk ID2D1HwndRenderTarget, DPI default adalah DPI sistem yang diperoleh dari ID2D1Factory target render.
Untuk target render lainnya, DPI default adalah 96.

Untuk menggunakan pengaturan DPI default, dpiX dan dpiY harus diatur ke 0. Mengatur hanya satu nilai ke 0 menyebabkan kesalahan E_INVALIDARG saat mencoba membuat target render.

Contoh

Contoh berikut menggunakan fungsi D2D1::RenderTargetProperties untuk membuat struktur D2D1_RENDER_TARGET_PROPERTIES yang cocok untuk sebagian besar target render.

RECT rc;
GetClientRect(m_hwnd, &rc);

D2D1_SIZE_U size = D2D1::SizeU(
    rc.right - rc.left,
    rc.bottom - rc.top
    );

// Create a Direct2D render target.
hr = m_pD2DFactory->CreateHwndRenderTarget(
    D2D1::RenderTargetProperties(),
    D2D1::HwndRenderTargetProperties(m_hwnd, size),
    &m_pRenderTarget
    );

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

Lihat juga

ID2D1RenderTarget::IsSupported

Gambaran Umum Target Render

Share via