Metode ID2D1SpriteBatch::SetSprites (d2d1_3.h)

Updates properti sprite yang ditentukan dalam batch sprite ini. Memberikan nilai null untuk properti apa pun akan membuat properti tersebut tidak dimodifikasi untuk sprite tersebut.

Sintaks

HRESULT SetSprites(
                 UINT32                  startIndex,
                 UINT32                  spriteCount,
  [in, optional] const D2D1_RECT_F       *destinationRectangles,
  [in, optional] const D2D1_RECT_U       *sourceRectangles,
  [in, optional] const D2D1_COLOR_F      *colors,
  [in, optional] const D2D1_MATRIX_3X2_F *transforms,
                 UINT32                  destinationRectanglesStride,
                 UINT32                  sourceRectanglesStride,
                 UINT32                  colorsStride,
                 UINT32                  transformsStride
);

Parameter

startIndex

Jenis: UINT32

Indeks sprite pertama dalam batch sprite ini untuk diperbarui.

spriteCount

Jenis: UINT32

Jumlah sprite yang akan diperbarui dengan properti baru. Ini menentukan berapa banyak langkah ke dalam setiap array direct2D yang diberikan akan dibaca.

[in, optional] destinationRectangles

Jenis: const D2D1_RECT_F*

Penunjuk ke array yang berisi persegi panjang tujuan yang menentukan tempat untuk menggambar sprite pada konteks perangkat tujuan.

[in, optional] sourceRectangles

Jenis: const D2D1_RECT_U*

Penunjuk ke array yang berisi persegi panjang sumber yang menentukan wilayah bitmap sumber untuk digambar sebagai sprite.

Direct2D akan menggunakan seluruh bitmap sumber untuk sprite yang diberi nilai null atau InfiniteRectU. Jika parameter ini dihilangkan sepenuhnya atau diatur ke nilai null, maka Direct2D akan menggunakan seluruh bitmap sumber untuk semua sprite yang diperbarui.

[in, optional] colors

Jenis: const D2D1_COLOR_F*

Penunjuk ke array yang berisi warna untuk diterapkan ke setiap sprite. Warna output adalah hasil perkalian komponen dari warna bitmap sumber dan warna yang disediakan. Warna output tidak dijepit.

Direct2D tidak akan mengubah warna sprite yang diberi nilai null. Jika parameter ini dihilangkan sepenuhnya atau diatur ke nilai null, maka Direct2D tidak akan mengubah warna sprite yang diperbarui.

[in, optional] transforms

Jenis: const D2D1_MATRIX_3X2_F*

Penunjuk ke array yang berisi transformasi untuk diterapkan ke setiap persegi tujuan sprite.

Direct2D tidak akan mengubah persegi panjang tujuan dari sprite apa pun yang diberi nilai null. Jika parameter ini dihilangkan sepenuhnya atau diatur ke nilai null, maka Direct2D tidak akan mengubah persegi panjang tujuan dari salah satu sprite yang diperbarui.

destinationRectanglesStride

Jenis: UINT32

Menentukan jarak, dalam byte, antara setiap persegi panjang dalam array destinationRectangles. Jika Anda memberikan langkah 0, persegi panjang tujuan yang sama akan digunakan untuk setiap sprite yang diperbarui.

sourceRectanglesStride

Jenis: UINT32

Menentukan jarak, dalam byte, antara setiap persegi panjang dalam array sourceRectangles (jika array tersebut diberikan). Jika Anda memberikan langkah 0, maka persegi panjang sumber yang sama akan digunakan untuk setiap sprite yang diperbarui.

colorsStride

Jenis: UINT32

Menentukan jarak, dalam byte, di antara setiap warna dalam array warna (jika array tersebut diberikan). Jika Anda memberikan langkah 0, maka warna yang sama akan digunakan untuk setiap sprite yang diperbarui.

transformsStride

Jenis: UINT32

Menentukan jarak, dalam byte, antara setiap transformasi dalam array transformasi (jika array tersebut diberikan). Jika Anda memberikan langkah 0, maka transformasi yang sama akan digunakan untuk setiap sprite yang diperbarui.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK pada keberhasilan. Mengembalikan E_INVALIDARG jika nilai yang tidak valid diteruskan ke metode . Dalam hal ini, tidak ada sprite yang dimodifikasi oleh panggilan ini ke SetSprites.

Persyaratan

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

Lihat juga

ID2D1SpriteBatch