ID3DXRenderToEnvMap::Face

Initiate the drawing of each face of an environment map.

HRESULT Face(
  D3DCUBEMAP_FACES Face,
  DWORD MipFilter
);

Parameters

Face

[in] The first face of the environmental cube map. See D3DCUBEMAP_FACES.

MipFilter

[in] A valid combination of one or more D3DX_FILTER flags.

Return Values

If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be D3DERR_INVALIDCALL.

Remarks

This method must be called once for each type of environment map. The only exception is a cubic environment map which requires this method to be called six times, once for each face in D3DCUBEMAP_FACES. For more information, see Environment Mapping.

Requirements

Header: Declared in D3dx9core.h.