added wglinfo

git-svn-id: https://glew.svn.sourceforge.net/svnroot/glew/trunk/glew@37 783a27ee-832a-0410-bc00-9f386506c6dd
This commit is contained in:
ikits 2003-02-03 19:34:45 +00:00
parent 0019d9535e
commit f58e3b1c33
2 changed files with 112 additions and 5 deletions

View File

@ -31,6 +31,7 @@ GLEW: The OpenGL Extension Wrangler Library
<tr><td align=center><a href="#Build"><font size="-1">How to Build Your Project with GLEW</font></a></td></tr>
<tr><td align=center><a href="#Install"><font size="-1">How to Install GLEW</font></a></td></tr>
<tr><td align=center><a href="#Use"><font size="-1">How to Use GLEW</font></a></td></tr>
<tr><td align=center><a href="#Utilities"><font size="-1">Utilities</font></a></td></tr>
<tr><td align=center><a href="#Issues"><font size="-1">Known Issues</font></a></td></tr>
<tr><td align=center><a href="#Credits"><font size="-1">Credits, Copyright</font></a></td></tr>
</table>
@ -332,14 +333,39 @@ else
}
</pre></blockquote>
<tr>
<td bgcolor="#FFF0D0" align="center"><a
name="Utilities"><font size="+1"><b>Utilities</b></font></a>
</td>
</tr>
<tr>
<td>
GLEW provides two command line tools: one for creating a list of
available extensions and visuals; and another for verification of extension
entry points.
<p>
<font size="+1"><b>glewinfo: a command line extension reporting utility</b></font>
<font size="+1"><b>wglinfo: reporting extensions and visuals on Windows</b></font>
<p>
GLEW comes with a command line utility called <tt>glewinfo</tt> that
allows you to make a list of the extensions supported on your platform.
The <tt>glewinfo</tt> utility uses GLEW to find out which extensions
<tt>wglinfo</tt> is the Windows version of <tt>glxinfo</tt>. By
default it creates a file called <tt>wglinfo.txt</tt> containing
a list of available OpenGL, WGL, and GLU extensions
as well as a table of visuals, aka. pixelformats. PBuffer and multiple output
capable visuals are also included. The format of the table is
described <a href="wglinfo.txt">here</a>. For additional usage information, type
<tt>wglinfo -h</tt>.
<p>
<font size="+1"><b>glewinfo: extension verification utility</b></font>
<p>
<tt>glewinfo</tt> allows you to verify the entry points for the
extensions supported on your platform. It uses GLEW to find out which extensions
and entry points are available and reports the results to a text file
called <tt>glewinfo.txt</tt>.
@ -384,7 +410,11 @@ GLEW was developed by Milan Ikits. He also performs occasional
maintainance to make sure that GLEW stays in mint condition. Aaron
Lefohn, Joe Kniss, and Chris Wyman were the first users and also
assisted with the design and debugging process. The acronym
originates from Aaron Lefohn.
originates from Aaron Lefohn. The RPM packages are maintained by Karol
Pietrzak. Nate Robins created the <tt>wglinfo</tt> utility,
to which modifications were added by Michael Wimmer.
<p>
<p>
GLEW is derived from the EXTGL project by Lev Povalahev. It is
licensed under the LGPL, the BSD license, the SGI Free Software

77
doc/wglinfo.txt Normal file
View File

@ -0,0 +1,77 @@
------------------
Readme for wglinfo
------------------
Copyright (C) Nate Robins, 1997
Michael Wimmer, 1999
Milan Ikits, 2003
wglinfo is a small utility that displays all available visuals,
aka. pixelformats, in an OpenGL system along with renderer version
information. It shows a table of all the visuals that support OpenGL
and their capabilities. The format of the table is similar to glxinfo
on Unix systems:
visual ~= pixel format descriptor
id = visual id (integer from 1 - max visuals)
dep = cColorBits - color depth
tp = dwFlags - visual type (wn: window, pb: pbuffer, bm: bitmap)
xsp = no analog - transparent pixel (currently always ".")
bfsz = cColorBits - framebuffer size
lvl = bReserved - overlay (>0), underlay (<0), main plane (0)
rgci = iPixelType - rb = rgba mode, ci = color index mode
db = dwFlags & PFD_DOUBLEBUFFER - double buffer flag (y = yes)
stro = dwFlags & PFD_STEREO - stereo flag (y = yes)
gene = dwFlags & PFD_GENERIC - software generic (y = yes) or ICD
geac = dwFlags & PFD_GENERIC_ACCELERATED - generic with hardware (MCD)
rsz = cRedBits - # bits of red
gsz = cGreenBits - # bits of green
bsz = cBlueBits - # bits of blue
asz = cAlphaBits - # bits of alpha
axbf = cAuxBuffers - # of aux buffers
dpth = cDepthBits - # bits of depth
stcl = cStencilBits - # bits of stencil
accum sz = cAccumBits - total # of bits in accumulation buffer
accum r = cAccumRedBits - # bits of red in accumulation buffer
accum g = cAccumGreenBits - # bits of green in accumulation buffer
accum b = cAccumBlueBits - # bits of blue in accumulation buffer
accum a = cAccumAlphaBits - # bits of alpha in accumulation buffer
ms ns/b = no analog - multisample buffers (currently always ".")
In the 10th column, you will find two additional columns:
ge ge
ne ac
Those capture the PFD_GENERIC_FORMAT (gene) and
PFD_GENERIC_ACCELERATED (geac) flags of the Pixelformat descriptor. If
'gene' is set to no, there is most probably an ICD (Installable Client
Driver) at work, i.e., a full OpenGL implementation by a hardware
vendor. If 'gene' is set to yes and 'geac' to no, then the MS/SGI
(whichever is reported) software implementation is at work. If 'gene'
and 'geac' both are set to yes, then the generic implementation is
supplemented by hardware acceleration, which should most certainly
mean that an MCD (Mini Client Driver) is at work, i.e., a small driver
that only exposes the rasterization interface of the underlying
hardware.
For additional details on what these flags mean, please refer to the
included source code. The original source code can be found in the
SGI OpenGL Windows SDK.
For usage information, type 'wglinfo -h'
The '-w' switch will case the program to list all pixelformats that
can be used for hardware accelerated rendering. Hence, all pixelformats
that can only render to bitmaps are omitted, making the output slightly more
readable.
The '-d' switch works around problems with some implementations where it is
not possible to create an OpenGL context without special preparations (fullscreen
mode or others). It forces wglinfo to only print pixelformat information, but
no renderer information, which would require a context to be created.
This switch shouldn't be necessary for any current OpenGL driver.
The '-v' switch lists the pixelformats in a verbose form.
The '-s' sends the output to stdout instead of wglinfo.txt.