ID2D1SpriteBatch ::SetSprites, méthode (d2d1_3.h)
Mises à jour les propriétés des sprites spécifiés dans ce lot de sprites. Si vous fournissez une valeur Null pour toute propriété, cette propriété n’est pas modifiée pour ce sprite.
Syntaxe
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
);
Paramètres
startIndex
Type : UINT32
Index du premier sprite de ce lot de sprites à mettre à jour.
spriteCount
Type : UINT32
Nombre de sprites à mettre à jour avec de nouvelles propriétés. Cela détermine le nombre de foulées dans chaque tableau donné que Direct2D lira.
[in, optional] destinationRectangles
Type : const D2D1_RECT_F*
Pointeur vers un tableau contenant les rectangles de destination spécifiant où dessiner les sprites sur le contexte de l’appareil de destination.
[in, optional] sourceRectangles
Type : const D2D1_RECT_U*
Pointeur vers un tableau contenant les rectangles sources spécifiant les régions de la bitmap source à dessiner en tant que sprites.
Direct2D utilise l’intégralité de l’image bitmap source pour les sprites auxquels une valeur null est affectée ou infiniteRectU. Si ce paramètre est omis entièrement ou défini sur une valeur Null, Direct2D utilise l’intégralité de la bitmap source pour tous les sprites mis à jour.
[in, optional] colors
Type : const D2D1_COLOR_F*
Pointeur vers un tableau contenant les couleurs à appliquer à chaque sprite. La couleur de sortie est le résultat d’une multiplication au niveau des composants de la couleur bitmap source et de la couleur fournie. La couleur de sortie n’est pas limitée.
Direct2D ne modifie pas la couleur des sprites auxquels une valeur null est affectée. Si ce paramètre est entièrement omis ou défini sur une valeur Null, Direct2D ne modifie pas la couleur des sprites mis à jour.
[in, optional] transforms
Type : const D2D1_MATRIX_3X2_F*
Pointeur vers un tableau contenant les transformations à appliquer au rectangle de destination de chaque sprite.
Direct2D ne transforme pas le rectangle de destination des sprites auxquels une valeur null est affectée. Si ce paramètre est omis entièrement ou défini sur une valeur Null, Direct2D ne transforme pas le rectangle de destination des sprites mis à jour.
destinationRectanglesStride
Type : UINT32
Spécifie la distance, en octets, entre chaque rectangle du tableau destinationRectangles. Si vous fournissez une foulée de 0, le même rectangle de destination est utilisé pour chaque sprite mis à jour.
sourceRectanglesStride
Type : UINT32
Spécifie la distance, en octets, entre chaque rectangle du tableau sourceRectangles (si ce tableau est donné). Si vous fournissez une foulée de 0, le même rectangle source est utilisé pour chaque sprite mis à jour.
colorsStride
Type : UINT32
Spécifie la distance, en octets, entre chaque couleur du tableau de couleurs (si ce tableau est donné). Si vous fournissez une foulée de 0, la même couleur est utilisée pour chaque sprite mis à jour.
transformsStride
Type : UINT32
Spécifie la distance, en octets, entre chaque transformation du tableau de transformations (si ce tableau est donné). Si vous fournissez une foulée de 0, la même transformation est utilisée pour chaque sprite mis à jour.
Valeur retournée
Type : HRESULT
Renvoie S_OK en cas de réussite. Retourne E_INVALIDARG si une valeur non valide a été passée à la méthode . Dans ce cas, aucun sprites n’est modifié par cet appel à SetSprites.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | d2d1_3.h |
| Bibliothèque | D2d1.lib |
| DLL | D2d1.dll |