D3DXCreateBox

The D3DXCreateBox function creates a box (cuboid) of given dimensions.

HRESULT D3DXCreateBox(
  LPDIRECT3DDEVICE7 pDevice,
  float width,
  float height,
  float depth,
  DWORD numTexCoords,
  ID3DXSimpleShape** ppShape
);

Parameters

pDevice

A pointer to the IDirect3DDevice7 interface of the device.

width

The width of the box, taken along the x-axis.

height

The height of the box, taken along the y-axis.

depth

The depth of the box, taken along the z-axis.

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.
  Version: Requires DirectX 7.0.
  Header: Declared in d3dxshapes.h.
  Library: Use d3dx.lib.

See Also

D3DXCreateCylinder, D3DXCreatePolygon, D3DXCreateSphere, D3DXCreateTeapot, D3DXCreateTorus