ID3DXBaseMesh::CloneMeshFVF-Methode

Klont ein Gittermodel mit einem flexiblen Vertexformat(FVF)-Code.

Syntax

HRESULT CloneMeshFVF(
  [in]          DWORD             Options,
  [in]          DWORD             FVF,
  [in]          LPDIRECT3DDEVICE9 pDevice,
  [out, retval] LPD3DXMESH        *ppCloneMesh
);

Parameter

Options [in]

Art: DWORD

Eine Kombination aus einem oder mehreren D3DXMESH-Flags, die Erstellungsoptionen für das Gittermodell angeben.

FVF [in]

Art: DWORD

Kombination von FVF-Codes, die das Vertexformat für die Vertices im Gittermodell der Ausgabe angibt. Die Werte der Codes finden Sie unter D3DFVF.

pDevice [in]

Typ: LPDIRECT3DDEVICE9

Zeiger auf eine IDirect3DDevice9-Schnittstelle, die das dem Gittermodell zugeordnete Geräteobjekt darstellt.

ppCloneMesh [out, retval]

Typ: LPD3DXMESH*

Adresse eines Zeigers auf eine ID3DXMesh-Schnittstelle, die das geklonte Gittermodell darstellt.

Rückgabewert

Typ: HRESULT

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

Hinweise

ID3DXBaseMesh::CloneMeshFVF wird verwendet, um das Vertexdatenlayout neu zu formatieren und zu ändern. Dazu wird ein neues Gittermodellobjekt erstellt. Verwenden Sie es beispielsweise, um Platz für Normale, Texturkoordinaten, Farben, Gewichtungen usw. hinzuzufügen, die noch nicht vorhanden waren.

ID3DXBaseMesh::UpdateSemantics aktualisiert die Vertexdeklaration mit unterschiedlichen semantischen Informationen, ohne das Layout des Vertexpuffers zu ändern. Diese Methode ändert den Inhalt des Vertexpuffers nicht. Verwenden Sie sie beispielsweise, um eine 3D-Texturkoordinate als Binormale oder Tangente oder umgekehrt zu bezeichnen.

Anforderungen

Anforderung	Wert
Header	D3DX9Mesh.h
Bibliothek	D3dx9.lib

Siehe auch

ID3DXBaseMesh

D3DXFVFFromDeclarator