ID2D1SpriteBatch::GetSprites-Methode (d2d1_3.h)

  • Artikel

Ruft die angegebene Teilmenge von Sprites aus diesem Spritebatch ab. Um die beste Leistung zu erzielen, verwenden Sie nullptr für Eigenschaften, die Sie nicht abrufen müssen.

Syntax

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

Typ: UINT32

Der Index des ersten sprite-Batches, der abgerufen werden soll.

spriteCount

Typ: UINT32

Die Anzahl der abzurufenden Sprites.

[out, optional] destinationRectangles

Typ: D2D1_RECT_F*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein Array, das die Zielrechtecke für die abgerufenen Sprites enthält.

[out, optional] sourceRectangles

Typ: D2D1_RECT_U*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein Array, das die Quellrechtecke für die abgerufenen Sprites enthält.

InfiniteRectU wird für alle Sprites zurückgegeben, denen kein Quellrechteck zugewiesen wurde.

[out, optional] colors

Typ: D2D1_COLOR_F*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein Array, das die Farben enthält, die auf die abgerufenen Sprites angewendet werden sollen.

Die Farbe {1.0f, 1.0f, 1.0f, 1.0f} wird für alle Sprites zurückgegeben, denen keine Farbe zugewiesen wurde.

[out, optional] transforms

Typ: D2D1_MATRIX_3X2_F*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein Array, das die Transformationen enthält, die auf die abgerufenen Sprites angewendet werden sollen.

Die Identitätsmatrix wird für alle Sprites zurückgegeben, denen keine Transformation zugewiesen wurde.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

   
Zielplattform Windows
Kopfzeile d2d1_3.h
Bibliothek D2d1.lib
DLL D2d1.dll

Weitere Informationen

ID2D1SpriteBatch