Funzione D3DXComputeIMTFromTexture

Articolo
06/13/2023

Calcola per triangolo IMT da una trama mappata su una mesh, da usare facoltativamente come input alle funzioni UVAtlas D3DX.

Sintassi

HRESULT D3DXComputeIMTFromTexture(
  _In_  LPD3DXMESH         pMesh,
  _In_  LPDIRECT3DTEXTURE9 pTexture,
  _In_  DWORD              dwTextureIndex,
  _In_  DWORD              dwOptions,
        LPD3DXUVATLASCB    pStatusCallback,
        LPVOID             pUserContext,
  _Out_ LPD3DXBUFFER       *ppIMTData
);

Parametri

pMesh [in]

Tipo: LPD3DXMESH

Puntatore a una mesh di input (vedere ID3DXMesh) che contiene la geometria dell'oggetto per calcolare IMT.

pTexture [in]

Tipo: LPDIRECT3DTEXTURE9

Puntatore alla trama (vedere IDirect3DTexture9) mappata alla mesh.

dwTextureIndex [in]

Tipo: DWORD

Indice di coordinate della trama in base zero che identifica il set di coordinate della trama da usare.

dwOptions [in]

Tipo: DWORD

Opzioni di wrapping della trama. Si tratta di una combinazione di uno o più FLAG D3DXIMT.

pStatusCallback

Tipo: LPD3DXUVATLASCB

Puntatore a una funzione di callback per monitorare lo stato di calcolo di IMT.

pUserContext

Tipo: LPVOID

Puntatore a una variabile definita dall'utente che viene passata alla funzione di callback di stato. In genere usato da un'applicazione per passare un puntatore a una struttura di dati che fornisce informazioni di contesto per la funzione di callback.

ppIMTData [out]

Tipo: LPD3DXBUFFER*

Puntatore al buffer (vedere ID3DXBuffer) contenente la matrice IMT restituita. Questa matrice può essere fornita come input per le funzioni UVAtlas D3DX per assegnare priorità all'allocazione dello spazio della trama nella parametrizzazione della trama.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito è D3D_OK; in caso contrario, il valore è D3DERR_INVALIDCALL.

Commenti

Dato una trama che esegue il mapping sulla superficie della mesh, l'algoritmo calcola IMT per ogni viso. In questo modo, i triangoli contenenti dati di segnale con frequenza inferiore richiedono meno spazio nell'atlas della trama finale quando vengono parametrizzati con le funzioni UVAtlas. Si presuppone che la trama venga interpolata sulla mesh bilinearly.

Requisiti

Requisito	Valore
Intestazione	D3DX9Mesh.h
Libreria	D3dx9.lib

Vedi anche

Funzioni UVAtlas
Uso di UVAtlas (Direct3D 9)