struktur D2D1_RENDER_TARGET_PROPERTIES (d2d1.h)
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.
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 |