DirectX基础 常用函数语句
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_ZERO
D3DBLEND_ONE
D3DBLEND_SRCCOLOR
D3DBLEND_INVSRCCOLOR
D3DBLEND_SRCALPHA
D3DBLEND_INVSRCALPHA
D3DBLEND_DESTALPHA
D3DBLEND_INDESTALPHA
D3DBLEND_DESTCOLOR
D3DBLEND_INVDESTCOLOR
D3DBLEND_SRCALPHASAT
D3DBLEND_BOTHINVSRCALPHA(该模式仅对D3DRS_SRCBLEND有效)
指定ALPHA来源：
//根据漫反射颜色计算Alpha Device->SetTextureStageState(0,D3DTSS_ALPHAARG1,D3DTA_DIFFUSE); Device->SetTextureStageState(0,D3DTSS_ALPHAAOP,D3DTOP_SELECTARG1);
//从Alpha通道获取Alpha Device->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_ZERO
D3DSTENCILOP_REPLACE
D3DSTENCILOP_INCRSAT
D3DSTENCILOP_DECRSAT
D3DSTENCILOP_INVERT
D3DSTENCILOP_INCR
D3DSTENCILOP_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 data Mesh->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默认为false
D3DRS_POINTSALEENABLE 默认为false，规定点的尺寸用屏幕坐标系的单位（即像素）来度量。若指定为true，则规定点的尺寸将用观察坐标系的单位来度量。
D3DRS_POINTSIZE用于指定点精灵的尺寸。
D3DRS_POINTSIZE_MIN
D3DRS_POINTSIZE_MAX
D3DRS_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)
