Microsoft DirectX 8.0 (C++)

D3DXCreateSkinMesh

Creates an empty skin mesh object using a declarator.

HRESULT D3DXCreateSkinMesh(
  DWORD numFaces,
  DWORD numVertices,
  DWORD numBones,
  DWORD Options,
  CONST DWORD* pDeclaration,
  LPDIRECT3DDEVICE8 pDevice,
  LPD3DXSKINMESH* ppSkinMesh
);

Parameters

numFaces
[in] Number of faces for the skin mesh.
numVertices
[in] Number of vertices for the skin mesh.
numBones
[in] Number of bones for the skin mesh.
Options
[in] A combination of one or more flags, specifying creation options for the mesh. The following flags are defined.
D3DXMESH_32BIT
The mesh has 32-bit indices instead of 16-bit indices. A 32-bit mesh can support up to 2^32-1 faces and vertices. This flag is not supported and should not be used.
D3DXMESH_DONOTCLIP
Use the D3DUSAGE_DONOTCLIP usage flag for vertex and index buffers.
D3DXMESH_DYNAMIC
Equivalent to specifying both D3DXMESH_VB_DYNAMIC and D3DXMESH_IB_DYNAMIC.
D3DXMESH_RTPATCHES
Use the D3DUSAGE_RTPATCHES usage flag for vertex and index buffers.
D3DXMESH_NPATCHES
Specifying this flag causes the vertex and index buffer of the mesh to be created with D3DUSAGE_NPATCHES flag. This is required if the mesh object is to be rendered using N-Patch enhancement using Microsoft® Direct3D®.
D3DXMESH_MANAGED
Equivalent to specifying both D3DXMESH_VB_MANAGED and D3DXMESH_IB_MANAGED.
D3DXMESH_POINTS
Use the D3DUSAGE_POINTS usage flag for vertex and index buffers.
D3DXMESH_IB_DYNAMIC
Use the D3DUSAGE_DYNAMIC usage flag for index buffers.
D3DXMESH_IB_MANAGED
Use the D3DPOOL_MANAGED memory class for index buffers.
D3DXMESH_IB_SYSTEMMEM
Use the D3DPOOL_SYSTEMMEM memory class for index buffers.
D3DXMESH_IB_WRITEONLY
Use the D3DUSAGE_WRITEONLY usage flag for index buffers.
D3DXMESH_SYSTEMMEM
Equivalent to specifying both D3DXMESH_VB_SYSTEMMEM and D3DXMESH_IB_SYSTEMMEM.
D3DXMESH_VB_DYNAMIC
Use the D3DUSAGE_DYNAMIC usage flag for vertex buffers.
D3DXMESH_VB_MANAGED
Use the D3DPOOL_MANAGED memory class for vertex buffers.
D3DXMESH_VB_SYSTEMMEM
Use the D3DPOOL_SYSTEMMEM memory class for vertex buffers.
D3DXMESH_VB_WRITEONLY
Use the D3DUSAGE_WRITEONLY usage flag for vertex buffers.
D3DXMESH_WRITEONLY
Equivalent to specifying both D3DXMESH_VB_WRITEONLY and D3DXMESH_IB_WRITEONLY.
pDeclaration
[in] Pointer to a DWORD value, representing the declarator that describes the vertex format for the returned skin mesh.
pDevice
[in] Pointer to an IDirect3DDevice8 interface, the device object to be associated with the skin mesh.
ppSkinMesh
[out, retval] Address of a pointer to an ID3DXSkinMesh interface, representing the created skin mesh object.

Return Values

If the function succeeds, the return value is D3D_OK.

If the function fails, the return value can be E_OUTOFMEMORY.

Remarks

Use ID3DXSkinMesh::SetBoneInfluence to populate the empty skin mesh object returned by this method.

Requirements

  Header: Declared in D3dx8mesh.h.
  Import Library: Use D3dx8.lib.

See Also

ID3DXSkinMesh::SetBoneInfluence