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

Atualizações as propriedades dos sprites especificados neste lote de sprite. Fornecer um valor nulo para qualquer propriedade deixará essa propriedade não modificada para esse sprite.

Sintaxe

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

Parâmetros

startIndex

Tipo: UINT32

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

spriteCount

Tipo: UINT32

O número de sprites a serem atualizados com novas propriedades. Isso determina quantos passos em cada matriz fornecida Direct2D lerá.

[in, optional] destinationRectangles

Tipo: const D2D1_RECT_F*

Um ponteiro para uma matriz que contém os retângulos de destino que especificam onde desenhar os sprites no contexto do dispositivo de destino.

[in, optional] sourceRectangles

Tipo: const D2D1_RECT_U*

Um ponteiro para uma matriz que contém os retângulos de origem que especificam as regiões do bitmap de origem a serem desenhadas como sprites.

Direct2D usará todo o bitmap de origem para sprites que recebem um valor nulo ou InfiniteRectU. Se esse parâmetro for omitido inteiramente ou definido como um valor nulo, Direct2D usará todo o bitmap de origem para todos os sprites atualizados.

[in, optional] colors

Tipo: const D2D1_COLOR_F*

Um ponteiro para uma matriz que contém as cores a serem aplicadas a cada sprite. A cor de saída é o resultado da multiplicação em termos de componente da cor do bitmap de origem e da cor fornecida. A cor de saída não está presa.

Direct2D não alterará a cor dos sprites atribuídos a um valor nulo. Se esse parâmetro for omitido inteiramente ou definido como um valor nulo, Direct2D não alterará a cor de nenhum dos sprites atualizados.

[in, optional] transforms

Tipo: const D2D1_MATRIX_3X2_F*

Um ponteiro para uma matriz que contém as transformações a serem aplicadas ao retângulo de destino de cada sprite.

Direct2D não transformará o retângulo de destino de nenhum sprite atribuído a um valor nulo. Se esse parâmetro for omitido inteiramente ou definido como um valor nulo, Direct2D não transformará o retângulo de destino de nenhum dos sprites atualizados.

destinationRectanglesStride

Tipo: UINT32

Especifica a distância, em bytes, entre cada retângulo na matriz destinationRectangles. Se você fornecer um passo de 0, o mesmo retângulo de destino será usado para cada sprite atualizado.

sourceRectanglesStride

Tipo: UINT32

Especifica a distância, em bytes, entre cada retângulo na matriz sourceRectangles (se essa matriz for fornecida). Se você fornecer um passo de 0, o mesmo retângulo de origem será usado para cada sprite atualizado.

colorsStride

Tipo: UINT32

Especifica a distância, em bytes, entre cada cor na matriz de cores (se essa matriz for fornecida). Se você fornecer um passo de 0, a mesma cor será usada para cada sprite atualizado.

transformsStride

Tipo: UINT32

Especifica a distância, em bytes, entre cada transformação na matriz de transformações (se essa matriz for fornecida). Se você fornecer um passo de 0, a mesma transformação será usada para cada sprite atualizado.

Retornar valor

Tipo: HRESULT

Retornará S_OK se houver êxito. Retorna E_INVALIDARG se um valor inválido foi passado para o método . Nesse caso, nenhum sprite é modificado por essa chamada para SetSprites.

Requisitos

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

Confira também

ID2D1SpriteBatch