From 893c5502ccaa6c0c8ad6dc3a375663d2996811e4 Mon Sep 17 00:00:00 2001 From: ikits Date: Tue, 8 Jul 2003 03:20:35 +0000 Subject: [PATCH] *** empty log message *** git-svn-id: https://glew.svn.sourceforge.net/svnroot/glew/trunk/glew@94 783a27ee-832a-0410-bc00-9f386506c6dd --- doc/README.html | 179 +++++++++++++++++++------------------- doc/glew.css | 40 +++++++++ doc/glew.html | 223 ------------------------------------------------ doc/glxew.html | 154 --------------------------------- doc/wglew.html | 144 ------------------------------- 5 files changed, 129 insertions(+), 611 deletions(-) create mode 100644 doc/glew.css delete mode 100644 doc/glew.html delete mode 100644 doc/glxew.html delete mode 100644 doc/wglew.html diff --git a/doc/README.html b/doc/README.html index 95e7930..2d935aa 100644 --- a/doc/README.html +++ b/doc/README.html @@ -1,29 +1,26 @@ - + GLEW: The OpenGL Extension Wrangler Library - + + - - +
- +
- - - - - - - @@ -46,15 +42,15 @@ name="Introduction">Introduction - @@ -66,7 +62,7 @@ name="Download">Obtaining GLEW - -
glew
The OpenGL Extension Wrangler Library
+

glew +

+The OpenGL Extension Wrangler Library +

@@ -34,9 +31,8 @@ GLEW: The OpenGL Extension Wrangler Library +
Introduction
Obtaining GLEW
Utilities
Known Issues
Credits, Copyright

-
-
+ The goal of the OpenGL Extension Wrangler Library (GLEW) is to assist 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 the products of two commodity graphics card -vendors, NVIDIA and ATI, on two operating systems, Windows and Linux. +currently supports SGI systems and PCs with commodity graphics cards +on three operating systems: Windows, Linux, and IRIX.

+ The source and precompiled binaries are available at the project website. @@ -81,7 +77,7 @@ name="Supported">Supported Extensions
+ - -
GLEW currently supports OpenGL, @@ -101,12 +97,12 @@ name="Build">How to Build Your Project with GLEW
+ There are two ways to build your project with GLEW.

-Including the source files / project file +Including the source files / project file

The simpler but less flexible way is to include glew.h and @@ -129,17 +125,16 @@ include glew.h first. In addition, glew.h includes

On Windows you can also add the supplied project file -(glew.dsp or glew.vcproj) to your workspace or -solution and compile it together with your other projects. In this -case you need to change the GLEW_BUILD preprocessor constant -to GLEW_STATIC, 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. +glew_static.dsp to your workspace (solution) and compile it together +with your other projects. In this case you need to change the +GLEW_BUILD preprocessor constant to GLEW_STATIC, +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.

-Using GLEW as a shared library +Using GLEW as a shared library

Alternatively, you can use the provided project files / makefile to @@ -170,7 +165,7 @@ or: Don't forget to link your project with glew32.lib, glu32.lib, and opengl32.lib on Windows and libGLEW.so, libGLU.so, and libGL.so on -Linux (-lGLEW -lGLU -lGL). +Linux and IRIX (-lGLEW -lGLU -lGL).

It is important to keep in mind that glew.h includes neither @@ -188,7 +183,7 @@ name="Install">How to Install GLEW

+

To install the shared library version of GLEW you need to copy the @@ -199,9 +194,9 @@ for you).

- + - + @@ -214,13 +209,10 @@ for you). where {VC Root} is your Visual C++ directory, typically C:/Program Files/Microsoft Visual Studio/VC98 for Visual Studio 6.0 or C:/Program Files/Microsoft Visual -Studio/Vc7/PlatformSDK for Visual Studio .NET. However, if you -build GLEW with Visual Studio .NET, the project file will -automatically install it into these directories, so you -don't have to worry about installation at all. +Studio/Vc7/PlatformSDK for Visual Studio .NET.

-On Linux, typing "make install" will attempt to install GLEW +On Linux and IRIX, typing "make install" will attempt to install GLEW into /usr/include/GL and /usr/lib. You can customize the installation target via the GLEW_DEST environment variable if you do not have write access @@ -236,9 +228,9 @@ name="Use">How to Use GLEW

