D3DXComputeIMTFromPerTexelSignal

Calculate per-triangle IMT's from per-texel data. This function is similar to D3DXComputeIMTFromTexture, but it uses a float array to pass in the data, and it can calculate higher dimensional values than 4.

HRESULT D3DXComputeIMTFromPerTexelSignal(
  LPD3DXMESH pMesh,
  DWORD dwTextureIndex,
  FLOAT * pfTexelSignal,
  UINT uWidth,
  UINT uHeight,
  UINT uSignalDimension,
  UINT uComponents,
  DWORD dwOptions,
  LPD3DXUVATLASCB pStatusCallback,
  LPVOID pUserContext,
  LPD3DXBUFFER * ppIMTData
);

Parameters

pMesh

[in] A pointer to an input mesh (see ID3DXMesh) which contains the object geometry for calculating the IMT.

dwTextureIndex

[in] Zero-based texture coordinate index that identifies which set of texture coordinates to use.

pfTexelSignal

[in] A pointer to an array of input texels from which IMT will be computed. The array size is uWidth*uHeight*uComponents.

uWidth

[in] Texture width in pixels.

uHeight

[in] Texture height in pixels.

uSignalDimension

[in] The number of floats per-component in each element of the signal array.

uComponents

[in] The number of components in each texel.

dwOptions

[in] Texture wrap options. This is a combination of one or more D3DXIMT FLAGS.

pStatusCallback

[in] A pointer to a callback function to monitor IMT computation progress.

pUserContext

[in] A pointer to a user-defined variable which is passed to the status callback function. Typically used by an application to pass a pointer to a data structure that provides context information for the callback function.

ppIMTData

[out] A pointer to the buffer (see ID3DXBuffer) containing the returned IMT array. This array can be provided as input to the D3DX UVAtlas Functions to prioritize texture-space allocation in the texture parameterization.

Return Values

If the function succeeds, the return value is D3D_OK; otherwise, the value is D3DERR_INVALIDCALL.

Requirements

Header: Declared in D3dx9mesh.h.

See Also

Using UVAtlas