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
Copyright (C)2010 Sandia Corporation
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.