Living without D3DX

来源:互联网 发布:vscode mactype 贴吧 编辑:程序博客网 时间:2024/05/21 09:11

General Helpers

The DirectX Tool Kit provides a number of helpers that are designed to simplify Direct3D 11 programming in the tradition of the original D3DX library. You can find the library on CodePlex and GitHub.

ID3DX10Sprite

SpriteBatch

ID3DX10Font

SpriteFont, SpriteBatch

ID3DX10Mesh

Model, ModelMesh, ModelMeshPart

D3DXCreateBox 
D3DXCreateCylinder 
D3DXCreateSphere
D3DXCreateTeapot 
D3DXCreateTorus

GeometricPrimitive

D3DX11CreateShaderResourceViewFromFile

CreateXXXTextureFromFile

D3DX11CreateShaderResourceViewFromResource
D3DX11CreateShaderResourceViewFromMemory

CreateXXXTextureFromMemory

D3DX11CreateTextureFromFile

CreateXXXTextureFromFile

D3DX11CreateTextureFromResource
D3DX11CreateTextureFromMemory

CreateXXXTextureFromMemory

D3DX11SaveTextureToFile

SaveXXXTextureToFile

HLSL Functions

The HLSL compiler, shader reflection API, and related functionality has been broken out into it's own D3DCompileDLL for some time. D3DCompile is in the Windows 8.x SDK and is included with VS 2012 and VS 2013 Preview.

D3DXCompileShaderFromFile
D3DX10CompileFromFile
D3DX11CompileFromFile
D3DCompileFromFileD3DXCompileShader
D3D10CompileShader
D3DX10CompileFromMemory
D3DX11CompileFromMemory
D3DCompileD3DXCompileShaderFromResource
D3DX10CompileFromResource
D3DX11CompileFromResource
No direct equivalent. Can use resource APIs and then D3DCompileabove.D3DXPreprocessShader
D3DXPreprocessShaderFromFile
D3DXPreprocessShaderFromResource
D3D10PreprocessShader
D3DX10PreprocessShaderFromFile
D3DX10PreprocessShaderFromMemory
D3DX10PreprocessShaderFromResource
D3DX11PreprocessShaderFromFile
D3DX11PreprocessShaderFromMemory
D3DX11PreprocessShaderFromResource
D3DPreprocessD3DXDisassembleShader
D3D10DisassembleShader
D3DX10DisassembleShader
D3DDisassembleD3D10ReflectShader
D3DX10ReflectShader
D3DReflect
D3D11Reflect
ID3DXBuffer
ID3D10Blob
ID3DBlobD3DXCreateBuffer
D3D10CreateBlob
D3DCreateBlobD3D10GetInputSignatureBlob
D3D10GetOutputSignatureBlob
D3D10GetInputAndOutputSignatureBlob
D3D10GetShaderDebugInfo
D3DGetBlobPart

Texture Functions

The DirectXTex library is primarily intended for texture processing offline with tools, although it can also be used at runtime for doing texture block compression, mipmap generation, or handling more general image processing needs. DirectXTK is intended for use at runtime with light-weight helpers and image loaders, but does not provide support for general runtime texture format conversion. You can find both libraries on CodePlex and GitHub.

D3DX11ComputeNormalMap

DirectXTex library, ComputeNormalMap

D3DX11CreateShaderResourceViewFromFile
D3DX11CreateTextureFromFile

DDSTextureLoader: CreateDDSTextureFromFile
WICTextureLoader: CreateWICTextureFromFile

DirectXTex library (tools), LoadFromXXXFile thenCreateShaderResourceView or CreateTexture

D3DX11CreateShaderResourceViewFromMemory
D3DX11CreateTextureFromMemory

DDSTextureLoader: CreateDDSTextureFromMemory
WICTextureLoader: CreateWICTextureFromMemory

DirectXTex library (tools), LoadFromXXXMemory thenCreateShaderResourceView or CreateTexture

D3DX11CreateShaderResourceViewFromResource
D3DX11CreateTextureFromResource

No direct equivalent, can use Win32 resource functions and then the ‘from memory’ APIs above.

D3DX11FilterTexture

DirectXTex library, GenerateMipMaps and GenerateMipMaps3D

D3DX11GetImageInfoFromFile

DirectXTex library, GetMetadataFromXXXFile

D3DX11GetImageInfoFromMemory

DirectXTex library, GetMetadataFromXXXMemory

D3DX11GetImageInfoFromResource

No direct equivalent, can use Win32 resource functions and then the ‘from memory’ APIs above.

D3DX11LoadTextureFromTexture

DirectXTex library, ResizeConvertCompressDecompress, and/or CopyRectangle

D3DX11SaveTextureToFile

ScreenGrab: SaveDDSTextureToFile or SaveWICTextureToFile

DirectXTex library, CaptureTexture then SaveToXXXFile

D3DX11SaveTextureToMemory

DirectXTex library, CaptureTexture then SaveToXXXMemory

Geometry Functions

The DirectXMesh library is intended for geometry processing offline with tools, although it can be used at runtime. You can find the library on CodePlex and GitHub.

D3DXCleanMeshCleanD3DXComputeNormalsComputeNormalsD3DXComputeTangent
D3DXComputeTangentFrame
D3DXComputeTangentFrameEx
ComputeTangentFrameID3DX10Mesh::GenerateAdjacencyAndPointRepsGenerateAdjacencyAndPointRepsID3DX10Mesh::GenerateGSAdjacencyGenerateGSAdjacencyID3DX10Mesh::OptimizeAttributeSort
OptimizeFacesEx
OptimizeVertices
ReorderIB
FinalizeIB
FinalizeVB
D3DXOptimizeFacesOptimizeFacesD3DXOptimizeVerticesOptimizeVerticesD3DXValidMeshValidate

Math

The legacy D3DXMath library has been replaced by DirectXMath. The library is in the Windows 8.x SDK and is included with VS 2012 and VS 2013 Preview.

D3DXFLOAT16HALFD3DXMATRIXA16XMMATRIX or XMFLOAT4X4A

D3DXQUATERNION

D3DXPLANE

D3DXCOLOR

XMVECTOR is used rather than having unique types, so you will likely need to use an XMFLOAT4D3DXVECTOR2XMFLOAT2D3DXVECTOR2_16FXMHALF2D3DXVECTOR3XMFLOAT3D3DXVECTOR4XMFLOAT4

(or if you can guarantee the data is 16-byte aligned, XMVECTOR orXMFLOAT4A )

D3DXVECTOR4_16FXMHALF4D3DX_PIXM_PID3DX_1BYPIXM_1DIVPID3DXToRadianXMConvertToRadiansD3DXToDegreeXMConvertToDegreesD3DXBoxBoundProbeBoundingBox::Intersects(XMVECTOR, XMVECTOR, float&)D3DXComputeBoundingBoxBoundingBox::CreateFromPointsD3DXComputeBoundingSphereBoundingSphere::CreateFromPointsD3DXSphereBoundProbeBoundingSphere::Intersects(XMVECTOR, XMVECTOR, float&)D3DXIntersectTriFunctionTriangleTests::IntersectsD3DXFloat32To16ArrayXMConvertFloatToHalfStreamD3DXFloat16To32ArrayXMConvertHalfToFloatStreamD3DXVec2LengthXMVector2Length or XMVector2LengthEstD3DXVec2LengthSqXMVector2LengthSqD3DXVec2DotXMVector2DotD3DXVec2CCWXMVector2CrossD3DXVec2AddXMVectorAddD3DXVec2SubtractXMVectorSubtractD3DXVec2MinimizeXMVectorMinD3DXVec2MaximizeXMVectorMaxD3DXVec2ScaleXMVectorScaleD3DXVec2LerpXMVectorLerp or XMVectorLerpVD3DXVec2NormalizeXMVector2Normalize or XMVector2NormalizeEstD3DXVec2HermiteXMVectorHermite or XMVectorHermiteVD3DXVec2CatmullRomXMVectorCatmullRom or XMVectorCatmullRomVD3DXVec2BaryCentricXMVectorBaryCentric or XMVectorBaryCentricVD3DXVec2TransformXMVector2TransformD3DXVec2TransformCoordXMVector2TransformCoordD3DXVec2TransformNormalXMVector2TransformNormalD3DXVec2TransformArrayXMVector2TransformStreamD3DXVec2TransformCoordArrayXMVector2TransformCoordStreamD3DXVec2TransformNormalArrayXMVector2TransformNormalStreamD3DXVec3LengthXMVector3Length or XMVector3LengthEstD3DXVec3LengthSqXMVector3LengthSqD3DXVec3DotXMVector3DotD3DXVec3CrossXMVector3CrossD3DXVec3AddXMVectorAddD3DXVec3SubtractXMVectorSubtractD3DXVec3MinimizeXMVectorMinD3DXVec3MaximizeXMVectorMaxD3DXVec3ScaleXMVectorScaleD3DXVec3LerpXMVectorLerp or XMVectorLerpVD3DXVec3NormalizeXMVector3Normalize or XMVector3NormalizeEstD3DXVec3HermiteXMVectorHermite or XMVectorHermiteVD3DXVec3CatmullRomXMVectorCatmullRom or XMVectorCatmullRomVD3DXVec3BaryCentricXMVectorBaryCentric or XMVectorBaryCentricVD3DXVec3TransformXMVector3TransformD3DXVec3TransformCoordXMVector3TransformCoordD3DXVec3TransformNormalXMVector3TransformNormalD3DXVec3TransformArrayXMVector3TransformStreamD3DXVec3TransformCoordArrayXMVector3TransformCoordStreamD3DXVec3TransformNormalArrayXMVector3TransformNormalStreamD3DXVec3ProjectXMVector3ProjectD3DXVec3UnprojectXMVector3UnprojectD3DXVec3ProjectArrayXMVector3ProjectStreamD3DXVec3UnprojectArrayXMVector3UnprojectStreamD3DXVec4LengthXMVector4Length or XMVector4LengthEstD3DXVec4LengthSqXMVector4LengthSqD3DXVec4DotXMVector4DotD3DXVec4AddXMVectorAddD3DXVec4SubtractXMVectorSubtractD3DXVec4MinimizeXMVectorMinD3DXVec4MaximizeXMVectorMaxD3DXVec4ScaleXMVectorScaleD3DXVec4LerpXMVectorLerp or XMVectorLerpVD3DXVec4CrossXMVector4CrossD3DXVec4NormalizeXMVector4Normalize or XMVector4NormalizeEstD3DXVec4HermiteXMVectorHermite or XMVectorHermiteVD3DXVec4CatmullRomXMVectorCatmullRom or XMVectorCatmullRomVD3DXVec4BaryCentricXMVectorBaryCentric or XMVectorBaryCentricVD3DXVec4TransformXMVector4TransformD3DXVec4TransformArrayXMVector4TransformStreamD3DXMatrixIdentityXMMatrixIdentityD3DXMatrixDeterminantXMMatrixDeterminantD3DXMatrixDecomposeXMMatrixDecomposeD3DXMatrixTransposeXMMatrixTransposeD3DXMatrixMultiplyXMMatrixMultiplyD3DXMatrixMultiplyTransposeXMMatrixMultiplyTransposeD3DXMatrixInverseXMMatrixInverseD3DXMatrixScalingXMMatrixScalingD3DXMatrixTranslationXMMatrixTranslationD3DXMatrixRotationXXMMatrixRotationXD3DXMatrixRotationYXMMatrixRotationYD3DXMatrixRotationZXMMatrixRotationZD3DXMatrixRotationAxisXMMatrixRotationAxisD3DXMatrixRotationQuaternionXMMatrixRotationQuaternionD3DXMatrixRotationYawPitchRollXMMatrixRotationRollPitchYaw
(Note the order of parameters is different:
D3DXMath takes yaw, pitch, roll,
DirectXMath takes pitch, yaw, roll)
D3DXMatrixTransformationXMMatrixTransformationD3DXMatrixTransformation2DXMMatrixTransformation2DD3DXMatrixAffineTransformationXMMatrixAffineTransformationD3DXMatrixAffineTransformation2DXMMatrixAffineTransformation2DD3DXMatrixLookAtRHXMMatrixLookAtRHD3DXMatrixLookAtLHXMMatrixLookAtLHD3DXMatrixPerspectiveRHXMMatrixPerspectiveRHD3DXMatrixPerspectiveLHXMMatrixPerspectiveLHD3DXMatrixPerspectiveFovRHXMMatrixPerspectiveFovRHD3DXMatrixPerspectiveFovLHXMMatrixPerspectiveFovLHD3DXMatrixPerspectiveOffCenterRHXMMatrixPerspectiveOffCenterRHD3DXMatrixPerspectiveOffCenterLHXMMatrixPerspectiveOffCenterLHD3DXMatrixOrthoRHXMMatrixOrthographicRHD3DXMatrixOrthoLHXMMatrixOrthographicLHD3DXMatrixOrthoOffCenterRHXMMatrixOrthographicOffCenterRHD3DXMatrixOrthoOffCenterLHXMMatrixOrthographicOffCenterLHD3DXMatrixShadowXMMatrixShadowD3DXMatrixReflectXMMatrixReflectD3DXQuaternionLengthXMQuaternionLengthD3DXQuaternionLengthSqXMQuaternionLengthSqD3DXQuaternionDotXMQuaternionDotD3DXQuaternionIdentityXMQuaternionIdentityD3DXQuaternionIsIdentityXMQuaternionIsIdentityD3DXQuaternionConjugateXMQuaternionConjugateD3DXQuaternionToAxisAngleXMQuaternionToAxisAngleD3DXQuaternionRotationMatrixXMQuaternionRotationMatrixD3DXQuaternionRotationAxisXMQuaternionRotationAxisD3DXQuaternionRotationYawPitchRollXMQuaternionRotationRollPitchYaw
(Note the order of parameters is different:
D3DXMath takes yaw, pitch, roll,
DirectXMath takes pitch, yaw, roll)
D3DXQuaternionMultiplyXMQuaternionMultiplyD3DXQuaternionNormalizeXMQuaternionNormalize or XMQuaternionNormalizeEstD3DXQuaternionInverseXMQuaternionInverseD3DXQuaternionLnXMQuaternionLnD3DXQuaternionExpXMQuaternionExpD3DXQuaternionSlerpXMQuaternionSlerp or XMQuaternionSlerpVD3DXQuaternionSquadXMQuaternionSquad or XMQuaternionSquadVD3DXQuaternionSquadSetupXMQuaternionSquadSetupD3DXQuaternionBaryCentricXMQuaternionBaryCentric or XMQuaternionBaryCentricVD3DXPlaneDotXMPlaneDotD3DXPlaneDotCoordXMPlaneDotCoordD3DXPlaneDotNormalXMPlaneDotNormalD3DXPlaneScaleXMVectorScaleD3DXPlaneNormalizeXMPlaneNormalize or XMPlaneNormalizeEstD3DXPlaneIntersectLineXMPlaneIntersectLineD3DXPlaneFromPointNormalXMPlaneFromPointNormalD3DXPlaneFromPointsXMPlaneFromPointsD3DXPlaneTransformXMPlaneTransformD3DXPlaneTransformArrayXMPlaneTransformStreamD3DXColorNegativeXMColorNegativeD3DXColorAddXMVectorAddD3DXColorSubtractXMVectorSubtractD3DXColorScaleXMVectorScaleD3DXColorModulateXMColorModulateD3DXColorLerpXMVectorLerp or XMVectorLerpVD3DXColorAdjustSaturationXMColorAdjustSaturationD3DXColorAdjustContrastXMColorAdjustContrastD3DXFresnelTermXMFresnelTerm

Spherical Harmonics Math

The SHmath library is available as an add-on for DirectXMath.

XMSHEvalDirectionEvaluates the Spherical Harmonic basis functions. Equivalent toD3DXSHEvalDirection function.XMSHRotateRotates SH vector by a rotation matrix. Equivalent to the D3DXSHRotate function.XMSHRotateZRotates the SH vector in the Z axis by an angle. Equivalent to the D3DXSHRotateZfunction.XMSHAddAdds two SH vectors. Equivalent to the D3DXSHAdd function.XMSHScaleScales a SH vector. Equivalent to the D3DXSHScale function.XMSHDotComputes the dot product of two SH vectors. Equivalent to the D3DXSHDotfunction.XMSHMultiply
XMSHMultiply2
XMSHMultiply3
XMSHMultiply4
XMSHMultiply5
XMSHMultiply6
Computes the product of two functions represented using SH. Equivalent toD3DXSHMultiply2, D3DXSHMultiply3, D3DXSHMultiply4, D3DXSHMultiply5, andD3DXSHMultiply6.XMSHEvalDirectionalLightEvaluates a directional light and returns spectral SH data. Equivalent to theD3DXSHEvalDirectionalLight function.XMSHEvalSphericalLightEvaluates a spherical light and returns spectral SH data. Equivalent to theD3DXEvalSphericalLight function.XMSHEvalConeLightEvaluates a light that is a cone of constant intensity and returns spectral SH data. Equivalent to the D3DXSHEvalConeLight function.XMSHEvalHemisphereLightEvaluates a light that is a linear interpolant between two colors over the sphere. Equivalent to the D3DXSHEvalHemisphereLight function.SHProjectCubeMapProjects a function represented in a cube map into spherical harmonics. Equivalent to the D3DX11SHProjectCubeMap function.

