D3DXLoadMeshFromX fonction)
Charge un maillage à partir d’un fichier DirectX. x.
Syntaxe
HRESULT D3DXLoadMeshFromX(
_In_ LPCTSTR pFilename,
_In_ DWORD Options,
_In_ LPDIRECT3DDEVICE9 pD3DDevice,
_Out_ LPD3DXBUFFER *ppAdjacency,
_Out_ LPD3DXBUFFER *ppMaterials,
_Out_ LPD3DXBUFFER *ppEffectInstances,
_Out_ DWORD *pNumMaterials,
_Out_ LPD3DXMESH *ppMesh
);
Paramètres
-
pFilename [ dans]
-
Type : LPCTSTR
Pointeur vers une chaîne qui spécifie le nom de fichier. Si les paramètres du compilateur requièrent Unicode, le type de données LPCTSTR est résolu en LPCWSTR. Dans le cas contraire, le type de données String est résolu en LPCSTR. Consultez la section Notes.
-
Options [ dans]
-
Type : DWORD
Combinaison d’un ou plusieurs indicateurs de l’énumération D3DXMESH , qui spécifie les options de création du maillage.
-
pD3DDevice [ dans]
-
Type : LPDIRECT3DDEVICE9
Pointeur vers une interface IDirect3DDevice9 , l’objet appareil associé à la maille.
-
ppAdjacency [ à]
-
Type : LPD3DXBUFFER*
Pointeur vers une mémoire tampon qui contient les données d’contiguïté. Les données d’adjacence contiennent un tableau de trois DWORD par visage qui spécifient les trois voisins pour chaque visage de la maille. Pour plus d’informations sur l’accès à la mémoire tampon, consultez ID3DXBuffer.
-
ppMaterials [ à]
-
Type : LPD3DXBUFFER*
Pointeur vers une mémoire tampon qui contient des données de matériaux. La mémoire tampon contient un tableau de structures D3DXMATERIAL , contenant les informations du fichier DirectX. Pour plus d’informations sur l’accès à la mémoire tampon, consultez ID3DXBuffer.
-
ppEffectInstances [ à]
-
Type : LPD3DXBUFFER*
Pointeur vers une mémoire tampon qui contient un tableau d’instances d’effet, une par groupe d’attributs dans le maillage retourné. Une instance Effect est une instance particulière d’informations d’état utilisée pour initialiser un effet. Consultez D3DXEFFECTINSTANCE. Pour plus d’informations sur l’accès à la mémoire tampon, consultez ID3DXBuffer.
-
pNumMaterials [ à]
-
Type : DWORD*
Pointeur vers le nombre de structures D3DXMATERIAL dans le tableau ppMaterials , lorsque la méthode retourne.
-
ppMesh [ à]
-
Type : LPD3DXMESH*
Adresse d’un pointeur vers une interface ID3DXMesh représentant le maillage chargé.
Valeur de retour
Type : HRESULT
Si la fonction est réussie, la valeur de retour est D3D _ OK. Si la fonction échoue, la valeur de retour peut être l’une des valeurs suivantes : D3DERR _ INVALIDCALL, E _ OUTOFMEMORY.
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 D3DXLoadMeshFromXW. Dans le cas contraire, l’appel de fonction est résolu en D3DXLoadMeshFromXA, car les chaînes ANSI sont utilisées.
Tous les maillages du fichier seront réduits en un seul maillage de sortie. Si le fichier contient une hiérarchie de frames, toutes les transformations sont appliquées à la maille.
Pour les fichiers de maillage qui ne contiennent pas d’informations sur l’instance d’effet, les instances d’effet par défaut sont générées à partir des informations matérielles du fichier. x. Une instance d’effet par défaut aura des valeurs par défaut qui correspondent aux membres de la structure D3DMATERIAL9 .
Le nom de texture par défaut est également renseigné, mais est géré différemment. Le nom est Texture0@Name , ce qui correspond à une variable Effect par le nom de « Texture0 » avec une annotation appelée « Name ». Contient le nom de fichier de chaîne pour la texture.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|