Función D3DXConcatenateMeshes

Concatena un grupo de mallas en una malla común. Este método puede aplicar opcionalmente una transformación de matriz a cada malla de entrada y sus coordenadas de textura.

Sintaxis

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
);

Parámetros

ppMeshes [in]

Tipo: LPD3DXMESH*

Matriz de punteros de malla de entrada (consulte ID3DXMesh). El número de elementos de la matriz es NumMeshes.

NumMeshes [in]

Tipo: UINT

Número de mallas de entrada que se van a concatenar.

Opciones [in]

Tipo: DWORD

Opciones de creación de malla; se trata de una combinación de una o varias marcas D3DXMESH . Las opciones de creación de malla son equivalentes al parámetro options requerido por D3DXCreateMesh.

pGeomXForms [in]

Tipo: const D3DXMATRIX*

Matriz opcional de transformaciones de geometría. El número de elementos de la matriz es NumMeshes; cada elemento es una matriz de transformación (consulte D3DXMATRIX). Puede ser NULL.

pTextureXForms [in]

Tipo: const D3DXMATRIX*

Matriz opcional de transformaciones de textura. El número de elementos de la matriz es NumMeshes; cada elemento es una matriz de transformación (consulte D3DXMATRIX). Este parámetro puede ser NULL.

pDecl [in]

Tipo: const D3DVERTEXELEMENT9*

Puntero opcional a una declaración de vértice (vea D3DVERTEXELEMENT9). Este parámetro puede ser NULL.

pD3DDevice [in]

Tipo: LPDIRECT3DDEVICE9

Puntero a un dispositivo IDirect3DDevice9 que se usa para crear la nueva malla.

ppMeshOut [out]

Tipo: LPD3DXMESH*

Dirección de un puntero a la malla creada (consulte ID3DXMesh).

Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, el valor devuelto es S_OK. Si se produce un error en la función, el valor devuelto puede ser uno de estos: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Comentarios

Si no se da ninguna declaración de vértice como parte del parámetro de creación de malla Options, el método generará una unión de todas las declaraciones de vértice de los subprocesos, promoviendo canales y tipos si es necesario. El método creará una tabla de atributos a partir de tablas de atributos de las mallas de entrada. Para garantizar la creación de una tabla de atributos, llame a Optimize with Flags establecido en D3DXMESHOPT_COMPACT y D3DXMESHOPT_ATTRSORT (consulte D3DXMESHOPT).

Requisitos

Requisito	Value
Encabezado	D3DX9Mesh.h
Biblioteca	D3dx9.lib

Consulte también

Funciones de malla