glXCreateContext man page on BSDi

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDi logo
[printable version]



GLXCREATECONTEXT()			     GLXCREATECONTEXT()

NAME
       glXCreateContext - create a new GLX rendering context

C SPECIFICATION
       GLXContext glXCreateContext( Display *dpy,
				    XVisualInfo *vis,
				    GLXContext shareList,
				    Bool direct )

PARAMETERS
       dpy	Specifies the connection to the X server.

       vis	Specifies  the	visual	that	defines the frame
		  buffer resources  available  to  the	rendering
		  context.   It is  a	pointer to an XVisualInfo
		  structure, not a visual ID or a  pointer  to	a
		  Visual.

       shareList  Specifies  the context with which to share dis-
		  play 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
		  possible   (True)   or  through  the	X  server
		  (False).

DESCRIPTION
       glXCreateContext creates	 a  GLX	 rendering  context  and
       returns	its  handle.   This context can be used to render
       into both windows and GLX  pixmaps.   If glXCreateContext
       fails to create a rendering context, NULL is returned.

       If direct is True, then a direct rendering context is cre-
       ated if the implementation supports direct  rendering,  if
       the  connection	is to an X server that is local, and if a
       direct rendering context is available. (An  implementation
       may  return  an indirect context when direct is True).  If
       direct is False, then a	rendering  context  that  renders
       through	the X server is always created. Direct rendering
       provides a performance advantage in some implementations.
       However, direct	rendering contexts cannot be shared out-
       side a single process, and they may be unable to render to
       GLX pixmaps.

       If  shareList  is  not NULL, then all display-list indexes
       and definitions are shared by context shareList and by the
       newly  created  context. An arbitrary number of contexts
       can share a single display-list space.  However, all  ren-
       dering  contexts that  share  a single display-list space
       must themselves exist in the same address space. Two ren-
       dering  contexts share	an  address  space  if	both  are

								1

GLXCREATECONTEXT()			     GLXCREATECONTEXT()

       nondirect using the same server, or if both are direct and
       owned  by  a  single  process.  Note that in the nondirect
       case, it is not necessary for the calling threads to share
       an  address  space,  only for their related rendering con-
       texts to share an address space.

       If the GL version is 1.1 or  greater,  then  all	 texture
       objects	except	object 0, are shared by any contexts that
       share display lists.

NOTES
       XVisualInfo is defined in Xutil.h.  It is a structure that
       includes visual, visualID, screen, and depth elements.

       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 sin-
       gle 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 equiva-
       lent to a process.

       It  may	not  be possible to render to a GLX pixmap with a
       direct rendering context.

ERRORS
       NULL is returned if execution fails on the client side.

       BadMatch is generated if the context to be  created  would
       not  share  the address space or the screen of the context
       specified by shareList.

       BadValue is generated if vis is not a  valid  visual  (for
       example, if a particular GLX implementation does not sup-
       port it).

       GLXBadContext is generated if shareList is not a GLX  con-
       text and is not NULL.

       BadAlloc is  generated if the server does not have enough
       resources to allocate the new context.

SEE ALSO
       glXDestroyContext, glXGetConfig, glXIsDirect,  glXMakeCur-
       rent

								2

[top]

List of man pages available for BSDi

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net