Metode ID2D1SpriteBatch::GetSprites (d2d1_3.h)

Mengambil subset sprite yang ditentukan dari batch sprite ini. Untuk performa terbaik, gunakan nullptr untuk properti yang tidak perlu Anda ambil.

Sintaks

HRESULT GetSprites(
                  UINT32            startIndex,
                  UINT32            spriteCount,
  [out, optional] D2D1_RECT_F       *destinationRectangles,
  [out, optional] D2D1_RECT_U       *sourceRectangles,
  [out, optional] D2D1_COLOR_F      *colors,
  [out, optional] D2D1_MATRIX_3X2_F *transforms
);

Parameter

startIndex

Jenis: UINT32

Indeks sprite pertama dalam batch sprite ini untuk diambil.

spriteCount

Jenis: UINT32

Jumlah sprite yang akan diambil.

[out, optional] destinationRectangles

Jenis: D2D1_RECT_F*

Ketika metode ini kembali, berisi penunjuk ke array yang berisi persegi panjang tujuan untuk sprite yang diambil.

[out, optional] sourceRectangles

Jenis: D2D1_RECT_U*

Ketika metode ini kembali, berisi penunjuk ke array yang berisi persegi panjang sumber untuk sprite yang diambil.

InfiniteRectU dikembalikan untuk sprite apa pun yang tidak diberi persegi sumber.

[out, optional] colors

Jenis: D2D1_COLOR_F*

Ketika metode ini kembali, berisi penunjuk ke array yang berisi warna yang akan diterapkan ke sprite yang diambil.

Warna {1.0f, 1.0f, 1.0f, 1.0f} dikembalikan untuk setiap sprite yang tidak diberi warna.

[out, optional] transforms

Jenis: D2D1_MATRIX_3X2_F*

Ketika metode ini kembali, berisi penunjuk ke array yang berisi transformasi yang akan diterapkan ke sprite yang diambil.

Matriks identitas dikembalikan untuk sprite apa pun yang tidak diberi transformasi.

Mengembalikan nilai

Jenis: HRESULT

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

Persyaratan

Target Platform	Windows
Header	d2d1_3.h
Pustaka	D2d1.lib
DLL	D2d1.dll

Lihat juga

ID2D1SpriteBatch