Werken met D3DXMath

D3DXMath is een wiskundige helperbibliotheek voor Direct3D-toepassingen. D3DXMath is langstaand, is opgenomen in D3DX 9 en D3DX 10 en dateert ook terug naar oudere versies van DirectX.

DirectXMath deelt veel van dezelfde functionaliteit in D3DXMath en intern D3DXMath bevat een aantal processorspecifieke optimalisaties. Het belangrijkste verschil is dat D3DXMath wordt gehost in de D3DX9*.DLL's en D3DX10*.DLL's en dat zeer weinig van de functies zijn geïnlineerd. De DirectXMath Library-oproepconventie is expliciet SIMD-vriendelijk, terwijl D3DXMath belasting- en opslagconversies moet uitvoeren om SIMD-optimalisatie te implementeren.

DirectXMath en D3DXMath combineren

D3DX11 bevat geen D3DXMath. Over het algemeen raden we u aan DirectXMath te gebruiken. U kunt echter wel blijven koppelen aan D3DX9 en/of D3DX10 in uw toepassing. Daarom kunt u D3DXMath blijven gebruiken of tegelijkertijd D3DXMath en DirectXMath gebruiken in uw toepassing.

Het is over het algemeen veilig om een XMVECTOR* te casten voor gebruik in een functie die een D3DXVECTOR4* vereist, of om een XMMATRIX* te casten voor een functie die een D3DXMATRIX* vereist. De inverse is echter niet algemeen veilig omdat XMVECTOR en XMMATRIX 16 byte moeten zijn uitgelijnd, terwijl D3DXVECTOR4 en D3DXMATRIX geen dergelijke vereiste hebben. Als u niet aan deze vereiste voldoet, kunnen er tijdens runtime ongeldige uitlijningsuitzonderingen optreden.

Het is veilig om een XMVECTOR* te casten naar een functie die D3DXVECTOR2* of D3DXVECTOR3* gebruikt, maar niet andersom. Zowel uitlijningsproblemen als het feit dat D3DXVECTOR2 en D3DXVECTOR3 kleinere structuren zijn, maken dit een onveilige bewerking.

DirectXMath gebruiken met Direct3D

Zowel DirectXMath als D3DXMath zijn optioneel bij het werken met Direct3D. Direct3D 9 gedefinieerde D3DMATRIX en D3DCOLOR als onderdeel van de Direct3D-API ter ondersteuning van de (nu verouderde) pijplijn met vaste functies. D3DXMath in D3DX9 breidt deze Direct3D 9-typen uit met algemene grafische wiskundige bewerkingen. Voor Direct3D 10.x en Direct3D 11 gebruikt de API alleen de programmeerbare pijplijn, zodat er geen API-specifieke structuur is voor matrices of kleurwaarden. Wanneer de nieuwere API's een kleurwaarde vereisen, nemen ze een expliciete matrix met floatwaarden of een algemene buffer met constante gegevens die worden geïnterpreteerd door de HLSL-shader. HLSL zelf kan ondersteuning bieden voor matrixindelingen voor rijen of kolommen, zodat de indeling helemaal aan u is (zie HLSL, Matrixvolgorde; als u kolom-primaire matrixindelingen in uw shaders gebruikt, moet u de DirectXMath-matrixgegevens transponeren terwijl u deze in uw constante bufferstructuren plaatst). Hoewel de DirectXMath- en D3DXMath-bibliotheken optioneel zijn, bieden beide algemene grafische functionaliteit en zijn ze daarom zeer handig bij het programmeren van Direct3D.

Het is veilig om een XMVECTOR* naar een D3DVECTOR* of XMMATRIX* te casten naar D3DMATRIX* omdat Direct3D 9 geen uitlijningsveronderstellingen over de binnenkomende gegevensstructuur maakt. Het is ook veilig om XMCOLOR naar D3DCOLOR te casten. U kunt een 4-floatweergave van kleur converteren naar XMCOLOR via XMStoreColor() om de 8:8:8:8:8 32-bits DWORD te verkrijgen die gelijk is aan D3DCOLOR.

Wanneer u met Direct3D 10.x of Direct3D 11 werkt, gebruikt u doorgaans DirectXMath-typen om een structuur te bouwen voor elk van uw constante buffers. In die gevallen is het grotendeels afhankelijk van uw vermogen om de uitlijning te beheren om deze efficiënt te maken, of om XMStore*() bewerkingen te gebruiken om XMVECTOR- en XMMATRIX-gegevens te converteren naar de juiste gegevenstypen. Wanneer u Direct3D 10.x- of Direct3D 11-API's aanroept waarvoor een float[4]-matrix met kleurwaarden is vereist, kunt u een XMVECTOR* of XMFLOAT4* met de kleurgegevens casten.

Overzetten vanuit D3DXMath

Verwante onderwerpen

DirectXMath Programming Guide