Fonction D3DXSaveMeshToX

Enregistre un maillage dans un fichier .x.

Syntaxe

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

Paramètres

pFilename [in]

Type : LPCTSTR

Pointeur vers une chaîne qui spécifie le nom de fichier. Si les paramètres du compilateur nécessitent Unicode, le type de données LPCTSTR est résolu en LPCWSTR. Sinon, le type de données de chaîne est résolu en LPCSTR. Consultez la section Notes.

pMesh [in]

Type : LPD3DXMESH

Pointeur vers une interface ID3DXMesh , représentant le maillage à enregistrer dans un fichier .x.

pAdjacency [in]

Type : const DWORD*

Pointeur vers un tableau de trois DWORD par visage qui spécifient les trois voisins pour chaque visage dans le maillage. Ce paramètre peut avoir la valeur NULL.

pMaterials [in]

Type : const D3DXMATERIAL*

Pointeur vers un tableau de structures D3DXMATERIAL , contenant des informations matérielles à enregistrer dans le fichier .x.

pEffectInstances [in]

Type : const D3DXEFFECTINSTANCE*

Pointeur vers un tableau d’instances d’effet, une par groupe d’attributs dans le maillage. Ce paramètre peut avoir la valeur NULL. Un effet instance est un instance particulier des informations d’état utilisées pour initialiser un effet. Pour plus d’informations, consultez D3DXEFFECTINSTANCE.

NumMaterials [in]

Type : DWORD

Nombre de structures D3DXMATERIAL dans le tableau pMaterials .

Format [in]

Type : DWORD

Combinaison de format de fichier et d’options d’enregistrement lors de l’enregistrement d’un fichier .x. Consultez Constantes de fichier D3DX X.

Valeur retournée

Type : HRESULT

Si la fonction réussit, la valeur de retour est D3D_OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR_INVALIDCALL.

Notes

Le paramètre du compilateur détermine également la version de la fonction. Si Unicode est défini, l’appel de fonction est résolu en D3DXSaveMeshToXW. Sinon, l’appel de fonction est résolu en D3DXSaveMeshToXA, car les chaînes ANSI sont utilisées.

Le format de fichier par défaut est binaire ; toutefois, si un fichier est spécifié en tant que fichier binaire et fichier texte, il est enregistré en tant que fichier texte. Quel que soit le format de fichier, vous pouvez également utiliser le format compressé pour réduire la taille du fichier.

Voici un exemple de code typique de l’utilisation de cette fonction.

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

Spécifications

Condition requise	Valeur
En-tête	D3DX9Mesh.h
Bibliothèque	D3dx9.lib

Voir aussi

Fonctions de maillage

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE