D3DXConcatenateMeshes-Funktion

Verkettet eine Gruppe von Gittern zu einem gemeinsamen Gitter. Diese Methode kann optional eine Matrixtransformation auf jedes Eingabegitter und seine Texturkoordinaten anwenden.

Syntax

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

Parameter

ppMeshes [in]

Typ: LPD3DXMESH*

Array von Eingabegitterzeigern (siehe ID3DXMesh). Die Anzahl der Elemente im Array ist NumMeshes.

NumMeshes [in]

Typ: UINT

Anzahl der zu verkettenden Eingabegitter.

Optionen [in]

Typ: DWORD

Optionen zum Erstellen von Gittern; Dies ist eine Kombination aus einem oder mehreren D3DXMESH-Flags . Die Optionen für die Gittererstellung entsprechen dem options-Parameter, der für D3DXCreateMesh erforderlich ist.

pGeomXForms [in]

Typ: const D3DXMATRIX*

Optionales Array von Geometrietransformationen. Die Anzahl der Elemente im Array ist NumMeshes; jedes Element ist eine Transformationsmatrix (siehe D3DXMATRIX). Kann NULL sein.

pTextureXForms [in]

Typ: const D3DXMATRIX*

Optionales Array von Texturtransformationen. Die Anzahl der Elemente im Array ist NumMeshes; jedes Element ist eine Transformationsmatrix (siehe D3DXMATRIX). Dieser Parameter kann NULL sein.

pDecl [in]

Typ: const D3DVERTEXELEMENT9*

Optionaler Zeiger auf eine Vertexdeklaration (siehe D3DVERTEXELEMENT9). Dieser Parameter kann NULL sein.

pD3DDevice [in]

Typ: LPDIRECT3DDEVICE9

Zeiger auf ein IDirect3DDevice9-Gerät , das zum Erstellen des neuen Gitters verwendet wird.

ppMeshOut [out]

Typ: LPD3DXMESH*

Adresse eines Zeigers auf das erstellte Gitter (siehe ID3DXMesh).

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Bemerkungen

Wenn im Rahmen des Options-Gittererstellungsparameters keine Vertexdeklaration angegeben wird, generiert die Methode eine Vereinigung aller Vertexdeklarationen der Untermeshes, wobei Kanäle und Typen bei Bedarf höher gelegt werden. Die -Methode erstellt eine Attributtabelle aus Attributtabellen der Eingabegitter. Um die Erstellung einer Attributtabelle sicherzustellen, rufen Sie Optimize auf, wobei Flags auf D3DXMESHOPT_COMPACT und D3DXMESHOPT_ATTRSORT festgelegt sind (siehe D3DXMESHOPT).

Anforderungen

Siehe auch

Gitterfunktionen