Fonction D3DXConcatenateMeshes

Article
06/13/2023

Concatène un groupe de maillages en 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 [in]

Type : LPD3DXMESH*

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

NumMeshes [in]

Type : UINT

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

Options [in]

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 [in]

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 (voir D3DXMATRIX). Peut être NULL.

pTextureXForms [in]

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 (voir D3DXMATRIX). Ce paramètre peut avoir la valeur NULL.

pDecl [in]

Type : const D3DVERTEXELEMENT9*

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

pD3DDevice [in]

Type : LPDIRECT3DDEVICE9

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

ppMeshOut [out]

Type : LPD3DXMESH*

Adresse d’un pointeur vers le maillage créé (voir ID3DXMesh).

Valeur retournée

Type : HRESULT

Si la fonction réussit, 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.

Notes

Si aucune déclaration de vertex n’est donnée dans le cadre du paramètre de création de maillage Options, la méthode génère une union de toutes les déclarations de vertex des sous-cœurs, 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 Optimiser avec indicateurs définis sur D3DXMESHOPT_COMPACT et D3DXMESHOPT_ATTRSORT (voir D3DXMESHOPT).

Spécifications

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

Voir aussi

Fonctions de maillage

Partager via