NAME
glXCreateContextWithConfigSGIX - create a new GLX rendering
context
C SPECIFICATION
GLXContext glXCreateContextWithConfigSGIX( Display *dpy,
GLXFBConfigSGIX config,
int render_type,
GLXContext shareList,
Bool direct )
PARAMETERS
dpy Specifies the connection to the X server.
config Specifies the config that defines the frame
buffer resources available to the rendering con-
text.
render_type
Specifies the rendering type of the context.
Allowed values are GLX_RGBA_TYPE_SGIX or
GLX_COLOR_INDEX_TYPE_SGIX.
shareList Specifies the context with which to share display
lists. NULL indicates that no sharing is to take
place.
direct Specifies whether rendering is to be done with a
direct connection to the graphics system if pos-
sible (True) or through the X server (False).
DESCRIPTION
glXCreateContextWithConfigSGIX is identical to glXCreateCon-
text except that the resulting GLXContext can be used to
render to any "compatible" GLXDrawable. A GLXContext and a
GLXDrawable are compatible if:
a. the render_type attribute for the context is supported
by the GLXFBConfigSGIX that the drawable was created
with. (e.g., if the context was created with
render_type GLX_RGBA_TYPE_SGIX, then the
GLXFBConfigSGIX's GLX_RENDER_TYPE_SGIX attribute must
have the GLX_RGBA_BIT_SGIX bit set.)
b. all color buffers and ancillary buffers that exist in
both GLXFBConfigSGIXs have the same depth. For example,
a GLXDrawable that had a front left buffer and a back
left buffer with red, green and blue sizes of 4 would
not be compatible with a GLXFBConfigSGIX that had only
a front left buffer with red, green and blue sizes of
8. However, it would be compatible with a GLXFBConfigS-
GIX that had only a front left buffer if the red, green
and blue sizes were 4.
No error will be generated if the value of GL_DRAW_BUFFER in
ctx indicates a color buffer that is not supported by draw-
able. In this case, all rendering will behave as if
GL_DRAW_BUFFER was set to NONE. The same is true for
GL_READ_BUFFER: no error will be generated if it does not
correspond to a valid color buffer; subsequent glReadPixel
and glCopyPixel operations will simply return invalid data.
Note that it is an error to later call glDrawBuffer and/or
glReadBuffer (even if they are implicitly called via glPo-
pAttrib) and specify a color buffer that is not supported by
drawable. Also subsequent calls to glCopyPixels, that
specify an unsupported ancillary buffer, will result in an
error.
NOTES
GLX_SGIX_fbconfig extension should be supported for this
function to be valid.
ERRORS
GLXBadContext is generated if sharelist is neither zero nor
a valid GLX rendering context.
GLXBadFBConfigSGIX is generated if config is not a valid
GLXFBConfigSGIX.
BadMatch is generated if the context to be created would not
share the address space or the screen of the context speci-
fied by shareList.
BadAlloc is generated if the server does not have enough
resources to allocate the new context.
BadValue if render_type does not refer to a valid rendering
type.
NULL is returned if execution fails on the client side.
SEE ALSO
glXMakeCurrent, glDrawBuffer,. glReadBuffer, glCopyPixels,
glReadPixels, glPopAttrib, glXCreateContext, glXGetConfig-
FromVisualSGIX, glXCreateGLXPixmapWithConfigSGIX,
glXChooseFBConfigSGIX, glXGetFBConfigFromVisualSGIX,
glXGetFBConfigAttribSGIX
|
Закладки на сайте Проследить за страницей |
Created 1996-2025 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |