glxmakecurrent(3) [redhat man page]
GLXMAKECURRENT() GLXMAKECURRENT() NAME
glXMakeCurrent - attach a GLX context to a window or a GLX pixmap C SPECIFICATION
Bool glXMakeCurrent( Display *dpy, GLXDrawable drawable, GLXContext ctx ) delim $$ PARAMETERS
dpy Specifies the connection to the X server. drawable Specifies a GLX drawable. Must be either an X window ID or a GLX pixmap ID. ctx Specifies a GLX rendering context that is to be attached to drawable. DESCRIPTION
glXMakeCurrent does two things: It makes ctx the current GLX rendering context of the calling thread, replacing the previously current con- text if there was one, and it attaches ctx to a GLX drawable, either a window or a GLX pixmap. As a result of these two actions, subse- quent GL rendering calls use rendering context ctx to modify GLX drawable drawable. Because glXMakeCurrent always replaces the current rendering context with ctx, there can be only one current context per thread. Pending commands to the previous context, if any, are flushed before it is released. The first time ctx is made current to any thread, its viewport is set to the full size of drawable. Subsequent calls by any thread to glX- MakeCurrent with ctx have no effect on its viewport. To release the current context without assigning a new one, call glXMakeCurrent with drawable set None and ctx set to NULL glXMakeCurrent returns True if it is successful, False otherwise. If False is returned, the previously current rendering context and draw- able (if any) remain unchanged. NOTES
A process is a single-execution environment, implemented in a single address space, consisting of one or more threads. A thread is one of a set of subprocesses that share a single address space, but maintain separate program counters, stack spaces, and other related global data. A thread that is the only member of its subprocess group is equivalent to a process. ERRORS
BadMatch is generated if drawable was not created with the same X screen and visual as ctx. It is also generated if drawable is None and ctx is not NULL. BadAccess is generated if ctx was current to another thread at the time glXMakeCurrent was called. GLXBadDrawable is generated if drawable is not a valid GLX drawable. GLXBadContext is generated if ctx is not a valid GLX context. GLXBadContextState is generated if glXMakeCurrent is executed between the execution of glBegin and the corresponding execution of glEnd. GLXBadContextState is also generated if the rendering context current to the calling thread has GL renderer state GL_FEEDBACK or GL_SELECT. GLXBadCurrentWindow is generated if there are pending GL commands for the previous context and the current drawable is a window that is no longer valid. BadAlloc may be generated if the server has delayed allocation of ancillary buffers until glXMakeCurrent is called, only to find that it has insufficient resources to complete the allocation. SEE ALSO
glXCreateContext, glXCreateGLXPixmap GLXMAKECURRENT()
Check Out this Related Man Page
GLXMAKECONTEXTCURREN(3G) OpenGL Manual GLXMAKECONTEXTCURREN(3G) NAME
glXMakeContextCurrent - attach a GLX context to a GLX drawable C SPECIFICATION
Bool glXMakeContextCurrent(Display * display, GLXDrawable draw, GLXDrawable read, GLXContext ctx); PARAMETERS
display Specifies the connection to the X server. draw Specifies a GLX drawable to render into. Must be an XID representing a GLXWindow, GLXPixmap, or GLXPbuffer. read Specifies a GLX drawable to read from. Must be an XID representing a GLXWindow, GLXPixmap, or GLXPbuffer. ctx Specifies the GLX context to be bound to read and ctx. DESCRIPTION
glXMakeContextCurrent binds ctx to the current rendering thread and to the draw and read GLX drawables. draw and read may be the same. draw is used for all OpenGL operations except: Any pixel data that are read based on the value of GLX_READ_BUFFER. Note that accumulation operations use the value of GLX_READ_BUFFER, but are not allowed unless draw is identical to read. Any depth values that are retrieved by glReadPixels() or glCopyPixels(). Any stencil values that are retrieved by glReadPixels() or glCopyPixels(). Frame buffer values are taken from draw. If the current rendering thread has a current rendering context, that context is flushed and replaced by ctx. The first time that ctx is made current, the viewport and scissor dimensions are set to the size of the draw drawable. The viewport and scissor are not modified when ctx is subsequently made current. To release the current context without assigning a new one, call glXMakeContextCurrent with draw and read set to None and ctx set to NULL. glXMakeContextCurrent returns True if it is successful, False otherwise. If False is returned, the previously current rendering context and drawable (if any) remain unchanged. NOTES
glXMakeContextCurrent is available only if the GLX version is 1.3 or greater. If the GLX version is 1.1 or 1.0, the GL version must be 1.0. If the GLX version is 1.2, then the GL version must be 1.1. If the GLX version is 1.3, then the GL version must be 1.2. ERRORS
BadMatch is generated if draw and read are not compatible. BadAccess is generated if ctx is current to some other thread. GLXContextState is generated if there is a current rendering context and its render mode is either GLX_FEEDBACK or GLX_SELECT. GLXBadContext is generated if ctx is not a valid GLX rendering context. GLXBadDrawable is generated if draw or read is not a valid GLX drawable. GLXBadWindow is generated if the underlying X window for either draw or read is no longer valid. GLXBadCurrentDrawable is generated if the previous context of the calling thread has unflushed commands and the previous drawable is no longer valid. BadAlloc is generated if the X server does not have enough resources to allocate the buffers. BadMatch is generated if: draw and read cannot fit into frame buffer memory simultaneously. draw or read is a GLXPixmap and ctx is a direct-rendering context. draw or read is a GLXPixmap and ctx was previously bound to a GLXWindow or GLXPbuffer. draw or read is a GLXWindow or GLXPbuffer and ctx was previously bound to a GLXPixmap. SEE ALSO
glXCreateNewContext(), glXCreateWindow(), glXCreatePixmap(), glXCreatePbuffer(), glXDestroyContext(), glXGetCurrentContext(), glXGetCurrentDisplay(), glXGetCurrentDrawable(), glXGetCurrentReadDrawable(), glXMakeCurrent() COPYRIGHT
Copyright (C) 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/. AUTHORS
opengl.org opengl.org 06/10/2014 GLXMAKECONTEXTCURREN(3G)