Trabalhando com o D3DXMath

D3DXMath é uma biblioteca auxiliar de matemática para aplicativos Direct3D. O D3DXMath é de longa data, está incluído no D3DX 9 e D3DX 10 e também remonta a versões mais antigas do DirectX.

O DirectXMath compartilha grande parte da mesma funcionalidade no D3DXMath, e internamente o D3DXMath inclui várias otimizações específicas do processador. A principal diferença é que o D3DXMath está hospedado no D3DX9*. DLLs e D3DX10*. DLLs, e muito poucas das funções estão embutidas. A convenção de chamada da Biblioteca DirectXMath é explicitamente amigável para SIMD, enquanto o D3DXMath precisa executar conversões de carga e armazenamento para implementar a otimização do SIMD.

Misturando DirectXMath e D3DXMath

D3DX11 não contém D3DXMath e, em geral, recomendamos o uso do DirectXMath. No entanto, você é livre para continuar a vincular ao D3DX9 e/ou D3DX10 em seu aplicativo e, portanto, você pode continuar a usar o D3DXMath ou usar o D3DXMath e o DirectXMath em seu aplicativo ao mesmo tempo.

Em geral, é seguro converter um XMVECTOR* para uma função que leva D3DXVECTOR4* ou converter um XMMATRIX* para uma função que leva D3DXMATRIX*. O inverso, no entanto, geralmente não é seguro porque XMVECTOR e XMMATRIX devem estar alinhados com 16 bytes, enquanto D3DXVECTOR4 e D3DXMATRIX não têm esse requisito. O não cumprimento desse requisito pode resultar em exceções de alinhamento inválidas em tempo de execução.

É seguro converter um XMVECTOR* para uma função que leva D3DXVECTOR2* ou D3DXVECTOR3*, mas não vice-versa. Tanto as preocupações de alinhamento como o facto de D3DXVECTOR2 e D3DXVECTOR3 serem estruturas mais pequenas tornam esta operação insegura.

Usando o DirectXMath com o Direct3D

O DirectXMath e o D3DXMath são opcionais ao trabalhar com Direct3D. O Direct3D 9 definiu D3DMATRIX e D3DCOLOR como parte da API do Direct3D para suportar o pipeline de função fixa, agora considerado legado. O D3DXMath no D3DX9 estende esses tipos Direct3D 9 com operações matemáticas gráficas comuns. Para Direct3D 10.x e Direct3D 11, a API usa apenas o pipeline programável, portanto, não há uma estrutura específica da API para matrizes ou valores de cor. Quando as APIs mais recentes exigem um valor de cor, elas usam uma matriz explícita de valores flutuantes ou um buffer genérico de dados constantes que é interpretado pelo sombreador HLSL. O HLSL em si pode suportar formatos de matriz por linha ou por coluna, portanto, o layout fica totalmente ao seu critério (para mais informações, consulte HLSL, Matrix Ordering; se usar formatos de matriz por coluna nos seus sombreadores, é necessário transpor os dados da matriz DirectXMath ao colocá-los nas suas estruturas de buffer constante). Embora opcionais, as bibliotecas DirectXMath e D3DXMath fornecem funcionalidades comuns relacionadas a gráficos e, portanto, são extremamente convenientes ao fazer programação Direct3D.

É seguro converter um XMVECTOR* para um D3DVECTOR* ou XMMATRIX* para D3DMATRIX*, uma vez que o Direct3D 9 não faz suposições de alinhamento sobre a estrutura de dados de entrada. Também é seguro transmitir XMCOLOR para D3DCOLOR. Você pode converter uma representação de cor com 4 valores de ponto flutuante para XMCOLOR via XMStoreColor() para obter o DWORD de 32 bits 8:8:8:8 equivalente ao D3DCOLOR.

Ao trabalhar com Direct3D 10.x ou Direct3D 11, você normalmente usará tipos DirectXMath para criar uma estrutura para cada um dos seus buffers constantes e, nesses casos, depende em grande parte de sua capacidade de controlar o alinhamento para torná-los eficientes, ou usar operações XMStore*() para converter dados XMVECTOR e XMMATRIX para os tipos de dados corretos. Ao chamar APIs do Direct3D 10.x ou Direct3D 11 que exigem uma matriz flutuante[4] de valores de cor, você pode converter um XMVECTOR* ou XMFLOAT4* contendo os dados de cor.

Migração do D3DXMath

Tópicos relacionados

Guia de programação do DirectXMath