- - @@ -380,13 +381,12 @@ name="Issues">Known Issues - - diff --git a/doc/glew.css b/doc/glew.css new file mode 100644 index 0000000..f610f57 --- /dev/null +++ b/doc/glew.css @@ -0,0 +1,40 @@ +h1 +{ + color: black; + font: 16pt "Verdana", "Arial", "Helvetica"; + display: inline; + /* font-weight: bold */ +} + +h2 +{ + color: black; + font: 14pt "Verdana", "Arial", "Helvetica"; +} + +body, table, td, p, div +{ + color: black; + font: 10pt "Verdana", "Arial", "Helvetica" +} + +a:link +{ + color: darkblue; + text-decoration: none; + +} + +a:visited +{ + color: darkblue; + text-decoration: none; + +} + +a:hover +{ + color: crimson; + text-decoration: underline; + +} diff --git a/doc/glew.html b/doc/glew.html deleted file mode 100644 index 54921d0..0000000 --- a/doc/glew.html +++ /dev/null @@ -1,223 +0,0 @@ - - - - - -GLEW: Supported OpenGL Extensions - - - - - -
-
lib/glew32.dll    to    
lib/shared/glew32.dll    to     %SystemRoot%/system32, usually C:/WINDOWS/system32
lib/glew32.lib    to    
lib/shared/glew32.lib    to     {VC Root}/Lib
include/GL/glew.h    to     {VC Root}/Include/GL
+ -Initializing GLEW +Initializing GLEW

First you need to create a valid OpenGL rendering context and call @@ -263,31 +255,41 @@ if (GLEW_OK != err)

-Querying the available OpenGL extensions +Querying the available OpenGL extensions

-To find out if a particular extension is available on your -platform, use the globally defined structure glew: +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 GLEW_{extension_name}: -

if (glew.ARB_vertex_program)
+
if (GLEW_ARB_vertex_program)
 {
   /* it is safe to use the ARB_vertex_program extension here */
   glGenProgramsARB(...);
 }
 

 
-You can also check for core OpenGL functionality.  For example, to
-see if OpenGL 1.3 is supported you can use the following:
+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.
 
-
if (glew.GL_13)
+

+
+You can also check for core OpenGL functionality.  For example, to
+see if OpenGL 1.3 is supported:
+
+
if (GLEW_VERSION_1_3)
 {
   /* Yay! OpenGL 1.3 is supported! */
 }
 

 
-In general, you can check if glew.{extension_name} or
-glew.GL_{version} is set or not.  For extensions
-glewGetExtension provides a slower alternative:
+In general, you can check if GLEW_{extension_name} or
+GLEW_VERSION_{version} is set or not.
+
+

+
+For extensions glewGetExtension provides a slower alternative:
 
 
if (GL_TRUE == glewGetExtension("GL_ARB_fragment_program"))
 {
@@ -295,9 +297,10 @@ In general, you can check if glew.{extension_name} or
 }
 

 
+
 

 
-Experimental drivers
+Experimental drivers
 

 
 GLEW works by querying the supported extensions from the graphics
@@ -310,20 +313,18 @@ sure that all extensions with valid entry points will be exposed.
 
 

 
-Platform specific extensions
+Platform specific extensions
 

 
 Platform specific extensions are separated into two header files:
-wglew.h and glxew.h.  These files define the
-available WGL and GLX extensions as well as the
-global wglew and glxew structs, which work similarly
-to the glew structure.  To determine if a given WGL or
-GLX extension is supported, query wglew.{extension name} or
-glxew.{extension_name}.  For example:
+wglew.h and glxew.h, which define the available
+WGL and GLX extensions.  To determine if a certain
+extension is supported, query WGLEW_{extension name} or
+GLXEW_{extension_name}.  For example:
 
 
#include <GL/wglew.h>
 
-if (wglew.ARB_pbuffer)
+if (WGLEW_ARB_pbuffer)
 {
   /* OK, we can use pbuffers */
 }
