NAME

icetGLSetReadBuffer -- set OpenGL buffer for images

Synopsis

#include <IceTGL.h>

void icetGLSetReadBuffer(

GLenum

mode );

Description

Set the OpenGL buffer from which to read images to composite. After the draw callback (specified by icetGLDrawCallback) returns, IceT grabs the rendered image from the OpenGL buffer specified by mode. This buffer is also used to write back fully composited images if the ICET_GL_DISPLAY option is on.

mode is an OpenGL value that specifies the buffer. It is passed to glReadBuffer and glDrawBuffer. Accepted values are GL_FRONT, GL_BACK, GL_LEFT, GL_RIGHT, GL_FRONT_LEFT, GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, and any of the GL_AUXi identifiers.

The current read buffer used is stored in the ICET_GL_READ_BUFFER state variable. The default value is GL_BACK.

Errors

ICET_INVALID_OPERATION: icetGLInitialize has not been called for this IceT context.
ICET_INVALID_ENUM: mode is not a known OpenGL buffer identifier.

Warnings

None.

Bugs

The check of mode is perfunctory. It just checks mode against a list of known buffers. It does not check to see if the buffer actually exists or for any other buffers that might be defined in an OpenGL extension.

Copyright

Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government retains certain rights in this software.

This source code is released under the New BSD License.