Função D3DXConcatenateMeshes

Concatena um grupo de malhas em uma malha comum. Opcionalmente, esse método pode aplicar uma transformação de matriz a cada malha de entrada e suas coordenadas de textura.

Sintaxe

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 ponteiros de malha de entrada (consulte ID3DXMesh). O número de elementos na matriz é NumMeshes.

NumMeshes [in]

Tipo: UINT

Número de malhas de entrada para concatenar.

Opções [in]

Tipo: DWORD

Opções de criação de malha; essa é uma combinação de um ou mais sinalizadores D3DXMESH . As opções de criação de malha são equivalentes ao parâmetro de opções exigido por D3DXCreateMesh.

pGeomXForms [in]

Tipo: const D3DXMATRIX*

Matriz opcional de transformações de geometria. O número de elementos na matriz é NumMeshes; cada elemento é uma matriz de transformação (consulte D3DXMATRIX). Pode ser NULL.

pTextureXForms [in]

Tipo: const D3DXMATRIX*

Matriz opcional de transformações de textura. O número de elementos na matriz é NumMeshes; cada elemento é uma matriz de transformação (consulte D3DXMATRIX). Esse parâmetro pode ser NULL.

pDecl [in]

Tipo: const D3DVERTEXELEMENT9*

Ponteiro opcional para uma declaração de vértice (consulte D3DVERTEXELEMENT9). Esse parâmetro pode ser NULL.

pD3DDevice [in]

Tipo: LPDIRECT3DDEVICE9

Ponteiro para um dispositivo IDirect3DDevice9 que é usado para criar a nova malha.

ppMeshOut [out]

Tipo: LPD3DXMESH*

Endereço de um ponteiro para a malha criada (consulte ID3DXMesh).

Valor retornado

Tipo: HRESULT

Se a função for bem-sucedida, o valor retornado será S_OK. Se a função falhar, o valor retornado poderá ser um destes: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Comentários

Se nenhuma declaração de vértice for fornecida como parte do parâmetro de criação da malha Opções, o método gerará uma união de todas as declarações de vértice dos submeshes, promovendo canais e tipos, se necessário. O método criará uma tabela de atributo a partir de tabelas de atributo das malhas de entrada. Para garantir a criação de uma tabela de atributos, chame Otimizar com sinalizadores definidos como D3DXMESHOPT_COMPACT e D3DXMESHOPT_ATTRSORT (consulte D3DXMESHOPT).

Requisitos

Requisito	Valor
parâmetro	D3DX9Mesh.h
Biblioteca	D3dx9.lib

Confira também

Funções de malha