Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help

       glXMakeCurrent -	attach a GLX context to	a window or a GLX pixmap

       Bool glXMakeCurrent( Display *dpy,
			    GLXDrawable	drawable,
			    GLXContext ctx )

       delim $$

       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

       glXMakeCurrent  does two	things:	It makes ctx the current GLX rendering
       context of the calling thread, replacing	the previously current context
       if  there was one, and it attaches ctx to a GLX drawable, either	a win-
       dow or a	GLX pixmap.  As	a result of these two actions,	subsequent  GL
       rendering  calls	use rendering context ctx to modify GLX	drawable draw-
       able.  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  glX-
       MakeCurrent 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.

       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  subpro-
       cess group is equivalent	to a process.

       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  an-
       cillary	buffers	 until	glXMakeCurrent is called, only to find that it
       has insufficient	resources to complete the allocation.

       glXCreateContext, glXCreateGLXPixmap



Want to link to this manual page? Use this URL:

home | help