From f58e3b1c3318f29f5527ba18b55220bd153869b5 Mon Sep 17 00:00:00 2001 From: ikits Date: Mon, 3 Feb 2003 19:34:45 +0000 Subject: [PATCH] added wglinfo git-svn-id: https://glew.svn.sourceforge.net/svnroot/glew/trunk/glew@37 783a27ee-832a-0410-bc00-9f386506c6dd --- doc/README.html | 40 +++++++++++++++++++++---- doc/wglinfo.txt | 77 +++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 112 insertions(+), 5 deletions(-) create mode 100644 doc/wglinfo.txt diff --git a/doc/README.html b/doc/README.html index 8d93e5e..5255198 100644 --- a/doc/README.html +++ b/doc/README.html @@ -31,6 +31,7 @@ GLEW: The OpenGL Extension Wrangler Library How to Build Your Project with GLEW How to Install GLEW How to Use GLEW +Utilities Known Issues Credits, Copyright @@ -332,14 +333,39 @@ else } + +Utilities + + + + + + +GLEW provides two command line tools: one for creating a list of +available extensions and visuals; and another for verification of extension +entry points. +

-glewinfo: a command line extension reporting utility +wglinfo: reporting extensions and visuals on Windows

-GLEW comes with a command line utility called glewinfo that -allows you to make a list of the extensions supported on your platform. -The glewinfo utility uses GLEW to find out which extensions +wglinfo is the Windows version of glxinfo. By +default it creates a file called wglinfo.txt 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 here. For additional usage information, type +wglinfo -h. + +

+ +glewinfo: extension verification utility +

+ +glewinfo 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 glewinfo.txt. @@ -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 wglinfo utility, +to which modifications were added by Michael Wimmer. +

+

GLEW is derived from the EXTGL project by Lev Povalahev. It is licensed under the LGPL, the BSD license, the SGI Free Software diff --git a/doc/wglinfo.txt b/doc/wglinfo.txt new file mode 100644 index 0000000..8066df7 --- /dev/null +++ b/doc/wglinfo.txt @@ -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.