Funzione D3DXCreateTorus

Articolo
06/13/2023

Usa un sistema di coordinate sinistrorso per creare una mesh contenente un toro.

Sintassi

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

Parametri

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Puntatore a un'interfaccia IDirect3DDevice9 che rappresenta il dispositivo associato alla mesh torus creata.

InnerRadius [in]

Tipo: FLOAT

Raggio interno del toro. Il valore deve essere maggiore o uguale a 0,0f.

OuterRadius [in]

Tipo: FLOAT

Raggio esterno del toro. Il valore deve essere maggiore o uguale a 0,0f.

Lati [in]

Tipo: UINT

Numero di lati in una sezione trasversale. Il valore deve essere maggiore o uguale a 3.

Anelli [in]

Tipo: UINT

Numero di anelli che costituiscono il toro. Il valore deve essere maggiore o uguale a 3.

ppMesh [out]

Tipo: LPD3DXMESH*

Indirizzo di un puntatore alla forma di output, un'interfaccia ID3DXMesh .

ppAdjacency [out]

Tipo: LPD3DXBUFFER*

Indirizzo di un puntatore a un'interfaccia ID3DXBuffer . Quando termina, questo parametro viene riempito con una matrice di tre DWORD per viso che specificano i tre vicini per ogni viso nella mesh. È possibile specificare NULL.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito viene D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Commenti

Il toro creato è centrato all'origine e il relativo asse è allineato all'asse z. Il raggio interno del toro è il raggio della sezione trasversale (raggio secondario) e il raggio esterno del toro è il raggio del foro centrale.

Questa funzione restituisce una mesh che può essere utilizzata in un secondo momento per disegnare o manipolare l'applicazione.

Questa funzione crea una mesh con l'opzione di creazione D3DXMESH_MANAGED e D3DFVF_XYZ | D3DFVF_NORMAL formato FVF (Flexible Vertex Format).

Requisiti

Requisito	Valore
Intestazione	D3dx9shape.h
Libreria	D3dx9.lib

Vedi anche

Funzioni di disegno delle forme

Condividi tramite