XNA 数学ライブラリからのコード移行

この概要では、XNA Math ライブラリを使用して既存のコードを DirectXMath ライブラリに移行するために必要な変更について説明します。

ヘッダーの変更

DirectXMath ライブラリでは、新しいヘッダーのセットが使用されます。

xnamath.h ヘッダーを DirectXMath.hに置き換え、GPU パック の種類の DirectXPackedVector.h を追加します。

xnacollision.h の DirectX SDK Collision サンプルの境界の種類が、DirectXCollision.hの DirectXMath ライブラリの一部になりました。 これらは、C スタイルの API ではなく C++ クラスを使用するように変更されています。

定数の変更

XNAMATH_VERSION (200、201、202、203、204 など) は、DIRECXTMATH_VERSION (300、301、302、303 など) に置き換えられました。

名前空間

DirectXMath ライブラリでは、C++ 名前空間を使用して型を整理します。 XNA Math では、グローバル名前空間のみが使用されました。 XNA Math と共通する DirectXMath 型は、DirectX または DirectX::P ackedVector 名前空間にあります。

C++ ソース ファイルでは、簡単な解決策は、using ステートメントを追加することです。

#include "DirectXMath.h"
#include "DirectXPackedVector.h"

using namespace DirectX; 
using namespace DirectX::PackedVector;

ヘッダーの場合、using ステートメントを追加することはベスト プラクティスとは見なされません。 代わりに、完全修飾名前空間を追加します。

struct mystruct
{
   DirectX::XMFLOAT3 position;
   DirectX::PackedVector::HALF packedValue;
};

部分読み込み

XMVECTOR の 4 個未満の要素を読み込むさまざまな関数の場合、XNA Math ライブラリは追加の要素を未定義のままにしました。 DirectXMath では、これらの追加要素は常に 0 で埋められます。

Xbox 360 固有の種類の削除

DirectXMath では、次の XNA 数学ライブラリの種類、関数、および定数を使用できません。

• HENDN3、XMHEND3、XMUHENDN3、XMUHEND3、XMDHENN3、XMDHEN3、XMUDHENN3、XMUDHEN3
• XMLoadHenDN3()、XMLoadHenD3()、XMLoadUHenDN3()、XMLoadUHenD3()、XMLoadDHenN3()、XMLoadDHenN3()、XMLoadUDHenN3()、XMLoadUDHen3()
• XMStoreHenDN3()、XMStoreHenD3()、XMStoreUHenDN3()、XMStoreUHenD3()、XMStoreDHenN3()、XMStoreDHenN3()、XMStoreUDHenN3()、XMStoreUDHen3()
• g_XMMaskHenD3、g_XMMaskDHen3、g_XMAddUHenD3、g_XMAddHenD3、g_XMAddDHen、g_XMMulHenD3、g_XMMulDHen3、g_XMXorHenD3、g_XMXorDHen3
• XMXICON4、XMXICO4、XMICON4、XMICO4、XMUICON4、XMUICO4
• XMLoadXIcoN4()、XMLoadXIco4()、XMLoadIcoN4()、XMLoadIco4()、XMLoadUIcoN4()、XMLoadUIco4()
• XMStoreXIcoN4()、XMStoreXIco4() 、XMStoreIcoN4()、XMStoreIco4()、XMStoreUIcoN4()、XMStoreUIco4()
• g_XMMaskIco4、g_XMXorXIco4、g_XMXorIco4、g_XMAddXIco4、g_XMAddUIco4、g_XMAddIco4、g_XMMulIco4

__vector4iは非推奨です。 代わりに XMVECTORI32 または XMVECTORU32 を使用してください。

次の関数と型は Xbox 360 のみであるため、非推奨とされます。XMLoadDecN4、XMStoreDecN4、XMDECN4、XMLoadDec4、XMStoreDec4、XMDEC4、XMLoadXDec4、XMStoreXDec4、XMXDEC4。

ARM-NEON 組み込み関数

このコードでベクター定数を宣言すると、SSE および NO-INTRINSICS の XNA Math 用にコンパイルされますが、ARM-NEON を使用した DirectXMath では失敗します。

XMVECTOR v = { 1.f, 2.f, 3.f, 4.f }

一般に、XMVECTORの初期化には、この方法はお勧めしません。 ただし、ベクター定数が必要な場合、XMVECTORF32 クラスはこの初期化スタイルをサポートし、XMVECTOR 型を自動的に返して、ほとんどの同じコンテキストで XMVECTORF32 を使用できます。 XMVECTORF32 クラスへの書き込み操作では、.v XMVECTOR メンバーを明示的に参照する必要があります。

Permute

XNA 数学ライブラリには、一般的なベクター のパーミュート用に次の形式がありました。

XMVECTOR XMVectorPermuteControl(UINT ElementIndex0, UINT ElementIndex1, UINT ElementIndex2, UINT ElementIndex3);
XMVECTOR XMVectorPermute(FXMVECTOR V1, FXMVECTOR V2, FXMVECTOR Control);

DirectXMath の場合、XMVectorPermuteControl は削除され、XM_PERMUTE_0Xされました。 XM_PERMUTE_1Z定数は、単純な 0 から 7 のインデックスに再定義されています。 XMVectorPermute新しい署名を次に示します。

XMVECTOR XMVectorPermute(FXMVECTOR V1, FXMVECTOR V2, uint32_t PermuteX, uint32_t PermuteY, uint32_t PermuteZ, uint32_t PermuteW);

コントロール ワードの代わりに、この関数は 4 つのインデックスをパラメーターとして直接受け取ります。これは、新しいXM_SWIZZLE_Xを使用する XMVectorSwizzle 関数にも似ています。 XM_SWIZZLE_W 0 から 3 の単純なインデックスとして定義された定数です。

XMVECTOR XMVectorSwizzle(FXMVECTOR V, uint32_t E0, uint32_t E1, uint32_t E2, uint32_t E3);

template<uint32_t PermuteX, uint32_t PermuteY, uint32_t PermuteZ, uint32_t PermuteW>
    XMVECTOR XMVectorPermute(FXMVECTOR V1, FXMVECTOR V2)</code></pre></td>

テンプレート フォーム

一般に、次の関数の関数形式でテンプレート フォームを使用する方がはるかに効率的であり、ライブラリはテンプレートの特殊化によってプラットフォーム固有の最適化を実行できます。

template<uint32_t PermuteX, uint32_t PermuteY, uint32_t PermuteZ, uint32_t PermuteW>
    XMVECTOR XMVectorPermute(FXMVECTOR V1, FXMVECTOR V2)

template<uint32_t SwizzleX, uint32_t SwizzleY, uint32_t SwizzleZ, uint32_t SwizzleW>
    XMVECTOR XMVectorSwizzle(FXMVECTOR V)

template<uint32_t Elements>
    XMVECTOR XMVectorShiftLeft(FXMVECTOR V1, FXMVECTOR V2)

template<uint32_t Elements>
    XMVECTOR XMVectorRotateLeft(FXMVECTOR V)

template<uint32_t Elements>
    XMVECTOR XMVectorRotateRight(FXMVECTOR V)

template<uint32_t VSLeftRotateElements, uint32_t Select0, uint32_t Select1, uint32_t Select2, uint32_t Select3>
    XMVECTOR XMVectorInsert(FXMVECTOR VD, FXMVECTOR VS)</code></pre></td>

削除された関数

関連トピック

DirectXMath プログラミング ガイド