glXHyperpipeAttribSGIX(3G)

NAME
     glXHyperpipeAttribSGIX - 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.


DESCRIPTION
     glXHyperpipeAttribSGIX 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
                           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 DEPENDENCIES
     glXHyperpipeAttribSGIX 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