D3DXCreatePolygon

The D3DXCreatePolygon function creates an n-sided polygon.

HRESULT D3DXCreatePolygon(
  LPDIRECT3DDEVICE7 pDevice,
  float sideSize,
  DWORD numSides,
  DWORD numTexCoords,
  ID3DXSimpleShape** ppShape
);

Parameters

pDevice

A pointer to the IDirect3DDevice7 interface of the device.

sideSize

The length of a side.

numSides

The number of sides.

numTexCoords

The number of texture coordinates desired in the output vertex-buffer. The default value is 1. D3DX_DEFAULT is a valid input for this parameter.

ppShape

The address of a pointer to the output vertex-buffer, an ID3DXSimpleShape interface.

Return Values

If the function succeeds, the return value is S_OK.

If the function fails, the return value may be one of the following values:

Remarks

This function returns a vertex buffer that can be used later for drawing or manipulation by the application.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Version: Requires DirectX 7.0.
  Header: Declared in d3dxshapes.h.
  Library: Use d3dx.lib.

See Also

D3DXCreateBox, D3DXCreateCylinder, D3DXCreateSphere, D3DXCreateTeapot, D3DXCreateTorus