D3DXCreateBox 函数

使用左手坐标系创建包含轴对齐框的网格。

语法

HRESULT D3DXCreateBox(
  _In_  LPDIRECT3DDEVICE9 pDevice,
  _In_  FLOAT             Width,
  _In_  FLOAT             Height,
  _In_  FLOAT             Depth,
  _Out_ LPD3DXMESH        *ppMesh,
  _Out_ LPD3DXBUFFER      *ppAdjacency
);

parameters

pDevice [in]

类型： LPDIRECT3DDEVICE9

指向 IDirect3DDevice9 接口的指针，表示与创建的框网格关联的设备。

Width [in]

类型： FLOAT

框的宽度，沿 x 轴。

高度 [in]

类型： FLOAT

框的高度，沿 y 轴。

深度 [in]

类型： FLOAT

框的深度，沿 z 轴。

ppMesh [out]

类型： LPD3DXMESH*

指向输出形状的指针的地址， ID3DXMesh 接口。

ppAdjacency [out]

类型： LPD3DXBUFFER*

指向 ID3DXBuffer 接口的指针的地址。 方法返回时，此参数使用每个人脸三个 DWORD 的数组填充，该数组为网格中每个人脸指定三个邻居。 可以指定 NULL。

返回值

类型： HRESULT

如果函数成功，则返回值D3D_OK。 如果函数失败，则返回值可以是以下值之一：D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA E_OUTOFMEMORY。

备注

创建的框在原点居中。

此函数使用D3DXMESH_MANAGED创建选项创建网格， 并D3DFVF_XYZ |D3DFVF_NORMAL FVF) (灵活顶点格式。

要求

请参阅

形状绘制函数