Export (0) Print
Expand All

D3DXCreateSphere function

Uses a left-handed coordinate system to create a mesh containing a sphere.

Syntax


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

Parameters

pDevice [in]

Type: LPDIRECT3DDEVICE9

Pointer to an IDirect3DDevice9 interface, representing the device associated with the created sphere mesh.

Radius [in]

Type: FLOAT

Radius of the sphere. This value should be greater than or equal to 0.0f.

Slices [in]

Type: UINT

Number of slices about the main axis.

Stacks [in]

Type: UINT

Number of stacks along the main axis.

ppMesh [out]

Type: LPD3DXMESH*

Address of a pointer to the output shape, an ID3DXMesh interface.

ppAdjacency [out]

Type: LPD3DXBUFFER*

Address of a pointer to an ID3DXBuffer interface. When the method returns, this parameter is filled with an array of three DWORDs per face that specify the three neighbors for each face in the mesh. NULL can be specified.

Return value

Type: HRESULT

If the function succeeds, the return value is D3D_OK. If the function fails, the return value can be one of the following: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Remarks

The created sphere is centered at the origin, and its axis is aligned with the z-axis.

This function creates a mesh with the D3DXMESH_MANAGED creation option and D3DFVF_XYZ | D3DFVF_NORMAL flexible vertex format (FVF).

Requirements

Header

D3dx9shape.h

Library

D3dx9.lib

 

 

Community Additions

ADD
Show:
© 2014 Microsoft