Método ID3DXSprite::D raw

Adiciona um sprite à lista de sprites em lote.

Sintaxe

HRESULT Draw(
  [in]       LPDIRECT3DTEXTURE9 pTexture,
  [in] const RECT               *pSrcRect,
  [in] const D3DXVECTOR3        *pCenter,
  [in] const D3DXVECTOR3        *pPosition,
  [in]       D3DCOLOR           Color
);

Parâmetros

pTexture [in]

Tipo: LPDIRECT3DTEXTURE9

Ponteiro para uma interface IDirect3DTexture9 que representa a textura sprite.

pSrcRect [in]

Tipo: const RECT*

Ponteiro para uma estrutura RECT que indica a parte da textura de origem a ser usada para o sprite. Se esse parâmetro for NULL, toda a imagem de origem será usada para o sprite.

pCenter [in]

Tipo: const D3DXVECTOR3*

Ponteiro para um vetor D3DXVECTOR3 que identifica o centro do sprite. Se esse argumento for NULL, o ponto (0,0,0) será usado, que é o canto superior esquerdo.

pPosition [in]

Tipo: const D3DXVECTOR3*

Ponteiro para um vetor D3DXVECTOR3 que identifica a posição do sprite. Se esse argumento for NULL, o ponto (0,0,0) será usado, que é o canto superior esquerdo.

Cor [in]

Tipo: D3DCOLOR

Tipo D3DCOLOR . Os canais de cor e alfa são modulados por esse valor. Um valor de 0xFFFFFFFF mantém a cor de origem original e os dados alfa. Use a macro D3DCOLOR_RGBA para ajudar a gerar essa cor.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será S_OK. Se o método falhar, o valor retornado poderá ser um dos seguintes: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Comentários

Para dimensionar, girar ou traduzir um sprite, chame ID3DXSprite::SetTransform com uma matriz que contém os valores de escala, rotação e conversão (SRT), antes de chamar ID3DXSprite::D raw. Para obter informações sobre como definir valores SRT em uma matriz, confira Transformações de matriz.

Requisitos

Requisito	Valor
parâmetro	D3dx9core.h
Biblioteca	D3dx9.lib

Confira também

ID3DXSprite

ID3DXSprite::GetTransform