Verwenden von D3DXMath

D3DXMath ist eine mathematische Hilfsbibliothek für Direct3D-Anwendungen. D3DXMath hat eine lange Tradition, ist in D3DX 9 und D3DX 10 enthalten und geht auch auf ältere Versionen von DirectX zurück.

DirectXMath verfügt über einen Großteil der gleichen Funktionalität wie D3DXMath, und intern enthält D3DXMath eine Reihe von prozessorspezifischen Optimierungen. Der Hauptunterschied besteht darin, dass D3DXMath in den D3DX9*.DLLs und D3DX10*.DLLs gehostet wird und nur sehr wenige der Funktionen inline sind. Die Aufrufkonvention der DirectXMath-Bibliothek ist explizit SIMD-freundlich, während D3DXMath zur Implementierung der SIMD-Optimierung Ladungs- und Store-Konvertierungen durchführen muss.

Vermischung von DirectXMath und D3DXMath

D3DX11 enthält kein D3DXMath, und wir empfehlen allgemein, stattdessen DirectXMath zu verwenden. Es steht Ihnen jedoch frei, in Ihrer Anwendung weiterhin auf D3DX9 und/oder D3DX10 zu linken. Sie könnten also weiterhin D3DXMath oder sowohl D3DXMath als auch DirectXMath gleichzeitig in Ihrer Anwendung verwenden.

Allgemein ist es sicher, einen XMVECTOR* an eine Funktion zu übergeben, die D3DXVECTOR4* entgegennimmt, oder einen XMMATRIX* an eine Funktion zu übergeben, die D3DXMATRIX* entgegennimmt. Der umgekehrte Weg ist jedoch nicht generell sicher, da XMVECTOR und XMMATRIX 16-Byte-ausgerichtet sein müssen, während für D3DXVECTOR4 und D3DXMATRIX keine solche Anforderung besteht. Die Nichteinhaltung dieser Anforderung kann zur Laufzeit zu Ausnahmen bezüglich der ungültigen Ausrichtung führen.

Es ist sicher, einen XMVECTOR* an eine Funktion zu übergeben, die D3DXVECTOR2* oder D3DXVECTOR3* entgegennimmt, aber nicht umgekehrt. Sowohl Bedenken hinsichtlich der Ausrichtung als auch die Tatsache, dass D3DXVECTOR2 und D3DXVECTOR3 kleinere Strukturen sind, machen diesen Vorgang unsicher.

Verwendung von DirectXMath mit Direct3D

Sowohl DirectXMath als auch D3DXMath sind optional, wenn Sie mit Direct3D arbeiten. Direct3D 9 definierte D3DMATRIX und D3DCOLOR als Teil der Direct3D-API zur Unterstützung der (jetzt veralteten) Pipeline mit festen Funktionen. D3DXMath in D3DX9 erweitert diese Direct3D 9-Typen um allgemeine grafische mathematische Operationen. Für Direct3D 10.x und Direct3D 11 verwendet die API nur die programmierbare Pipeline, sodass es keine API-spezifische Struktur für Matrizen oder Farbwerte gibt. Wenn die neueren APIs einen Farbwert benötigen, nehmen sie ein explizites Array von Float-Werten oder einen generischen Puffer mit konstanten Daten, der vom HLSL-Shader interpretiert wird. HLSL selbst kann sowohl zeilen- als auch spalten-dominante Matrixformate unterstützen, sodass das Layout ganz Ihnen überlassen bleibt (weitere Informationen finden Sie unter HLSL, Matrixanordnung; wenn Sie spalten-dominante Matrixformate in Ihren Shadern verwenden, müssen Sie die DirectXMath-Matrixdaten transponieren, wenn Sie sie in Ihren konstanten Pufferstrukturen platzieren). Die Bibliotheken DirectXMath und D3DXMath sind zwar optional, bieten aber beide allgemeine grafikbezogene Funktionen und sind daher bei der Direct3D-Programmierung äußerst praktisch.

Es ist sicher, einen XMVECTOR* in einen D3DVECTOR* oder einen XMMATRIX* in einen D3DMATRIX* zu wandeln, da Direct3D 9 keine Annahmen über die Ausrichtung der eingehenden Datenstruktur trifft. Es ist auch sicher, XMCOLOR in D3DCOLOR zu wandeln. Sie können eine 4-Float-Darstellung der Farbe über XMStoreColor() in XMCOLOR umwandeln, um das 8:8:8:8 32-Bit DWORD zu erhalten, das D3DCOLOR entspricht.

Wenn Sie mit Direct3D 10.x oder Direct3D 11 arbeiten, werden Sie in der Regel DirectXMath-Typen verwenden, um eine Struktur für jeden Ihrer Konstantenpuffer zu erstellen. In diesen Fällen hängt es weitgehend von Ihrer Möglichkeit ab, die Ausrichtung zu steuern, um diese effizient zu machen, oder XMStore*()-Operationen zu verwenden, um XMVECTOR- und XMMATRIX-Daten in die richtigen Datentypen zu konvertieren. Wenn Sie Direct3D 10.x- oder Direct3D 11-APIs aufrufen, die ein float[4]-Array mit Farbwerten erfordern, können Sie einen XMVECTOR* oder XMFLOAT4* casten, der die Farbdaten enthält.

Portierung von D3DXMath

Zugehörige Themen

DirectXMath-Programmieranleitung