Freigeben über


D3DXCreateCylinder-Funktion

Verwendet ein linkshändiges Koordinatensystem, um ein Gitter mit einem Zylinder zu erstellen.

Syntax

HRESULT D3DXCreateCylinder(
  _In_  LPDIRECT3DDEVICE9 pDevice,
  _In_  FLOAT             Radius1,
  _In_  FLOAT             Radius2,
  _In_  FLOAT             Length,
  _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 Zylindergitter zugeordnet ist.

Radius1 [in]

Typ: FLOAT

Radius am negativen Z-Ende. Der Wert sollte größer oder gleich 0,0f sein.

Radius2 [in]

Typ: FLOAT

Radius am positiven Z-Ende. Der Wert sollte größer oder gleich 0,0f sein.

Länge [in]

Typ: FLOAT

Länge des Zylinders entlang der Z-Achse.

Slices [in]

Typ: UINT

Anzahl der Slices ü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

Der erzeugte Zylinder ist am Ursprung zentriert, und seine Achse ist auf die Z-Achse ausgerichtet.

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

Anforderungen

Anforderung Wert
Header
D3dx9shape.h
Bibliothek
D3dx9.lib

Siehe auch

Shape-Zeichenfunktionen