The OpenGL Extension Wrangler Library

Copyright (C) 2002-2008, Milan Ikits <milan ikits[]ieee="" org=""></milan>

Copyright (C) 2002-2008, Marcelo E. Magallon <mmagallo[]debian org=""></mmagallo[]debian>

Copyright (C) 2002, Lev Povalahev

All rights reserved.

Redistribution and use in source and binary forms, with or without 

modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice, 

  this list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright notice, 

  this list of conditions and the following disclaimer in the documentation 

  and/or other materials provided with the distribution.

* The name of the author may be used to endorse or promote products 

  derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 

AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 

IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 

LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 

CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 

SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS

INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN

CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)

ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF

THE POSSIBILITY OF SUCH DAMAGE.

-->

<title>GLEW: The OpenGL Extension Wrangler Library</title>

<meta content="text/html; charset=US-ASCII" http-equiv="Content-Type"> 

<link href="glew.css" rel="stylesheet" type="text/css">

Latest Release: 1.9.0

Download

Usage

Building

Installation

Source Generation

Credits & Copyright

Change Log

Project Page

Mailing Lists

Bug Tracker

Last Update: 08-06-12

height="35" border="0" alt="OpenGL Logo">

src="http://sourceforge.net/sflogo.php?group_id=67586&type=1"

width="88" height="31" border="0" alt="SourceForge Logo">

href="http://sourceforge.net/donate/index.php?group_id=67586">

src="http://images.sourceforge.net/images/project-support.jpg"

width="88" height="32" border="0" alt="Support This Project"> -->

The OpenGL Extension Wrangler Library

Installation

To use the shared library version of GLEW, you need to copy the

headers and libraries into their destination directories. On Windows

this typically boils down to copying:

<tt>bin/glew32.dll</tt>    to    

<tt>%SystemRoot%/system32</tt>

<tt>lib/glew32.lib</tt>    to    

<tt>{VC Root}/Lib</tt>

<tt>include/GL/glew.h</tt>    to    

<tt>{VC Root}/Include/GL</tt>

<tt>include/GL/wglew.h</tt>    to    

<tt>{VC Root}/Include/GL</tt>

where <tt>{VC Root}</tt> is the Visual C++ root directory, typically

<tt>C:/Program Files/Microsoft Visual Studio/VC98</tt> for Visual

Studio 6.0 or <tt>C:/Program Files/Microsoft Visual</tt>

Studio .NET 2003/Vc7/PlatformSDK for Visual Studio .NET.

On Unix, typing <tt>make install</tt> will attempt to install GLEW

into <tt>/usr/include/GL</tt> and <tt>/usr/lib</tt>.  You can

customize the installation target via the <tt>GLEW_DEST</tt>

environment variable if you do not have write access to these

directories.

Building Your Project with GLEW

There are two ways to build your project with GLEW.

Including the source files / project file

The simpler but less flexible way is to include <tt>glew.h</tt> and

<tt>glew.c</tt> into your project.  On Windows, you also need to

define the <tt>GLEW_STATIC</tt> preprocessor token when building a

static library or executable, and the <tt>GLEW_BUILD</tt> preprocessor

token when building a dll.  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:

#include <glew.h>

#include <GL/glut.h>

<gl, glu, and glut functionality is available here>

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 do not

need to include it separately.

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 also need to

change the <tt>GLEW_BUILD</tt> preprocessor constant to

<tt>GLEW_STATIC</tt> when building a static library or executable,

otherwise you get build errors.

Note that GLEW does not use the C

runtime library, so it does not matter which version (single-threaded,

multi-threaded or multi-threaded DLL) it is linked with (without

debugging information). It is, however, always a good idea to compile all

your projects including GLEW with the same C runtime settings.

Using GLEW as a shared library

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:

#include <GL/glew.h>

#include <GL/glut.h>

<gl, glu, and glut functionality is available here>

or:

#include <GL/glew.h>

<gl and glu functionality is available here>

Remember 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

Unix (<tt>-lGLEW -lGLU -lGL</tt>).

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>.