Método ID2D1SpriteBatch::GetSprites (d2d1_3.h)

Recupera o subconjunto especificado de sprites deste lote de sprite. Para obter o melhor desempenho, use nullptr para propriedades que você não precisa recuperar.

Sintaxe

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

Parâmetros

startIndex

Tipo: UINT32

O índice do primeiro sprite neste lote de sprite a ser recuperado.

spriteCount

Tipo: UINT32

O número de sprites a serem recuperados.

[out, optional] destinationRectangles

Tipo: D2D1_RECT_F*

Quando esse método retorna, contém um ponteiro para uma matriz que contém os retângulos de destino para os sprites recuperados.

[out, optional] sourceRectangles

Tipo: D2D1_RECT_U*

Quando esse método retorna, contém um ponteiro para uma matriz que contém os retângulos de origem para os sprites recuperados.

O InfiniteRectU é retornado para quaisquer sprites que não foram atribuídos a um retângulo de origem.

[out, optional] colors

Tipo: D2D1_COLOR_F*

Quando esse método retorna, contém um ponteiro para uma matriz que contém as cores a serem aplicadas aos sprites recuperados.

A cor {1.0f, 1.0f, 1.0f, 1.0f} é retornada para quaisquer sprites que não foram atribuídos a uma cor.

[out, optional] transforms

Tipo: D2D1_MATRIX_3X2_F*

Quando esse método retorna, contém um ponteiro para uma matriz que contém as transformações a serem aplicadas aos sprites recuperados.

A matriz de identidade é retornada para quaisquer sprites que não foram atribuídos a uma transformação.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	d2d1_3.h
Biblioteca	D2d1.lib
DLL	D2d1.dll

Confira também

ID2D1SpriteBatch