DirectX常用函数语句

 

常用数学类函数：

　　计算向量的长度（模）：　

FLOAT D3DXVec3Length(CONST D3DXVECTOR3* pV);

 　　向量的规范化：　

D3DXVECTOR3 *D3DXVec3Normalize(D3DXVECTOR3* pOut, CONST D3DXVECTOR3* pV);

　　点积：　

FLOAT D3DXVec3Dot(CONST D3DXVECTOR3* pV1, CONST D3DXVECTOR3* pV2);

　　叉积：

D3DXVECTOR3 *  D3DXVec3Cross(D3DXVECTOR3* pOut,CONST D3DXVECTOR3* pV1, CONST D3DXVECTOR3* pV2);

 

　　创建镜像变换矩阵：

D3DXMATRIX * D3DXMatrixReflect(D3DXMATRIX *pOut,CONST D3DXPLANE *pPlane);

 

　　创建阴影矩阵：

D3DXMATRIX * D3DXMatrixShadow(D3DXMATRIX *pOut,CONST D3DXVECTOR4 *pLight,CONST D3DXPLANE *pPlane);

 

　　绕任意轴旋转的矩阵：

D3DXMATRIX *D3DXMatrixRotationAxis(D3DXMATRIX *pOut,  //返回旋转矩阵CONST D3DXVECTOR3 *pV,FLOAT Angle)

 

　　变换点：

// Transform (x, y, z, 1) by matrix, project result back into w=1.D3DXVECTOR3* WINAPI D3DXVec3TransformCoord    ( D3DXVECTOR3 *pOut, CONST D3DXVECTOR3 *pV, CONST D3DXMATRIX *pM );

 

　　变换向量：

// Transform (x, y, z, 0) by matrix.  If you transforming a normal by a// non-affine matrix, the matrix you pass to this function should be the// transpose of the inverse of the matrix you would use to transform a coord.D3DXVECTOR3* WINAPI D3DXVec3TransformNormal    ( D3DXVECTOR3 *pOut, CONST D3DXVECTOR3 *pV, CONST D3DXMATRIX *pM );

 

 

常用相机相关函数：

　　创建视矩阵：

D3DXMATRIX *D3DXMatrixLookAtLH(D3DXMATRIX* pOut,CONST D3DXVECTOR3* pEye,CONST D3DXVECTOR3* pAt,CONST D3DXVECTOR3* pUp)

　　设定视矩阵：

Device->SetTransform(D3DTS_VIEW,&V);

 

　　创建投影矩阵：

D3DXMATRIX *D3DXMatrixPerspectiveFovLH(D3DXMATRIX* pOut,FLOAT fovY,  //垂直方向的视场角（单位为弧度）FLOAT Aspect,FLOAT zn,  //到近平面的距离FLOAT zf);

　　设定投影矩阵：

Device->SetTransform(D3DTS_PROJECTION,&proj);

 

 

渲染状态设置：

　　背面消隐：

Device->SetRenderState(D3DRS_CULLMODE,Value);

　　其中Value可以取值：D3DCULL_NONE或D3DCULL_CW、D3DCULL_CCW

 

光照类函数：

　　镜面反射分量开启：　　

Device->SetRenderState(D3DRS_SPECULARENABLE, true);

　　所有法向量重新规范化：

Device->SetRenderState(D3DRS_NORMALIZENORMALS, true);

　　对光源进行注册：

Device->SetLight(0,&light);

　　使能光源：

Device->LightEnable(0,true);

　　启用光照：

Device->SetRenderState(D3DRS_LIGHTING, true);  //默认状态下光照是启用的，但是显示指定并无大碍

　　设定材质：

D3DMATERIAL9 mtrl;//。。。。设置材质参数Device->SetMaterial(&mtrl);

 

纹理：

　　从图像文件中读入纹理数据，然后加载到IDirect3DTexture9对象中：

HRESULT D3DXCreateTextureFromFile(LPDIRECT3DDEVICE9 pDevice,LPCTSTR pSrcFile,LPDIRECT3DTEXTURE9 *ppTexture);

 

　　设置当前纹理：

HRESULT IDirect3DDevice9::SetTexture(DWORD Stage,IDirect3DBaseTexture9 *pTexture);

 

　　设置纹理过滤方式：

　　放大过滤器：

Device->SetSamplerState(0,D3DSAMP_MAGFILTER,D3DTEXF_POINT);

　　缩小过滤器：

Device->SetSamplerState(0,D3DSAMP_MINFILTER,D3DTEXF_POINT);

 

　　放大过滤器：

Device->SetSamplerState(0,D3DSAMP_MAGFILTER,D3DTEXF_LINEAR);

　　缩小过滤器：

Device->SetSamplerState(0,D3DSAMP_MINFILTER,D3DTEXF_LINEAR);

 

　　放大过滤器：

Device->SetSamplerState(0,D3DSAMP_MAGFILTER,D3DTEXF_ANISOTROPIC);

　　缩小过滤器：

Device->SetSamplerState(0,D3DSAMP_MINFILTER,D3DTEXF_ANISOTROPIC);

 

　　使用各向异性纹理过滤时，必须对D3DSAMP_MAXANISOTROPIC水平值进行设定，该值决定了各向异性过滤的质量水平。

Device->SetSamplerState(0,D3DSAMP_MAXANISOTROPIC,4);

 

　　多级渐进纹理过滤器设置：

Device->SetSamplerState(0,D3DSAMP_MIPFILTER,Filter);

　　Filter可取以下值：

　　D3DTEXF_NONE, D3DTEXF_POINT, D3DTEXF_LINEAR

 

　　寻址模式：

　　重复寻址模式Wrap：

Device->SetSamplerState(0,D3DSAMP_ADDRESSU, D3DTADDRESS_WRAP);Device->SetSamplerState(0,D3DSAMP_ADDRESSV, D3DTADDRESS_WRAP);

 

　　边界颜色（border color）寻址模式：

Device->SetSamplerState(0,D3DSAMP_ADDRESSU, D3DTADDRESS_BORDER);Device->SetSamplerState(0,D3DSAMP_ADDRESSV, D3DTADDRESS_BORDER);Device->SetSamplerState(0,D3DSAMP_BORDERCOLOR, 0x000000ff);

 

　　箝位（Clamp）寻址模式：

Device->SetSamplerState(0,D3DSAMP_ADDRESSU, D3DTADDRESS_CLAMP);Device->SetSamplerState(0,D3DSAMP_ADDRESSV, D3DTADDRESS_CLAMP);

 

　　镜像（Mirror）寻址模式：

Device->SetSamplerState(0,D3DSAMP_ADDRESSU, D3DTADDRESS_MIRROR);Device->SetSamplerState(0,D3DSAMP_ADDRESSV, D3DTADDRESS_MIRROR);

 

 

融合技术：

　　启用融合运算：（默认禁止）

Device->SetRenderState(D3DRS_ALPHABLENDENABLE,true);

 

　　设定融合因子：

Device->SetRenderState(D3DRS_SRCBLEND,Souce);Device->SetRenderState(D3DRS_DESTBLEND,Destination);

　　其中，Source和Destination可取下列融合因子：

　　源融合因子和目标融合因子的默认值分别是D3DBLEND_SRCALPHA  和D3DBLEND_INVSRCALPHA

 

D3DBLEND_ZEROD3DBLEND_ONED3DBLEND_SRCCOLORD3DBLEND_INVSRCCOLORD3DBLEND_SRCALPHAD3DBLEND_INVSRCALPHAD3DBLEND_DESTALPHAD3DBLEND_INDESTALPHAD3DBLEND_DESTCOLORD3DBLEND_INVDESTCOLORD3DBLEND_SRCALPHASATD3DBLEND_BOTHINVSRCALPHA(该模式仅对D3DRS_SRCBLEND有效)

 

　　指定ALPHA来源：

//根据漫反射颜色计算AlphaDevice->SetTextureStageState(0,D3DTSS_ALPHAARG1,D3DTA_DIFFUSE);Device->SetTextureStageState(0,D3DTSS_ALPHAAOP,D3DTOP_SELECTARG1);

 

//从Alpha通道获取AlphaDevice->SetTextureStageState(0,D3DTSS_ALPHAARG1,D3DTA_TEXTURE);Device->SetTextureStageState(0,D3DTSS_ALPHAAOP,D3DTOP_SELECTARG1);

 

 

模板：

　　启用和禁用模板缓存：

Device->SetRenderState(D3DRS_STENCILENABLE,true);Device->SetRenderState(D3DRS_STENCILENABLE,false);

 

　　模板测试：

(ref & mask) ComparisonOperation(value & mask)

 

　　模板参考值ref的默认值为0，改变该值：

Device->SetRenderState(D3DRS_STENCILREF,0x1);

 

　　模板掩码mask的默认值为0xffffffff，改变该值：

Device->SetRenderState(D3DRS_STENCILMASK,0x0000ffff);

 

 

　　通过绘制状态D3DRS_STENCILFUNC来设置比较运算函数：

　　该比较运算函数可以取自枚举类型D3DCMPFUNC

　　

　　

　　模板缓存的更新：

Device->SetRenderState(D3DRS_STENCILFAIL,StencilOperation);Device->SetRenderState(D3DRS_STENCILZFAIL, StencilOperation);Device->SetRenderState(D3DRS_STENCILPASS, StencilOperation);

 

　　StencilOperation可取以下预定义常量：

D3DSTENCILOP_KEEP 不更新模板缓存的值，保留当前值D3DSTENCILOP_ZEROD3DSTENCILOP_REPLACED3DSTENCILOP_INCRSATD3DSTENCILOP_DECRSATD3DSTENCILOP_INVERTD3DSTENCILOP_INCRD3DSTENCILOP_DECR

 

　　模板写掩码：

Device->SetRenderState(D3DRS_STENCILWRITEMASK,0x0000ffff);

 

网格：

　　得到指向顶点缓存和索引缓存接口的指针：

HRESULT ID3DXMesh :: GetVertexBuffer(LPDIRECT3DVERTEXBUFFER9* ppVB);HRESULT ID3DXMesh :: GetIndexBuffer(LPDIRECT3DINDEXBUFFER9* ppIB);

 

　　锁定顶点缓存和索引缓存：

HRESULT ID3DXMesh :: LockVertexBuffer(DWORD Flags,BYTE** ppData);HRESULT ID3DXMesh :: LockIndexBuffer(DWORD Flags,BYTE** ppData);

　　当该函数返回时，ppData返回指向被锁定的内存的指针的地址。

　　当对被锁定内存完成操作后，务必调用相应的解锁方法：

HRESULT ID3DXMesh :: UnlockVertexBuffer();HRESULT ID3DXMesh :: UnlockIndexBuffer();

 

　　ID3DXMesh接口用于获取几何信息的另外一些方法：

DWORD GetFVF();DWORD GetNumVertices();DWORD GetNumBytesPerVertex();DWORD GetNumFaces();

 

　　访问属性缓存，必须先将其锁定：

DWORD* buffer=0;Mesh->LockAttributeBuffer(lockingFlags, &buffer);//Read or write to attribute buffer…..Mesh->UnlockAttributeBuffer();

 

　　绘制：

Mesh->DrawSubset(0);Mesh->DrawSubset(i);

 

　　网格优化：

HRESULT ID3DXMesh :: OptimizeInplace(DWORD Flags,CONST DWORD* pAdjacencyIn,DWORD* pAdjacencyOut,DWORD* pFaceRemap,LPD3DXBUFFER* ppVertexRemap);

 

 

　　访问一个网格面的属性表：

HRESULT ID3DXMesh :: GetAttributeTable(D3DXATTRIBUTERANGE *pAttribTable,DWORD *pAttribTableSize);

　　对属性表进行设置：

D3DXATTRIBUTERANGE attributeTable[12];//…fill attributeTable array with dataMesh->SetAttributeTable(attributeTable,12);

 

　　输出邻接信息：

HRESULT ID3DXMesh :: GenerateAdjacency(FLOAT fEpsilon,DWORD* pAdjacency);

 

　　生成网格数据的一个副本：

HRESULT ID3DXMesh :: CloneMeshFVF(DWORD Options, 创建标记或标记组合DWORD FVF, 所要创建的克隆网格的灵活顶点格式LPDIRECT3DDEVICE9 pDevice,LPD3DXMESH *ppCloneMesh)

 

　　创建空网格：

HRESULT WINAPI D3DXCreateMeshFVF(DWORD NumFaces,DWORD NumVertices,DWORD Options,DWORD FVF,LPDIRECT3DDEVICE9 pDevice,LPD3DXMESH *ppMesh)

 

　　创建空网格2：

HRESULT D3DXCreateMesh (DWORD NumFaces,DWORD NumVertices,DWORD Options,CONST LPD3DVERTEXELEMENT9* pDeclaration， 数组，描述顶点数据的布局方式LPDIRECT3DDEVICE9 pDevice,LPD3DXMESH *ppMesh)

 

　　格式相关函数：

HRESULT D3DXDeclaratorFromFVF(DWORD FVF,D3DVERTEXELEMENT9 Declaration[MAX_FVF_DECL_SIZE])

 

　　加载XFile文件：

HRESULT D3DXLoadMeshFromX(LPCSTR pFilename,DWORD Options,LPDIRECT3DDEVICE9 pDevice,LPD3DXBUFFER *ppAdjacency,LPD3DXBUFFER *ppMaterials,LPD3DXBUFFER *ppEffectInstances, 该参数返回一个ID3DXBuffer对象，该对象包含了一个D3DXEFFECTINSTANCE结构。可以通过指定该参数为0而将其忽略。PDWORD pNumMaterials,LPD3DXMESH *ppMesh);

 

　　产生任意网格的顶点法向量：

HRESULT D3DXComputeNormals(LPD3DXBASEMESH pMesh,CONST DWORD *pAdjacency)

 

　　注意：必须包含标记D3DFVF_NORMAL

 

　　生成渐进网格：

HRESULT D3DXGeneratePMesh(LPD3DXMESH pMesh,CONST DWORD *pAdjacency,CONST D3DXATTRIBUTEWEIGHTS *pVertexAttributeWeights,CONST FLOAT *pVertexWeights,DWORD MinValue,DWORD Options,LPD3DXPMESH *ppPMesh)

 

　　设置网格面片数被简化到的个数：

HRESULT SetNumFaces(DWORD Faces)

 

　　设置网格的顶点数被简化到的个数：

HRESULT SetNumVertices(DWORD Vertices)

 

　　计算网格的外接球：

HRESULT WINAPI D3DXComputeBoundingSphere(CONST D3DXVECTOR3 *pFirstPosition,DWORD NumVertices,DWORD dwStride,D3DXVECTOR3 *pCenter,FLOAT *pRadius)

 

　　计算外接体：

HRESULT WINAPI D3DXComputeBoundingBox(CONST D3DXVECTOR3 *pFirstPosition,DWORD NumVertices,DWORD dwStride,D3DXVECTOR3 *pMin,D3DXVECTOR3 *pMax)

 

 

粒子系统：

　　点精灵的行为由绘制状态来控制：

D3DRS_POINTSPRITEENABLE默认为falseD3DRS_POINTSALEENABLE 默认为false，规定点的尺寸用屏幕坐标系的单位（即像素）来度量。若指定为true，则规定点的尺寸将用观察坐标系的单位来度量。D3DRS_POINTSIZE用于指定点精灵的尺寸。D3DRS_POINTSIZE_MIND3DRS_POINTSIZE_MAXD3DRS_POINTSCALE_A, D3DRS_POINTSCALE_B,D3DRS_POINTSCALE_C,这三个常量控制了点精灵的尺寸如何随距离发生变化。

                      

　　创建顶点缓存：

Device->CreateVertexBuffer(-vbSize*sizeof(Particle),D3DUSAGE_DYNAMIC|D3DUSAGE_POINTS|D3DUSAGE_WRITEONLY,Particle::FVF,D3DPOOL_DEFAULT,&_vb,0)