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-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |