ID2D1SpriteBatch::GetSprites, méthode (d2d1_3.h)
Récupère le sous-ensemble spécifié de sprites à partir de ce lot de sprites. Pour de meilleures performances, utilisez nullptr pour les propriétés que vous n’avez pas besoin de récupérer.
Syntaxe
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
);
Paramètres
startIndex
Type : UINT32
Index du premier sprite de ce lot de sprites à récupérer.
spriteCount
Type : UINT32
Nombre de sprites à récupérer.
[out, optional] destinationRectangles
Type : D2D1_RECT_F*
Lorsque cette méthode retourne, contient un pointeur vers un tableau contenant les rectangles de destination pour les sprites récupérés.
[out, optional] sourceRectangles
Type : D2D1_RECT_U*
Lorsque cette méthode retourne, contient un pointeur vers un tableau contenant les rectangles sources pour les sprites récupérés.
L’objet InfiniteRectU est retourné pour tous les sprites qui n’ont pas été affectés à un rectangle source.
[out, optional] colors
Type : D2D1_COLOR_F*
Lorsque cette méthode retourne, contient un pointeur vers un tableau contenant les couleurs à appliquer aux sprites récupérés.
La couleur {1.0f, 1.0f, 1.0f, 1.0f} est retournée pour les sprites auxquels aucune couleur n’a été attribuée.
[out, optional] transforms
Type : D2D1_MATRIX_3X2_F*
Lorsque cette méthode retourne, contient un pointeur vers un tableau contenant les transformations à appliquer aux sprites récupérés.
La matrice d’identité est retournée pour tous les sprites qui n’ont pas été affectés à une transformation.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Spécifications
| Plateforme cible | Windows |
| En-tête | d2d1_3.h |
| Bibliothèque | D2d1.lib |
| DLL | D2d1.dll |