Uso di D3DXMath

D3DXMath è una libreria di supporto matematico per le applicazioni Direct3D. D3DXMath è di lunga durata, è incluso anche in D3DX 9 e D3DX 10 e risale alle versioni precedenti di DirectX.

DirectXMath condivide gran parte delle stesse funzionalità in D3DXMath e internamente D3DXMath include una serie di ottimizzazioni specifiche del processore. La differenza principale è che D3DXMath è ospitato in D3DX9*. DLL e D3DX10*. Le DLL e pochissime funzioni sono inlining. La convenzione di chiamata della libreria DirectXMath è esplicitamente compatibile con SIMD, mentre D3DXMath deve eseguire conversioni di caricamento e archiviazione per implementare l'ottimizzazione SIMD.

Combinazione di DirectXMath e D3DXMath

D3DX11 non contiene D3DXMath e in generale è consigliabile usare DirectXMath. Tuttavia, è possibile continuare a collegarsi a D3DX9 e/o D3DX10 nell'applicazione e quindi continuare a usare D3DXMath o usare sia D3DXMath che DirectXMath nell'applicazione contemporaneamente.

In generale, è possibile eseguire il cast di un XMVECTOR* a una funzione che accetta D3DXVECTOR4* o di eseguire il cast di una XMMATRIX* a una funzione che accetta D3DXMATRIX*. L'inverso, tuttavia, non è generalmente sicuro perché XMVECTOR e XMMATRIX devono essere allineati a 16 byte, mentre D3DXVECTOR4 e D3DXMATRIX non hanno tali requisiti. Il mancato rispetto di questo requisito può comportare eccezioni di allineamento non valide in fase di esecuzione.

È possibile eseguire il cast di un XMVECTOR* a una funzione che accetta D3DXVECTOR2* o D3DXVECTOR3*, ma non viceversa. Sia i problemi di allineamento che il fatto che D3DXVECTOR2 e D3DXVECTOR3 siano strutture più piccole rendono questa operazione non sicura.

Uso di DirectXMath con Direct3D

Sia DirectXMath che D3DXMath sono facoltativi quando si usa Direct3D. Direct3D 9 ha definito D3DMATRIX e D3DCOLOR come parte dell'API Direct3D in supporto della pipeline a funzione fissa (ora legacy). D3DXMath in D3DX9 estende questi tipi Direct3D 9 con operazioni matematiche grafiche comuni. Per Direct3D 10.x e Direct3D 11, l'API usa solo la pipeline programmabile, quindi non esiste una struttura specifica dell'API per matrici o valori di colore. Quando le API più recenti richiedono un valore di colore, accettano una matrice esplicita di valori float o un buffer generico di dati costanti interpretati dallo shader HLSL. HLSL stesso può supportare formati di matrice principale o principale di riga o colonna, quindi il layout dipende interamente dall'utente (per altre informazioni, vedere HLSL, Matrix Ordering; se si usano formati di matrice principale della colonna negli shader, è necessario trasporre i dati della matrice DirectXMath mentre li si inserisce nelle strutture di buffer costanti). Anche se facoltativo, le librerie DirectXMath e D3DXMath forniscono entrambe funzionalità comuni correlate alla grafica e sono quindi estremamente utili quando si esegue la programmazione Direct3D.

È possibile eseguire il cast di un XMVECTOR* in un D3DVECTOR* o XMMATRIX* per D3DMATRIX* poiché Direct3D 9 non presuppone alcun allineamento sulla struttura dei dati in ingresso. È anche possibile eseguire il cast di XMCOLOR in D3DCOLOR. È possibile convertire una rappresentazione a 4 float di colore in XMCOLOR tramite XMStoreColor() per ottenere la DWORD a 8:8:8:8 a 32 bit equivalente a D3DCOLOR.

Quando si usano i tipi Direct3D 10.x o Direct3D 11, in genere si useranno i tipi DirectXMath per compilare una struttura per ognuno dei buffer costanti e in questi casi dipende in gran parte dalla possibilità di controllare l'allineamento per rendere efficienti queste operazioni o per usare le operazioni XMStore*() per convertire i dati XMVECTOR e XMMATRIX nei tipi di dati corretti. Quando si chiamano API Direct3D 10.x o Direct3D 11 che richiedono una matrice float[4] di valori di colore, è possibile eseguire il cast di un XMVECTOR* o XMFLOAT4* contenente i dati sul colore.

Conversione da D3DXMath

Argomenti correlati

Guida per programmatori DirectXMath