Função D3DXSaveMeshHierarchyToFile

Cria um arquivo .x e salva a hierarquia de malha e as animações correspondentes nele.

Sintaxe

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

Parâmetros

pFilename [in]

Tipo: LPCSTR

Ponteiro para uma cadeia de caracteres que especifica o nome do arquivo .x que identifica a malha salva. Se as configurações do compilador exigirem Unicode, o tipo de dados LPCTSTR será resolvido para LPCWSTR. Caso contrário, o tipo de dados de cadeia de caracteres é resolvido para LPCSTR. Consulte Observações.

XFormat [in]

Tipo: DWORD

Formato do arquivo .x (texto ou binário, compactado ou não). Consulte D3DXF_FILEFORMAT. D3DXF_FILEFORMAT_COMPRESSED pode ser combinado (usando um OR lógico) com os sinalizadores D3DXF_FILEFORMAT_BINARY ou D3DXF_FILEFORMAT_TEXT para reduzir o tamanho do arquivo de saída.

pFrameRoot [in]

Tipo: const D3DXFRAME*

Nó raiz da hierarquia a ser salva. Consulte D3DXFRAME.

pAnimController [in]

Tipo: LPD3DXANIMATIONCONTROLLER

Controlador de animação que tem conjuntos de animação a serem armazenados. Consulte ID3DXAnimationController.

pUserDataSaver [in]

Tipo: LPD3DXSAVEUSERDATA

Interface fornecida pelo aplicativo que permite o salvamento de dados do usuário. Consulte ID3DXSaveUserData.

Valor retornado

Tipo: HRESULT

Se a função for bem-sucedida, o valor retornado será D3D_OK. Se a função falhar, o valor retornado poderá ser: D3DERR_INVALIDCALL.

Comentários

A configuração do compilador também determina a versão da função. Se Unicode for definido, a chamada de função será resolvida para D3DXSaveMeshHierarchyToFileW. Caso contrário, a chamada de função será resolvida para D3DXSaveMeshHierarchyToFileA.

Essa função não salva conjuntos de animação compactados.

Requisitos

Requisito	Valor
parâmetro	D3dx9anim.h
Biblioteca	D3dx9.lib

Confira também

Funções de animação

Referência de arquivo X