METODE ID2D1RenderTarget::CreateCompatibleRenderTarget(D2D1_SIZE_F,D2D1_SIZE_U,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,
  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.

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 ini 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 piksel bilangan bulat, DPI target render yang kompatibel sama dengan DPI target induk. Jika desiredSize memetakan ke ukuran fraksional-piksel, ukuran piksel dibulatkan ke bilangan bulat terdekat dan DPI untuk target render yang kompatibel sedikit lebih tinggi daripada 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 target render baru dihitung untuk memperhitungkan perbedaan skala.
  • Jika desiredSize atau desiredPixelSize tidak 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