Funzione D3DXLoadPatchMeshFromXof

Articolo
06/13/2023

Carica una mesh di patch da un oggetto ID3DXFileData .

Sintassi

HRESULT D3DXLoadPatchMeshFromXof(
  _In_  LPD3DXFILEDATA    pxofMesh,
  _In_  DWORD             Options,
  _In_  LPDIRECT3DDEVICE9 pD3DDevice,
  _Out_ LPD3DXBUFFER      *ppMaterials,
  _Out_ LPD3DXBUFFER      *ppEffectInstances,
  _Out_ PDWORD            pNumMaterials,
  _Out_ LPD3DXPATCHMESH   *ppMesh
);

Parametri

pxofMesh [in]

Tipo: LPD3DXFILEDATA

Puntatore a un'interfaccia ID3DXFileData che rappresenta l'oggetto dati del file da caricare.

Opzioni [in]

Tipo: DWORD

Combinazione di uno o più flag D3DXMESH , specificando le opzioni di creazione per la mesh.

pD3DDevice [in]

Tipo: LPDIRECT3DDEVICE9

Puntatore al dispositivo da cui viene creata la mesh.

ppMaterials [out]

Tipo: LPD3DXBUFFER*

Matrice di materiali contenuti nella mesh. Ogni materiale viene indicizzato da un'interfaccia ID3DXBuffer .

ppEffectInstances [out]

Tipo: LPD3DXBUFFER*

Puntatore a un buffer contenente una matrice di istanze di effetto, una per gruppo di attributi nella mesh restituita. Un'istanza dell'effetto è un'istanza specifica di informazioni sullo stato usate per inizializzare un effetto. Vedere D3DXEFFECTINSTANCE. Per altre informazioni sull'accesso al buffer, vedere ID3DXBuffer.

pNumMaterials [out]

Tipo: PDWORD

Puntatore contenente il numero di materiali nella mesh.

ppMesh [out]

Tipo: LPD3DXPATCHMESH*

Indirizzo di un puntatore a un'interfaccia ID3DXPatchMesh che rappresenta la mesh caricata.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito è D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Commenti

Per i file mesh che non contengono informazioni sull'istanza degli effetti, le istanze di effetto predefinite verranno generate dalle informazioni sul materiale nel file .x. Un'istanza di effetto predefinita avrà valori predefiniti che corrispondono ai membri della struttura D3DMATERIAL9 .

Il nome della trama predefinito viene compilato anche, ma viene gestito in modo diverso. Il nome sarà Texture0@Name, che corrisponde a una variabile di effetto in base al nome "Texture0" con un'annotazione denominata "Name". Questo conterrà il nome del file di stringa per la trama.

Requisiti

Requisito	Valore
Intestazione	D3DX9Mesh.h
Libreria	D3dx9.lib

Vedi anche

Funzioni mesh
D3DXEFFECTDEFAULT
D3DXEFFECTINSTANCE

Share via