Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

glxcreatepbuffer(3g) [centos man page]

GLXCREATEPBUFFER(3G)						   OpenGL Manual					      GLXCREATEPBUFFER(3G)

NAME

       glXCreatePbuffer - create an off-screen rendering area

C SPECIFICATION

       GLXPbuffer glXCreatePbuffer(Display * dpy, GLXFBConfig config, const int * attrib_list);

PARAMETERS

       dpy
	   Specifies the connection to the X server.

       config
	   Specifies a GLXFBConfig structure with the desired attributes for the window.

       attrib_list
	   Specifies a list of attribute value pairs, which must be terminated with None or NULL. Accepted attributes are GLX_PBUFFER_WIDTH,
	   GLX_PBUFFER_HEIGHT, GLX_PRESERVED_CONTENTS, and GLX_LARGEST_PBUFFER.

DESCRIPTION

       glXCreatePbuffer creates an off-screen rendering area and returns its XID. Any GLX rendering context that was created with respect to
       config can be used to render into this window. Use glXMakeContextCurrent() to associate the rendering area with a GLX rendering context.

       The accepted attributes for a GLXPbuffer are:

       GLX_PBUFFER_WIDTH
	   Specify the pixel width of the requested GLXPbuffer. The default value is 0.

       GLX_PBUFFER_HEIGHT
	   Specify the pixel height of the requested GLXPbuffer. The default value is 0.

       GLX_LARGEST_PBUFFER
	   Specify to obtain the largest available pixel buffer, if the requested allocation would have failed. The width and height of the
	   allocated pixel buffer will never exceed the specified GLX_PBUFFER_WIDTH or GLX_PBUFFER_HEIGHT, respectively. Use glXQueryDrawable() to
	   retrieve the dimensions of the allocated pixel buffer. The default value is False.

       GLX_PRESERVED_CONTENTS
	   Specify if the contents of the pixel buffer should be preserved when a resource conflict occurs. If set to False, the contents of the
	   pixel buffer may be lost at any time. If set to True, or not specified in attrib_list, then the contents of the pixel buffer will be
	   preserved (most likely by copying the contents into main system memory from the frame buffer). In either case, the client can register
	   (using glXSelectEvent(), to receive pixel buffer clobber events that are generated when the pbuffer contents have been preserved or
	   damaged.

       GLXPbuffers contain the color and ancillary buffers specified by config. It is possible to create a pixel buffer with back buffers and to
       swap those buffers using glXSwapBuffers().

NOTES

       glXCreatePbuffer 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.

       GLXPbuffers are allocated from frame buffer resources; applications should consider deallocating them when they are not in use.

ERRORS

       BadAlloc is generated if there are insufficient resources to allocate the requested GLXPbuffer.

       GLXBadFBConfig is generated if config is not a valid GLXFBConfig.

       BadMatch is generated if config does not support rendering to pixel buffers (e.g., GLX_DRAWABLE_TYPE does not contain GLX_PBUFFER_BIT).

SEE ALSO

       glXChooseFBConfig(), glXCreatePbuffer, glXMakeContextCurrent(), glXSelectEvent()

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						      GLXCREATEPBUFFER(3G)

Check Out this Related Man Page

GLXSWAPBUFFERS(3G)						   OpenGL Manual						GLXSWAPBUFFERS(3G)

NAME

       glXSwapBuffers - exchange front and back buffers

C SPECIFICATION

       void glXSwapBuffers(Display * dpy, GLXDrawable drawable);

PARAMETERS

       dpy
	   Specifies the connection to the X server.

       drawable
	   Specifies the drawable whose buffers are to be swapped.

DESCRIPTION

       glXSwapBuffers promotes the contents of the back buffer of drawable to become the contents of the front buffer of drawable. 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 glXSwapBuffers is called.

       glXSwapBuffers performs an implicit glFlush() before it returns. Subsequent OpenGL commands may be issued immediately after calling
       glXSwapBuffers, but are not executed until the buffer exchange is completed.

       If drawable was not created with respect to a double-buffered visual, glXSwapBuffers has no effect, and no error is generated.

NOTES

       The contents of the back buffer become undefined after a swap. Note that this applies to pixel buffers as well as windows.

       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
       glFinish() and then using a semaphore in shared memory to rendezvous before swapping.

ERRORS

       GLXBadDrawable is generated if drawable is not a valid GLX drawable.

       GLXBadCurrentWindow is generated if dpy and drawable are respectively the display and drawable associated with the current context of the
       calling thread, and drawable identifies a window that is no longer valid.

SEE ALSO

       glFlush()

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							GLXSWAPBUFFERS(3G)
Man Page