The OpenGL Extension Wrangler Library
Go to file
2019-02-02 23:36:35 +10:00
auto Extend glewinfo to support optional -experimental mode, default to normal mode of operation 2019-02-02 15:03:57 +10:00
build FreeBSD cmake fixup for locating X11 include and lib 2019-02-02 09:23:01 +10:00
config FreeBSD build fixup to use X11 from /usr/local 2019-02-02 09:23:01 +10:00
doc Bump GLEW version to 2.1.0 2017-07-31 20:24:29 +10:00
src Tidy up use of unsued parameter attribute for Mac gcc builds 2016-12-25 00:49:20 +10:00
.gitattributes Initial EGL core and extension support with Python egl.xml spec parser 2016-02-06 12:41:11 +10:00
.gitignore Add Visual Studio 2015 and 2017 project files 2017-11-19 09:16:38 +10:00
.travis.yml Travis: variable-driven artifacts (again) 2019-01-30 20:55:26 +10:00
cmake-testbuild.sh build: cmake-testbuild to work on OS X and with CMake < 3.0 2015-07-12 23:12:36 +02:00
glew.pc.in Extend glew.pc output to mention GL linking (-framework on OSX) 2019-02-02 23:36:35 +10:00
LICENSE.txt Set eol-style to native for misc headers and text files 2009-10-07 15:36:15 +00:00
Makefile Extend glew.pc output to mention GL linking (-framework on OSX) 2019-02-02 23:36:35 +10:00
README.md FreeBSD pkg install for README.md 2019-02-02 09:23:01 +10:00

GLEW - The OpenGL Extension Wrangler Library

The OpenGL Extension Wrangler Library (GLEW) is a cross-platform open-source C/C++ extension loading library. GLEW provides efficient run-time mechanisms for determining which OpenGL extensions are supported on the target platform. OpenGL core and extension functionality is exposed in a single header file. GLEW has been tested on a variety of operating systems, including Windows, Linux, Mac OS X, FreeBSD, Irix, and Solaris.

http://glew.sourceforge.net/

https://github.com/nigels-com/glew

Build Status Gitter Download

Downloads

Current release is 2.1.0. (Change Log)

Sources available as ZIP or TGZ.

Windows binaries for 32-bit and 64-bit.

Recent snapshots

Snapshots may contain new features, bug-fixes or new OpenGL extensions ahead of tested, official releases.

glew-20181010.tgz GLEW 2.2.0 RC1: New extensions, bug fixes

Build

It is highly recommended to build from a tgz or zip release snapshot. The code generation workflow is a complex brew of gnu make, perl and python, that works best on Linux or Mac. For most end-users of GLEW the official releases are the best choice, with first class support.

Linux and Mac

Using GNU Make

Install build tools

Debian/Ubuntu/Mint: $ sudo apt-get install build-essential libxmu-dev libxi-dev libgl-dev

RedHat/CentOS/Fedora: $ sudo yum install libXmu-devel libXi-devel libGL-devel

FreeBSD: # pkg install xorg lang/gcc git cmake gmake bash python perl5

Build
$ make
$ sudo make install
$ make clean

Targets: all, glew.lib (sub-targets: glew.lib.shared, glew.lib.static), glew.bin, clean, install, uninstall

Variables: SYSTEM=linux-clang, GLEW_DEST=/usr/local, STRIP=

Note: may need to make auto folder

Linux EGL
$ sudo apt install libegl1-mesa-dev
$ make SYSTEM=linux-egl
Linux OSMesa
$ sudo apt install libosmesa-dev
$ make SYSTEM=linux-osmesa
Linux mingw-w64
$ sudo apt install mingw-w64
$ make SYSTEM=linux-mingw32
$ make SYSTEM=linux-mingw64

Using cmake

CMake 2.8.12 or higher is required.

Install build tools

Debian/Ubuntu/Mint: $ sudo apt-get install build-essential libxmu-dev libxi-dev libgl-dev cmake git

RedHat/CentOS/Fedora: $ sudo yum install libXmu-devel libXi-devel libGL-devel cmake git

Build
$ cd build
$ cmake ./cmake
$ make -j4
Target Description
glew Build the glew shared library.
glew_s Build the glew static library.
glewinfo Build the glewinfo executable (requires BUILD_UTILS to be ON).
visualinfo Build the visualinfo executable (requires BUILD_UTILS to be ON).
install Install all enabled targets into CMAKE_INSTALL_PREFIX.
clean Clean up build artifacts.
all Build all enabled targets (default target).
Variables Description
BUILD_UTILS Build the glewinfo and visualinfo executables.
GLEW_REGAL Build in Regal mode.
GLEW_OSMESA Build in off-screen Mesa mode.
BUILD_FRAMEWORK Build as MacOSX Framework. Setting CMAKE_INSTALL_PREFIX to /Library/Frameworks is recommended.

Windows

Visual Studio

Use the provided Visual Studio project file in build/vc15/

Projects for vc6, vc10, vc12 and vc14 are also provided

MSYS/Mingw

Available from Mingw

Requirements: bash, make, gcc

$ mingw32-make
$ mingw32-make install
$ mingw32-make install.all

Alternative toolchain: SYSTEM=mingw-win32

MSYS2/Mingw-w64

Available from Msys2 and/or Mingw-w64

Requirements: bash, make, gcc

$ pacman -S gcc make  mingw-w64-i686-gcc mingw-w64-x86_64-gcc
$ make
$ make install
$ make install.all

Alternative toolchain: SYSTEM=msys, SYSTEM=msys-win32, SYSTEM=msys-win64

glewinfo

glewinfo is a command-line tool useful for inspecting the capabilities of an OpenGL implementation and GLEW support for that. Please include glewinfo.txt with bug reports, as appropriate.

---------------------------
    GLEW Extension Info
---------------------------

GLEW version 2.0.0
Reporting capabilities of pixelformat 3
Running on a Intel(R) HD Graphics 3000 from Intel
OpenGL version 3.1.0 - Build 9.17.10.4229 is supported

GL_VERSION_1_1:                                                OK
---------------

GL_VERSION_1_2:                                                OK
---------------
  glCopyTexSubImage3D:                                         OK
  glDrawRangeElements:                                         OK
  glTexImage3D:                                                OK
  glTexSubImage3D:                                             OK

...

Code Generation

A Unix or Mac environment is needed for building GLEW from scratch to include new extensions, or customize the code generation. The extension data is regenerated from the top level source directory with:

make extensions

An alternative to generating the GLEW sources from scratch is to download a pre-generated (unsupported) snapshot:

https://sourceforge.net/projects/glew/files/glew/snapshots/

Travis-built snapshots are also available:

https://glew.s3.amazonaws.com/index.html

Authors

GLEW is currently maintained by Nigel Stewart with bug fixes, new OpenGL extension support and new releases.

GLEW was developed by Milan Ikits and Marcelo Magallon. 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 identified and fixed several problems with GLX and SDL. Nate Robins created the wglinfo utility, to which modifications were made by Michael Wimmer.

Contributions

GLEW welcomes community contributions. Typically these are co-ordinated via Issues or Pull Requests in the GitHub web interface.

Be sure to mention platform and compiler toolchain details when filing a bug report. The output of glewinfo can be quite useful for discussion also.

Generally GLEW is released once a year, around the time of the Siggraph computer graphics conference. If you're not using the current release version of GLEW, be sure to check if the issue or bug is fixed there.

GLEW is originally derived from the EXTGL project by Lev Povalahev. The source code is licensed under the Modified BSD License, the Mesa 3-D License (MIT) and the Khronos License (MIT).

The automatic code generation scripts are released under the GNU GPL.