D3DXMath の操作

D3DXMath は、Direct3D アプリケーション用の数学ヘルパー ライブラリです。 D3DXMath は長年使用されており、D3DX 9 および D3DX 10 に含まれており、DirectX の古いバージョンにも遡ります。

DirectXMath は D3DXMath と同じ機能を多く共有しており、内部的には D3DXMath にはプロセッサ固有の最適化が多数含まれています。 主な違いは、D3DXMath が D3DX9*.DLL および D3DX10*.DLL でホストされており、インライン化される関数がごくわずかであることです。 DirectXMath ライブラリの呼び出し規約は明示的に SIMD に対応していますが、D3DXMath は SIMD 最適化を実装するためにロードおよびストアの変換を実行する必要があります。

DirectXMath と D3DXMath の混在

D3DX11 には D3DXMath が含まれていないため、通常は代わりに DirectXMath を使用することをお勧めします。 ただし、アプリケーションで D3DX9 や D3DX10 にリンクし続けることは自由であるため、D3DXMath を引き続き使用することも、アプリケーションで D3DXMath と DirectXMath の両方を同時に使用することもできます。

一般に、XMVECTOR* を D3DXVECTOR4* を受け取る関数にキャストしたり、XMMATRIX* を D3DXMATRIX* を受け取る関数にキャストしたりすることは安全です。 ただし、XMVECTOR と XMMATRIX は 16 バイト境界に揃える必要があるのに対し、D3DXVECTOR4 と D3DXMATRIX にはそのような要件がないため、その逆は一般に安全ではありません。 この要件に準拠しないと、実行時に無効なアラインメント例外が発生する可能性があります。

XMVECTOR* は、D3DXVECTOR2* または D3DXVECTOR3* を受け取る関数にキャストしても安全ですが、その逆は受け取りません。 アラインメントに関する懸念と、D3DXVECTOR2 および D3DXVECTOR3 が小さい構造体であるという事実の両方により、これは安全でない操作になります。

Direct3D での DirectXMath の使用

Direct3D を使用する場合、DirectXMath と D3DXMath はどちらも省略可能です。 Direct3D 9 では、(現在はレガシとなっている) 固定機能パイプラインをサポートするために、Direct3D API の一部として D3DMATRIX と D3DCOLOR が定義されていました。 D3DX9 の D3DXMath は、一般的なグラフィックス演算を使用して、これらの Direct3D 9 型を拡張します。 Direct3D 10.x および Direct3D 11 の場合、API はプログラム可能なパイプラインのみを使用するため、マトリックスまたはカラー値に対して API 固有の構造はありません。 新しい API でカラー値が必要な場合は、明示的な float 値の配列、または HLSL シェーダーによって解釈される定数データの汎用バッファーが使用されます。 HLSL自体は行優先または列優先のマトリックス形式をサポートできるため、レイアウトは完全にユーザーの責任です (詳細については、HLSL、「マトリックスの順序」を参照してください。シェーダーで列優先のマトリックス形式を使用する場合は、定数バッファー構造に配置するときに DirectXMath マトリックス データを入れ替える必要があります。 省略可能ではありますが、DirectXMath ライブラリと D3DXMath ライブラリはどちらも一般的なグラフィックス関連の機能を提供するため、Direct3D プログラミングを行うときに非常に便利です。

Direct3D 9 では、受信データ構造に関する配置の想定が行われないため、XMVECTOR* を D3DVECTOR* に、または XMMATRIX* を D3DMATRIX* にキャストしても安全です。 XMCOLOR を D3DCOLOR にキャストしても安全です。 XMStoreColor() を介して 4 浮動小数点数のカラー表現を XMCOLOR に変換し、D3DCOLOR と同等の 8:8:8:8 32 ビット DWORD を取得できます。

Direct3D 10.x または Direct3D 11 を使用する場合、通常は DirectXMath 型を使用して各定数バッファーの構造を構築します。その場合、効率を上げるために配置を制御する能力、または XMStore*() 操作を使用して XMVECTOR および XMMATRIX データを正しいデータ型に変換する能力に大きく依存します。 カラー値の float[4] 配列を必要とする Direct3D 10.x または Direct3D 11 API を呼び出す場合は、カラー データを含む XMVECTOR* または XMFLOAT4* をキャストできます。

D3DXMath からの移植

関連トピック

DirectXMath プログラミング ガイド