@@ -340,7 +341,7 @@ name="Utilities">Utilities
+ GLEW provides two command line tools: one for creating a list of available extensions and visuals; and another for verification of extension @@ -348,26 +349,26 @@ entry points.

-wglinfo: extensions and visuals on Windows +wglinfo: extensions and visuals on Windows

wglinfo is the Windows version of glxinfo. By default it creates a file called wglinfo.txt that contains a list of available OpenGL, WGL, and GLU extensions -as well as a table of visuals aka. pixelformats. PBuffer and multiple output +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: 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. +and entry points are available. On Windows it reports the results to a text file +called glewinfo.txt, on Linux and IRIX it prints them to stdout.

+ GLEW requires GLX 1.2 to assure compatibility with GLUT. In addition, -the SGI GLX video extensions are not supported, because they depend on -external libraries. +the SGI GLX video extensions are currently not supported.

-Note that according to the WGL documentation you have to initialize the entry points for every rendering context you create. GLEW ignores this requirement, and does not define per context entry points. This means @@ -405,24 +405,23 @@ name="Credits">Credits, Copyright

-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. Pasi Kärkkäinen identified -and fixed several problems with GLX and SDL. The RPM packages are -maintained by Karol - Pietrzak. Nate Robins created the -wglinfo utility, - to which modifications were added by -Michael Wimmer. + +GLEW has been 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 originates from Aaron Lefohn. Pasi Kärkkäinen +identified and fixed several problems with GLX and SDL. 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. The source code -is licensed under the modified BSD license, the SGI Free Software -License B, and the GLX Public License. +GLEW is originally derived from the EXTGL project by Lev Povalahev. +The source code is licensed under the modified BSD license, the SGI Free Software License B, and the GLX Public License. 


 
@@ -430,8 +429,8 @@ License B, and the GLX Public License.
 		
 
-
+

 

-Last update: 05-01-03
+Last update: 07-07-03
 

 

 

-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
GLEW: OpenGL Extensions

-
-
-
-
-
-
-
-
-
-
ARBEXTATINVSGIMisc

-
ARB
-

-
-ARB_depth_texture

-ARB_fragment_program

-ARB_imaging

-ARB_matrix_palette

-ARB_multisample

-ARB_multitexture

-ARB_point_parameters

-ARB_shadow

-ARB_shadow_ambient

-ARB_texture_border_clamp

-ARB_texture_compression

-ARB_texture_cube_map

-ARB_texture_env_add

-ARB_texture_env_combine

-ARB_texture_env_crossbar

-ARB_texture_env_dot3

-ARB_texture_mirrored_repeat

-ARB_transpose_matrix

-ARB_vertex_blend

-ARB_vertex_buffer_object

-ARB_vertex_program

-ARB_window_pos

-
-
EXT
-

-
-EXT_abgr

-EXT_bgra

-EXT_blend_color

-EXT_blend_func_separate

-EXT_blend_minmax

-EXT_blend_subtract

-EXT_clip_volume_hint

-EXT_compiled_vertex_array

-EXT_draw_range_elements

-EXT_cull_vertex

-EXT_fog_coord

-EXT_multi_draw_arrays

-EXT_packed_pixels

-EXT_point_parameters

-EXT_secondary_color

-EXT_separate_specular_color

-EXT_shadow_funcs

-EXT_stencil_two_side

-EXT_stencil_wrap

-EXT_texture_compression_s3tc

-EXT_texture_filter_anisotropic

-EXT_texture_lod_bias

-EXT_texture_rectangle

-EXT_texture3D

-EXT_vertex_shader

-EXT_vertex_weighting

-
-
ATI
-

-
-ATI_draw_buffers

-ATI_element_array

-ATI_envmap_bumpmap

-ATI_fragment_shader

-ATI_map_object_buffer

-ATI_pn_triangles

-ATI_separate_stencil

-ATI_text_fragment_shader

-ATI_texture_env_combine3

-ATI_texture_float

-ATI_texture_mirror_once

-ATI_vertex_array_object

-ATI_vertex_attrib_array_object

-ATI_vertex_streams

-ATIX_point_sprites

-ATIX_texture_env_combine3

-ATIX_texture_env_route

-ATIX_vertex_shader_output_point_size

-
-
NV
-

-
-NV_blend_square

