Utilisation de D3DXMath

D3DXMath est une bibliothèque d’assistance mathématique pour les applications Direct3D. La bibliothèque D3DXMath est éprouvée, est incluse dans D3DX 9 et D3DX 10, et est également utilisée dans les versions antérieures de DirectX.

DirectXMath propose une grande partie des fonctionnalités présentes dans D3DXMath. En interne, D3DXMath comprend un certain nombre d'optimisations spécifiques au processeur. La principale différence est que D3DXMath est hébergé dans les fichiers D3DX9*.DLL et D3DX10*.DLL. Très peu de fonctionnalités sont inline. La convention d’appel de la bibliothèque DirectXMath est explicitement compatible SIMD, tandis que D3DXMath doit effectuer des conversions de charge et de stockage pour implémenter l’optimisation SIMD.

Utiliser à la fois DirectXMath et D3DXMath

D3DX11 ne contient pas D3DXMath. De manière générale, nous vous recommandons d’utiliser DirectXMath à la place. Toutefois, vous pouvez continuer à associer votre application à D3DX9 et/ou D3DX10 dans votre application. Par conséquent, vous pouvez continuer à utiliser D3DXMath ou à utiliser D3DXMath et DirectXMath dans votre application en même temps.

Pour plus de sécurité, il est généralement recommandé de caster un XMVECTOR* vers une fonction qui accepte D3DXVECTOR4* ou de caster un XMMATRIX* vers une fonction qui accepte D3DXMATRIX*. En revanche, l'inverse n'est pas recommandé, car XMVECTOR et XMMATRIX doivent être alignés sur 16 octets. Cette exigence ne s'applique pas à D3DXVECTOR4 ni à D3DXMATRIX. Le non-respect cette exigence peut entraîner des exceptions d’alignement non valides au moment de l’exécution.

Vous pouvez sans problème caster un XMVECTOR* vers une fonction qui prend D3DXVECTOR2* ou D3DXVECTOR3*, mais pas inversement. Cette opération est dangereuse en raison de problèmes d'alignement et du fait que D3DXVECTOR2 et D3DXVECTOR3 sont des structures de plus petites envergure.

Utilisation de DirectXMath avec Direct3D

DirectXMath et D3DXMath sont facultatifs pour utiliser Direct3D. Direct3D 9 a défini D3DMATRIX et D3DCOLOR dans le cadre de l’API Direct3D pour prendre en charge le pipeline de fonction fixe (maintenant héritée). D3DXMath dans D3DX9 étend ces types Direct3D 9 à des opérations mathématiques graphiques courantes. Pour Direct3D 10.x et Direct3D 11, l’API utilise uniquement le pipeline programmable, de sorte qu’il n’existe aucune structure spécifique à l’API pour les matrices ou les valeurs de couleur. Lorsque les API plus récentes nécessitent une valeur de couleur, elles prennent un tableau explicite de valeurs float ou une mémoire tampon générique de données constantes interprétées par le nuanceur HLSL. HLSL lui-même peut prendre en charge les formats de matrice row-major ou column-major. Vous pouvez choisir la disposition qui vous convient le mieux (pour en savoir plus, consultez HLSL, Ordre des matrices. Si vous utilisez des formats de matrice column-major dans vos nuanceurs, vous devez transposer les données de matrice DirectXMath à mesure que vous les placez dans vos structures de mémoire tampon constantes). Bien que facultatives, les bibliothèques DirectXMath et D3DXMath fournissent toutes deux des fonctionnalités graphiques courantes et sont donc extrêmement pratiques lorsque vous programmez avec Direct3D.

Pour plus de sécurité, castez XMVECTOR* vers D3DVECTOR* ou XMMATRIX* vers D3DMATRIX*, car Direct3D 9 ne fait aucune hypothèse d’alignement sur la structure de données entrante. Il est également recommandé de caster XMCOLOR vers D3DCOLOR. Vous pouvez convertir une représentation 4-float de la couleur en XMCOLOR via XMStoreColor() pour obtenir le DWORD 32 bits 8:8:8:8 équivalent à D3DCOLOR.

Lorsque vous utilisez Direct3D 10.x ou Direct3D 11, vous utiliserez généralement des types DirectXMath afin de générer une structure pour chacune de vos mémoires tampon constantes. Dans ce cas, vous dépendez en grande partie de votre capacité à contrôler l’alignement pour rendre ces opérations efficaces, ou pour utiliser des opérations XMStore*() afin de convertir des données XMVECTOR et XMMATRIX en types de données corrects. Lorsque vous appelez des API Direct3D 10.x ou Direct3D 11 qui nécessitent un tableau float[4] de valeurs de couleur, vous pouvez caster un XMVECTOR* ou un XMFLOAT4* contenant les données de couleur.

Portage à partir de D3DXMath

Rubriques connexes

Guide de programmation DirectXMath