ID3DXPRTBuffer::ExtractToMesh method

Extracts coefficient data from a single-channel buffer and adds the data to an ID3DXMesh object.

Syntax

HRESULT ExtractToMesh(
  [in] UINT         NumCoefficients,
  [in] D3DDECLUSAGE Usage,
  [in] UINT         UsageIndexStart,
  [in] LPD3DXMESH   pScene
);

Parameters

NumCoefficients [in]

Type: UINT

Number of coefficients to extract from the buffer. When using spherical harmonic (SH) precomputed radiance transfer (PRT), the number of coefficients should be Order ². Order must be in the range of D3DXSH_MINORDER to D3DXSH_MAXORDER, inclusive.

Usage [in]

Type: D3DDECLUSAGE

Vertex usage descriptions of the mesh. See D3DDECLUSAGE.

UsageIndexStart [in]

Type: UINT

Starting index for coefficients to be stored in the mesh.

pScene [in]

Type: LPD3DXMESH

Pointer to an ID3DXMesh mesh object that will store coefficients.

Return value

Type: HRESULT

If the method succeeds, the return value is S_OK. If the method fails, the return value can be one of the following: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Requirements

Requirement	Value
Header	D3DX9Mesh.h
Library	D3dx9.lib

See also

ID3DXPRTBuffer