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

GLXGETFBCONFIGATTRIB(3G)					   OpenGL Manual					  GLXGETFBCONFIGATTRIB(3G)

NAME
glXGetFBConfigAttrib - return information about a GLX frame buffer configuration C SPECIFICATION
int glXGetFBConfigAttrib(Display * dpy, GLXFBConfig config, int attribute, int * value); PARAMETERS
dpy Specifies the connection to the X server. config Specifies the GLX frame buffer configuration to be queried. attribute Specifies the attribute to be returned. value Returns the requested value. DESCRIPTION
glXGetFBConfigAttrib sets value to the attribute value of GLX drawables created with respect to config. glXGetFBConfigAttrib returns an error code if it fails for any reason. Otherwise, Success is returned. attribute is one of the following: GLX_FBCONFIG_ID XID of the given GLXFBConfig. GLX_BUFFER_SIZE Number of bits per color buffer. If the frame buffer configuration supports RGBA contexts, then GLX_BUFFER_SIZE is the sum of GLX_RED_SIZE, GLX_GREEN_SIZE, GLX_BLUE_SIZE, and GLX_ALPHA_SIZE. If the frame buffer configuration supports only color index contexts, GLX_BUFFER_SIZE is the size of the color indexes. GLX_LEVEL Frame buffer level of the configuration. 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 underlie the default buffer. GLX_DOUBLEBUFFER True if color buffers exist in front/back pairs that can be swapped, False otherwise. GLX_STEREO True if color buffers exist in left/right pairs, False otherwise. GLX_AUX_BUFFERS Number of auxiliary color buffers that are available. Zero indicates that no auxiliary color buffers exist. GLX_RED_SIZE Number of bits of red stored in each color buffer. Undefined if RGBA contexts are not supported by the frame buffer configuration. GLX_GREEN_SIZE Number of bits of green stored in each color buffer. Undefined if RGBA contexts are not supported by the frame buffer configuration. GLX_BLUE_SIZE Number of bits of blue stored in each color buffer. Undefined if RGBA contexts are not supported by the frame buffer configuration. GLX_ALPHA_SIZE Number of bits of alpha stored in each color buffer. Undefined if RGBA contexts are not supported by the frame buffer configuration. GLX_DEPTH_SIZE Number of bits in the depth buffer. GLX_STENCIL_SIZE Number of bits in the stencil buffer. GLX_ACCUM_RED_SIZE Number of bits of red stored in the accumulation buffer. GLX_ACCUM_GREEN_SIZE Number of bits of green stored in the accumulation buffer. GLX_ACCUM_BLUE_SIZE Number of bits of blue stored in the accumulation buffer. GLX_ACCUM_ALPHA_SIZE Number of bits of alpha stored in the accumulation buffer. GLX_RENDER_TYPE Mask indicating what type of GLX contexts can be made current to the frame buffer configuration. Valid bits are GLX_RGBA_BIT and GLX_COLOR_INDEX_BIT. GLX_DRAWABLE_TYPE Mask indicating what drawable types the frame buffer configuration supports. Valid bits are GLX_WINDOW_BIT, GLX_PIXMAP_BIT, and GLX_PBUFFER_BIT. GLX_X_RENDERABLE True if drawables created with the frame buffer configuration can be rendered to by X. GLX_VISUAL_ID XID of the corresponding visual, or zero if there is no associated visual (i.e., if GLX_X_RENDERABLE is False or GLX_DRAWABLE_TYPE does not have the GLX_WINDOW_BIT bit set). GLX_X_VISUAL_TYPE Visual type of associated visual. The returned value will be one of: GLX_TRUE_COLOR, GLX_DIRECT_COLOR, GLX_PSEUDO_COLOR, GLX_STATIC_COLOR, GLX_GRAY_SCALE, GLX_STATIC_GRAY, or GLX_NONE, if there is no associated visual (i.e., if GLX_X_RENDERABLE is False or GLX_DRAWABLE_TYPE does not have the GLX_WINDOW_BIT bit set). GLX_CONFIG_CAVEAT One of GLX_NONE, GLX_SLOW_CONFIG, or GLX_NON_CONFORMANT_CONFIG, indicating that the frame buffer configuration has no caveats, some aspect of the frame buffer configuration runs slower than other frame buffer configurations, or some aspect of the frame buffer configuration is nonconformant, respectively. GLX_TRANSPARENT_TYPE One of GLX_NONE, GLX_TRANSPARENT_RGB, GLX_TRANSPARENT_INDEX, indicating that the frame buffer configuration is opaque, is transparent for particular values of red, green, and blue, or is transparent for particular index values, respectively. GLX_TRANSPARENT_INDEX_VALUE Integer value between 0 and the maximum frame buffer value for indices, indicating the transparent index value for the frame buffer configuration. Undefined if GLX_TRANSPARENT_TYPE is not GLX_TRANSPARENT_INDEX. GLX_TRANSPARENT_RED_VALUE Integer value between 0 and the maximum frame buffer value for red, indicating the transparent red value for the frame buffer configuration. Undefined if GLX_TRANSPARENT_TYPE is not GLX_TRANSPARENT_RGB. GLX_TRANSPARENT_GREEN_VALUE Integer value between 0 and the maximum frame buffer value for green, indicating the transparent green value for the frame buffer configuration. Undefined if GLX_TRANSPARENT_TYPE is not GLX_TRANSPARENT_RGB. GLX_TRANSPARENT_BLUE_VALUE Integer value between 0 and the maximum frame buffer value for blue, indicating the transparent blue value for the frame buffer configuration. Undefined if GLX_TRANSPARENT_TYPE is not GLX_TRANSPARENT_RGB. GLX_TRANSPARENT_ALPHA_VALUE Integer value between 0 and the maximum frame buffer value for alpha, indicating the transparent blue value for the frame buffer configuration. Undefined if GLX_TRANSPARENT_TYPE is not GLX_TRANSPARENT_RGB. GLX_MAX_PBUFFER_WIDTH The maximum width that can be specified to glXCreatePbuffer(). GLX_MAX_PBUFFER_HEIGHT The maximum height that can be specified to glXCreatePbuffer(). GLX_MAX_PBUFFER_PIXELS The maximum number of pixels (width times height) for a pixel buffer. Note that this value may be less than GLX_MAX_PBUFFER_WIDTH times GLX_MAX_PBUFFER_HEIGHT. Also, this value is static and assumes that no other pixel buffers or X resources are contending for the frame buffer memory. As a result, it may not be possible to allocate a pixel buffer of the size given by GLX_MAX_PBUFFER_PIXELS. Applications should choose the frame buffer configuration that most closely meets their requirements. Creating windows, GLX pixmaps, or GLX pixel buffers with unnecessary buffers can result in reduced rendering performance as well as poor resource allocation. NOTES
glXGetFBConfigAttrib 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
GLX_NO_EXTENSION is returned if dpy does not support the GLX extension. GLX_BAD_ATTRIBUTE is returned if attribute is not a valid GLX attribute. SEE ALSO
glXGetFBConfigs(), glXChooseFBConfig(), glXGetVisualFromFBConfig(), glXGetConfig() 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 GLXGETFBCONFIGATTRIB(3G)
Man Page

Featured Tech Videos