METODE ID2D1RenderTarget::CreateCompatibleRenderTarget(D2D1_SIZE_F,D2D1_SIZE_U,D2D1_PIXEL_FORMAT,ID2D1BitmapRenderTarget**) (d2d1.h)

  • Artikel

Membuat target render bitmap untuk digunakan selama gambar di luar layar menengah yang kompatibel dengan target render saat ini.

Sintaks

HRESULT CreateCompatibleRenderTarget(
  D2D1_SIZE_F             desiredSize,
  D2D1_SIZE_U             desiredPixelSize,
  D2D1_PIXEL_FORMAT       desiredFormat,
  ID2D1BitmapRenderTarget **bitmapRenderTarget
);

Parameter

desiredSize

Jenis: [in] D2D1_SIZE_F

Ukuran target render baru yang diinginkan (dalam piksel independen perangkat), jika harus berbeda dari target render asli. Untuk informasi selengkapnya, lihat bagian Keterangan.

desiredPixelSize

Jenis: [in] D2D1_SIZE_U

Ukuran target render baru yang diinginkan dalam piksel jika harus berbeda dari target render asli. Untuk informasi lebih lanjut, lihat bagian Keterangan.

desiredFormat

Jenis: [in] D2D1_PIXEL_FORMAT

Format piksel dan mode alfa yang diinginkan dari target render baru. Jika format piksel diatur ke DXGI_FORMAT_UNKNOWN, target render baru menggunakan format piksel yang sama dengan target render asli. Jika mode alfa D2D1_ALPHA_MODE_UNKNOWN, mode alfa dari target render baru default ke D2D1_ALPHA_MODE_PREMULTIPLIED. Untuk informasi tentang format piksel yang didukung, lihat Format Piksel yang Didukung dan Mode Alfa.

bitmapRenderTarget

Jenis: [out] ID2D1BitmapRenderTarget**

Ketika metode ini kembali, berisi penunjuk ke penunjuk ke target render bitmap baru. Parameter ini diteruskan tanpa diinisialisasi.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Ukuran piksel dan DPI target render baru dapat diubah dengan menentukan nilai untuk desiredSize atau desiredPixelSize.

  • Jika desiredSize ditentukan tetapi desiredPixelSize tidak, ukuran piksel dihitung dari ukuran yang diinginkan menggunakan DPI target induk. Jika peta desiredSize ke ukuran integer-pixel, DPI dari target render yang kompatibel sama dengan DPI target induk. Jika peta desiredSize ke ukuran fractional-pixel, ukuran piksel dibulatkan ke bilangan bulat terdekat dan DPI untuk target render yang kompatibel sedikit lebih tinggi dari DPI target render induk. Dalam semua kasus, peta koordinat (desiredSize.width, desiredSize.height) ke sudut kanan bawah target render yang kompatibel.
  • Jika desiredPixelSize ditentukan dan desiredSize tidak, DPI dari target render baru sama dengan target render asli.
  • Jika desiredSize dan desiredPixelSize ditentukan, DPI dari target render baru dihitung untuk memperhitungkan perbedaan skala.
  • Jika tidak ada desiredSize atau desiredPixelSize yang ditentukan, ukuran target render baru dan DPI cocok dengan target render asli.

Target render bitmap yang dibuat oleh metode ini tidak kompatibel dengan GDI.

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