pbuffer info
authorBrian Paul <brian.paul@tungstengraphics.com>
Tue, 2 Sep 2003 16:58:14 +0000 (16:58 +0000)
committerBrian Paul <brian.paul@tungstengraphics.com>
Tue, 2 Sep 2003 16:58:14 +0000 (16:58 +0000)
docs/contents.html
docs/pbuffers.html [new file with mode: 0644]

index acd30a57f839da64a84b1248f26167ba902db526..20fd949f8444105652a766119469b5900c19bc23 100644 (file)
@@ -37,6 +37,7 @@
 <ul>
 <LI><A HREF="envvars.html" target="MainFrame">Environment Variables</A>
 <LI><A HREF="osmesa.html" target="MainFrame">Off-Screen Rendering</A>
+<LI><A HREF="pbuffers.html" target="MainFrame">Pbuffer Rendering</A>
 <LI><A HREF="debugging.html" target="MainFrame">Debugging Tips</A>
 <LI><A HREF="perf.html" target="MainFrame">Performance Tips</A>
 <LI><A HREF="extensions.html" target="MainFrame">Mesa Extensions</A>
diff --git a/docs/pbuffers.html b/docs/pbuffers.html
new file mode 100644 (file)
index 0000000..74af478
--- /dev/null
@@ -0,0 +1,51 @@
+<HTML>
+
+<TITLE>PBuffer Rendering</TITLE>
+
+<BODY text="#000000" bgcolor="#55bbff" link="#111188">
+
+<H1>PBuffer Rendering</H1>
+
+<p>
+Basically, FBconfigs and PBuffers allow you to do off-screen rendering
+with OpenGL.  The OSMesa interface does basically the same thing, but
+fbconfigs and pbuffers are supported by more vendors.
+</p>
+
+<p>
+PBuffers are getting more use nowadays, though they've actually been
+around for a long time on IRIX systems and other workstations.
+</p>
+
+<p>
+The
+<a href="http://oss.sgi.com/projects/ogl-sample/registry/SGIX/fbconfig.txt"
+target="_parent">GL_SGIX_fbconfig</a>
+and
+<a href="http://oss.sgi.com/projects/ogl-sample/registry/SGIX/pbuffer.txt"
+target="_parent">
+GL_SGIX_pbuffer</a> extensions describe the functionality.
+More recently, these extensions have been promoted to ARB extensions (on
+Windows at least).
+</p>
+
+<p>
+The Mesa/progs/xdemos/ directory has some useful code for working
+with pbuffers:
+</p>
+
+<ul>
+<li><b>pbinfo.c</b> - like glxinfo, it prints a list of available
+    fbconfigs and whether each supports pbuffers.
+<li><b>pbutil.c</b> - a few utility functions for dealing with
+    fbconfigs and pbuffers.
+<li><b>pbdemo.c</b> - a demonstration of off-screen rendering with pbuffers.
+</ul>
+
+<p>
+Mesa 4.1 and later support GL_SGIX_fbconfig and GL_SGIX_pbuffer (software
+rendering only).
+</p>
+
+</BODY>
+</HTML>