diff options
Diffstat (limited to 'xc/doc/man/GL/glx')
27 files changed, 0 insertions, 2069 deletions
diff --git a/xc/doc/man/GL/glx/Imakefile b/xc/doc/man/GL/glx/Imakefile deleted file mode 100644 index 3b55858bc..000000000 --- a/xc/doc/man/GL/glx/Imakefile +++ /dev/null @@ -1,67 +0,0 @@ -XCOMM The contents of this file are subject to the GLX Public License Version 1.0 -XCOMM (the "License"). You may not use this file except in compliance with the -XCOMM License. You may obtain a copy of the License at Silicon Graphics, Inc., -XCOMM attn: Legal Services, 2011 N. Shoreline Blvd., Mountain View, CA 94043 -XCOMM or at http://www.sgi.com/software/opensource/glx/license.html. -XCOMM -XCOMM Software distributed under the License is distributed on an "AS IS" -XCOMM basis. ALL WARRANTIES ARE DISCLAIMED, INCLUDING, WITHOUT LIMITATION, ANY -XCOMM IMPLIED WARRANTIES OF MERCHANTABILITY, OF FITNESS FOR A PARTICULAR -XCOMM PURPOSE OR OF NON- INFRINGEMENT. See the License for the specific -XCOMM language governing rights and limitations under the License. -XCOMM -XCOMM The Original Software is GLX version 1.2 source code, released February, -XCOMM 1999. The developer of the Original Software is Silicon Graphics, Inc. -XCOMM Those portions of the Subject Software created by Silicon Graphics, Inc. -XCOMM are Copyright (c) 1991-9 Silicon Graphics, Inc. All Rights Reserved. -XCOMM -XCOMM $XFree86: xc/doc/man/GL/glx/Imakefile,v 1.3 1999/03/07 14:23:30 dawes Exp $ - -MANDIR = $(LIBMANDIR) -MANSUFFIX = $(LIBMANSUFFIX) -MSUFF = man - -MAN_PAGES = \ -glXChooseVisual.$(MSUFF) glXCopyContext.$(MSUFF) \ -glXCreateContext.$(MSUFF) glXCreateGLXPixmap.$(MSUFF) \ -glXDestroyContext.$(MSUFF) glXDestroyGLXPixmap.$(MSUFF) \ -glXFreeContextEXT.$(MSUFF) glXGetClientString.$(MSUFF) \ -glXGetConfig.$(MSUFF) glXGetContextIDEXT.$(MSUFF) \ -glXGetCurrentContext.$(MSUFF) glXGetCurrentDisplay.$(MSUFF) \ -glXGetCurrentDrawable.$(MSUFF) glXImportContextEXT.$(MSUFF) \ -glXIntro.$(MSUFF) glXIsDirect.$(MSUFF) \ -glXMakeCurrent.$(MSUFF) glXQueryContextInfoEXT.$(MSUFF) \ -glXQueryExtension.$(MSUFF) glXQueryExtensionsString.$(MSUFF) \ -glXQueryServerString.$(MSUFF) glXQueryVersion.$(MSUFF) \ -glXSwapBuffers.$(MSUFF) glXUseXFont.$(MSUFF) \ -glXWaitGL.$(MSUFF) glXWaitX.$(MSUFF) - -InstallMultipleMan($(MAN_PAGES),$(LIBMANDIR)) - -LinkFile(glXChooseVisual.$(MSUFF), xchoosevisual.3gl) -LinkFile(glXCopyContext.$(MSUFF), xcopycontext.3gl) -LinkFile(glXCreateContext.$(MSUFF), xcreatecontext.3gl) -LinkFile(glXCreateGLXPixmap.$(MSUFF), xcreateglxpixmap.3gl) -LinkFile(glXDestroyContext.$(MSUFF), xdestroycontext.3gl) -LinkFile(glXDestroyGLXPixmap.$(MSUFF), xdestroyglxpixmap.3gl) -LinkFile(glXFreeContextEXT.$(MSUFF), xfreecontextext.3gl) -LinkFile(glXGetClientString.$(MSUFF), xgetclientstring.3gl) -LinkFile(glXGetConfig.$(MSUFF), xgetconfig.3gl) -LinkFile(glXGetContextIDEXT.$(MSUFF), xgetcontextidext.3gl) -LinkFile(glXGetCurrentContext.$(MSUFF), xgetcurrentcontext.3gl) -LinkFile(glXGetCurrentDisplay.$(MSUFF), xgetcurrentdisplay.3gl) -LinkFile(glXGetCurrentDrawable.$(MSUFF), xgetcurrentdrawable.3gl) -LinkFile(glXImportContextEXT.$(MSUFF), ximportcontextext.3gl) -LinkFile(glXIntro.$(MSUFF), xintro.3gl) -LinkFile(glXIsDirect.$(MSUFF), xisdirect.3gl) -LinkFile(glXMakeCurrent.$(MSUFF), xmakecurrent.3gl) -LinkFile(glXQueryContextInfoEXT.$(MSUFF), xquerycontextinfoext.3gl) -LinkFile(glXQueryExtension.$(MSUFF), xqueryextension.3gl) -LinkFile(glXQueryExtensionsString.$(MSUFF), xqueryextensionsstring.3gl) -LinkFile(glXQueryServerString.$(MSUFF), xqueryserverstring.3gl) -LinkFile(glXQueryVersion.$(MSUFF), xqueryversion.3gl) -LinkFile(glXSwapBuffers.$(MSUFF), xswapbuffers.3gl) -LinkFile(glXUseXFont.$(MSUFF), xusexfont.3gl) -LinkFile(glXWaitGL.$(MSUFF), xwaitgl.3gl) -LinkFile(glXWaitX.$(MSUFF), xwaitx.3gl) - diff --git a/xc/doc/man/GL/glx/xchoosevisual.3gl b/xc/doc/man/GL/glx/xchoosevisual.3gl deleted file mode 100644 index 419bd19ee..000000000 --- a/xc/doc/man/GL/glx/xchoosevisual.3gl +++ /dev/null @@ -1,225 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 58988 14 xchoosevisual.gl -.TH GLXCHOOSEVISUAL -.SH NAME -.B "glXChooseVisual -\- return a visual that matches specified attributes - -.SH C SPECIFICATION -XVisualInfo* \f3glXChooseVisual\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3XVisualInfo* \fPglXChooseVisual( 'u - int \fIscreen\fP, - int \fI*attribList\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fIattribList\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2screen\fP -Specifies the screen number. -.TP -\f2attribList\fP -Specifies a list of boolean attributes and integer attribute/value pairs. -The last attribute must be \f3None\fP. -.SH DESCRIPTION -\f3glXChooseVisual\fP returns a pointer to an XVisualInfo structure describing the visual -that best meets a minimum specification. -The boolean GLX attributes of the visual that is returned will match the -specified values, -and the integer GLX attributes will meet or exceed the specified -minimum values. -If all other attributes are equivalent, then TrueColor and PseudoColor -visuals have priority over DirectColor and StaticColor visuals, -respectively. -If no conforming visual exists, \f3NULL\fP is returned. -To free the data returned by this function, use \f3XFree\fP. -.P -All boolean GLX attributes default to \f3False\fP -except \f3GLX_USE_GL\fP, -which defaults to \f3True\fP. -All integer GLX attributes default to zero. -Default specifications are superseded by attributes included in \f2attribList\fP. -Boolean attributes included in \f2attribList\fP are understood to be \f3True\fP. -Integer attributes and enumerated type attributes are followed immediately -by the corresponding desired or -minimum value. -The list must be terminated with \f3None\fP. -.P -The interpretations of the various GLX visual attributes are as follows: -.TP 22 -\f3GLX_USE_GL\fP -Ignored. -Only visuals that can be rendered with GLX are considered. -.TP -\f3GLX_BUFFER_SIZE\fP -Must be followed by a nonnegative integer that indicates the desired -color index buffer size. -The smallest index buffer of at least the specified size is preferred. -Ignored if \f3GLX_RGBA\fP is asserted. -.BP -.TP -\f3GLX_LEVEL\fP -Must be followed by an integer buffer-level specification. -This specification is honored exactly. -Buffer level zero corresponds to the main frame buffer of the display. -Buffer level one is the first overlay frame buffer, level two the second -overlay frame buffer, and so on. -Negative buffer levels correspond to underlay frame buffers. -.TP -\f3GLX_RGBA\fP -If present, -only TrueColor and DirectColor visuals are considered. -Otherwise, -only PseudoColor and StaticColor visuals are considered. -.TP -\f3GLX_DOUBLEBUFFER\fP -If present, -only double-buffered visuals are considered. -.BR -Otherwise, -only single-buffered visuals are considered. -.TP -\f3GLX_STEREO\fP -If present, -only stereo visuals are considered. -Otherwise, -only monoscopic visuals are considered. -.TP -\f3GLX_AUX_BUFFERS\fP -Must be followed by a nonnegative integer that indicates the desired -number of auxiliary buffers. -Visuals with the -.BR -smallest number of auxiliary buffers that meets or exceeds -the specified number are preferred. -.TP -\f3GLX_RED_SIZE\fP -Must be followed by a nonnegative minimum size specification. -If this value is zero, -the smallest available red buffer is preferred. -Otherwise, the largest available red buffer of at least the minimum size -is preferred. -.TP -\f3GLX_GREEN_SIZE\fP -Must be followed by a nonnegative minimum size specification. -If this value is zero, -the smallest available green buffer is preferred. -Otherwise, the largest available green buffer of at least the minimum size -is preferred. -.TP -\f3GLX_BLUE_SIZE\fP -Must be followed by a nonnegative minimum size specification. -If this value is zero, -the smallest available blue buffer is preferred. -Otherwise, the largest available blue buffer of at least the minimum size -is preferred. -.TP -\f3GLX_ALPHA_SIZE\fP -Must be followed by a nonnegative minimum size specification. -If this value is zero, -the smallest available alpha buffer is preferred. -Otherwise, the largest available alpha buffer of at least the minimum size -is preferred. -.TP -\f3GLX_DEPTH_SIZE\fP -Must be followed by a nonnegative minimum size specification. -If this value is zero, -visuals with no depth buffer are preferred. -Otherwise, the largest available depth buffer of at least the minimum size -is preferred. -.TP -\f3GLX_STENCIL_SIZE\fP -Must be followed by a nonnegative integer that indicates the desired -number of stencil bitplanes. -The smallest stencil buffer of at least the specified size is preferred. -If the desired value is zero, -visuals with no stencil buffer are preferred. -.TP -\f3GLX_ACCUM_RED_SIZE\fP -Must be followed by a nonnegative minimum size specification. -If this value is zero, -visuals with no red accumulation buffer are preferred. -Otherwise, the largest possible red accumulation buffer -of at least the minimum size is preferred. -.TP -\f3GLX_ACCUM_GREEN_SIZE\fP -Must be followed by a nonnegative minimum size specification. -If this value is zero, -visuals with no green accumulation buffer are preferred. -Otherwise, the largest possible green accumulation buffer -of at least the minimum size is preferred. -.TP -\f3GLX_ACCUM_BLUE_SIZE\fP -Must be followed by a nonnegative minimum size specification. -If this value is zero, -visuals with no blue accumulation buffer are preferred. -Otherwise, the largest possible blue accumulation buffer -of at least the minimum size is preferred. -.TP -\f3GLX_ACCUM_ALPHA_SIZE\fP -Must be followed by a nonnegative minimum size specification. -If this value is zero, -visuals with no alpha accumulation buffer are preferred. -Otherwise, the largest possible alpha accumulation buffer -of at least the minimum size is preferred. -.TE -.SH EXAMPLES -.TP 12 -\f2attribList\fP = -{\f3GLX_RGBA\fP, -\f3GLX_RED_SIZE\fP, 4, -\f3GLX_GREEN_SIZE\fP, 4, -\f3GLX_BLUE_SIZE\fP, 4, -\f3None\fP}; -.P -Specifies a single-buffered RGB visual in the normal frame buffer, -not an overlay or underlay buffer. -The returned visual supports at least four bits each of red, -green, and blue, -and possibly no bits of alpha. -It does not support color index mode, -double-buffering, or stereo display. -It may or may not have one or more auxiliary color buffers, -a depth buffer, -a stencil buffer, -or an accumulation buffer. -.SH NOTES -\f3XVisualInfo\fP is defined in \f2Xutil.h.\fP -It is a structure that includes \f2visual\fP, \f2visualID\fP, \f2screen\fP, and -\f2depth\fP elements. -.P -\f3glXChooseVisual\fP is implemented as a client-side utility using only \f3XGetVisualInfo\fP -and \f3glXGetConfig\fP. -Calls to these two routines can be used to implement selection algorithms -other than the generic one implemented by \f3glXChooseVisual\fP. -.P -GLX implementers are strongly discouraged, -but not proscribed, -from changing the selection algorithm used by \f3glXChooseVisual\fP. -Therefore, selections may change from release to release -of the client-side library. -.P -There is no direct filter for picking only visuals that -support GLXPixmaps. -GLXPixmaps are supported for visuals whose -\f3GLX_BUFFER_SIZE\fP -is one of the pixmap depths supported by the X server. -.SH ERRORS -\f3NULL\fP is returned if an undefined GLX attribute is encountered in -\f2attribList\fP. -.SH SEE ALSO -\f3glXCreateContext\fP, -\f3glXGetConfig\fP diff --git a/xc/doc/man/GL/glx/xcopycontext.3gl b/xc/doc/man/GL/glx/xcopycontext.3gl deleted file mode 100644 index b439ae3fb..000000000 --- a/xc/doc/man/GL/glx/xcopycontext.3gl +++ /dev/null @@ -1,98 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 49166 6 xcopycontext.gl -.TH GLXCOPYCONTEXT -.SH NAME -.B "glXCopyContext -\- copy state from one rendering context to another - -.SH C SPECIFICATION -void \f3glXCopyContext\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3void \fPglXCopyContext( 'u - GLXContext \fIsrc\fP, - GLXContext \fIdst\fP, - unsigned long \fImask\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fImask\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2src\fP -Specifies the source context. -.TP -\f2dst\fP -Specifies the destination context. -.TP -\f2mask\fP -Specifies which portions of \f2src\fP state are to be copied to \f2dst\fP. -.SH DESCRIPTION -\f3glXCopyContext\fP copies selected groups of state variables from \f2src\fP to \f2dst\fP. -\f2mask\fP indicates which groups of state variables are to be copied. -\f2mask\fP contains the bitwise OR of the same symbolic names that are -passed to the GL command \f3glPushAttrib\fP. -The single symbolic constant \f3GL_ALL_ATTRIB_BITS\fP can be used to -copy the maximum possible portion of rendering state. -.P -The copy can be done only if the renderers named by \f2src\fP and \f2dst\fP -share an address space. -Two rendering contexts share an address space if both are 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 contexts to share an address space. -.P -Not all values for GL state can be copied. -For example, -pixel pack and unpack state, -render mode state, -and select and feedback state are not copied. -The state that can be copied is exactly the state that is manipulated -by the GL command -.br -\f3glPushAttrib\fP. -.P -An implicit \f3glFlush\fP is done by \f3glXCopyContext\fP if \f2src\fP is the current -context for the calling thread. -.SH NOTES -.P -A \f2process\fP is a single execution environment, -implemented in a single address space, -consisting of one or more threads. -.P -A \f2thread\fP 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 \f2thread\fP that is the only member of its subprocess group -is equivalent to a \f2process\fP. -.SH ERRORS -\f3BadMatch\fP is generated if rendering contexts \f2src\fP and \f2dst\fP -do not share an address space -or were not created with respect to the same screen. -.P -\f3BadAccess\fP is generated if \f2dst\fP is current to any thread -(including the calling thread) at the time \f3glXCopyContext\fP is called. -.P -\f3GLXBadCurrentWindow\fP is generated if \f2src\fP is the current -context and the current drawable is a window that is no longer valid. -.P -\f3GLXBadContext\fP is generated if either \f2src\fP or \f2dst\fP is not -a valid GLX context. -.SH SEE ALSO -\f3glPushAttrib\fP, -\f3glXCreateContext\fP, -\f3glXIsDirect\fP diff --git a/xc/doc/man/GL/glx/xcreatecontext.3gl b/xc/doc/man/GL/glx/xcreatecontext.3gl deleted file mode 100644 index 2b4f635e0..000000000 --- a/xc/doc/man/GL/glx/xcreatecontext.3gl +++ /dev/null @@ -1,117 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 16965 8 xcreatecontext.gl -.TH GLXCREATECONTEXT -.SH NAME -.B "glXCreateContext -\- create a new GLX rendering context - -.SH C SPECIFICATION -GLXContext \f3glXCreateContext\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3GLXContext \fPglXCreateContext( 'u - XVisualInfo \fI*vis\fP, - GLXContext \fIshareList\fP, - Bool \fIdirect\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fIshareList\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2vis\fP -Specifies the visual that defines the frame buffer resources available to -the rendering context. -It is a pointer to an \f3XVisualInfo\fP structure, -not a visual ID or a pointer to a \f3Visual\fP. -.TP -\f2shareList\fP -Specifies the context with which to share display lists. -\f3NULL\fP indicates that no sharing is to take place. -.TP -\f2direct\fP -Specifies whether rendering is to be done with a direct connection -to the graphics system if possible (\f3True\fP) -or through the X server (\f3False\fP). -.SH DESCRIPTION -\f3glXCreateContext\fP creates a GLX rendering context and returns its handle. -This context can be used to render into both windows and GLX pixmaps. -If \f3glXCreateContext\fP fails to create a rendering context, -\f3NULL\fP is returned. -.P -If \f2direct\fP is \f3True\fP, -then a direct rendering context is created 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 \f2direct\fP is \f3True\fP). -If \f2direct\fP is \f3False\fP, -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 outside a single process, -and they may be unable to render to GLX pixmaps. -.P -If \f2shareList\fP is not \f3NULL\fP, -then all display-list indexes and definitions are shared by -context \f2shareList\fP and by the newly created context. -An arbitrary number of contexts can share a single display-list space. -However, -all rendering contexts that share a single display-list space must -themselves exist in the same address space. -Two rendering contexts share an address space if both are 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 contexts to share an address space. -.P -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. -.SH NOTES -\f3XVisualInfo\fP is defined in \f2Xutil.h.\fP -It is a structure that includes \f2visual\fP, \f2visualID\fP, \f2screen\fP, and -\f2depth\fP elements. -.P -A \f2process\fP is a single execution environment, -implemented in a single address space, -consisting of one or more threads. -.P -A \f2thread\fP 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 \f2thread\fP that is the only member of its subprocess group -is equivalent to a \f2process\fP. -.P -It may not be possible to render to a GLX pixmap with a direct rendering -context. -.SH ERRORS -\f3NULL\fP is returned if execution fails on the client side. -.P -\f3BadMatch\fP is generated if the context to be created would not -share the address space or the screen of the context specified by \f2shareList\fP. -.P -\f3BadValue\fP is generated if \f2vis\fP is not a valid visual (for -example, if a particular GLX implementation does not support it). -.P -\f3GLXBadContext\fP is generated if \f2shareList\fP is not a GLX context -and is not \f3NULL\fP. -.P -\f3BadAlloc\fP is generated if the server does not have enough -resources to allocate the new context. -.SH SEE ALSO -\f3glXDestroyContext\fP, -\f3glXGetConfig\fP, -\f3glXIsDirect\fP, -\f3glXMakeCurrent\fP - diff --git a/xc/doc/man/GL/glx/xcreateglxpixmap.3gl b/xc/doc/man/GL/glx/xcreateglxpixmap.3gl deleted file mode 100644 index fbaaaaa09..000000000 --- a/xc/doc/man/GL/glx/xcreateglxpixmap.3gl +++ /dev/null @@ -1,76 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 62493 5 xcreateglxpixmap.gl -.TH GLXCREATEGLXPIXMAP -.SH NAME -.B "glXCreateGLXPixmap -\- create an off-screen GLX rendering area - -.SH C SPECIFICATION -GLXPixmap \f3glXCreateGLXPixmap\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3GLXPixmap \fPglXCreateGLXPixmap( 'u - XVisualInfo \fI*vis\fP, - Pixmap \fIpixmap\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fIpixmap\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2vis\fP -Specifies the visual that defines the structure of the rendering area. -It is a pointer to an \f3XVisualInfo\fP structure, -not a visual ID or a pointer to a \f3Visual\fP. -.TP -\f2pixmap\fP -Specifies the X pixmap that will be used as the front left color buffer -of the off-screen rendering area. -.SH DESCRIPTION -\f3glXCreateGLXPixmap\fP creates an off-screen rendering area and returns its XID. -Any GLX rendering context that was created with respect to \f2vis\fP -can be used to render into this off-screen area. -Use \f3glXMakeCurrent\fP to associate the rendering area with a GLX -rendering context. -.P -The X pixmap identified by \f2pixmap\fP is used as the front left buffer of the -resulting off-screen rendering area. -All other buffers specified by \f2vis\fP, -including color buffers other than the front left buffer, -are created without externally visible names. -GLX pixmaps with double-buffering are supported. -However, \f3glXSwapBuffers\fP is ignored by these pixmaps. -.P -Some implementations may not support GLX pixmaps with direct rendering -contexts. -.SH NOTES -\f3XVisualInfo\fP is defined in \f2Xutil.h.\fP -It is a structure that includes \f2visual\fP, \f2visualID\fP, \f2screen\fP, and -\f2depth\fP elements. -.SH ERRORS -\f3BadMatch\fP is generated if the depth of \f2pixmap\fP does not match -the depth value reported by core X11 for \f2vis\fP, -or if \f2pixmap\fP was not created with respect to the same screen as \f2vis\fP. -.P -\f3BadValue\fP is generated -if \f2vis\fP is not a valid XVisualInfo pointer (for example, if a -particular GLX implementation does not support this visual). -.P -\f3BadPixmap\fP is generated if \f2pixmap\fP is not a valid pixmap. -.P -\f3BadAlloc\fP is generated if the server cannot allocate the GLX -pixmap. -.SH SEE ALSO -\f3glXCreateContext\fP, -\f3glXIsDirect\fP, -\f3glXMakeCurrent\fP diff --git a/xc/doc/man/GL/glx/xdestroycontext.3gl b/xc/doc/man/GL/glx/xdestroycontext.3gl deleted file mode 100644 index 0a2fd2597..000000000 --- a/xc/doc/man/GL/glx/xdestroycontext.3gl +++ /dev/null @@ -1,44 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 5532 2 xdestroycontext.gl -.TH GLXDESTROYCONTEXT -.SH NAME -.B "glXDestroyContext -\- destroy a GLX context - -.SH C SPECIFICATION -void \f3glXDestroyContext\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3void \fPglXDestroyContext( 'u - GLXContext \fIctx\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\f2dpy\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2ctx\fP -Specifies the GLX context to be destroyed. -.SH DESCRIPTION -If the GLX rendering context \f2ctx\fP is not current to any thread, -\f3glXDestroyContext\fP -destroys it immediately. -Otherwise, -\f2ctx\fP is destroyed when it becomes not current to any thread. -In either case, the resource ID -referenced by \f2ctx\fP is freed immediately. -.SH ERRORS -\f3GLXBadContext\fP is generated if \f2ctx\fP is not a valid GLX context. -.SH SEE ALSO -\f3glXCreateContext\fP, -\f3glXMakeCurrent\fP diff --git a/xc/doc/man/GL/glx/xdestroyglxpixmap.3gl b/xc/doc/man/GL/glx/xdestroyglxpixmap.3gl deleted file mode 100644 index df30588e4..000000000 --- a/xc/doc/man/GL/glx/xdestroyglxpixmap.3gl +++ /dev/null @@ -1,43 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 2275 2 xdestroyglxpixmap.gl -.TH GLXDESTROYGLXPIXMAP -.SH NAME -.B "glXDestroyGLXPixmap -\- destroy a GLX pixmap - -.SH C SPECIFICATION -void \f3glXDestroyGLXPixmap\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3void \fPglXDestroyGLXPixmap( 'u - GLXPixmap \fIpix\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\f2dpy\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2pix\fP -Specifies the GLX pixmap to be destroyed. -.SH DESCRIPTION -If the GLX pixmap \f2pix\fP is not current to any client, -\f3glXDestroyGLXPixmap\fP destroys it immediately. -Otherwise, -\f2pix\fP is destroyed when it becomes not current to any client. -In either case, the resource ID -is freed immediately. -.SH ERRORS -\f3GLXBadPixmap\fP is generated if \f2pix\fP is not a valid GLX pixmap. -.SH SEE ALSO -\f3glXCreateGLXPixmap\fP, -\f3glXMakeCurrent\fP diff --git a/xc/doc/man/GL/glx/xfreecontextext.3gl b/xc/doc/man/GL/glx/xfreecontextext.3gl deleted file mode 100644 index 0bc818faf..000000000 --- a/xc/doc/man/GL/glx/xfreecontextext.3gl +++ /dev/null @@ -1,54 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 37853 3 xfreecontextext.gl -.TH GLXFREECONTEXTEXT -.SH NAME -.B "glXFreeContextEXT -\- free client-side memory for imported context - -.SH C SPECIFICATION -void \f3glXFreeContextEXT\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3void \fPglXFreeContextEXT( 'u - GLXContext \fIctx\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\f2dpy\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. - -.TP -\f2ctx\fP -Specifies a GLX rendering context. - -.SH DESCRIPTION -\f3glXFreeContextEXT\fP frees the client-side part of a GLXContext that -was created with \f3glXImportContext\fP. \f3glXFreeContextEXT\fP does not -free the server-side context information or the XID -associated with the server-side context. -.P -\f3glXFreeContextEXT\fP is part of the \f3EXT_import_context\fP extension, -not part of the core GLX command set. If \f3GLX_EXT_import_context\fP -is included in the string returned by \f3glXQueryExtensionsString\fP, -when called with argument \f3GLX_EXTENSIONS\fP, -extension \f3EXT_vertex_array\fP is supported. - -.SH ERRORS -\f3GLXBadContext\fP is generated if \f2ctx\fP does not -refer to a valid context. - -.SH SEE ALSO -\f3glXCreateContext\fP, -\f3glXQueryVersion\fP, -\f3glXQueryExtensionsString\fP, -\f3glXImportContextEXT\fP diff --git a/xc/doc/man/GL/glx/xgetclientstring.3gl b/xc/doc/man/GL/glx/xgetclientstring.3gl deleted file mode 100644 index aee237d17..000000000 --- a/xc/doc/man/GL/glx/xgetclientstring.3gl +++ /dev/null @@ -1,64 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 29851 4 xgetclientstring.gl -.TH GLXGETCLIENTSTRING -.SH NAME -.B "glXGetClientString -\- return a string describing the client - -.SH C SPECIFICATION -const char * \f3glXGetClientString\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3const char * \fPglXGetClientString( 'u - int \fIname\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fIname\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2name\fP -Specifies which string is returned. -One of \f3GLX_VENDOR\fP, \f3GLX_VERSION\fP, or \f3GLX_EXTENSIONS\fP. -.SH DESCRIPTION -\f3glXGetClientString\fP returns a string -describing some aspect of the client library. The possible values for \f2name\fP -are \f3GLX_VENDOR\fP, \f3GLX_VERSION\fP, and -\f3GLX_EXTENSIONS\fP. If \f2name\fP -is not set to one of these values, \f3glXGetClientString\fP returns \f3NULL\fP. -The format and contents of the vendor string is implementation dependent. -.P -The extensions string is null-terminated and contains a -space-separated list of extension names. (The extension names never -contain spaces.) -If there are no extensions to GLX, then the empty string is returned. -.P -The version string is laid out as follows: -.sp -<major_version.minor_version><space><vendor-specific info> -.sp -Both the major and minor portions of the version number are of arbitrary -length. The vendor-specific information is optional. However, if it is -present, the format and contents are implementation specific. -.SH NOTES -\f3glXGetClientString\fP is available only if the GLX version is 1.1 or greater. -.P -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. -.P -\f3glXGetClientString\fP only returns information about GLX extensions supported by the client. -Call \f3glGetString\fP to get a list of GL extensions supported by the server. -.SH SEE ALSO -\f3glXQueryVersion\fP, -\f3glXQueryExtensionsString\fP, -\f3glXQueryServerString\fP diff --git a/xc/doc/man/GL/glx/xgetconfig.3gl b/xc/doc/man/GL/glx/xgetconfig.3gl deleted file mode 100644 index 780d099c2..000000000 --- a/xc/doc/man/GL/glx/xgetconfig.3gl +++ /dev/null @@ -1,177 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 60987 10 xgetconfig.gl -.TH GLXGETCONFIG -.SH NAME -.B "glXGetConfig -\- return information about GLX visuals - -.SH C SPECIFICATION -int \f3glXGetConfig\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3int \fPglXGetConfig( 'u - XVisualInfo \fI*vis\fP, - int \fIattrib\fP, - int \fI*value\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fIattrib\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2vis\fP -Specifies the visual to be queried. -It is a pointer to an \f3XVisualInfo\fP structure, -not a visual ID or a pointer to a \f3Visual\fP. -.TP -\f2attrib\fP -Specifies the visual attribute to be returned. -.TP -\f2value\fP -Returns the requested value. -.SH DESCRIPTION -\f3glXGetConfig\fP sets \f2value\fP to the \f2attrib\fP value of windows or GLX pixmaps -created with respect to \f2vis\fP. -\f3glXGetConfig\fP returns an error code if it fails for any reason. -Otherwise, zero is returned. -.P -\f2attrib\fP is one of the following: -.P -.TP 22 -\f3GLX_USE_GL\fP -\f3True\fP if OpenGL rendering is supported by this visual, -\f3False\fP otherwise. -.TP -\f3GLX_BUFFER_SIZE\fP -Number of bits per color buffer. -For RGBA visuals, \f3GLX_BUFFER_SIZE\fP is the sum of -\f3GLX_RED_SIZE\fP, -\f3GLX_GREEN_SIZE\fP, -\f3GLX_BLUE_SIZE\fP, and -\f3GLX_ALPHA_SIZE\fP. -For color index visuals, \f3GLX_BUFFER_SIZE\fP is the size of the -color indexes. -.TP -\f3GLX_LEVEL\fP -Frame buffer level of the visual. -Level zero is the default frame buffer. -Positive levels correspond to frame buffers that overlay the default buffer, -and negative levels correspond to frame buffers that underlay the default -buffer. -.TP -\f3GLX_RGBA\fP -\f3True\fP if color buffers store red, green, blue, and alpha values. -\f3False\fP if they store color indexes. -.TP -\f3GLX_DOUBLEBUFFER\fP -\f3True\fP if color buffers exist in front/back pairs that can be swapped, -\f3False\fP otherwise. -.TP -\f3GLX_STEREO\fP -\f3True\fP if color buffers exist in left/right pairs, -\f3False\fP otherwise. -.TP -\f3GLX_AUX_BUFFERS\fP -Number of auxiliary color buffers that are available. -Zero indicates that no auxiliary color buffers exist. -.TP -\f3GLX_RED_SIZE\fP -Number of bits of red stored in each color buffer. -Undefined if \f3GLX_RGBA\fP is \f3False\fP. -.TP -\f3GLX_GREEN_SIZE\fP -Number of bits of green stored in each color buffer. -Undefined if \f3GLX_RGBA\fP is \f3False\fP. -.TP -\f3GLX_BLUE_SIZE\fP -Number of bits of blue stored in each color buffer. -Undefined if \f3GLX_RGBA\fP is \f3False\fP. -.TP -\f3GLX_ALPHA_SIZE\fP -Number of bits of alpha stored in each color buffer. -Undefined if \f3GLX_RGBA\fP is \f3False\fP. -.TP -\f3GLX_DEPTH_SIZE\fP -Number of bits in the depth buffer. -.TP -\f3GLX_STENCIL_SIZE\fP -Number of bits in the stencil buffer. -.TP -\f3GLX_ACCUM_RED_SIZE\fP -Number of bits of red stored in the accumulation buffer. -.TP -\f3GLX_ACCUM_GREEN_SIZE\fP -Number of bits of green stored in the accumulation buffer. -.TP -\f3GLX_ACCUM_BLUE_SIZE\fP -Number of bits of blue stored in the accumulation buffer. -.TP -\f3GLX_ACCUM_ALPHA_SIZE\fP -Number of bits of alpha stored in the accumulation buffer. -.TE -.P -The X protocol allows a single visual ID to be instantiated with -different numbers of bits per pixel. -Windows or GLX pixmaps that will be rendered with OpenGL, however, -must be instantiated with a color buffer depth of \f3GLX_BUFFER_SIZE\fP. -.P -Although a GLX implementation can export many visuals that support GL -rendering, -it must support -at least one RGBA visual. This visual must have at -least one color buffer, -a stencil buffer of at least 1 bit, -a depth buffer of at least 12 bits, -and an accumulation buffer. -Alpha bitplanes are optional in this visual. -However, -its color buffer size must be as great as that of the -deepest \f3TrueColor\fP, \f3DirectColor\fP, -\f3PseudoColor\fP, or \f3StaticColor\fP visual supported on level zero, -and it must itself be made available on level zero. -.P -In addition, if the X server exports a \f3PseudoColor\fP -or \f3StaticColor\fP visual on framebuffer level 0, a color index -visual is also required on that level. -It must have -at least one color buffer, -a stencil buffer of at least 1 bit, -and a depth buffer of at least 12 bits. -This visual must -have as many -color bitplanes as the deepest -\f3PseudoColor\fP or \f3StaticColor\fP visual supported on level 0. -.P -Applications are best written to select the visual that most closely -meets their requirements. -Creating windows or GLX pixmaps with unnecessary buffers can result in -reduced rendering performance as well as poor resource allocation. -.SH NOTES -\f3XVisualInfo\fP is defined in \f2Xutil.h.\fP -It is a structure that includes \f2visual\fP, \f2visualID\fP, \f2screen\fP, and -\f2depth\fP elements. -.SH ERRORS -\f3GLX_NO_EXTENSION\fP is returned if \f2dpy\fP does not support the GLX -extension. -.P -\f3GLX_BAD_SCREEN\fP is returned if the screen of \f2vis\fP does not correspond -to a screen. -.P -\f3GLX_BAD_ATTRIBUTE\fP is returned if \f2attrib\fP is not a valid GLX attribute. -.P -\f3GLX_BAD_VISUAL\fP is returned if \f2vis\fP doesn't support GLX and an -attribute other than \f3GLX_USE_GL\fP is requested. -.SH SEE ALSO -\f3glXChooseVisual\fP, -\f3glXCreateContext\fP - diff --git a/xc/doc/man/GL/glx/xgetcontextidext.3gl b/xc/doc/man/GL/glx/xgetcontextidext.3gl deleted file mode 100644 index da00b5688..000000000 --- a/xc/doc/man/GL/glx/xgetcontextidext.3gl +++ /dev/null @@ -1,47 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 25633 3 xgetcontextidext.gl -.TH GLXGETCONTEXTIDEXT -.SH NAME -.B "glXGetContextIDEXT -\- get the XID for a context. - -.SH C SPECIFICATION -GLXContextID \f3glXGetContextIDEXT\fP( -const GLXContext \fIctx\fP ) -.nf -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\f2ctx\fP\ \ 'u -\f2ctx\fP -Specifies a GLX rendering context. - -.SH DESCRIPTION -\f3glXGetContextIDEXT\fP returns the XID associated with a GLXContext. -.P -No round trip is forced to the server; unlike most X calls that -return a value, \f3glXGetContextIDEXT\fP does not flush any pending events. -.P -\f3glXGetContextIDEXT\fP is part of the \f3EXT_import_context\fP extension, -not part of the core GLX command set. If \f3GLX_EXT_import_context\fP -is included in the string returned by \f3glXQueryExtensionsString\fP, -when called with argument \f3GLX_EXTENSIONS\fP, -extension \f3EXT_import_context\fP is supported. - -.SH ERRORS -\f3GLXBadContext\fP is generated if \f2ctx\fP does not -refer to a valid context. - -.SH SEE ALSO -\f3glXCreateContext\fP, -\f3glXQueryVersion\fP, -\f3glXQueryExtensionsString\fP diff --git a/xc/doc/man/GL/glx/xgetcurrentcontext.3gl b/xc/doc/man/GL/glx/xgetcurrentcontext.3gl deleted file mode 100644 index 04e6a2c95..000000000 --- a/xc/doc/man/GL/glx/xgetcurrentcontext.3gl +++ /dev/null @@ -1,30 +0,0 @@ -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 49308 2 xgetcurrentcontext.gl -.TH GLXGETCURRENTCONTEXT -.SH NAME -.B "glXGetCurrentContext -\- return the current context - -.SH C SPECIFICATION -GLXContext \f3glXGetCurrentContext\fP( void ) -.nf -.fi - - -.SH DESCRIPTION -\f3glXGetCurrentContext\fP returns the current context, -as specified by \f3glXMakeCurrent\fP. -If there is no current context, -\f3NULL\fP is returned. - -\f3glXGetCurrentContext\fP returns client-side information. -It does not make a round trip to the server. - -.SH SEE ALSO -\f3glXCreateContext\fP, -\f3glXMakeCurrent\fP diff --git a/xc/doc/man/GL/glx/xgetcurrentdisplay.3gl b/xc/doc/man/GL/glx/xgetcurrentdisplay.3gl deleted file mode 100644 index 60ee242bd..000000000 --- a/xc/doc/man/GL/glx/xgetcurrentdisplay.3gl +++ /dev/null @@ -1,33 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 59497 2 xgetcurrentdisplay.gl -.TH GLXGETCURRENTDISPLAY -.SH NAME -.B "glXGetCurrentDisplay -\- get display for current context - -.SH C SPECIFICATION -Display * \f3glXGetCurrentDisplay\fP( void ) -.nf -.fi - -.EQ -delim $$ -.EN -.SH DESCRIPTION -\f3glXGetCurrentDisplay\fP returns the display for the current context. If no -context is current, NULL is returned. -.P -\f3glXGetCurrentDisplay\fP returns client-side information. It does not make a round trip -to the server, and therefore does not flush any pending events. -.SH NOTES -\f3glXGetCurrentDisplay\fP is only supported if the GLX version is 1.2 or greater. -.SH SEE ALSO -\f3glXQueryVersion\fP, -\f3glXQueryExtensionsString\fP - diff --git a/xc/doc/man/GL/glx/xgetcurrentdrawable.3gl b/xc/doc/man/GL/glx/xgetcurrentdrawable.3gl deleted file mode 100644 index 4b8883c3f..000000000 --- a/xc/doc/man/GL/glx/xgetcurrentdrawable.3gl +++ /dev/null @@ -1,28 +0,0 @@ -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 49921 2 xgetcurrentdrawable.gl -.TH GLXGETCURRENTDRAWABLE -.SH NAME -.B "glXGetCurrentDrawable -\- return the current drawable - -.SH C SPECIFICATION -GLXDrawable \f3glXGetCurrentDrawable\fP( void ) -.nf -.fi - -.SH DESCRIPTION -\f3glXGetCurrentDrawable\fP returns the current drawable, -as specified by \f3glXMakeCurrent\fP. -If there is no current drawable, -\f3None\fP is returned. -.P -\f3glXGetCurrentDrawable\fP returns client-side information. -It does not make a round trip to the server. -.SH SEE ALSO -\f3glXCreateGLXPixmap\fP, -\f3glXMakeCurrent\fP diff --git a/xc/doc/man/GL/glx/ximportcontextext.3gl b/xc/doc/man/GL/glx/ximportcontextext.3gl deleted file mode 100644 index 0cece66b2..000000000 --- a/xc/doc/man/GL/glx/ximportcontextext.3gl +++ /dev/null @@ -1,71 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 38402 4 ximportcontextext.gl -.TH GLXIMPORTCONTEXTEXT -.SH NAME -.B "glXImportContextEXT -\- import another process's indirect rendering context. - -.SH C SPECIFICATION -GLXContext \f3glXImportContextEXT\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3GLXContext \fPglXImportContextEXT( 'u - GLXContextID \fIcontextID\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fIcontextID\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. - -.TP -\f2contextID\fP -Specifies a GLX rendering context. - -.SH DESCRIPTION -\f3glXImportContextEXT\fP creates a GLXContext given the XID of an existing GLXContext. -It may be used in place of \f3glXCreateContext\fP, -to share another process's indirect rendering context. -.P -Only the server-side context information can be shared between -X clients; client-side state, such as pixel storage modes, -cannot be shared. Thus, \f3glXImportContextEXT\fP must allocate memory to store -client-side information. This memory is freed by calling -\f3glXFreeContextEXT\fP. -.P -This call does not create a new XID. It merely makes an -existing object available to the importing client (Display *). -Like any XID, it goes away when the creating client drops its -connection or the ID is explicitly deleted. Note that this is -when the XID goes away. The object goes away when the XID -goes away AND the context is not current to any thread. -.P -If \f2contextID\fP refers to a -direct rendering context then no error is generated but -\f3glXImportContextEXT\fP returns NULL. -.P -\f3glXImportContextEXT\fP is part of the \f3EXT_import_context\fP extension, -not part of the core GLX command set. If \f3GLX_EXT_import_context\fP -is included in the string returned by \f3glXQueryExtensionsString\fP, -when called with argument \f3GLX_EXTENSIONS\fP, -extension \f3EXT_import_context\fP is supported. - -.SH ERRORS -\f3GLXBadContext\fP is generated if \f2contextID\fP does not -refer to a valid context. - -.SH SEE ALSO -\f3glXCreateContext\fP, -\f3glXQueryVersion\fP, -\f3glXQueryExtensionsString\fP, -\f3glXGetContextIDEXT\fP, -\f3glXFreeContextEXT\fP diff --git a/xc/doc/man/GL/glx/xintro.3gl b/xc/doc/man/GL/glx/xintro.3gl deleted file mode 100644 index 218cdd3fe..000000000 --- a/xc/doc/man/GL/glx/xintro.3gl +++ /dev/null @@ -1,238 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 32008 15 xintro.gl -.TH GLXINTRO -.SH NAME -.B "glXIntro -\- Introduction to OpenGL in the X window system - -.SH OVERVIEW -OpenGL (called GL in other pages) is a high-performance 3D-oriented renderer. -It is available in the X window system through the GLX extension. -To determine whether the GLX extension is supported by an X server, -and if so, what version is supported, call \f3glXQueryExtension\fP -and \f3glXQueryVersion\fP. -.P -GLX extended servers make a subset of their visuals available -for OpenGL rendering. -Drawables created with these visuals can also be rendered using -the core X renderer -and with the renderer of any other X extension that is compatible -with all core X visuals. -.P -GLX extends drawables with several buffers other than -the standard color buffer. -These buffers include back and auxiliary color buffers, -a depth buffer, -a stencil buffer, -and a color accumulation buffer. -Some or all are included in each X visual that supports OpenGL. -.P -To render using OpenGL into an X drawable, -you must first choose a visual that defines the required OpenGL buffers. -\f3glXChooseVisual\fP can be used to simplify selecting a compatible visual. -If more control of the selection process is required, -use \f3XGetVisualInfo\fP and \f3glXGetConfig\fP to select among -all the available visuals. -.P -Use the selected visual to create both a GLX context and an X -drawable. -GLX contexts are created with \f3glXCreateContext\fP, -and drawables are created with either \f3XCreateWindow\fP or -\f3glXCreateGLXPixmap\fP. -Finally, -bind the context and the drawable together using \f3glXMakeCurrent\fP. -This context/drawable pair becomes the current context and current -drawable, -and it is used by all OpenGL commands until \f3glXMakeCurrent\fP is -called with different arguments. -.P -Both core X and OpenGL commands can be used to operate on the -current drawable. -The X and OpenGL command streams are not synchronized, -however, -except at explicitly created boundaries generated by calling -\f3glXWaitGL\fP, \f3glXWaitX\fP, \f3XSync\fP, and \f3glFlush\fP. -.SH EXAMPLES -Below is the minimum code required to create an RGBA-format, -X window that's compatible with OpenGL and to clear it to yellow. -The code is correct, -but it does not include any error checking. -Return values \f2dpy\fP, -\f2vi\fP, -\f2cx\fP, -\f2cmap\fP, and -\f2win\fP should all be tested. -.P -.Ex -#include <GL/glx.h> -#include <GL/gl.h> -#include <unistd.h> - -static int attributeListSgl[] = { - GLX_RGBA, - GLX_RED_SIZE, 1, /*get the deepest buffer with 1 red bit*/ - GLX_GREEN_SIZE, 1, - GLX_BLUE_SIZE, 1, - None }; - -static int attributeListDbl[] = { - GLX_RGBA, - GLX_DOUBLE_BUFFER, /*In case single buffering is not supported*/ - GLX_RED_SIZE, 1, - GLX_GREEN_SIZE, 1, - GLX_BLUE_SIZE, 1, - None }; - - -static Bool WaitForNotify(Display *d, XEvent *e, char *arg) { - return (e->type == MapNotify) && (e->xmap.window == (Window)arg); -} - -int main(int argc, char **argv) { - Display *dpy; - XVisualInfo *vi; - Colormap cmap; - XSetWindowAttributes swa; - Window win; - GLXContext cx; - XEvent event; - int swap_flag = FALSE; - - - /* get a connection */ - dpy = XOpenDisplay(0); - - /* get an appropriate visual */ - vi = glXChooseVisual(dpy, DefaultScreen(dpy), attributeListSgl); - if (vi == NULL) { - vi = glXChooseVisual(dpy, DefaultScreen(dpy), attributeListDbl); - swap_flag = TRUE; - } - - /* create a GLX context */ - cx = glXCreateContext(dpy, vi, 0, GL_TRUE); - - /* create a color map */ - cmap = XCreateColormap(dpy, RootWindow(dpy, vi->screen), - vi->visual, AllocNone); - - /* create a window */ - swa.colormap = cmap; - swa.border_pixel = 0; - swa.event_mask = StructureNotifyMask; - win = XCreateWindow(dpy, RootWindow(dpy, vi->screen), 0, 0, 100, 100, - 0, vi->depth, InputOutput, vi->visual, - CWBorderPixel|CWColormap|CWEventMask, &swa); - XMapWindow(dpy, win); - XIfEvent(dpy, &event, WaitForNotify, (char*)win); - - /* connect the context to the window */ - glXMakeCurrent(dpy, win, cx); - - /* clear the buffer */ - glClearColor(1,1,0,1); - glClear(GL_COLOR_BUFFER_BIT); - glFlush(); - if (swap_flag) glXSwapBuffers(dpy,win); - - /* wait a while */ - sleep(10); -} -.Ee -.SH NOTES -A color map must be created and passed to \f3XCreateWindow\fP. -See the preceding example code. -.P -A GLX context must be created and attached to an X drawable before -OpenGL commands can be executed. -OpenGL commands issued while no context/drawable pair is current -result in undefined behavior. -.P -Exposure events indicate that \f2all\fP buffers associated with the -specified window may be damaged and should be repainted. -Although certain buffers of some visuals on some systems -may never require repainting -(the depth buffer, for example), -it is incorrect to write a program assuming that these buffers will -not be damaged. -.P -GLX commands manipulate XVisualInfo structures rather than pointers to -visuals or visual IDs. -XVisualInfo structures contain \f2visual\fP, -\f2visualID\fP, -\f2screen\fP, and -\f2depth\fP elements, -as well as other X-specific information. -.SH USING GLX EXTENSIONS -All supported GLX extensions will have a corresponding definition in glx.h -and a token in the extension string returned by \f3glXQueryExtensionsString\fP. -For example, if the \f3EXT_visual_info\fP extension is supported, -then this token will be defined in glx.h and \f3EXT_visual_info\fP -will appear in the extension -string returned by \f3glXQueryExtensionsString\fP. The definitions in glx.h -can be used at compile time to determine if procedure calls corresponding -to an extension exist in the library. -.P -OpenGL itself has also been extended. Refer to \f3glIntro\fP for more -information. -.P -.SH GLX 1.1 and GLX 1.2 -GLX 1.2 is now supported. It is backward compatible with GLX 1.1 and -GLX 1.0. -.P -GLX 1.2 corresponds to OpenGL version 1.1 and introduces the following -new call: \f3glGetCurrentDisplay\fP. -.P -GLX 1.1 corresponds to OpenGL version 1.0 and introduces the -following new calls: -\f3glXQueryExtensionsString\fP, \f3glXQueryServerString\fP, and -\f3glXGetClientString\fP. -.P -Call \f3glQueryVersion\fP -to determine at runtime what version of GLX is available. \f3glQueryVersion\fP -returns the version that is supported on the connection. Thus -if 1.2 is returned, both the client and server support GLX 1.2. -You can also check the GLX version at compile time: GLX_VERSION_1_1 -will be defined in glx.h if GLX 1.1 calls are supported and -GLX_VERSION_1_2 will be defined if GLX 1.2 calls are supported. -.SH SEE ALSO -\f3glIntro\fP, -\f3glFinish\fP, -\f3glFlush\fP, -\f3glXChooseVisual\fP, -\f3glXCopyContext\fP, -.br -\f3glXCreateContext\fP, -\f3glXCreateGLXPixmap\fP, -\f3glXDestroyContext\fP, -.br -\f3glXGetClientString\fP, -\f3glXGetConfig\fP, -\f3glXIsDirect\fP, -\f3glXMakeCurrent\fP, -.br -\f3glXQueryExtension\fP, -\f3glXQueryExtensionsString\fP, -\f3glXQueryServerString\fP, -\f3glXQueryVersion\fP, -\f3glXSwapBuffers\fP, -\f3glXUseXFont\fP, -\f3glXWaitGL\fP, -\f3glXWaitX\fP, -\f3XCreateColormap\fP, -\f3XCreateWindow\fP, -\f3XSync\fP - - - - - - - - diff --git a/xc/doc/man/GL/glx/xisdirect.3gl b/xc/doc/man/GL/glx/xisdirect.3gl deleted file mode 100644 index ed423807b..000000000 --- a/xc/doc/man/GL/glx/xisdirect.3gl +++ /dev/null @@ -1,42 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 12384 2 xisdirect.gl -.TH GLXISDIRECT -.SH NAME -.B "glXIsDirect -\- indicate whether direct rendering is enabled - -.SH C SPECIFICATION -Bool \f3glXIsDirect\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3Bool \fPglXIsDirect( 'u - GLXContext \fIctx\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\f2dpy\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2ctx\fP -Specifies the GLX context that is being queried. -.SH DESCRIPTION -\f3glXIsDirect\fP returns \f3True\fP if \f2ctx\fP is a direct rendering context, -\f3False\fP otherwise. -Direct rendering contexts pass rendering commands directly from the calling -process's address space to the rendering system, -bypassing the X server. -Nondirect rendering contexts pass all rendering commands to the X server. -.SH ERRORS -\f3GLXBadContext\fP is generated if \f2ctx\fP is not a valid GLX context. -.SH SEE ALSO -\f3glXCreateContext\fP diff --git a/xc/doc/man/GL/glx/xmakecurrent.3gl b/xc/doc/man/GL/glx/xmakecurrent.3gl deleted file mode 100644 index 91c39157a..000000000 --- a/xc/doc/man/GL/glx/xmakecurrent.3gl +++ /dev/null @@ -1,107 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 28564 7 xmakecurrent.gl -.TH GLXMAKECURRENT -.SH NAME -.B "glXMakeCurrent -\- attach a GLX context to a window or a GLX pixmap - -.SH C SPECIFICATION -Bool \f3glXMakeCurrent\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3Bool \fPglXMakeCurrent( 'u - GLXDrawable \fIdrawable\fP, - GLXContext \fIctx\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fIdrawable\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2drawable\fP -Specifies a GLX drawable. -Must be either an X window ID or a GLX pixmap ID. -.TP -\f2ctx\fP -Specifies a GLX rendering context that is to be attached to \f2drawable\fP. -.SH DESCRIPTION -\f3glXMakeCurrent\fP does two things: -It makes \f2ctx\fP the current GLX rendering context of the calling thread, -replacing the previously current context if there was one, -and it attaches \f2ctx\fP to a GLX drawable, -either a window or a GLX pixmap. -As a result of these two actions, -subsequent GL rendering calls -use rendering context \f2ctx\fP to modify GLX drawable \f2drawable\fP. -Because \f3glXMakeCurrent\fP always replaces the current rendering context with \f2ctx\fP, -there can be only one current context per thread. -.P -Pending commands to the -previous context, if any, are flushed before it is released. -.P -The first time \f2ctx\fP is made current to any thread, -its viewport is set to the full size of \f2drawable\fP. -Subsequent calls by any thread to \f3glXMakeCurrent\fP with \f2ctx\fP -have no effect on its viewport. -.P -To release the current context without assigning a new one, -call \f3glXMakeCurrent\fP with \f2drawable\fP set \f3None\fP and \f2ctx\fP -set to \f3NULL\fP -.P -\f3glXMakeCurrent\fP returns \f3True\fP if it is successful, -\f3False\fP otherwise. -If \f3False\fP is returned, the previously current rendering context -and drawable (if any) remain unchanged. -.SH NOTES -A \f2process\fP is a single-execution environment, -implemented in a single address space, -consisting of one or more threads. -.P -A \f2thread\fP 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 \f2thread\fP that is the only member of its subprocess group -is equivalent to a \f2process\fP. -.SH ERRORS -\f3BadMatch\fP is generated if \f2drawable\fP was not -created with the same X screen and visual as \f2ctx\fP. -It is also generated if \f2drawable\fP is \f3None\fP and \f2ctx\fP is not -\f3NULL\fP. -.P -\f3BadAccess\fP is generated if \f2ctx\fP was current to another thread -at the time \f3glXMakeCurrent\fP was called. -.P -\f3GLXBadDrawable\fP is generated if \f2drawable\fP is not a valid GLX drawable. -.P -\f3GLXBadContext\fP is generated if \f2ctx\fP is not a valid GLX context. -.P -\f3GLXBadContextState\fP is generated if \f3glXMakeCurrent\fP is executed between -the execution of \f3glBegin\fP and the corresponding execution of \f3glEnd\fP. -.P -\f3GLXBadContextState\fP is also generated if the rendering context current -to the calling thread has GL renderer state \f3GL_FEEDBACK\fP or -\f3GL_SELECT\fP. -.P -\f3GLXBadCurrentWindow\fP is generated if there are pending GL -commands for the previous context and the current drawable is -a window that is no longer valid. -.P -\f3BadAlloc\fP may be generated if the server has delayed allocation -of ancillary buffers until \f3glXMakeCurrent\fP is called, only to find that it has -insufficient resources to complete the allocation. -.SH SEE ALSO -\f3glXCreateContext\fP, -\f3glXCreateGLXPixmap\fP - diff --git a/xc/doc/man/GL/glx/xquerycontextinfoext.3gl b/xc/doc/man/GL/glx/xquerycontextinfoext.3gl deleted file mode 100644 index 5250afa3d..000000000 --- a/xc/doc/man/GL/glx/xquerycontextinfoext.3gl +++ /dev/null @@ -1,67 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 51469 3 xquerycontextinfoext.gl -.TH GLXQUERYCONTEXTINFOEXT -.SH NAME -.B "glXQueryContextInfoEXT -\- query context information - -.SH C SPECIFICATION -int \f3glXQueryContextInfoEXT\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3int \fPglXQueryContextInfoEXT( 'u - GLXContext \fIctx\fP, - int \fIattribute\fP, - int \fI*value\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fIattribute\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. - -.TP -\f2ctx\fP -Specifies a GLX rendering context. - -.TP -\f2attribute\fP -The visual ID that the context was created with. - -.TP -\f2value\fP -The X screen the the context was created for. - -.TP -_param5 -The context with which this context shares display lists. -or \f3NULL\fP if this context does not share display lists. - -.SH DESCRIPTION -\f3glXQueryContextInfoEXT\fP returns the the visual id, screen number, and share list -of \f2ctx\fP. This call may cause a round trip to the server. -.P -\f3glXQueryContextInfoEXT\fP is part of the \f3EXT_import_context\fP extension, -not part of the core GLX command set. If \f3GLX_EXT_import_context\fP -is included in the string returned by \f3glXQueryExtensionsString\fP, -when called with argument \f3GLX_EXTENSIONS\fP, -extension \f3EXT_import_context\fP is supported. - -.SH ERRORS -\f3GLXBadContext\fP is generated if \f2ctx\fP does not -refer to a valid context. - -.SH SEE ALSO -\f3glXCreateContext\fP, -\f3glXQueryVersion\fP, -\f3glXQueryExtensionsString\fP - diff --git a/xc/doc/man/GL/glx/xqueryextension.3gl b/xc/doc/man/GL/glx/xqueryextension.3gl deleted file mode 100644 index d8e1d682e..000000000 --- a/xc/doc/man/GL/glx/xqueryextension.3gl +++ /dev/null @@ -1,52 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 25267 2 xqueryextension.gl -.TH GLXQUERYEXTENSION -.SH NAME -.B "glXQueryExtension -\- indicate whether the GLX extension is supported - -.SH C SPECIFICATION -Bool \f3glXQueryExtension\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3Bool \fPglXQueryExtension( 'u - int \fI*errorBase\fP, - int \fI*eventBase\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fIerrorBase\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2errorBase\fP -Returns the base error code of the GLX server extension. -.TP -\f2eventBase\fP -Returns the base event code of the GLX server extension. -.SH DESCRIPTION -\f3glXQueryExtension\fP returns \f3True\fP if the X server of -connection \f2dpy\fP supports the GLX extension, -\f3False\fP otherwise. -If \f3True\fP is returned, -then \f2errorBase\fP and \f2eventBase\fP return the error base and event base of -the GLX extension. -Otherwise, \f2errorBase\fP and \f2eventBase\fP are unchanged. -.P -\f2errorBase\fP and \f2eventBase\fP do not return values if they are specified -as \f3NULL\fP. -.SH NOTES -\f2eventBase\fP is included for future extensions. -GLX does not currently define any events. -.SH SEE ALSO -\f3glXQueryVersion\fP - diff --git a/xc/doc/man/GL/glx/xqueryextensionsstring.3gl b/xc/doc/man/GL/glx/xqueryextensionsstring.3gl deleted file mode 100644 index 63f3bb886..000000000 --- a/xc/doc/man/GL/glx/xqueryextensionsstring.3gl +++ /dev/null @@ -1,48 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 26309 3 xqueryextensionsstring.gl -.TH GLXQUERYEXTENSIONSSTRING -.SH NAME -.B "glXQueryExtensionsString -\- return list of supported extensions - -.SH C SPECIFICATION -const char * \f3glXQueryExtensionsString\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3const char * \fPglXQueryExtensionsString( 'u - int \fIscreen\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fIscreen\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2screen\fP -Specifies the screen. -.SH DESCRIPTION -\f3glXQueryExtensionsString\fP returns a pointer to a string describing -which GLX extensions are supported on the connection. The string -is null-terminated and contains a space-separated list of -extension names. (The extension names themselves never contain -spaces.) If there are no extensions to GLX, then the empty string is -returned. -.SH NOTES -\f3glXQueryExtensionsString\fP is available only if the GLX version is 1.1 or greater. -.P -\f3glXQueryExtensionsString\fP only returns information about GLX extensions. Call -\f3glGetString\fP to get a list of GL extensions. -.SH SEE ALSO -\f3glGetString\fP, -\f3glXQueryVersion\fP, -\f3glXQueryServerString\fP, -\f3glXGetClientString\fP diff --git a/xc/doc/man/GL/glx/xqueryserverstring.3gl b/xc/doc/man/GL/glx/xqueryserverstring.3gl deleted file mode 100644 index dcbde87ea..000000000 --- a/xc/doc/man/GL/glx/xqueryserverstring.3gl +++ /dev/null @@ -1,58 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 52600 3 xqueryserverstring.gl -.TH GLXQUERYSERVERSTRING -.SH NAME -.B "glXQueryServerString -\- return string describing the server - -.SH C SPECIFICATION -const char * \f3glXQueryServerString\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3const char * \fPglXQueryServerString( 'u - int \fIscreen\fP, - int \fIname\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fIscreen\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2screen\fP -Specifies the screen number. -.TP -\f2name\fP -Specifies which string is returned. -One of \f3GLX_VENDOR\fP, \f3GLX_VERSION\fP, or \f3GLX_EXTENSIONS\fP. -.SH DESCRIPTION -\f3glXQueryServerString\fP -returns a pointer to a static, null-terminated string -describing some aspect of the server's GLX extension. The possible values for -\f2name\fP and the format of the strings is the same as for -\f3glXGetClientString\fP. If \f2name\fP is not set to a recognized value, -\f3NULL\fP is returned. -.SH NOTES -\f3glXQueryServerString\fP is available only if the GLX version is 1.1 or greater. -.P -If the GLX version is 1.1 or 1.0, the GL version must be 1.0. -If the GLX version is 1.2, the GL version must be 1.1. -.P -\f3glXQueryServerString\fP only returns information about GLX extensions supported by the server. -Call \f3glGetString\fP to get a list of GL extensions. -Call \f3glXGetClientString\fP to get a list of GLX extensions supported by the -client. -.SH SEE ALSO -\f3glXQueryVersion\fP, -\f3glXGetClientString\fP, -\f3glXQueryExtensionsString\fP - diff --git a/xc/doc/man/GL/glx/xqueryversion.3gl b/xc/doc/man/GL/glx/xqueryversion.3gl deleted file mode 100644 index ba6f1e267..000000000 --- a/xc/doc/man/GL/glx/xqueryversion.3gl +++ /dev/null @@ -1,51 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 36423 3 xqueryversion.gl -.TH GLXQUERYVERSION -.SH NAME -.B "glXQueryVersion -\- return the version numbers of the GLX extension - -.SH C SPECIFICATION -Bool \f3glXQueryVersion\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3Bool \fPglXQueryVersion( 'u - int \fI*major\fP, - int \fI*minor\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fImajor\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2major\fP -Returns the major version number of the GLX server extension. -.TP -\f2minor\fP -Returns the minor version number of the GLX server extension. -.SH DESCRIPTION -\f3glXQueryVersion\fP returns the major and minor version numbers of the GLX extension -implemented by the server associated with connection \f2dpy\fP. -Implementations with the same major version number are upward compatible, -meaning that the implementation with the higher minor number is a superset -of the version with the lower minor number. -.P -\f2major\fP and \f2minor\fP do not return values if they are specified as -\f3NULL\fP. -.SH ERRORS -\f3glXQueryVersion\fP returns \f3False\fP if it fails, -\f3True\fP otherwise. -.P -\f2major\fP and \f2minor\fP are not updated when \f3False\fP is returned. -.SH SEE ALSO -\f3glXQueryExtension\fP diff --git a/xc/doc/man/GL/glx/xswapbuffers.3gl b/xc/doc/man/GL/glx/xswapbuffers.3gl deleted file mode 100644 index 951588708..000000000 --- a/xc/doc/man/GL/glx/xswapbuffers.3gl +++ /dev/null @@ -1,72 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:56 -.ds Dm Feb 10 17:2 -.ds Xs 58040 5 xswapbuffers.gl -.TH GLXSWAPBUFFERS -.SH NAME -.B "glXSwapBuffers -\- exchange front and back buffers - -.SH C SPECIFICATION -void \f3glXSwapBuffers\fP( -Display \fI*dpy\fP, -.nf -.ta \w'\f3void \fPglXSwapBuffers( 'u - GLXDrawable \fIdrawable\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fIdrawable\fP\ \ 'u -\f2dpy\fP -Specifies the connection to the X server. -.TP -\f2drawable\fP -Specifies the drawable whose buffers are to be swapped. -.SH DESCRIPTION -\f3glXSwapBuffers\fP promotes the contents of the back buffer of \f2drawable\fP to become -the contents of the front buffer of \f2drawable\fP. -The contents of the back buffer then become undefined. -The update typically takes place during the vertical retrace of -the monitor, -rather than immediately after \f3glXSwapBuffers\fP is called. -.P -\f3glXSwapBuffers\fP performs an implicit \f3glFlush\fP before it returns. -Subsequent OpenGL commands may be issued immediately after calling \f3glXSwapBuffers\fP, -but are not executed until the buffer exchange is completed. -.P -If \f2drawable\fP was not created with respect to a double-buffered visual, -\f3glXSwapBuffers\fP has no effect, -and no error is generated. -.SH NOTES -The contents of the back buffer become undefined after -a swap. Note that this applies to pbuffers as well as windows. -.P -All GLX rendering contexts share the same notion of which are front buffers -and which are back buffers. -One consequence is that when multiple clients are rendering to the same -double-buffered window, -all of them should finish rendering before one of them issues the command -to swap buffers. -The clients are responsible for implementing this synchronization. -Typically this is accomplished by executing \f3glFinish\fP and then -using a semaphore in shared memory to rendezvous before swapping. -.SH ERRORS -\f3GLXBadDrawable\fP is generated if \f2drawable\fP is not a valid GLX drawable. -.P -\f3GLXBadCurrentWindow\fP is generated if \f2dpy\fP and \f2drawable\fP are -respectively the display and drawable associated with the current -context of the calling thread, and \f2drawable\fP identifies a window that -is no longer valid. -.SH SEE ALSO -\f3glFlush\fP, -\f3glXBindSwapBarrierSGIX\fP, -\f3glXJoinSwapGroupSGIX\fP, -\f3glXSwapIntervalSGI\fP - diff --git a/xc/doc/man/GL/glx/xusexfont.3gl b/xc/doc/man/GL/glx/xusexfont.3gl deleted file mode 100644 index 4a854ed19..000000000 --- a/xc/doc/man/GL/glx/xusexfont.3gl +++ /dev/null @@ -1,76 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:57 -.ds Dm Feb 10 17:2 -.ds Xs 55673 5 xusexfont.gl -.TH GLXUSEXFONT -.SH NAME -.B "glXUseXFont -\- create bitmap display lists from an X font - -.SH C SPECIFICATION -void \f3glXUseXFont\fP( -Font \fIfont\fP, -.nf -.ta \w'\f3void \fPglXUseXFont( 'u - int \fIfirst\fP, - int \fIcount\fP, - int \fIlistBase\fP ) -.fi - -.EQ -delim $$ -.EN -.SH PARAMETERS -.TP \w'\fIlistBase\fP\ \ 'u -\f2font\fP -Specifies the font from which character glyphs are to be taken. -.TP -\f2first\fP -Specifies the index of the first glyph to be taken. -.TP -\f2count\fP -Specifies the number of glyphs to be taken. -.TP -\f2listBase\fP -Specifies the index of the first display list to be generated. -.SH DESCRIPTION -\f3glXUseXFont\fP generates \f2count\fP display lists, -named \f2listBase\fP through \f2listBase\fP\&+\&\f2count\fP\&\-\&1, -each containing a single \f3glBitmap\fP command. -The parameters of the \f3glBitmap\fP command of display list \f2listBase\fP\&+\f2i\fP -are derived from glyph \f2first\fP\&+\f2i\fP. -Bitmap parameters \f2xorig, yorig, width,\fP and \f2height\fP -are computed from font metrics as -\f2descent\-1, \-lbearing,\fP -\f2rbearing\-lbearing,\fP and \f2ascent+descent\fP, respectively. -\f2xmove\fP is taken from the glyph's \f2width\fP metric, -and \f2ymove\fP is set to zero. -Finally, -the glyph's image is converted to the appropriate format for \f3glBitmap\fP. -.P -Using \f3glXUseXFont\fP may be more efficient than accessing the X font and generating -the display lists explicitly, -both because the display lists are created on the server without requiring -a round trip of the glyph data, -and because the server may choose to delay the creation of each -bitmap until it is accessed. -.P -Empty display lists are created for all glyphs that are requested and -are not defined in \f2font\fP. -\f3glXUseXFont\fP is ignored if there is no current GLX context. -.SH ERRORS -\f3BadFont\fP is generated if \f2font\fP is not a valid font. -.P -\f3GLXBadContextState\fP is generated if the current GLX context is -in display-list construction mode. -.P -\f3GLXBadCurrentWindow\fP is generated if the drawable associated -with the current context of the calling thread is a window, and that -window is no longer valid. -.SH SEE ALSO -\f3glBitmap\fP, -\f3glXMakeCurrent\fP diff --git a/xc/doc/man/GL/glx/xwaitgl.3gl b/xc/doc/man/GL/glx/xwaitgl.3gl deleted file mode 100644 index 2d77e522b..000000000 --- a/xc/doc/man/GL/glx/xwaitgl.3gl +++ /dev/null @@ -1,42 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:57 -.ds Dm Feb 10 17:2 -.ds Xs 20224 2 xwaitgl.gl -.TH GLXWAITGL -.SH NAME -.B "glXWaitGL -\- complete GL execution prior to subsequent X calls - -.SH C SPECIFICATION -void \f3glXWaitGL\fP( void ) -.nf -.fi - -.EQ -delim $$ -.EN -.SH DESCRIPTION -GL rendering calls made prior to \f3glXWaitGL\fP are guaranteed to be -executed before X rendering calls made after \f3glXWaitGL\fP. -Although this same result can be achieved using \f3glFinish\fP, -\f3glXWaitGL\fP does not require a round trip to the server, -and it is therefore more efficient in cases where client and server -are on separate machines. -.P -\f3glXWaitGL\fP is ignored if there is no current GLX context. -.SH NOTES -\f3glXWaitGL\fP may or may not flush the X stream. -.SH ERRORS -\f3GLXBadCurrentWindow\fP is generated if the drawable associated -with the current context of the calling thread is a window, and that -window is no longer valid. -.SH SEE ALSO -\f3glFinish\fP, -\f3glFlush\fP, -\f3glXWaitX\fP, -\f3XSync\fP - diff --git a/xc/doc/man/GL/glx/xwaitx.3gl b/xc/doc/man/GL/glx/xwaitx.3gl deleted file mode 100644 index 44dc143b9..000000000 --- a/xc/doc/man/GL/glx/xwaitx.3gl +++ /dev/null @@ -1,42 +0,0 @@ -'\"! eqn | mmdoc -'\"macro stdmacro -.ds Vn Version 1.2 -.ds Dt 6 March 1997 -.ds Re Release 1.2.0 -.ds Dp Feb 16 02:57 -.ds Dm Feb 10 17:2 -.ds Xs 20029 2 xwaitx.gl -.TH GLXWAITX -.SH NAME -.B "glXWaitX -\- complete X execution prior to subsequent GL calls - -.SH C SPECIFICATION -void \f3glXWaitX\fP( void ) -.nf -.fi - -.EQ -delim $$ -.EN -.SH DESCRIPTION -X rendering calls made prior to \f3glXWaitX\fP are guaranteed to be -executed before GL rendering calls made after \f3glXWaitX\fP. -Although the same result can be achieved using \f3XSync\fP, -\f3glXWaitX\fP does not require a round trip to the server, -and it is therefore more efficient in cases where client and server -are on separate machines. -.P -\f3glXWaitX\fP is ignored if there is no current GLX context. -.SH NOTES -\f3glXWaitX\fP may or may not flush the GL stream. -.SH ERRORS -\f3GLXBadCurrentWindow\fP is generated if the drawable associated -with the current context of the calling thread is a window, and that -window is no longer valid. -.SH SEE ALSO -\f3glFinish\fP, -\f3glFlush\fP, -\f3glXWaitGL\fP, -\f3XSync\fP - |