D3DXCreateBox-Funktion

  • Artikel

Verwendet ein linkshändiges Koordinatensystem, um ein Gitter zu erstellen, das ein achsenbündiges Feld enthält.

Syntax

HRESULT D3DXCreateBox(
  _In_  LPDIRECT3DDEVICE9 pDevice,
  _In_  FLOAT             Width,
  _In_  FLOAT             Height,
  _In_  FLOAT             Depth,
  _Out_ LPD3DXMESH        *ppMesh,
  _Out_ LPD3DXBUFFER      *ppAdjacency
);

Parameter

pDevice [in]

Typ: LPDIRECT3DDEVICE9

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

Breite [in]

Typ: FLOAT

Breite des Felds entlang der x-Achse.

Höhe [in]

Typ: FLOAT

Höhe des Kastens entlang der y-Achse.

Tiefe [in]

Typ: FLOAT

Tiefe des Felds entlang der Z-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

Das erstellte Feld wird am Ursprung zentriert.

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