Поделиться через

Функция D3DXSaveMeshToX

  • Статья

Сохраняет сетку в X-файле.

Синтаксис

HRESULT D3DXSaveMeshToX(
  _In_       LPCTSTR            pFilename,
  _In_       LPD3DXMESH         pMesh,
  _In_ const DWORD              *pAdjacency,
  _In_ const D3DXMATERIAL       *pMaterials,
  _In_ const D3DXEFFECTINSTANCE *pEffectInstances,
  _In_       DWORD              NumMaterials,
  _In_       DWORD              Format
);

Параметры

pFilename [in]

Тип: LPCTSTR

Указатель на строку, указывающую имя файла. Если для параметров компилятора требуется Юникод, тип данных LPCTSTR разрешается в LPCWSTR. В противном случае строковый тип данных разрешается в LPCSTR. См. заметки.

pMesh [in]

Тип: LPD3DXMESH

Указатель на интерфейс ID3DXMesh , представляющий сетку для сохранения в X-файл.

pAdjacency [in]

Тип: const DWORD*

Указатель на массив из трех DWORD для каждого лица, который определяет три соседя для каждого лица в сетке. Этот параметр может иметь значение NULL.

pMaterials [in]

Тип: const D3DXMATERIAL*

Указатель на массив структур D3DXMATERIAL , содержащий сведения о материалах, которые необходимо сохранить в X-файле.

pEffectInstances [in]

Тип: const D3DXEFFECTINSTANCE*

Указатель на массив экземпляров эффектов, по одному на группу атрибутов в сетке. Этот параметр может иметь значение NULL. Экземпляр эффекта — это конкретный экземпляр сведений о состоянии, используемых для инициализации эффекта. Дополнительные сведения см. в разделе D3DXEFFECTINSTANCE.

NumMaterials [in]

Тип: DWORD

Число структур D3DXMATERIAL в массиве pMaterials .

Формат [in]

Тип: DWORD

Сочетание формата файла и параметров сохранения при сохранении X-файла. См . раздел Константы файлов D3DX X.

Возвращаемое значение

Тип: HRESULT

Если функция выполняется успешно, возвращаемое значение будет D3D_OK. Если функция завершается сбоем, возвращаемое значение может быть одним из следующих: D3DERR_INVALIDCALL.

Комментарии

Параметр компилятора также определяет версию функции. Если определен Юникод, вызов функции разрешается в D3DXSaveMeshToXW. В противном случае вызов функции разрешается в D3DXSaveMeshToXA, так как используются строки ANSI.

Формат файла по умолчанию — двоичный; Однако если файл указан как двоичный и текстовый, он будет сохранен как текстовый файл. Независимо от формата файла, вы также можете использовать сжатый формат для уменьшения размера файла.

Ниже приведен типичный пример кода использования этой функции.

ID3DXMesh*    m_pMesh;           // Mesh object to be saved to a .x file
D3DXMATERIAL* m_pMaterials;      // Array of material structs in the mesh
DWORD         m_dwNumMaterials;  // Number of material structs in the mesh
    
DWORD dwFormat = D3DXF_FILEFORMAT_BINARY;  // Binary-format .x file (default)
// DWORD dwFormat = D3DXF_FILEFORMAT_TEXT; // Text-format .x file
    
// Load mesh into m_pMesh and determine values of m_pMaterials and 
// m_dwNumMaterials with calls to D3DXLoadMeshxxx or other D3DX functions
    
// ...
        
D3DXSaveMeshToX(
    L"outputxfilename.x",
    m_pMesh,
    NULL,
    m_pMaterials,
    NULL,
    m_dwNumMaterials,
    dwFormat );

Требования

Требование Значение
Заголовок
D3DX9Mesh.h
Библиотека
D3dx9.lib

См. также раздел

Функции сетки

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE