D3DXCreatePolygon-Funktion

Verwendet ein linkshändiges Koordinatensystem, um ein Gitter zu erstellen, das ein nseitiges Polygon enthält.

Syntax

HRESULT D3DXCreatePolygon(
  _In_  LPDIRECT3DDEVICE9 pDevice,
  _In_  FLOAT             Length,
  _In_  UINT              Sides,
  _Out_ LPD3DXMESH        *ppMesh,
  _Out_ LPD3DXBUFFER      *ppAdjacency
);

Parameter

pDevice [in]

Typ: LPDIRECT3DDEVICE9

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

Länge [in]

Typ: FLOAT

Länge jeder Seite.

Seiten [in]

Typ: UINT

Anzahl der Seiten für das Polygon. 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

Das erstellte Polygon ist am Ursprung zentriert.

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