glXQueryGLXPbufferSGIX(3G)  OpenGL Reference - GLX  glXQueryGLXPbufferSGIX(3G)

NAME    [Toc]    [Back]

     glXQueryGLXPbufferSGIX - returns information about	a GLX pixel buffer

C SPECIFICATION    [Toc]    [Back]

     int glXQueryGLXPbufferSGIX( Display *dpy,
				 GLXPbufferSGIX	pbuf,
				 int attribute,
				 unsigned int *value )

PARAMETERS    [Toc]    [Back]

     dpy	Specifies the connection to the	X server.

     pbuf	Specifies the GLX pixel	buffer to be queried.

     attribute	Specifies the attribute	to be returned.

     value	Returns	the requested value.

DESCRIPTION    [Toc]    [Back]

     glXQueryGLXPbufferSGIX sets value to the attribute	value for pbuf.	 It
     returns an	error code if it fails for any reason.	Otherwise, zero	is
     returned.

     attribute is one of the following:

     GLX_WIDTH_SGIX	   Width of pbuf.

     GLX_HEIGHT_SGIX	   Height of pbuf.

     GLX_PRESERVED_CONTENTS_SGIX    [Toc]    [Back]
			   True	if the contents	of pbuf	are preserved when a
			   resource conflict occurs; False otherwise.

     GLX_LARGEST_PBUFFER_SGIX    [Toc]    [Back]
			   Set when the	GLX pixel buffer is created by calling
			   glXCreateGLXPbufferSGIX.  When False,
			   glXCreateGLXPbufferSGIX fails if it cannot allocate
			   a GLX pixel buffer of size width by height.	When
			   True, a pixel buffer	with the largest width and
			   height possible (but	not larger than	the values
			   specified) is created when the allocation of	the
			   buffer would	otherwise fail.

     GLX_DIGITAL_MEDIA_PBUFFER_SGIX    [Toc]    [Back]
			   True	if pbuf	can be associated with a compatible
			   DMbuffer; False otherwise.






									Page 1






glXQueryGLXPbufferSGIX(3G)  OpenGL Reference - GLX  glXQueryGLXPbufferSGIX(3G)



     GLX_FBCONFIG_ID_SGIX  XID for pbuf.

NOTES    [Toc]    [Back]

     glXQueryGLXPbufferSGIX is part of the SGIX_pbuffer	extension.

ERRORS    [Toc]    [Back]

     A GLXBadPbufferSGIX is generated if pbuf is not a valid GLX pixel buffer.

     GLX_BAD_ATTRIB is returned	if attribute is	not a valid GLX	attribute.



MACHINE	DEPENDENCIES
     The SGIX_pbuffer extension	is supported only on RealityEngine,
     RealityEngine2, and VTX systems, on InfiniteReality systems, on High
     Impact and	Maximum	Impact systems,	and on O2 systems.

     The SGIX_dm_pbuffer extension is currently	supported only on O2 systems.

     On	O2 systems the GLX_LARGEST_PBUFFER_SGIX	attribute may incorrectly
     limit the size of the pbuffer created when	the requested dimensions are
     larger than the screen.  It is possible to	allocate pbuffers up to	2048
     square with the attribute set to False.

SEE ALSO    [Toc]    [Back]

     glXCreateGLXPbufferSGIX, glXGetFBConfigAttribSGIX,	glXChooseFBConfigSGIX


									PPPPaaaaggggeeee 2222