Condividi tramite


Funzione D3DXSaveMeshHierarchyToFile

Crea un file con estensione x e salva la gerarchia di mesh e le animazioni corrispondenti.

Sintassi

HRESULT D3DXSaveMeshHierarchyToFile(
  _In_       LPCSTR                    pFilename,
  _In_       DWORD                     XFormat,
  _In_ const D3DXFRAME                 *pFrameRoot,
  _In_       LPD3DXANIMATIONCONTROLLER pAnimController,
  _In_       LPD3DXSAVEUSERDATA        pUserDataSaver
);

Parametri

pFilename [in]

Tipo: LPCSTR

Puntatore a una stringa che specifica il nome del file con estensione x che identifica la mesh salvata. Se le impostazioni del compilatore richiedono Unicode, il tipo di dati LPCTSTR viene risolto in LPCWSTR. In caso contrario, il tipo di dati stringa viene risolto in LPCSTR. Vedere la sezione Osservazioni.

XFormat [in]

Tipo: DWORD

Formato del file con estensione x (testo o binario, compresso o meno). Vedere D3DXF_FILEFORMAT. D3DXF_FILEFORMAT_COMPRESSED possono essere combinati (usando un OR logico) con i flag D3DXF_FILEFORMAT_BINARY o D3DXF_FILEFORMAT_TEXT per ridurre le dimensioni del file di output.

pFrameRoot [in]

Tipo: const D3DXFRAME*

Nodo radice della gerarchia da salvare. Vedere D3DXFRAME.

pAnimController [in]

Tipo: LPD3DXANIMATIONCONTROLLER

Controller di animazione con set di animazioni da archiviare. Vedere ID3DXAnimationController.

pUserDataSaver [in]

Tipo: LPD3DXSAVEUSERDATA

Interfaccia fornita dall'applicazione che consente il salvataggio dei dati utente. Vedere ID3DXSaveUserData.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito viene D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere: D3DERR_INVALIDCALL.

Commenti

L'impostazione del compilatore determina anche la versione della funzione. Se Unicode è definito, la chiamata di funzione viene risolta in D3DXSaveMeshHierarchyToFileW. In caso contrario, la chiamata di funzione viene risolta in D3DXSaveMeshHierarchyToFileA.

Questa funzione non salva set di animazioni compressi.

Requisiti

Requisito Valore
Intestazione
D3dx9anim.h
Libreria
D3dx9.lib

Vedi anche

Funzioni di animazione

Informazioni di riferimento su file X