2002-12-13 08:31:58 +00:00
|
|
|
<!--
|
2004-02-19 06:22:04 +00:00
|
|
|
Copyright (C) 2004, 2003, 2002, Milan Ikits <milan ikits[at]ieee org>
|
|
|
|
Copyright (C) 2004, 2003, 2002, Marcelo E. Magallon <mmagallo[at]debian org>
|
2003-07-08 03:20:35 +00:00
|
|
|
This documentation may not be modified or redistributed in any
|
|
|
|
form, except by the copyright holder.
|
2002-12-13 08:31:58 +00:00
|
|
|
-->
|
2003-07-08 03:20:35 +00:00
|
|
|
<!doctype html public "-//w3c//dtd html 4.01 transitional//en" "http://www.w3.org/TR/html/4/loose.dtd">
|
2002-12-13 08:31:58 +00:00
|
|
|
<html>
|
|
|
|
<head>
|
|
|
|
<title>
|
|
|
|
GLEW: The OpenGL Extension Wrangler Library
|
|
|
|
</title>
|
2003-07-08 03:20:35 +00:00
|
|
|
<meta http-equiv="content-type" content="text/html; charset=US-ASCII">
|
|
|
|
<link href="glew.css" type=text/css rel=stylesheet>
|
2002-12-13 08:31:58 +00:00
|
|
|
</head>
|
2003-07-08 03:20:35 +00:00
|
|
|
<body bgcolor="#fff0d0">
|
2002-12-13 08:31:58 +00:00
|
|
|
<center>
|
2003-07-08 15:15:37 +00:00
|
|
|
<table border=0 width="60%" cellpadding="5" cellspacing="5">
|
2002-12-13 08:31:58 +00:00
|
|
|
<tr>
|
2003-07-08 03:20:35 +00:00
|
|
|
<td bgcolor="#ffffff" align=center><br><p><img src="./glew.png" alt="glew" width="97" height="75">
|
|
|
|
<p>
|
2003-07-09 01:31:19 +00:00
|
|
|
<h1>The OpenGL Extension Wrangler Library</h1>
|
2003-07-08 03:20:35 +00:00
|
|
|
<p>
|
2002-12-13 08:31:58 +00:00
|
|
|
<table border=0 cellpadding=0 cellspacing=0 align=center>
|
2003-07-09 01:31:19 +00:00
|
|
|
<tr><td align=center><a href="#Introduction"><small>Introduction</small></a></td></tr>
|
|
|
|
<tr><td align=center><a href="#Download"><small>Obtaining GLEW</small></a></td></tr>
|
|
|
|
<tr><td align=center><a href="#Supported"><small>Supported Extensions</small></a></td></tr>
|
|
|
|
<tr><td align=center><a href="#Build"><small>How to Build Your Project with GLEW</small></a></td></tr>
|
|
|
|
<tr><td align=center><a href="#Install"><small>How to Install GLEW</small></a></td></tr>
|
|
|
|
<tr><td align=center><a href="#Use"><small>How to Use GLEW</small></a></td></tr>
|
|
|
|
<tr><td align=center><a href="#Utilities"><small>Utilities</small></a></td></tr>
|
|
|
|
<tr><td align=center>
|
|
|
|
<a href="#Auto"><small>Automatic Code Generation</small></a>
|
|
|
|
</td></tr>
|
|
|
|
<tr><td align=center>
|
|
|
|
<a href="#Namespace"><small>Separate Namespace</small></a>
|
|
|
|
</td></tr>
|
2004-02-19 06:17:47 +00:00
|
|
|
<tr><td align=center>
|
|
|
|
<a href="#Context"><small>Multiple Rendering Contexts (GLEW MX)</small></a>
|
|
|
|
</td></tr>
|
2003-07-09 01:31:19 +00:00
|
|
|
<tr><td align=center><a href="#Issues"><small>Known Issues</small></a></td></tr>
|
|
|
|
<tr><td align=center><a href="#Credits"><small>Credits, Copyright</small></a></td></tr>
|
|
|
|
<tr><td align=center><a href="#Log"><small>Change Log</small></a></td></tr>
|
|
|
|
<tr><td align=center><a href="http://sourceforge.net/tracker/?group_id=67586">
|
2003-07-08 03:20:35 +00:00
|
|
|
<tr><td align=center><br></td></tr>
|
2002-12-13 08:31:58 +00:00
|
|
|
</table>
|
|
|
|
</tr>
|
|
|
|
|
2003-07-08 15:15:37 +00:00
|
|
|
<tr><td bgcolor="#fff0d0" align="center"></td></tr>
|
2002-12-13 08:31:58 +00:00
|
|
|
|
|
|
|
<tr>
|
2003-07-08 03:20:35 +00:00
|
|
|
<td bgcolor="#ffffff">
|
2003-07-09 01:31:19 +00:00
|
|
|
<center><a name="Introduction"><h2>Introduction</h2></a></center>
|
2003-07-08 15:15:37 +00:00
|
|
|
<p>
|
2004-02-19 06:17:47 +00:00
|
|
|
|
2002-12-13 08:31:58 +00:00
|
|
|
The goal of the OpenGL Extension Wrangler Library (GLEW) is to assist
|
2004-02-19 06:17:47 +00:00
|
|
|
C/C++ OpenGL developers with two tedious tasks: initializing and using
|
|
|
|
extensions and writing portable applications. GLEW provides an
|
|
|
|
efficient run-time mechanism to determine whether a certain extension
|
|
|
|
is supported by the driver or not. OpenGL core and extension
|
|
|
|
functionality is exposed via a single header file. GLEW currently
|
|
|
|
supports a variety of platforms and operating systems, including
|
|
|
|
Windows, Linux, Darwin, Irix, and Solaris.
|
2002-12-13 08:31:58 +00:00
|
|
|
<p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
|
2003-07-08 15:15:37 +00:00
|
|
|
<tr><td bgcolor="#fff0d0" align="center"></td></tr>
|
2002-12-13 08:31:58 +00:00
|
|
|
|
|
|
|
<tr>
|
2003-07-08 03:20:35 +00:00
|
|
|
<td bgcolor="#ffffff">
|
2003-07-09 01:31:19 +00:00
|
|
|
<center><a name="Download"><h2>Obtaining GLEW</h2></a></center>
|
2003-07-08 15:15:37 +00:00
|
|
|
<p>
|
|
|
|
Source and precompiled binaries are available at the <a
|
2002-12-13 08:31:58 +00:00
|
|
|
href="http://glew.sourceforge.net/">project website</a>.
|
|
|
|
|
|
|
|
<p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
|
2003-07-08 15:15:37 +00:00
|
|
|
<tr><td bgcolor="#fff0d0" align="center"></td></tr>
|
2002-12-22 01:03:12 +00:00
|
|
|
|
|
|
|
<tr>
|
2003-07-08 03:20:35 +00:00
|
|
|
<td bgcolor="#ffffff">
|
2003-07-09 01:31:19 +00:00
|
|
|
<center><a name="Supported"><h2>Supported Extensions</h2></a></center>
|
2003-07-08 15:15:37 +00:00
|
|
|
<p>
|
|
|
|
GLEW currently supports the following extensions:
|
|
|
|
<ul>
|
|
|
|
<li><a href="glew.html">OpenGL extensions</a>
|
|
|
|
<li><a href="wglew.html">WGL extensions</a>
|
|
|
|
<li><a href="glxew.html">GLX extensions</a>
|
|
|
|
</ul>
|
|
|
|
<p>
|
2003-07-08 17:17:49 +00:00
|
|
|
Useful links about OpenGL extensions:
|
2003-07-08 15:15:37 +00:00
|
|
|
<ul>
|
|
|
|
<li><a
|
2004-02-19 06:35:34 +00:00
|
|
|
href="http://www.opengl.org/resources/features/OGLextensions/">
|
2003-07-08 15:15:37 +00:00
|
|
|
All About OpenGL Extensions</a>
|
|
|
|
<li><a href="http://oss.sgi.com/projects/ogl-sample/registry/">OpenGL Extension Registry</a>
|
|
|
|
<li><a
|
|
|
|
href="http://www.ati.com/developer/sdk/radeonSDK/html/info/Prog3D.html">ATI
|
|
|
|
OpenGL Extension Specifications</a>
|
|
|
|
<li><a
|
2003-12-15 16:46:12 +00:00
|
|
|
href="http://developer.apple.com/opengl/extensions.html">
|
|
|
|
APPLE OpenGL Extensions Guide</a>
|
2004-09-06 15:37:03 +00:00
|
|
|
<li><a
|
|
|
|
href="http://developer.nvidia.com/view.asp?IO=nvidia_opengl_specs">NVIDIA
|
|
|
|
OpenGL Extension Specifications</a>
|
2003-07-08 15:15:37 +00:00
|
|
|
</ul>
|
2002-12-22 01:03:12 +00:00
|
|
|
<p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
|
2003-07-08 15:15:37 +00:00
|
|
|
<tr><td bgcolor="#fff0d0" align="center"></td></tr>
|
2002-12-13 08:31:58 +00:00
|
|
|
|
|
|
|
<tr>
|
2003-07-08 03:20:35 +00:00
|
|
|
<td bgcolor="#ffffff">
|
2002-12-13 08:31:58 +00:00
|
|
|
|
2003-07-09 01:31:19 +00:00
|
|
|
<center><a name="Build"><h2>How to Build Your Project with GLEW</h2></a></center>
|
2003-07-08 15:15:37 +00:00
|
|
|
<p>
|
|
|
|
|
2002-12-13 08:31:58 +00:00
|
|
|
There are two ways to build your project with GLEW.
|
|
|
|
<p>
|
|
|
|
|
2003-07-09 01:31:19 +00:00
|
|
|
<h3>Including the source files / project file</h3>
|
2002-12-13 08:31:58 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
The simpler but less flexible way is to include <tt>glew.h</tt> and
|
2003-09-15 16:04:41 +00:00
|
|
|
<tt>glew.c</tt> into your project and define the <tt>GLEW_STATIC</tt>
|
|
|
|
preprocessor constant for the static library or executable you are
|
|
|
|
building together with GLEW (Windows only). You also need to replace
|
|
|
|
<tt><GL/gl.h></tt> and <tt><GL/glu.h></tt> with
|
|
|
|
<tt><glew.h></tt> in your code and set the appropriate include
|
|
|
|
flag (<tt>-I</tt>) to tell the compiler where to look for it. For
|
|
|
|
example:
|
2002-12-13 08:31:58 +00:00
|
|
|
|
|
|
|
<blockquote><pre>#include <glew.h>
|
|
|
|
#include <GL/glut.h>
|
|
|
|
<gl, glu, and glut functionality is available here>
|
|
|
|
</pre></blockquote>
|
|
|
|
|
2003-09-15 16:04:41 +00:00
|
|
|
Depending on where you put <tt>glew.h</tt> you may also need to change
|
|
|
|
the include directives in <tt>glew.c</tt>. Note that if you are using
|
|
|
|
GLEW together with GLUT, you have to include <tt>glew.h</tt> first.
|
|
|
|
In addition, <tt>glew.h</tt> includes <tt>glu.h</tt>, so you don't
|
|
|
|
need to include it separately.
|
2002-12-13 08:31:58 +00:00
|
|
|
|
|
|
|
<p>
|
2003-09-15 16:04:41 +00:00
|
|
|
On Windows you also have the option of adding the supplied project
|
|
|
|
file <tt>glew_static.dsp</tt> to your workspace (solution) and compile
|
|
|
|
it together with your other projects. In this case you need to change
|
|
|
|
the <tt>GLEW_BUILD</tt> preprocessor constant to <tt>GLEW_STATIC</tt>,
|
2003-07-08 03:20:35 +00:00
|
|
|
otherwise you get build errors. <b>Note that GLEW does not use the C
|
|
|
|
runtime library, so it does not matter which version (single-threaded,
|
2003-09-15 16:04:41 +00:00
|
|
|
multi-threaded or multi-threaded DLL) it is linked with (without
|
2003-09-15 16:15:38 +00:00
|
|
|
debugging information). It is, however, always a good idea to compile all
|
2003-09-15 16:04:41 +00:00
|
|
|
your projects including GLEW with the same C runtime settings.</b>
|
2002-12-13 08:31:58 +00:00
|
|
|
|
|
|
|
<p>
|
|
|
|
|
2003-07-09 01:31:19 +00:00
|
|
|
<h3>Using GLEW as a shared library</h3>
|
2002-12-13 08:31:58 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
Alternatively, you can use the provided project files / makefile to
|
|
|
|
build a separate shared library you can link your projects with later.
|
|
|
|
In this case the best practice is to install <tt>glew.h</tt>,
|
|
|
|
<tt>glew32.lib</tt>, and <tt>glew32.dll</tt> / <tt>libGLEW.so</tt> to
|
|
|
|
where the OpenGL equivalents <tt>gl.h</tt>, <tt>opengl32.lib</tt>, and
|
|
|
|
<tt>opengl32.dll</tt> / <tt>libGL.so</tt> are located. Note that you
|
|
|
|
need administrative privileges to do this. If you do not have
|
|
|
|
administrator access and your system administrator will not do it for
|
|
|
|
you, you can install GLEW into your own lib and include subdirectories
|
|
|
|
and tell the compiler where to find it. Then you can just replace
|
|
|
|
<tt><GL/gl.h></tt> with <tt><GL/glew.h></tt> in your
|
|
|
|
program:
|
|
|
|
|
|
|
|
<blockquote><pre>#include <GL/glew.h>
|
|
|
|
#include <GL/glut.h>
|
|
|
|
<gl, glu, and glut functionality is available here>
|
|
|
|
</pre></blockquote>
|
|
|
|
|
|
|
|
or:
|
|
|
|
|
|
|
|
<blockquote><pre>#include <GL/glew.h>
|
|
|
|
<gl and glu functionality is available here>
|
|
|
|
</pre></blockquote>
|
|
|
|
|
|
|
|
<p>
|
|
|
|
Don't forget to link your project with <tt>glew32.lib</tt>,
|
|
|
|
<tt>glu32.lib</tt>, and <tt>opengl32.lib</tt> on Windows and
|
|
|
|
<tt>libGLEW.so</tt>, <tt>libGLU.so</tt>, and <tt>libGL.so</tt> on
|
2003-07-08 03:20:35 +00:00
|
|
|
Linux and IRIX (<tt>-lGLEW -lGLU -lGL</tt>).
|
2002-12-13 08:31:58 +00:00
|
|
|
|
|
|
|
<p>
|
|
|
|
It is important to keep in mind that <tt>glew.h</tt> includes neither
|
|
|
|
<tt>windows.h</tt> nor <tt>gl.h</tt>. Also, GLEW will warn you by
|
|
|
|
issuing a preprocessor error in case you have included <tt>gl.h</tt>,
|
|
|
|
<tt>glext.h</tt>, or <tt>glATI.h</tt> before <tt>glew.h</tt>.
|
|
|
|
<p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
|
2003-07-08 15:15:37 +00:00
|
|
|
<tr><td bgcolor="#fff0d0" align="center"></td></tr>
|
2002-12-13 08:31:58 +00:00
|
|
|
|
|
|
|
<tr>
|
2003-07-08 03:20:35 +00:00
|
|
|
<td bgcolor="#ffffff">
|
2002-12-13 08:31:58 +00:00
|
|
|
|
2003-07-09 01:31:19 +00:00
|
|
|
<center><a name="Install"><h2>How to Install GLEW</h2></a></center>
|
2003-07-08 15:15:37 +00:00
|
|
|
|
2002-12-13 08:31:58 +00:00
|
|
|
<p>
|
|
|
|
To install the shared library version of GLEW you need to copy the
|
|
|
|
headers and libraries into their destination directories. On Windows
|
|
|
|
this boils down to copying (no, we will not write a Windows installer
|
|
|
|
for you).
|
|
|
|
<p>
|
|
|
|
|
|
|
|
<center>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0>
|
2003-09-15 16:13:21 +00:00
|
|
|
<tr><td><tt>lib/glew32.dll</tt></td><td> to </td>
|
2003-07-08 15:15:37 +00:00
|
|
|
<td><tt>%SystemRoot%/system32</tt></td></tr>
|
2003-09-15 16:13:21 +00:00
|
|
|
<tr><td><tt>lib/glew32.lib</tt></td><td> to </td>
|
2002-12-13 08:31:58 +00:00
|
|
|
<td><tt>{VC Root}/Lib</tt></td></tr>
|
|
|
|
<tr><td><tt>include/GL/glew.h</tt></td><td> to </td>
|
|
|
|
<td><tt>{VC Root}/Include/GL</tt></td></tr>
|
|
|
|
<tr><td><tt>include/GL/wglew.h</tt></td><td> to </td>
|
|
|
|
<td><tt>{VC Root}/Include/GL</tt></td></tr>
|
|
|
|
</table>
|
|
|
|
</center>
|
|
|
|
<p>
|
|
|
|
|
|
|
|
where <tt>{VC Root}</tt> is your Visual C++ directory, typically
|
|
|
|
<tt>C:/Program Files/Microsoft Visual Studio/VC98</tt> for Visual
|
|
|
|
Studio 6.0 or <tt>C:/Program Files/Microsoft Visual
|
2003-07-08 03:20:35 +00:00
|
|
|
Studio/Vc7/PlatformSDK</tt> for Visual Studio .NET.
|
2002-12-13 08:31:58 +00:00
|
|
|
|
|
|
|
<p>
|
2003-07-08 03:20:35 +00:00
|
|
|
On Linux and IRIX, typing <tt>"make install"</tt> will attempt to install GLEW
|
2002-12-13 08:31:58 +00:00
|
|
|
into <tt>/usr/include/GL</tt> and <tt>/usr/lib</tt>. You can
|
2003-05-04 20:11:39 +00:00
|
|
|
customize the installation target via the <tt>GLEW_DEST</tt>
|
2002-12-13 08:31:58 +00:00
|
|
|
environment variable if you do not have write access
|
|
|
|
to these directories.
|
|
|
|
<p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
|
2003-07-08 15:15:37 +00:00
|
|
|
<tr><td bgcolor="#fff0d0" align="center"></td></tr>
|
2002-12-13 08:31:58 +00:00
|
|
|
|
|
|
|
<tr>
|
2003-07-08 03:20:35 +00:00
|
|
|
<td bgcolor="#ffffff">
|
2002-12-13 08:31:58 +00:00
|
|
|
|
2003-07-09 01:31:19 +00:00
|
|
|
<center><a name="Use"><h2>How to Use GLEW</h2></a></center>
|
2003-07-08 15:15:37 +00:00
|
|
|
<p>
|
|
|
|
|
2003-07-09 01:31:19 +00:00
|
|
|
<h3>Initializing GLEW</h3>
|
2002-12-13 08:31:58 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
First you need to create a valid OpenGL rendering context and call
|
|
|
|
<tt>glewInit()</tt> to initialize the extension entry points. If
|
2003-07-08 17:17:49 +00:00
|
|
|
<tt>glewInit()</tt> returns <tt>GLEW_OK</tt>, the initialization
|
2002-12-13 08:31:58 +00:00
|
|
|
succeeded and you can use the available extensions as well as core
|
|
|
|
OpenGL functionality. For example:
|
|
|
|
|
|
|
|
<blockquote><pre>#include <GL/glew.h>
|
|
|
|
#include <GL/glut.h>
|
|
|
|
...
|
|
|
|
glutInit(&argc, argv);
|
|
|
|
glutCreateWindow("GLEW Test");
|
2003-09-17 17:52:44 +00:00
|
|
|
GLenum err = glewInit();
|
2002-12-13 08:31:58 +00:00
|
|
|
if (GLEW_OK != err)
|
|
|
|
{
|
|
|
|
/* problem: glewInit failed, something is seriously wrong */
|
|
|
|
fprintf(stderr, "Error: %s\n", glewGetErrorString(err));
|
|
|
|
...
|
|
|
|
}
|
2003-09-15 16:04:41 +00:00
|
|
|
fprintf(stdout, "Status: Using GLEW %s\n", glewGetString(GLEW_VERSION));
|
2002-12-13 08:31:58 +00:00
|
|
|
</pre></blockquote>
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
2003-07-09 01:31:19 +00:00
|
|
|
<h3>Querying the available OpenGL extensions</h3>
|
2002-12-13 08:31:58 +00:00
|
|
|
<p>
|
|
|
|
|
2003-07-08 03:20:35 +00:00
|
|
|
Starting from GLEW 1.1.0, you can find out if a particular extension
|
|
|
|
is available on your platform by querying globally defined variables
|
|
|
|
of the form <tt>GLEW_{extension_name}</tt>:
|
2002-12-13 08:31:58 +00:00
|
|
|
|
2003-07-08 03:20:35 +00:00
|
|
|
<blockquote><pre>if (GLEW_ARB_vertex_program)
|
2002-12-13 08:31:58 +00:00
|
|
|
{
|
|
|
|
/* it is safe to use the ARB_vertex_program extension here */
|
|
|
|
glGenProgramsARB(...);
|
|
|
|
}
|
|
|
|
</pre></blockquote>
|
|
|
|
|
2003-07-08 03:20:35 +00:00
|
|
|
<b>In GLEW 1.0.x, a global structure was used for this task. To ensure
|
|
|
|
binary compatibility between releases, the struct was replaced with a
|
|
|
|
set of variables.</b>
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
2002-12-13 08:31:58 +00:00
|
|
|
You can also check for core OpenGL functionality. For example, to
|
2003-07-08 03:20:35 +00:00
|
|
|
see if OpenGL 1.3 is supported:
|
2002-12-13 08:31:58 +00:00
|
|
|
|
2003-07-08 03:20:35 +00:00
|
|
|
<blockquote><pre>if (GLEW_VERSION_1_3)
|
2002-12-13 08:31:58 +00:00
|
|
|
{
|
|
|
|
/* Yay! OpenGL 1.3 is supported! */
|
|
|
|
}
|
|
|
|
</pre></blockquote>
|
|
|
|
|
2003-07-08 03:20:35 +00:00
|
|
|
In general, you can check if <tt>GLEW_{extension_name}</tt> or
|
|
|
|
<tt>GLEW_VERSION_{version}</tt> is set or not.
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
|
|
|
For extensions <tt>glewGetExtension</tt> provides a slower alternative:
|
2002-12-15 07:36:45 +00:00
|
|
|
|
|
|
|
<blockquote><pre>if (GL_TRUE == glewGetExtension("GL_ARB_fragment_program"))
|
|
|
|
{
|
|
|
|
/* Looks like ARB_fragment_program is supported. */
|
|
|
|
}
|
|
|
|
</pre></blockquote>
|
2002-12-13 08:31:58 +00:00
|
|
|
|
2003-07-08 03:20:35 +00:00
|
|
|
|
2002-12-13 08:31:58 +00:00
|
|
|
<p>
|
|
|
|
|
2003-07-09 01:31:19 +00:00
|
|
|
<h3>Experimental drivers</h3>
|
2002-12-13 08:31:58 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
GLEW works by querying the supported extensions from the graphics
|
|
|
|
driver. Experimental drivers, however, might not report every
|
|
|
|
available extension through the standard mechanism, in which case GLEW
|
|
|
|
will report it unsupported. To circumvent this situation, the
|
|
|
|
<tt>glewExperimental</tt> global switch can be turned on by setting it
|
|
|
|
to <tt>GL_TRUE</tt> before calling <tt>glewInit()</tt>. This makes
|
|
|
|
sure that all extensions with valid entry points will be exposed.
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
2003-07-09 01:31:19 +00:00
|
|
|
<h3>Platform specific extensions</h3>
|
2002-12-13 08:31:58 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
Platform specific extensions are separated into two header files:
|
2003-07-08 03:20:35 +00:00
|
|
|
<tt>wglew.h</tt> and <tt>glxew.h</tt>, which define the available
|
|
|
|
<tt>WGL</tt> and <tt>GLX</tt> extensions. To determine if a certain
|
|
|
|
extension is supported, query <tt>WGLEW_{extension name}</tt> or
|
|
|
|
<tt>GLXEW_{extension_name}</tt>. For example:
|
2002-12-13 08:31:58 +00:00
|
|
|
|
|
|
|
<blockquote><pre>#include <GL/wglew.h>
|
|
|
|
|
2003-07-08 03:20:35 +00:00
|
|
|
if (WGLEW_ARB_pbuffer)
|
2002-12-13 08:31:58 +00:00
|
|
|
{
|
|
|
|
/* OK, we can use pbuffers */
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
/* Sorry, pbuffers will not work on this platform */
|
|
|
|
}
|
|
|
|
</pre></blockquote>
|
|
|
|
|
2003-07-08 15:15:37 +00:00
|
|
|
<tr><td bgcolor="#fff0d0" align="center"></td></tr>
|
2003-02-03 19:34:45 +00:00
|
|
|
|
|
|
|
<tr>
|
2003-07-08 03:20:35 +00:00
|
|
|
<td bgcolor="#ffffff">
|
2003-02-03 19:34:45 +00:00
|
|
|
|
2003-07-09 01:31:19 +00:00
|
|
|
<center><a name="Utilities"><h2>Utilities</h2></a></center>
|
2003-07-08 15:15:37 +00:00
|
|
|
<p>
|
|
|
|
|
2003-02-03 19:34:45 +00:00
|
|
|
GLEW provides two command line tools: one for creating a list of
|
2003-09-15 16:04:41 +00:00
|
|
|
available extensions and visuals; and another for verifying extension
|
2003-02-03 19:34:45 +00:00
|
|
|
entry points.
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
2004-09-06 15:37:03 +00:00
|
|
|
<h3>visualinfo: extensions and visuals</h3>
|
2003-02-03 19:34:45 +00:00
|
|
|
<p>
|
|
|
|
|
2004-09-06 15:37:03 +00:00
|
|
|
<tt>visualinfo</tt> is an extended version of <tt>glxinfo</tt>. On
|
|
|
|
Windows, by default it creates a file called <tt>visualinfo.txt</tt>
|
|
|
|
that contains a list of available OpenGL, WGL, and GLU extensions as
|
|
|
|
well as a table of visuals aka. pixel formats. Pbuffer and multiple
|
2004-09-06 15:39:40 +00:00
|
|
|
output capable visuals are also included. For additional usage
|
2004-09-06 15:37:03 +00:00
|
|
|
information, type <tt>visualinfo -h</tt>.
|
2003-02-03 19:34:45 +00:00
|
|
|
|
2002-12-13 08:31:58 +00:00
|
|
|
<p>
|
|
|
|
|
2003-07-09 01:31:19 +00:00
|
|
|
<h3>glewinfo: extension verification utility</h3>
|
2002-12-13 08:31:58 +00:00
|
|
|
<p>
|
|
|
|
|
2003-02-03 19:34:45 +00:00
|
|
|
<tt>glewinfo</tt> allows you to verify the entry points for the
|
2003-09-15 16:04:41 +00:00
|
|
|
extensions supported on your platform. It uses GLEW to find out which
|
|
|
|
extensions and entry points are available. On Windows it reports the
|
2004-02-19 06:17:47 +00:00
|
|
|
results to a text file called <tt>glewinfo.txt</tt>, on Unix it prints
|
|
|
|
them to <tt>stdout</tt>. <p>
|
|
|
|
|
|
|
|
Windows Usage: <blockquote><pre>glewinfo [-pf <id>]</pre></blockquote>
|
|
|
|
|
|
|
|
where <tt><id></tt> is the pixelformat id for which the
|
|
|
|
capabilities are displayed.
|
2002-12-13 08:31:58 +00:00
|
|
|
|
2004-02-19 06:17:47 +00:00
|
|
|
<p>
|
|
|
|
Unix Usage:
|
|
|
|
<blockquote><pre>glewinfo [-display <dpy>] [-visual <id>]</pre></blockquote>
|
|
|
|
|
|
|
|
where <tt><dpy></tt> is the X11 display and <tt><id></tt> is
|
|
|
|
the visual id for which the capabilities are displayed.
|
2002-12-13 08:31:58 +00:00
|
|
|
<p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
|
2003-07-08 17:17:49 +00:00
|
|
|
|
|
|
|
<tr><td bgcolor="#fff0d0" align="center"></td></tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
<td bgcolor="#ffffff">
|
|
|
|
|
2003-07-09 01:31:19 +00:00
|
|
|
<center><a name="Auto"><h2>Automatic Code Generation</h2></a></center>
|
2003-07-08 17:17:49 +00:00
|
|
|
<p>
|
|
|
|
|
2004-02-19 06:17:47 +00:00
|
|
|
Starting with release 1.1.0, the source code and parts of the
|
2003-07-08 17:17:49 +00:00
|
|
|
documentation are automatically generated from the extension
|
|
|
|
specifications via a two-step process. In the first step,
|
2003-09-15 16:04:41 +00:00
|
|
|
specification files from the OpenGL registry are parsed and skeleton
|
2003-07-08 17:17:49 +00:00
|
|
|
descriptors are created for each extension. These descriptors contain
|
|
|
|
all necessary information for creating the source code and
|
2003-09-15 16:04:41 +00:00
|
|
|
documentation in a simple and compact format, including the name of
|
|
|
|
the extension, url, tokens, function declarations, typedefs and struct
|
|
|
|
definitions. In the second step, the header files as well as the
|
|
|
|
library and glewinfo source are generated from the descriptor
|
2003-07-08 17:17:49 +00:00
|
|
|
files. The code generation scripts are located in the <tt>auto</tt>
|
|
|
|
subdirectory.
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr><td bgcolor="#fff0d0" align="center"></td></tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
<td bgcolor="#ffffff">
|
|
|
|
|
2003-07-09 01:31:19 +00:00
|
|
|
<center><a name="Namespace"><h2>Separate Namespace</h2></a></center>
|
2003-07-08 17:17:49 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
To avoid name clashes when linking with libraries that include the
|
|
|
|
same symbol, extension entry points are declared in a separate
|
|
|
|
namespace (release 1.1.0 and up). This is achieved by aliasing OpenGL
|
|
|
|
function names to their GLEW equivalents. For instance,
|
|
|
|
<tt>glFancyFunction</tt> is simply an alias to
|
|
|
|
<tt>glewFancyFunction</tt>. Note that the separate namespace doesn't
|
|
|
|
effect token and function pointer definitions.
|
|
|
|
<p>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
2004-02-19 06:17:47 +00:00
|
|
|
<tr><td bgcolor="#fff0d0" align="center"></td></tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
<td bgcolor="#ffffff">
|
|
|
|
|
|
|
|
<center><a name="Context"><h2>Multiple Rendering
|
|
|
|
Contexts (GLEW MX)</h2></a></center>
|
|
|
|
<p>
|
|
|
|
|
|
|
|
Starting with release 1.2.0, thread-safe support for multiple
|
|
|
|
rendering contexts (possibly with different capabilities) is
|
|
|
|
available. Since this is not required by most users, it is not added
|
|
|
|
to the binary releases to maintain compatibility between different
|
|
|
|
versions. To include multi-context support, you have to do the
|
|
|
|
following:
|
|
|
|
|
|
|
|
<ol>
|
2004-03-24 04:56:20 +00:00
|
|
|
<li>Compile and use GLEW with the <tt>GLEW_MX</tt> preprocessor token
|
|
|
|
defined.</li>
|
|
|
|
<li>For each rendering context, create a <tt>GLEWContext</tt> object
|
|
|
|
that will be available as long as the rendering context exists.</li>
|
|
|
|
<li>Define a macro or function called <tt>glewGetContext()</tt> that
|
|
|
|
returns a pointer to the <tt>GLEWContext</tt> object associated with
|
|
|
|
the rendering context from which OpenGL/WGL/GLX calls are
|
|
|
|
issued. (This dispatch mechanism is primitive, but generic.)
|
|
|
|
<li>Replace the global <tt>glewInit()</tt> call with
|
|
|
|
<tt>glewContextInit(glewGetContext())</tt>. Note, that the
|
|
|
|
<tt>GLEWContext</tt> pointer returned by <tt>glewGetContext()</tt> has
|
|
|
|
to reside in global or thread-local memory. Also, remember to call
|
|
|
|
<tt>glewContextInit</tt> after creating the <tt>GLEWContext</tt> object
|
|
|
|
in each rendering context.
|
2004-02-19 06:17:47 +00:00
|
|
|
</ol>
|
|
|
|
|
2004-03-24 04:56:20 +00:00
|
|
|
<p>Note that according to <a
|
2004-02-19 06:17:47 +00:00
|
|
|
href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/opengl/ntopnglr_6yer.asp">WGL
|
|
|
|
documentation</a>, you have to initialize the entry points for every
|
2004-03-24 04:56:20 +00:00
|
|
|
rendering context you create that use pixel formats with different
|
2004-02-19 06:17:47 +00:00
|
|
|
capabilities (for example the pixel formats provided by the generic
|
|
|
|
software OpenGL implementation by Microsoft vs. the hardware
|
|
|
|
accelerated pixel formats). <b>GLEW by default ignores this
|
|
|
|
requirement, and does not define per-context entry points (you can
|
|
|
|
however do this using the steps described above).</b> Assuming a
|
|
|
|
global namespace for the entry points works in most situations,
|
|
|
|
because typically all hardware accelerated pixel formats provide the
|
|
|
|
same entry points and capabilities (and why would anyone want to use
|
|
|
|
the software renderer when hardware acceleration is available?). This
|
|
|
|
means that unless you use the multi-context version of GLEW, you need
|
|
|
|
to call <tt>glewInit()</tt> only once in your program, or more
|
2004-03-24 04:56:20 +00:00
|
|
|
precisely, once per process.</p>
|
2004-02-19 06:17:47 +00:00
|
|
|
|
|
|
|
<p>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
|
2003-07-08 15:15:37 +00:00
|
|
|
<tr><td bgcolor="#fff0d0" align="center"></td></tr>
|
2002-12-13 08:31:58 +00:00
|
|
|
|
|
|
|
<tr>
|
2003-07-08 03:20:35 +00:00
|
|
|
<td bgcolor="#ffffff">
|
2002-12-13 08:31:58 +00:00
|
|
|
|
2003-07-09 01:31:19 +00:00
|
|
|
<center><a name="Issues"><h2>Known Issues</h2></a></center>
|
2003-07-08 15:15:37 +00:00
|
|
|
<p>
|
|
|
|
|
2004-02-19 06:17:47 +00:00
|
|
|
GLEW requires GLX 1.2 to assure compatibility with GLUT. Also,
|
2003-07-08 03:20:35 +00:00
|
|
|
the SGI GLX video extensions are currently not supported.
|
2002-12-13 08:31:58 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
|
2003-07-08 15:15:37 +00:00
|
|
|
<tr><td bgcolor="#fff0d0" align="center"></td></tr>
|
2002-12-13 08:31:58 +00:00
|
|
|
|
|
|
|
<tr>
|
2003-07-08 03:20:35 +00:00
|
|
|
<td bgcolor="#ffffff">
|
2003-07-09 01:31:19 +00:00
|
|
|
<center><a name="Credits"><h2>Credits, Copyright</h2></a></center>
|
2003-07-08 15:15:37 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
GLEW was developed by Milan Ikits and Marcelo Magallon. They also
|
|
|
|
perform 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 GLEW originates from Aaron Lefohn. Pasi Kärkkäinen
|
2003-07-08 03:20:35 +00:00
|
|
|
identified and fixed several problems with GLX and SDL. The RPM
|
|
|
|
packages are maintained by Karol Pietrzak. Nate Robins created the
|
|
|
|
<tt>wglinfo</tt> utility, to which modifications were added by Michael
|
|
|
|
Wimmer.
|
2003-02-03 19:34:45 +00:00
|
|
|
<p>
|
|
|
|
|
2002-12-13 08:31:58 +00:00
|
|
|
<p>
|
2004-02-19 06:17:47 +00:00
|
|
|
GLEW is originally derived from the EXTGL project by Lev Povalahev. The
|
2003-07-08 15:15:37 +00:00
|
|
|
source code is licensed under the modified BSD license, the <a
|
2003-07-08 03:20:35 +00:00
|
|
|
href="sgi.txt">SGI Free Software License B</a>, and the <a
|
2003-07-08 17:17:49 +00:00
|
|
|
href="glx.txt">GLX Public License</a>. The automatic code
|
|
|
|
generation scripts are released under the <a href="gpl.txt">GPL</a>.
|
2002-12-13 08:31:58 +00:00
|
|
|
|
|
|
|
<blockquote><pre></pre></blockquote>
|
|
|
|
|
2003-07-08 18:24:33 +00:00
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr><td bgcolor="#fff0d0" align="center"></td></tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
<td bgcolor="#ffffff">
|
2003-07-09 01:31:19 +00:00
|
|
|
<center><a name="Log"><h2>Change Log</h2></a></center>
|
2003-07-08 18:24:33 +00:00
|
|
|
<p>
|
|
|
|
<ul class="none">
|
2004-09-06 15:37:03 +00:00
|
|
|
<li><b>1.2.4</b> [09-06-04]
|
|
|
|
<ul>
|
|
|
|
<li> Added ARB_draw_buffers and ARB_texture_rectangle
|
|
|
|
<li> Replaced <tt>wglinfo</tt> with <tt>visualinfo</tt>
|
|
|
|
</ul>
|
|
|
|
<p>
|
2004-06-10 10:03:59 +00:00
|
|
|
<li><b>1.2.3</b> [06-10-04]
|
|
|
|
<ul>
|
|
|
|
<li> Added NV_fragment_program2, NV_fragment_program_option, NV_vertex_program2_option, NV_vertex_program3
|
|
|
|
<li> Bug fix in GL_ARB_vertex_blend
|
|
|
|
</ul>
|
|
|
|
<p>
|
2004-05-09 07:39:29 +00:00
|
|
|
<li><b>1.2.2</b> [05-08-04]
|
|
|
|
<ul>
|
|
|
|
<li> Added GL_EXT_pixel_buffer_object, removed GL_NV_element_array
|
2004-05-09 09:36:16 +00:00
|
|
|
<li> Fixed GLEW_MX problems
|
|
|
|
<li> Bug fix in GL_EXT_texture_rectangle and <tt>wglinfo</tt>
|
2004-05-09 07:39:29 +00:00
|
|
|
</ul>
|
|
|
|
<p>
|
2004-03-19 20:22:23 +00:00
|
|
|
<li><b>1.2.1</b> [03-18-04]
|
|
|
|
<ul>
|
|
|
|
<li> Bug fix in OpenGL version query (early release of 1.2.0 contained this bug)
|
|
|
|
<li> Bug fix in GL_ARB_shader_objects and temporary bug fix in GL_ARB_vertex_shader
|
|
|
|
<li> Added flags on GDI support and multisampling to <tt>wglinfo</tt>
|
|
|
|
</ul>
|
|
|
|
<p>
|
2004-02-19 06:17:47 +00:00
|
|
|
<li><b>1.2.0</b> [02-19-04]
|
|
|
|
<ul>
|
|
|
|
<li> Added full OpenGL 1.5 support
|
|
|
|
<li> Added support for multiple rendering contexts with different capabilities
|
|
|
|
<li> Added command line flags to <tt>glewinfo</tt> for selecting displays and visuals
|
|
|
|
<li> Added GLX_SGIS_multisample, GLX_SUN_video_resize, and GL_SUN_read_video_pixels
|
|
|
|
<li> Added MinGW/MSYS support
|
|
|
|
<li> Bug fixes in GL_ARB_shader_objects and the OS X build
|
|
|
|
</ul>
|
|
|
|
<p>
|
2003-12-15 16:00:55 +00:00
|
|
|
<li><b>1.1.4</b> [12-15-03]
|
|
|
|
<ul>
|
2003-12-15 16:43:43 +00:00
|
|
|
<li> Added GL_APPLE_float_pixels, GL_APPLE_texture_range,
|
|
|
|
GL_EXT_texture_cube_map, GL_EXT_texture_edge_clamp,
|
|
|
|
GLX_ATI_pixel_format_float, and GLX_ATI_render_texture
|
2003-12-15 16:05:44 +00:00
|
|
|
<li> Bug fixes in GL_ATI_map_object_buffer and GL_ATI_fragment_shader
|
2003-12-15 16:00:55 +00:00
|
|
|
</ul>
|
2003-12-15 16:23:17 +00:00
|
|
|
<p>
|
2003-10-29 04:28:16 +00:00
|
|
|
<li><b>1.1.3</b> [10-28-03]
|
|
|
|
<ul>
|
|
|
|
<li> Added Solaris and Darwin support
|
|
|
|
<li> Added GL_ARB_fragment_shader, GL_ARB_shader_objects, and
|
|
|
|
GL_ARB_vertex_shader
|
|
|
|
<li> Fixed bug in GL_WIN_swap_hint
|
|
|
|
<li> Removed <tt>glewinfo</tt>'s dependency on <tt>GLUT</tt>
|
|
|
|
</ul>
|
|
|
|
<p>
|
2003-09-15 16:04:41 +00:00
|
|
|
<li><b>1.1.2</b> [09-15-03]
|
|
|
|
<ul>
|
|
|
|
<li> Removed dependency on WGL_{ARB,EXT}_extensions_string
|
|
|
|
<li> Added glewGetString for querying GLEW version string
|
|
|
|
</ul>
|
|
|
|
<p>
|
2003-08-11 19:16:58 +00:00
|
|
|
<li><b>1.1.1</b> [08-11-03]
|
|
|
|
<ul>
|
|
|
|
<li> Added GLX_NV_float_buffer
|
|
|
|
<li> Fixed bug in GL_ARB_vertex_buffer_object
|
|
|
|
<li> Minor updates in documentation
|
|
|
|
</ul>
|
|
|
|
<p>
|
2003-07-08 18:24:33 +00:00
|
|
|
<li><b>1.1.0</b> [07-08-03]
|
|
|
|
<ul>
|
2003-07-08 18:29:41 +00:00
|
|
|
<li> Added automatic code generation
|
|
|
|
<li> Added almost every extension in the registry
|
|
|
|
<li> Added separate namespace
|
|
|
|
<li> Added IRIX support
|
2003-07-08 18:24:33 +00:00
|
|
|
<li> Updated documentation
|
|
|
|
</ul>
|
2003-07-09 01:31:19 +00:00
|
|
|
<p>
|
2003-07-08 18:24:33 +00:00
|
|
|
<li><b>1.0.7</b> [06-29-03]
|
|
|
|
<ul>
|
|
|
|
<li> Added GL_EXT_depth_bounds_test
|
|
|
|
<li> Fixed typos
|
|
|
|
</ul>
|
2003-07-09 01:31:19 +00:00
|
|
|
<p>
|
2003-07-08 18:24:33 +00:00
|
|
|
<li><b>1.0.6</b> [05-05-03]
|
|
|
|
<ul>
|
|
|
|
<li> Added ARB_vertex_buffer_object and NV_half_float
|
|
|
|
<li> Updated <tt>wglinfo</tt>
|
|
|
|
<li> Temporary Linux bug fixes (problems with SDL and MESA)
|
|
|
|
</ul>
|
2003-07-09 01:31:19 +00:00
|
|
|
<p>
|
2003-07-08 18:24:33 +00:00
|
|
|
<li><b>1.0.5</b> [02-17-03]
|
|
|
|
<ul>
|
|
|
|
<li> Bug fixes
|
|
|
|
<li> Added <tt>wglinfo</tt>
|
|
|
|
<li> Updated documentation
|
|
|
|
</ul>
|
2003-07-09 01:31:19 +00:00
|
|
|
<p>
|
2003-07-08 18:24:33 +00:00
|
|
|
<li><b>1.0.4</b> [02-02-03]
|
|
|
|
<ul>
|
|
|
|
<li> Added NV_texture_expand_normal
|
|
|
|
<li> Added mingw support
|
|
|
|
<li> Updated documentation
|
|
|
|
</ul>
|
2003-07-09 01:31:19 +00:00
|
|
|
<p>
|
2003-07-08 18:24:33 +00:00
|
|
|
<li><b>1.0.3</b> [01-09-03]
|
|
|
|
<ul>
|
|
|
|
<li> Cleaned up ATI extensions
|
|
|
|
<li> Changed function prototypes to match glext.h
|
|
|
|
<li> Added EXT_texture3D
|
|
|
|
<li> Fixed typos in ATI_vertex_attrib_array_object and ATI_draw_buffers
|
|
|
|
</ul>
|
2003-07-09 01:31:19 +00:00
|
|
|
<p>
|
2003-07-08 18:24:33 +00:00
|
|
|
<li><b>1.0.2</b> [12-21-02]
|
|
|
|
<ul>
|
|
|
|
<li> Added list of supported extensions to documentation
|
|
|
|
<li> Added NV_half_float and NV_texgen_emboss
|
|
|
|
</ul>
|
2003-07-09 01:31:19 +00:00
|
|
|
<p>
|
2003-07-08 18:24:33 +00:00
|
|
|
<li><b>1.0.1</b> [12-17-02]
|
|
|
|
<ul>
|
|
|
|
<li> Bug fixes
|
|
|
|
<li> Added glewGetExtension
|
|
|
|
</ul>
|
2003-07-09 01:31:19 +00:00
|
|
|
<p>
|
2003-07-08 18:24:33 +00:00
|
|
|
<li><b>1.0.0</b> [12-12-02]
|
|
|
|
<ul>
|
|
|
|
<li> Initial release
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
|
2002-12-13 08:31:58 +00:00
|
|
|
<tr>
|
|
|
|
<td bgcolor="#FFF0D0">
|
|
|
|
<table border="0" cellspacing="0" cellpadding="0" width="100%">
|
|
|
|
<tr>
|
2003-07-08 03:20:35 +00:00
|
|
|
<td align="right">
|
2004-06-10 10:03:59 +00:00
|
|
|
<i>Last update: 06-10-04</i></td>
|
2002-12-13 08:31:58 +00:00
|
|
|
</tr>
|
|
|
|
</table>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
</table>
|
|
|
|
</center>
|
|
|
|
|
|
|
|
</body>
|