D3DXCreateTorus-Funktion

Verwendet ein linkshändiges Koordinatensystem, um ein Gitternetz 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 Torusgitternetz 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 Kreuzabschnitt. Der Wert muss größer oder gleich 3 sein.

Ringe [ In]

Typ: UINT

Anzahl der Ringe, die den Torus bilden. Der Wert muss größer oder gleich 3 sein.

ppMesh [ out]

Typ: LPD3DXMESH*

Adresse eines Zeigers auf die Ausgabeform, eine ID3DXMesh-Schnittstelle.

ppAdencyency [ out]

Typ: LPD3DXBUFFER*

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

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ausgeführt wird, lautet der Rückgabewert D3D _ OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Werte sein: D3DERR _ INVALIDCALL, D3DXERR _ INVALIDDATA, E _ OUTOFMEMORY.

Hinweise

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

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

Diese Funktion erstellt ein Netz mit der Erstellungsoption D3DXMESH _ MANAGED und D3DFVF _ XYZ | D3DFVF _ NORMAL Flexible Vertex format (FVF).

Anforderungen

Anforderung Wert
Header
D3dx9shape.h
Bibliothek
D3dx9.lib

Weitere Informationen

Zeichnen von Formenfunktionen