D3DXComputeIMTFromSignal fonction)

Calcule les IMTs par triangle à partir d’un signal spécifié par l’application, qui varie en fonction de la surface du maillage (généralement à une fréquence plus élevée que les données de vertex). Le signal est évalué par le biais d’une fonction de rappel spécifiée par l’utilisateur.

Syntaxe

HRESULT D3DXComputeIMTFromSignal(
  _In_  LPD3DXMESH              pMesh,
  _In_  DWORD                   dwTextureIndex,
  _In_  UINT                    uSignalDimension,
  _In_  FLOAT                   fMaxUVDistance,
  _In_  DWORD                   dwOptions,
  _In_  LPD3DXIMTSIGNALCALLBACK pSignalCallback,
  _In_  VOID                    *pUserData,
        LPD3DXUVATLASCB         pStatusCallback,
        LPVOID                  pUserContext,
  _Out_ LPD3DXBUFFER            *ppIMTData
);

Paramètres

pMesh [ dans]

Type : LPD3DXMESH

Pointeur vers un maillage d’entrée (voir ID3DXMesh) qui contient la géométrie d’objet pour le calcul du IMT.

dwTextureIndex [ dans]

Type : DWORD

Index de coordonnées de texture de base zéro qui identifie le jeu de coordonnées de texture à utiliser.

uSignalDimension [ dans]

Type : uint

Nombre de composants dans chaque point de données dans le signal.

fMaxUVDistance [ dans]

Type : float

Distance maximale entre les vertex ; l’algorithme continue à se subdiviser jusqu’à ce que la distance entre tous les vertex soit inférieure ou égale à fMaxUVDistance.

dwOptions [ dans]

Type : DWORD

Options de retour à la ligne. Il s’agit d’une combinaison d’un ou plusieurs indicateurs D3DXIMT.

pSignalCallback [ dans]

Type : LPD3DXIMTSIGNALCALLBACK

Pointeur vers une fonction évaluateur fournie par l’utilisateur, qui sera utilisée pour calculer la valeur de signal à des coordonnées U, V arbitraires. La fonction suit le prototype de LPD3DXIMTSIGNALCALLBACK.

pUserData [ dans]

Type : void *

Pointeur vers une valeur définie par l’utilisateur qui est passée à la fonction de rappel de signal. Généralement utilisé par une application pour passer un pointeur vers une structure de données qui fournit des informations de contexte pour la fonction de rappel.

pStatusCallback

Type : LPD3DXUVATLASCB

Pointeur vers une fonction de rappel pour surveiller la progression du calcul IMT.

pUserContext

Type : LPVOID

Pointeur vers une variable définie par l’utilisateur qui est passée à la fonction de rappel d’État. Généralement utilisé par une application pour passer un pointeur vers une structure de données qui fournit des informations de contexte pour la fonction de rappel.

ppIMTData [ à]

Type : LPD3DXBUFFER*

Pointeur vers la mémoire tampon (consultez ID3DXBuffer) contenant le tableau IMT retourné. Ce tableau peut être fourni comme entrée aux fonctions D3DX UVAtlas pour classer par ordre de priorité l’allocation d’espace de texture dans le paramétrage de la texture.

Valeur de retour

Type : HRESULT

Si la fonction est réussie, la valeur de retour est D3D _ OK ; sinon, la valeur est D3DERR _ INVALIDCALL.

Notes

Cette fonction requiert que le maillage d’entrée contienne un mappage de texture signal-à-maillage (coordonnées de texture). Elle permet à l’utilisateur de définir un signal arbitrairement sur la surface de la maille.

Spécifications

Condition requise Valeur
En-tête
D3DX9Mesh. h
Bibliothèque
D3dx9. lib

Voir aussi

UVAtlas, fonctions

Utilisation de UVAtlas (Direct3D 9)