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 |
|
| Bibliothèque |
|
Voir aussi