![]() |
![]() |
![]() |
Saves a mesh to a .x file.
Syntax
HRESULT WINAPI D3DXSaveMeshToX(
LPCTSTR pFilename, LPD3DXMESH pMesh, const DWORD *pAdjacency, const D3DXMATERIAL *pMaterials, const D3DXEFFECTINSTANCE *pEffectInstances, DWORD NumMaterials, DWORD Format );
Parameters
- pFilename
- [in] Pointer to a string that specifies the filename. If the compiler settings require Unicode, the data type LPCTSTR resolves to LPCWSTR. Otherwise, the string data type resolves to LPCSTR. See Remarks.
- pMesh
- [in] Pointer to an ID3DXMesh interface, representing the mesh to save to a .x file.
- pAdjacency
- [in] Pointer to an array of three DWORDs per face that specify the three neighbors for each face in the mesh. This parameter may be NULL.
- pMaterials
- [in] Pointer to an array of D3DXMATERIAL structures, containing material information to be saved in the .x file.
- pEffectInstances
- [in] Pointer to an array of effect instances, one per attribute group in the mesh. This parameter may be NULL. An effect instance is a particular instance of state information used to initialize an effect. For more information, see D3DXEFFECTINSTANCE.
- NumMaterials
- [in] Number of D3DXMATERIAL structures in the pMaterials array.
- Format
- [in] Indicates the format to use when saving the .x file. For more information, see Remarks.
Return Value
If the function succeeds, the return value is D3D_OK.
If the function fails, the return value can be:
D3DERR_INVALIDCALL The method call is invalid. For example, a method's parameter may have an invalid value.
Remarks
The compiler setting also determines the function version. If Unicode is defined, the function call resolves to D3DXSaveMeshToXW. Otherwise, the function call resolves to D3DXSaveMeshToXA because ANSI strings are being used.
The default file format is binary; however, if a file is specified as both a binary and a text file, it will be saved as a text file. Regardless of the file format, you may also use the compressed format to reduce the file size.
The following is a typical code example of how to use this function.
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 );
Function Information
Header d3dx9mesh.h Import library d3dx9.lib Minimum operating systems Windows 98
See Also
D3DXEFFECTDEFAULT, D3DXEFFECTINSTANCE