D3DXCreatePolygon Function

Uses a left-handed coordinate system to create a mesh containing an n-sided polygon.

Syntax

HRESULT D3DXCreatePolygon(      

    LPDIRECT3DDEVICE9 pDevice,
    FLOAT Length,
    UINT Sides,
    LPD3DXMESH *ppMesh,
    LPD3DXBUFFER *ppAdjacency
);

Parameters

pDevice

[in] Pointer to an IDirect3DDevice9 interface, representing the device associated with the created polygon mesh.

Length

[in] Length of each side.

Sides

[in] Number of sides for the polygon. Value must be greater than or equal to 3.

ppMesh

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

ppAdjacency

[out] 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

If the function succeeds, the return value is D3D_OK.

If the function fails, the return value can be one of the following values.

D3DERR_INVALIDCALL	The method call is invalid. For example, a method's parameter may have an invalid value.
D3DXERR_INVALIDDATA	The data is invalid.
E_OUTOFMEMORY	Microsoft?Direct3D?could not allocate sufficient memory to complete the call.

Remarks

The created polygon is centered at the origin.

Function Information

Header	d3dx9shape.h
Import library	d3dx9.lib
Minimum operating systems	Windows 98