Effects (FX)

The Effects system for Direct3D 11 is primarily provided as a porting aid for older code. The library is available onCodePlex and GitHub.

D3DXCreateEffect
D3DXCreateEffectEx
D3DXCreateEffectFromResource
D3DXCreateEffectFromResourceEx
D3D10CompileEffectFromMemory

D3DX11CompileEffectFromMemory

D3DXCreateEffectFromFile
D3DXCreateEffectFromFileEx

D3DX11CompileEffectFromFile

D3D10CreateEffectFromMemory

D3DX11CreateEffectFromMemory

D3DXCreateEffectPool
D3D10CreateEffectPoolFromMemory

Effects 11 does not support 'effect pools'
or D3DCOMPILE_EFFECT_CHILD_EFFECT. Effect groups provide a more efficient solution for common scenarios previously addressed with 'effect pools'

D3DXDisassembleEffect
D3D10DisassembleEffect

D3DDisassemble
D3DDisassemble10Effect in D3DCompile

Performance/Profiling

D3DX9 included the entry-points intercepted by PIX for Windows for performance profiling. This is now handled by the DirectX runtime directly and is monitored by the Visual Studio Graphics Diagnostics tool.

D3DPERF_BeginEvent
D3DPERF_EndEvent
D3DPERF_SetMarker
D3DPERF_SetRegion
D3DPERF_QueryRepeatFrame
D3DPERF_SetOptions
D3DPERF_GetStatus

ID3DUserDefinedAnnotation which is supported by the DirectX 11.1 runtime on Windows 8.x and Windows 7 Service Pack 1 + KB2670838

If using DirectX 11.2+, you can use ID3D11DeviceContext2 directly for BeginEventInt, SetMarkerInt, and EndEvent.

UVAtlas Functions

The UVAtlas library is intended for isochart creation offline with tools, although it can be used at runtime. You can find the library on CodePlex and GitHub.

D3DXUVAtlasCreateUVAtlasCreateD3DXUVAtlasPartitionUVAtlasPartitionD3DXUVAtlasPackUVAtlasPackD3DXComputeIMTFromPerVertexSignalUVAtlasComputeIMTFromPerVertexSignalD3DXComputeIMTFromPerTexelSignalUVAtlasComputeIMTFromPerTexelSignalD3DXComputeIMTFromSignalUVAtlasComputeIMTFromSignalD3DXComputeIMTFromTextureUVAtlasComputeIMTFromTexture

Note

Careful readers will note that there are a few omissions from this table.

  • The ID3DXMatrixStack from D3DXMath doesn't have a new version, but it's actually pretty easy to implement your own. If someone has a burning need for this, please comment below.
  • The Precomputed Radiance Transfer (PRT) simulator is only available in closed-source form in legacy D3DX9. There are a number of papers that cover this technology in the literature, and the most generally useful parts of this functionality are the SHmath functions which are available.
0 0