-NV_copy_depth_to_color

-NV_depth_clamp

-NV_element_array

-NV_evaluators

-NV_fence

-NV_fog_distance

-NV_float_buffer

-NV_fragment_program

-NV_half_float

-NV_light_max_exponent

-NV_multisample_filter_hint

-NV_occlusion_query

-NV_packed_depth_stencil

-NV_pixel_data_range

-NV_point_sprite

-NV_primitive_restart

-NV_register_combiners

-NV_register_combiners2

-NV_texgen_emboss

-NV_texgen_reflection

-NV_texture_compression_vtc

-NV_texture_env_combine4

-NV_texture_expand_normal

-NV_texture_rectangle

-NV_texture_shader

-NV_texture_shader2

-NV_texture_shader3

-NV_vertex_array_range

-NV_vertex_array_range2

-NV_vertex_program

-NV_vertex_program1_1

-NV_vertex_program2

-
-
SGI
-

-
-SGIS_generate_mipmap

-SGIS_texture_lod

-SGIX_depth_texture

-SGIX_shadow

-
-
Misc
-

-
-HP_occlusion_test

-S3_s3tc

-WIN_swap_hint

-
-

-
-
-
-
-

-Last update: 05-01-03

-

-

-
-
diff --git a/doc/glxew.html b/doc/glxew.html
deleted file mode 100644
index 97ca9b8..0000000
--- a/doc/glxew.html
+++ /dev/null
@@ -1,154 +0,0 @@
-
- 
-
-
-
-GLEW: Supported GLX extensions
-
- 
-
-
-
-

-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
GLEW: GLX Extensions

-
-
-
-
-
-
-
-
-
-
-
ARBEXTNVMESASGIOMLSUN

-
ARB
-

-
-ARB_get_proc_address

-ARB_multisample

-
-
EXT
-

-
-EXT_import_context

-EXT_visual_info

-EXT_visual_rating

-
-
NV
-

-
-NV_vertex_array_range

-
-
MESA
-

-
-MESA_copy_sub_buffer

-MESA_pixmap_colormap

-MESA_release_buffers

-MESA_set_3dfx_mode

-
-
SGI
-

-
-SGI_cushion

-SGI_make_current_read

-SGI_swap_control

-SGI_video_sync

-SGIS_blended_overlay

-SGIS_multisample

-SGIS_shared_multisample

-SGIX_fbconfig

-SGIX_pbuffer

-SGIX_swap_group

-SGIX_swap_barrier

-SGIX_visual_select_group

-
-
OML
-

-
-OML_swap_method

-OML_sync_control

-
-
SUN
-

-
-SUN_get_transparent_index

-
-

-
-
-
-
-

-Last update: 12-21-02

-

-

-
-
diff --git a/doc/wglew.html b/doc/wglew.html
deleted file mode 100644
index bb1d36e..0000000
--- a/doc/wglew.html
+++ /dev/null
@@ -1,144 +0,0 @@
-
- 
-
-
-
-GLEW: Supported WGL Extensions
-
- 
-
-
-
-

-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
GLEW: WGL Extensions

-
-
-
-
-
-
-
-
-
-
ARBEXTATINVI3DOML

-
ARB
-

-
-ARB_buffer_region

-ARB_extensions_string

-ARB_make_current_read

-ARB_multisample

-ARB_pbuffer

-ARB_pixel_format

-ARB_render_texture

-
-
EXT
-

-
-EXT_depth_float

-EXT_display_color_table

-EXT_extensions_string

-EXT_make_current_read

-EXT_multisample

-EXT_swap_control

-EXT_pixel_format

-EXT_pbuffer

-
-
ATI
-

-
-ATI_pixel_format_float

-
-
NV
-

-
-NV_float_buffer

-NV_render_depth_texture

-NV_render_texture_rectangle

-NV_vertex_array_range

-
-
I3D
-

-
-I3D_digital_video_control

-I3D_gamma

-I3D_genlock

-I3D_image_buffer

-I3D_swap_frame_lock

-I3D_swap_frame_usage

-
-
OML
-

-
-OML_sync_control

-
-

-
-
-
-
-

-Last update: 01-10-03

-

-

-
-