Fonction D3DXCreateTorus

Article
06/13/2023

Utilise un système de coordonnées gaucher pour créer un maillage contenant un tore.

Syntaxe

HRESULT D3DXCreateTorus(
  _In_  LPDIRECT3DDEVICE9 pDevice,
  _In_  FLOAT             InnerRadius,
  _In_  FLOAT             OuterRadius,
  _In_  UINT              Sides,
  _In_  UINT              Rings,
  _Out_ LPD3DXMESH        *ppMesh,
  _Out_ LPD3DXBUFFER      *ppAdjacency
);

Paramètres

pDevice [in]

Type : LPDIRECT3DDEVICE9

Pointeur vers une interface IDirect3DDevice9 , représentant l’appareil associé au maillage de tore créé.

InnerRadius [in]

Type : FLOAT

Rayon interne du tore. La valeur doit être supérieure ou égale à 0,0f.

OuterRadius [in]

Type : FLOAT

Rayon externe du tore. La valeur doit être supérieure ou égale à 0,0f.

Côtés [in]

Type : UINT

Nombre de côtés dans une section croisée. La valeur doit être supérieure ou égale à 3.

Anneaux [in]

Type : UINT

Nombre d’anneaux composant le tore. La valeur doit être supérieure ou égale à 3.

ppMesh [out]

Type : LPD3DXMESH*

Adresse d’un pointeur vers la forme de sortie, une interface ID3DXMesh .

ppAdjacency [out]

Type : LPD3DXBUFFER*

Adresse d’un pointeur vers une interface ID3DXBuffer . Lorsque la méthode retourne, ce paramètre est rempli avec un tableau de trois DWORD par visage qui spécifient les trois voisins pour chaque face dans le maillage. Null peut être spécifié.

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, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Notes

Le tore créé est centré à l’origine et son axe est aligné sur l’axe des zs. Le rayon interne du tore est le rayon de la section croisée (rayon secondaire), et le rayon externe du tore est le rayon du trou central.

Cette fonction retourne un maillage qui peut être utilisé ultérieurement pour le dessin ou la manipulation par l’application.

Cette fonction crée un maillage avec l’option de création D3DXMESH_MANAGED et D3DFVF_XYZ | D3DFVF_NORMAL format de vertex flexible (FVF).

Spécifications

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

Voir aussi

Fonctions de dessin de forme

Share via