D3DXConvertMeshSubsetToStrips

Convert the specified mesh subset into a series of strips.

HRESULT D3DXConvertMeshSubsetToStrips(
  LPD3DXBASEMESH MeshIn,
  DWORD AttribId,
  DWORD IBOptions,
  LPDIRECT3DINDEXBUFFER9 * ppIndexBuffer,
  DWORD * pNumIndices,
  LPD3DXBUFFER * ppStripLengths,
  DWORD * pNumStrips
);

Parameters

MeshIn

[in] Pointer to an ID3DXBaseMesh interface, representing the mesh to convert to a strip.

AttribId

[in] Attribute ID of the mesh subset to convert to strips.

IBOptions

[in] Combination of one or more flags from the D3DXMESH enumeration, specifying options for creating the index buffer. Cannot be D3DXMESH_32BIT. The index buffer will be created with 32-bit or 16-bit indices depending on the format of the index buffer of the mesh specified by the MeshIn parameter.

ppIndexBuffer

[out] Pointer to an IDirect3DIndexBuffer9 interface, representing index buffer containing the strip.

pNumIndices

[out] Number of indices in the buffer returned in the ppIndexBuffer parameter.

ppStripLengths

[out] Buffer containing an array of one DWORD per strip, which specifies the number of triangles in the that strip.

pNumStrips

[out] Number of individual strips in the index buffer and corresponding strip length array.

Return Values

If the function succeeds, the return value is D3D_OK. If the function fails, the return value can be one of the following values: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Remarks

Before running this function, call ID3DXMesh::Optimize or D3DXOptimizeFaces, with the D3DXMESHOPT_ATTRSORT flag set.

Requirements

Header: Declared in D3dx9mesh.h.