Metodo ID2D1SpriteBatch::GetSprites (d2d1_3.h)

Recupera il subset specificato di sprite da questo batch sprite. Per ottenere prestazioni ottimali, usare Nullptr per le proprietà che non è necessario recuperare.

Sintassi

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

Parametri

startIndex

Tipo: UINT32

Indice del primo sprite in questo batch sprite da recuperare.

spriteCount

Tipo: UINT32

Numero di sprite da recuperare.

[out, optional] destinationRectangles

Tipo: D2D1_RECT_F*

Quando questo metodo restituisce, contiene un puntatore a una matrice contenente i rettangoli di destinazione per gli sprite recuperati.

[out, optional] sourceRectangles

Tipo: D2D1_RECT_U*

Quando questo metodo restituisce, contiene un puntatore a una matrice contenente i rettangoli di origine per gli sprite recuperati.

L'oggetto InfiniteRectU viene restituito per eventuali sprite non assegnati a un rettangolo di origine.

[out, optional] colors

Tipo: D2D1_COLOR_F*

Quando questo metodo restituisce, contiene un puntatore a una matrice contenente i colori da applicare agli sprite recuperati.

Il colore {1.0f, 1.0f, 1.0f, 1.0f} viene restituito per eventuali sprite non assegnati a un colore.

[out, optional] transforms

Tipo: D2D1_MATRIX_3X2_F*

Quando questo metodo restituisce, contiene un puntatore a una matrice contenente le trasformazioni da applicare agli sprite recuperati.

La matrice di identità viene restituita per eventuali sprite non assegnati a una trasformazione.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Vedi anche

ID2D1SpriteBatch