D3DXCreateSphere-Funktion

Artikel
08/14/2024

Verwendet ein linkshändiges Koordinatensystem, um ein Gitter zu erstellen, das eine Kugel enthält.

Syntax

HRESULT D3DXCreateSphere(
  _In_  LPDIRECT3DDEVICE9 pDevice,
  _In_  FLOAT             Radius,
  _In_  UINT              Slices,
  _In_  UINT              Stacks,
  _Out_ LPD3DXMESH        *ppMesh,
  _Out_ LPD3DXBUFFER      *ppAdjacency
);

Parameter

pDevice [in]

Typ: LPDIRECT3DDEVICE9

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

Radius [in]

Typ: FLOAT

Radius der Kugel. Dieser Wert sollte größer oder gleich 0,0f sein.

Slices [in]

Typ: UINT

Anzahl der Segmente über die Standard Achse.

Stapel [ in]

Typ: UINT

Anzahl der Stapel entlang der Standard Achse.

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

Die erstellte Kugel wird am Ursprung zentriert, und ihre Achse wird an der Z-Achse ausgerichtet.

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