D3DXCreateTorus-Funktion

Artikel
08/14/2024

Verwendet ein linkshändiges Koordinatensystem, um ein Gitter zu erstellen, das einen Torus enthält.

Syntax

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

Parameter

pDevice [in]

Typ: LPDIRECT3DDEVICE9

Zeiger auf eine IDirect3DDevice9-Schnittstelle , die das Gerät darstellt, das dem erstellten Torus-Gitter zugeordnet ist.

InnerRadius [in]

Typ: FLOAT

Innerer Radius des Torus. Der Wert sollte größer oder gleich 0,0f sein.

OuterRadius [in]

Typ: FLOAT

Äußerer Radius des Torus. Der Wert sollte größer oder gleich 0,0f sein.

Seiten [in]

Typ: UINT

Anzahl der Seiten in einem Querschnitt. Der Wert muss größer oder gleich 3 sein.

Ringe [in]

Typ: UINT

Anzahl der Ringe, aus der der Torus besteht. Der Wert muss größer oder gleich 3 sein.

ppMesh [out]

Typ: LPD3DXMESH*

Adresse eines Zeigers auf das Ausgabe-Shape, eine ID3DXMesh-Schnittstelle .

ppAdjacency [out]

Typ: LPD3DXBUFFER*

Adresse eines Zeigers auf eine ID3DXBuffer-Schnittstelle . Wenn die Methode zurückgibt, wird dieser Parameter mit einem Array von drei DWORDs pro Gesicht gefüllt, die die drei Nachbarn für jedes Gesicht im Gitter angeben. NULL kann angegeben werden.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Bemerkungen

Der erstellte Torus wird am Ursprung zentriert, und seine Achse wird an der Z-Achse ausgerichtet. Der innere Radius des Torus ist der Radius des Querschnitts (der kleinere Radius), und der äußere Radius des Torus ist der Radius des zentralen Lochs.

Diese Funktion gibt ein Gitter zurück, das später zum Zeichnen oder Bearbeiten durch die Anwendung verwendet werden kann.

Diese Funktion erstellt ein Gitter mit der D3DXMESH_MANAGED-Erstellungsoption und D3DFVF_XYZ | D3DFVF_NORMAL flexibles Vertexformat (FVF).

Anforderungen

Anforderung	Wert
Header	D3dx9shape.h
Bibliothek	D3dx9.lib

Weitere Informationen

Shape-Zeichnungsfunktionen

Freigeben über