glClearColor

The glClearColor function specifies clear values for the color buffers.

void glClearColor(
  GLclampf red,
  GLclampf green,
  GLclampf blue,
  GLclampf alpha
);

Parameters

red, green, blue, alpha
The red, green, blue, and alpha values that glClear uses to clear the color buffers. The default values are all zero.

Remarks

The glClearColor function specifies the red, green, blue, and alpha values used by glClear to clear the color buffers. Values specified by glClearColor are clamped to the range [0,1].

The following functions retrieve information related to the glClearColor function:

glGet with argument GL_ACCUM_CLEAR_VALUE

glGet with argument GL_COLOR_CLEAR_VALUE

Error Codes

The following is the error code generated and its condition.

Error code Condition
GL_INVALID_OPERATION glClearColor was called between a call to glBegin and the corresponding call to glEnd.

Requirements

  Windows NT/2000: Requires Windows NT 3.5 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in Gl.h.
  Library: Use Opengl32.lib.

See Also

glBegin, glClear, glEnd, glGet


  

Community Additions

Show: