Metodo ID2D1SpriteBatch::SetSprites (d2d1_3.h)

Aggiornamenti le proprietà degli sprite specificati in questo batch sprite. Specificando un valore Null per qualsiasi proprietà, tale proprietà non verrà modificata per tale sprite.

Sintassi

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
);

Parametri

startIndex

Tipo: UINT32

Indice del primo sprite in questo batch sprite da aggiornare.

spriteCount

Tipo: UINT32

Numero di sprite da aggiornare con nuove proprietà. In questo modo viene determinato il numero di passi in ogni matrice Direct2D specificata.

[in, optional] destinationRectangles

Tipo: const D2D1_RECT_F*

Puntatore a una matrice contenente i rettangoli di destinazione che specificano dove disegnare le sprite nel contesto del dispositivo di destinazione.

[in, optional] sourceRectangles

Tipo: const D2D1_RECT_U*

Puntatore a una matrice contenente i rettangoli di origine che specificano le aree della bitmap di origine da disegnare come sprite.

Direct2D userà l'intera bitmap di origine per gli sprite assegnati a un valore Null o a InfiniteRectU. Se questo parametro viene omesso interamente o impostato su un valore Null, Direct2D userà l'intera bitmap di origine per tutte le sprite aggiornate.

[in, optional] colors

Tipo: const D2D1_COLOR_F*

Puntatore a una matrice contenente i colori da applicare a ogni sprite. Il colore di output è il risultato della moltiplicazione a livello di componente del colore bitmap di origine e del colore specificato. Il colore di output non è bloccato.

Direct2D non modifica il colore delle sprite assegnate a un valore Null. Se questo parametro viene omesso interamente o impostato su un valore Null, Direct2D non cambierà il colore di uno degli sprite aggiornati.

[in, optional] transforms

Tipo: const D2D1_MATRIX_3X2_F*

Puntatore a una matrice contenente le trasformazioni da applicare al rettangolo di destinazione di ogni sprite.

Direct2D non trasforma il rettangolo di destinazione di eventuali sprite assegnati a un valore Null. Se questo parametro viene omesso interamente o impostato su un valore Null, Direct2D non trasforma il rettangolo di destinazione di uno dei sprite aggiornati.

destinationRectanglesStride

Tipo: UINT32

Specifica la distanza, in byte, tra ogni rettangolo della matrice destinationRectangles. Se si specifica uno stride di 0, verrà usato lo stesso rettangolo di destinazione per ogni sprite aggiornata.

sourceRectanglesStride

Tipo: UINT32

Specifica la distanza, in byte, tra ogni rettangolo della matrice sourceRectangles (se viene specificata tale matrice). Se si specifica uno stride di 0, verrà usato lo stesso rettangolo di origine per ogni sprite aggiornata.

colorsStride

Tipo: UINT32

Specifica la distanza, in byte, tra ogni colore nella matrice di colori (se viene specificata tale matrice). Se si specifica uno stride di 0, lo stesso colore verrà usato per ogni sprite aggiornata.

transformsStride

Tipo: UINT32

Specifica la distanza, in byte, tra ogni trasformazione nella matrice di trasformazioni (se viene specificata la matrice). Se si specifica uno stride di 0, verrà usata la stessa trasformazione per ogni sprite aggiornata.

Valore restituito

Tipo: HRESULT

Restituisce S_OK sull'esito positivo. Restituisce E_INVALIDARG se al metodo è stato passato un valore non valido. In questo caso, nessun sprite viene modificato da questa chiamata a SetSprites.

Requisiti

Vedi anche

ID2D1SpriteBatch