D3DXLoadSkinMeshFromXof-Funktion

Lädt ein Skin mesh aus einem DirectX.x-Dateidatenobjekt.

Syntax

HRESULT D3DXLoadSkinMeshFromXof(
  _In_  LPD3DXFILEDATA    pxofMesh,
  _In_  DWORD             Options,
  _In_  LPDIRECT3DDEVICE9 pD3DDevice,
  _Out_ LPD3DXBUFFER      *ppAdjacency,
  _Out_ LPD3DXBUFFER      *ppMaterials,
  _Out_ LPD3DXBUFFER      *ppEffectInstances,
  _Out_ DWORD             *pMatOut,
  _Out_ LPD3DXSKININFO    *ppSkinInfo,
  _Out_ LPD3DXMESH        *ppMesh
);

Parameter

pxofMesh [ In]

Typ: LPD3DXFILEDATA

Zeiger auf eine ID3DXFileData-Schnittstelle, die das zu ladende Dateidatenobjekt darstellt.

Optionen [ In]

Typ: DWORD

Kombination aus einem oder mehreren Flags aus der D3DXMESH-Enumeration, die Erstellungsoptionen für das Gitternetz angibt.

pD3DDevice [ In]

Typ: LPDIRECT3DDEVICE9

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

ppAdencyency [ out]

Typ: LPD3DXBUFFER*

Adresse eines Zeigers auf eine ID3DXBuffer-Schnittstelle. Wenn diese Methode zurückgegeben wird, wird dieser Parameter mit einem Array von drei DWORDs pro Gesicht gefüllt, die die drei Nachbarn für jedes Gesicht im Netz angeben.

ppMaterials [ out]

Typ: LPD3DXBUFFER*

Adresse eines Zeigers auf eine ID3DXBuffer-Schnittstelle. Wenn die Methode zurückgegeben wird, wird dieser Parameter mit einem Array von D3DXMATERIAL-Strukturen gefüllt.

ppEffectInstances [ out]

Typ: LPD3DXBUFFER*

Zeiger auf einen Puffer, der ein Array von Effektinstanzen enthält, eine pro Attributgruppe im zurückgegebenen Gitternetz. Eine Effektinstanz ist eine bestimmte Instanz von Zustandsinformationen, die zum Initialisieren eines Effekts verwendet werden. Siehe D3DXEFFECTINSTANCE. Weitere Informationen zum Zugriff auf den Puffer finden Sie unter ID3DXBuffer.

pMatOut [ out]

Typ: DWORD*

Zeiger auf die Anzahl der D3DXMATERIAL-Strukturen im ppMaterials-Array, wenn die Methode zurückgegeben wird.

ppSkinInfo [ out]

Typ: LPD3DXSKININFO*

Adresse eines Zeigers auf eine ID3DXSkinInfo-Schnittstelle, die die Skinninginformationen darstellt.

ppMesh [ out]

Typ: LPD3DXMESH*

Adresse eines Zeigers auf eine ID3DXMesh-Schnittstelle, die das geladene Gitternetz darstellt.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ausgeführt wird, lautet der Rückgabewert D3D _ OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Werte sein: D3DERR _ INVALIDCALL, D3DXERR _ INVALIDDATA, E _ OUTOFMEMORY

Hinweise

Diese Methode verwendet einen Zeiger auf ein internes Objekt in der X-Datei, sodass Sie die Framehierarchie laden können.

Für Meshdateien, die keine Effektinstanzinformationen enthalten, werden Standardeffektinstanzen aus den Materialinformationen in der X-Datei generiert. Eine Standardeffektinstanz hat Standardwerte, die den Membern der D3DMATERIAL9-Struktur entsprechen.

Der Standardtexturname ist ebenfalls ausgefüllt, wird jedoch anders behandelt. Der Name lautet Texture0@Name , was einer Effektvariablen mit dem Namen "Texture0" mit einer Anmerkung namens "Name" entspricht. Dieser enthält den Namen der Zeichenfolgendatei für die Textur.

Anforderungen

Anforderung Wert
Header
D3DX9Mesh.h
Bibliothek
D3dx9.lib

Siehe auch

Mesh-Funktionen

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE