ID2D1SpriteBatch::GetSprites-Methode (d2d1_3.h)
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 |