glXQueryHyperpipeBestAttribSGIX(3G)

NAME
     glXQueryHyperpipeBestAttribSGIX - query best hyperpipe attributes


C SPECIFICATION
     int glXQueryHyperpipeBestAttribSGIX( Display *dpy,
                                          int timeSlice,
                                          int attrib,
                                          int size,
                                          void *attribList,
                                          void *returnAttribList )


PARAMETERS
     dpy               Specifies the connection to the X server.


     timeSlice         Specifies the timeslice whose attributes are to be
                       queried.


     attrib            Specifies the attribute being queried.


     size              Specifies the size of the attribute block.


     attribList        Pointer to array desired attributes.


     returnAttribList  Pointer to block of memory for best attributes to be
                       returned.


DESCRIPTION
     glXQueryHyperpipeBestAttribSGIX is part of the SGIX_hyperpipe extension.

     Hyperpipe hardware may have constraints on the attributes available
     through the glXHyperpipeAttribSGIX command.
     glXQueryHyperpipeBestAttribSGIX uses the constraints on attribList to
     come up with the best possible attributes, and returns them in
     returnAttribList.

     attrib is one of the following:

     GLX_PIPE_RECT         Queries the subrectangles that constitute the
                           hyperpipe output during timeSlice.  An array of
                           GLXPipeRects will be returned in the memory pointed
                           to by returnAttribList.  There will be one
                           GLXPipeRect per pipe participating in the given
                           timeSlice. attribList should hold an array of
                           GLXPipeRects, one per pipe in the given timeSlice.
                           returnAttribList should point to a block of memory
                           big enough to hold the GLXPipeRects.

     GLX_PIPE_RECT_LIMITS  Queries the maximum height and width of the
                           subrectangles of the given timeSlice.

     glXQueryHyperpipeBestAttribSGIX 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.


MACHINE DEPENDENCIES
     glXQueryHyperpipeBestAttribSGIX is currently supported only on
     InfinitePerformance systems.


SEE ALSO
     glXHyperpipeAttribSGIX glXQueryHyperpipeAttribSGIX hyperpipe