Função D3DXLoadSkinMeshFromXof

Carrega uma malha de pele de um objeto de dados de arquivo .x do DirectX.

Sintaxe

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
);

Parâmetros

pxofMesh [in]

Tipo: LPD3DXFILEDATA

Ponteiro para uma interface ID3DXFileData , representando o objeto de dados de arquivo a ser carregado.

Opções [in]

Tipo: DWORD

Combinação de um ou mais sinalizadores, da enumeração D3DXMESH , especificando opções de criação para a malha.

pD3DDevice [in]

Tipo: LPDIRECT3DDEVICE9

Ponteiro para uma interface IDirect3DDevice9 , o objeto do dispositivo associado à malha.

ppAdjacency [out]

Tipo: LPD3DXBUFFER*

Endereço de um ponteiro para uma interface ID3DXBuffer . Quando esse método retorna, esse parâmetro é preenchido com uma matriz de três DWORDs por rosto que especificam os três vizinhos para cada rosto na malha.

ppMaterials [out]

Tipo: LPD3DXBUFFER*

Endereço de um ponteiro para uma interface ID3DXBuffer . Quando o método retorna, esse parâmetro é preenchido com uma matriz de estruturas D3DXMATERIAL .

ppEffectInstances [out]

Tipo: LPD3DXBUFFER*

Ponteiro para um buffer que contém uma matriz de instâncias de efeito, uma por grupo de atributos na malha retornada. Uma instância de efeito é uma instância específica das informações de estado usadas para inicializar um efeito. Consulte D3DXEFFECTINSTANCE. Para obter mais informações sobre como acessar o buffer, consulte ID3DXBuffer.

pMatOut [out]

Tipo: DWORD*

Ponteiro para o número de estruturas D3DXMATERIAL na matriz ppMaterials , quando o método retorna.

ppSkinInfo [out]

Tipo: LPD3DXSKININFO*

Endereço de um ponteiro para uma interface ID3DXSkinInfo , que representa as informações de skinning.

ppMesh [out]

Tipo: LPD3DXMESH*

Endereço de um ponteiro para uma interface ID3DXMesh , que representa a malha carregada.

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 um dos seguintes: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA E_OUTOFMEMORY

Comentários

Esse método usa um ponteiro para um objeto interno no arquivo .x, permitindo que você carregue a hierarquia de quadros.

Para arquivos de malha que não contêm informações de instância de efeito, instâncias de efeito padrão serão geradas a partir das informações de material no arquivo .x. Uma instância de efeito padrão terá valores padrão que correspondem aos membros da estrutura D3DMATERIAL9 .

O nome de textura padrão também é preenchido, mas é tratado de forma diferente. O nome será Texture0@Name, que corresponde a uma variável de efeito pelo nome de "Texture0" com uma anotação chamada "Name". Isso conterá o nome do arquivo de cadeia de caracteres para a textura.

Requisitos

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

Confira também

Funções de malha

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE