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

Voir aussi

ID2D1SpriteBatch