glXHyperpipeAttribSGIX(3G) OpenGL Reference - GLX glXHyperpipeAttribSGIX(3G)NAMEglXHyperpipeAttribSGIX - Set hyperpipe attributes
C SPECIFICATION
int glXHyperpipeAttribSGIX( Display *dpy,
int timeSlice,
int attrib,
int size,
void *attribList )
PARAMETERS
dpy Specifies the connection to the X server.
timeSlice Specifies the timeslice whose attributes are to be set.
attrib Specifies the attribute being set.
size Specifies the size of the attribute block.
attribList Pointer to array of requested values. The number of elements
in this array should equal the number of pipes contributing
to this timeslice.
DESCRIPTIONglXHyperpipeAttribSGIX is part of the SGIX_hyperpipe extension.
glXHyperpipeAttribSGIX attempts to set attrib for the currently bound
hyperpipe. The values of the attributes being set are subject to hardware
constraints. This call will fail if the specified values do not conform
to those constraints. Use glXQueryHyperpipeBestAttribSGIX to determine
values that conform to hardware constraints.
attrib is one of the following:
GLX_PIPE_RECT_SGIX Sets the values of the subrectangles that
contribute to the given timeSlice of the currently
bound hyperpipe. This swap synchronous change in
the rectangle position allows load balancing among
various pipes.
GLX_HYPERPIPE_STEREO_SGIX
Turns on a stereo mode which alternates between the
first pipes in the hyperpipe networking. One pipe
provides the left eye data, and the second provides
the right eye data. attribList should be an
Page 1
glXHyperpipeAttribSGIX(3G) OpenGL Reference - GLX glXHyperpipeAttribSGIX(3G)
integer, with 1 turning the mode on, and 0 turning
the mode off.
GLX_HYPERPIPE_PIXEL_AVERAGE_SGIX
Turns on a mode in which all pipes in the hyperpipe
network are averaged together, and the resulting
data is sent to the display. attribList should be
an integer, with 1 turning the mode on, and 0
turning the mode off.
glXHyperpipeAttribSGIX works with a direct context only.
RETURN VALUES
Returns 0 on success.
Returns GLX_BAD_VALUE if the attribute specified is incorrect, or if one
or more of the elements specified in the attribute list is incorrect.
Returns GLX_BAD_HYPERPIPE_SGIX if the hyperpipe bound to the current
context is invalid or absent.
Returns GLX_BAD_CONTEXT if there is no current context, or if the current
context is not a direct context.
MACHINE DEPENDENCIESglXHyperpipeAttribSGIX is currently supported only on InfinitePerformance
systems.
On InfinitePerformance systems GLX_PIPE_RECT_SGIX requires that X origins
and sizes be aligned on 4 pixel boundaries.
SEE ALSO
glXQueryHyperpipeAttribSGIX glXQueryHyperpipeBestAttribSGIX hyperpipe
Page 2
