D3DXConcatenateMeshes fonction)

Concatène un groupe de maillages dans un maillage commun. Cette méthode peut éventuellement appliquer une transformation de matrice à chaque maillage d’entrée et ses coordonnées de texture.

Syntaxe

HRESULT D3DXConcatenateMeshes(
  _In_        LPD3DXMESH        *ppMeshes,
  _In_        UINT              NumMeshes,
  _In_        DWORD             Options,
  _In_  const D3DXMATRIX        *pGeomXForms,
  _In_  const D3DXMATRIX        *pTextureXForms,
  _In_  const D3DVERTEXELEMENT9 *pDecl,
  _In_        LPDIRECT3DDEVICE9 pD3DDevice,
  _Out_       LPD3DXMESH        *ppMeshOut
);

Paramètres

ppMeshes [ dans]

Type : LPD3DXMESH*

Tableau de pointeurs de maillage d’entrée (consultez ID3DXMesh). Le nombre d’éléments dans le tableau est NumMeshes.

NumMeshes [ dans]

Type : uint

Nombre de maillages d’entrée à concaténer.

Options [ dans]

Type : DWORD

Options de création de maillage ; Il s’agit d’une combinaison d’un ou plusieurs indicateurs D3DXMESH . Les options de création de maillage sont équivalentes au paramètre d’options requis par D3DXCreateMesh.

pGeomXForms [ dans]

Type : const D3DXMATRIX *

Tableau facultatif de transformations géométriques. Le nombre d’éléments dans le tableau est NumMeshes ; chaque élément est une matrice de transformation (consultez D3DXMATRIX). Peut avoir la valeur null.

pTextureXForms [ dans]

Type : const D3DXMATRIX *

Tableau facultatif de transformations de texture. Le nombre d’éléments dans le tableau est NumMeshes ; chaque élément est une matrice de transformation (consultez D3DXMATRIX). Ce paramètre peut avoir la valeur null.

pDecl [ dans]

Type : const D3DVERTEXELEMENT9 *

Pointeur facultatif vers une déclaration de vertex (consultez D3DVERTEXELEMENT9). Ce paramètre peut avoir la valeur null.

pD3DDevice [ dans]

Type : LPDIRECT3DDEVICE9

Pointeur vers un appareil IDirect3DDevice9 utilisé pour créer le nouveau maillage.

ppMeshOut [ à]

Type : LPD3DXMESH*

Adresse d’un pointeur vers la maille créée (voir ID3DXMesh).

Valeur retournée

Type : HRESULT

Si la fonction est réussie, la valeur de retour est S _ OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR _ INVALIDCALL, E _ OUTOFMEMORY.

Remarques

Si aucune déclaration de vertex n’est fournie dans le cadre du paramètre de création de maillage d’options, la méthode génère une Union de toutes les déclarations de vertex des sous-mailles, en promouvant les canaux et les types si nécessaire. La méthode crée une table d’attributs à partir des tables d’attributs des maillages d’entrée. Pour garantir la création d’une table d’attributs, appelez optimize avec les indicateurs définis sur D3DXMESHOPT _ compact et D3DXMESHOPT _ ATTRSORT (voir D3DXMESHOPT).

Configuration requise

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

Voir aussi

Fonctions de maillage