Guile-OpenGL
************
This manual is for Guile-OpenGL (version 0.1.0, updated 23 March 2014)
Copyright (C) 2014 Free Software Foundation, Inc. and others.
Guile-OpenGL is free software: you can redistribute and/or modify
it and its documentation under the terms of the GNU Lesser General
Public License as published by the Free Software Foundation, either
version 3 of the License, or (at your option) any later version.
Guile-OpenGL is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this program. If not, see
.
Portions of this document were generated from the upstream OpenGL
documentation. The work as a whole is redistributable under the license
above. Sections containing generated documentation are prefixed with a
specific copyright header.
1 Introduction
**************
Guile-OpenGL is Guile's interface to OpenGL.
In addition to the OpenGL API, Guile also provides access to related
libraries and toolkits such as GLU, GLX, and GLUT. The following
chapters discuss the parts of OpenGL and how Guile binds them.
But before that, some notes on the binding as a whole.
1.1 About
=========
Guile-OpenGL uses the dynamic "foreign function interface" provided by
Guile 2.0, providing access to OpenGL without any C code at all. In
fact, much of Guile-OpenGL (and this manual) is automatically generated
from upstream API specifications and documentation.
We have tried to do a very complete job at wrapping OpenGL, and
additionally have tried to provide a nice Scheme interface as well. Our
strategy has been to separate the binding into low-level and high-level
pieces.
The low-level bindings correspond exactly with the OpenGL
specification, and are well-documented. However, these interfaces are
not so nice to use from Scheme; output arguments have to be allocated by
the caller, and there is only the most basic level of type checking, and
no sanity checking at all. For example, you can pass a bytevector of
image data to the low-level 'glTexImage2D' procedure, but no check is
made that the dimensions you specify actually correspond to the size of
the bytevector. This function could end up reading past the end of the
bytevector. Worse things can happen with procedures that write to
arrays, like 'glGetTexImage'.
The high-level bindings are currently a work in progress, and are
being manually written. They intend to be a complete interface to the
OpenGL API, without the need to use the low-level bindings. However,
the low-level bindings will always be available for you to use if
needed, and have the advantage that their behavior is better documented
and specified by OpenGL itself.
Low-level bindings are accessed by loading the '(MODULE low-level)',
for example via:
(use-modules (gl low-level))
The high-level modules are named like '(MODULE)', for example '(gl)'.
2 API Conventions
*****************
FIXME: A very rough draft. Bindings and text are not fully synced until
more work is done here.
This chapter documents the general conventions used by the low-level
and high-level bindings. Any conventions specific to a particular
module are documented in the relevent section.
As Guile-OpenGL is in very early stages of development these
conventions are subject to change. Feedback is certainly welcome, and
nothing is set in stone.
2.1 Enumerations
================
The OpenGL API defines many "symbolic constants", most of which are
collected together as named "enumerations" or "bitfields". Access to
these constants is the same for the low-level bindings and high-level
interface.
For each OpenGL enumeration type, there is a similarly named Scheme
type whose constructor takes an unquoted Scheme symbol naming one of the
values. Guile-OpenGL translates the names to a more common Scheme
style:
* any API prefix is removed (for example, GL_); and
* all names are lowercase, with underscores and CamelCase replaced by
hyphens.
For example, the OpenGL API defines an enumeration with symbolic
constants whose C names are GL_POINTS, GL_LINES, GL_TRIANGLES, and so
on. Collectively they form the BeginMode enumeration type. To access
these constants in Guile, apply the constant name to the enumeration
type: '(begin-mode triangles)'.
Bitfields are similar, though the constructor accepts multiple
symbols and produces an appropriate mask. In the GLUT API there is the
DisplayMode bitfield, with symbolic constants GLUT_RGB, GLUT_INDEX,
GLUT_SINGLE, and so on. To create a mask representing a
double-buffered, rgb display-mode with a depth buffer: '(display-mode
double rgb depth)'.
Enumeration and bitfield values, once constructed, can be compared
using 'eqv?'. For example, to determine if 'modelview' is the current
matrix mode use '(eqv? (gl-matrix-mode) (matrix-mode modelview))'.
2.2 Functions
=============
The low-level bindings currently use names identical to their C API
counterparts.
High-level bindings adopt names that are closer to natural language,
and a more common style for Scheme:
* the API prefix is always removed;
* abbreviations are avoided; and
* names are all lowercase with words separated by hyphens.
Some function names are altered in additional ways, to make clear
which object is being operated on. Functions that mutate objects or
state will have their name prefixed with 'set-', such as
'set-matrix-mode'.
FIXME: This choice may be too unnatural for GL users.
Where the C API specifies multiple functions that perform a similar
task on varying number and types of arguments, the high-level bindings
provide a single function that takes optional arguments, and, where
appropriate, using only the most natural type. Consider the group of C
API functions including 'glVertex2f', 'glVertex3f', and so on; the
high-level GL interface provides only a single function 'glVertex' with
optional arguments.
The high-level interfaces may differ in other ways, and it is
important to refer to the specific documentation.
It is generally fine to intermix functions from corresponding
low-level and high-level bindings. This can be useful if you know the
specific type of data you are working with and want to avoid the
overhead of dynamic dispatch at runtime. Any cases where such
intermixing causes problems will be noted in the documentation for the
high-level bindings.
3 GL
****
3.1 About OpenGL
================
The OpenGL API is a standard interface for drawing three-dimensional
graphics. From its origin in Silicon Graphics's workstations the early
1990s, today it has become ubiquitous, with implementations on mobile
phones, televisions, tablets, desktops, and even web browsers.
OpenGL has been able to achieve such widespread adoption not just
because it co-evolved with powerful graphics hardware, but also because
it was conceived of as an interface specification and not a piece of
source code. In fact, these days it is a family of APIs, available in
several flavors and versions:
OpenGL 1.x
This series of specifications started with the original releases in
1992, and ended with OpenGL 1.5 in 2003. This era corresponds to a
time when graphics cards were less powerful and more
special-purpose, with dedicated hardware to handle such details as
fog and lighting. As such the OpenGL 1.x API reflects the
capabilities of these special units.
OpenGL 2.x
By the early 2000s, graphics hardware had become much more
general-purpose and needed a more general-purpose API. The
so-called "fixed-function rendering pipeline" of the earlier years
was replaced with a "programmable rendering pipeline", in which
effects that would have required special hardware were instead
performed by custom programs running on the graphics card. OpenGL
added support for allocating "buffer objects" on the graphics card,
and for "shader programs", which did the actual rendering. In
time, this buffer-focused API came to be the preferred form of
talking to the GL.
OpenGL ES
OpenGL ES was a "cut-down" version of OpenGL 2.x, designed to be
small enough to appeal to embedded device vendors. OpenGL ES 1.x
removed some of the legacy functionality from OpenGL, while adding
interfaces to use fixed-point math, for devices without
floating-point units. OpenGL ES 2.x went farther still, removing
the fixed-function pipeline entirely. OpenGL ES 2.x is common on
current smart phone platforms.
OpenGL 3.x and above
The OpenGL 3.x series followed the lead of OpenGL ES, first
deprecating (in 3.0) and then removing (in 3.1) the fixed-function
pipeline. OpenGL 3.0 was released in 2008, but the free Mesa
impementation only began supporting it in 2012, so it is currently
(23 March 2014) less common.
Guile wraps the OpenGL 2.1 API. It's a ubiquitous subset of the
OpenGL implementations that are actually deployed in the wild; its
legacy API looks back to OpenGL 1.x, while the buffer-oriented API is
compatible with OpenGL ES.
The full OpenGL 2.1 specification is available at
.
3.2 GL Contexts
===============
All this talk about drawing is very well and good, but how do you
actually get a canvas? Interestingly enough, this is outside the
purview of the OpenGL specification. There are specific ways to get an
"OpenGL context" for each different windowing system that is out there.
OpenGL is all crayons and no paper.
For the X window system, there is a standard API for creating a GL
context given a window (or a drawable), "GLX". *Note GLX::, for more
information on its binding in Guile.
Bseides creating contexts from native windows or drawables, each
backend also supports functions to make a context "current". The OpenGL
API is stateful; you can think of each call as taking an implicit
"current context" parameter, which holds the current state of the GL and
is operated on by the function in question. Contexts are
thread-specific, and one context should not be active on more than one
thread at a time.
All calls to OpenGL functions must be made while a context is active;
otherwise the result is undefined. Hopefully while you are getting used
to this rule, your driver is nice enough not to crash on you if you call
a function outside a GL context, but it's not even required to do that.
Backend-specific functions may or may not require a context to be
current; for example, Windows requires a context to be current, wheras
GLX does not.
There have been a few attempts at abstracting away the need for
calling API specific to a given windowing system, notably GLUT and EGL.
GLUT is the older of the two, and though it is practically unchanged
since the mid-1990s, it is still widely used on desktops. *Note GLUT::,
for more on GLUT.
EGL is technically part of OpenGL ES, and was designed with the
modern OpenGL API and mobile hardware in mind, though it also works on
the desktop. Guile does not yet have an EGL binding.
3.3 Rendering
=============
To draw with OpenGL, you obtain a drawing context (*note GL Contexts::)
and send "the GL" some geometry. (You can think of the GL as a layer
over your graphics card.) You can give the GL points, lines, and
triangles in three-dimensional space. You configure your GL to render a
certain part of space, and it takes your geometry, rasterizes it, and
writes it to the screen (when you tell it to).
That's the basic idea. You can customize most parts of this
"rendering pipeline", by specifying attributes of your geometry with the
OpenGL API, and by programmatically operating on the geometry and the
pixels with programs called "shaders".
GL is an "immediate-mode" graphics API, which is to say that it
doesn't keep around a scene graph of objects. Instead, at every frame
you as the OpenGL user have to tell the GL what is in the world, and how
to paint it. It's a fairly low-level interface, but a powerful one.
See , for more
details.
In the old days of OpenGL 1.0, it was common to call a function to
paint each individual vertex. You'll still see this style in some old
tutorials. This quickly gets expensive if you have a lot of vertexes,
though. This style, known as "Legacy OpenGL", was deprecated and even
removed from some versions of OpenGL. See
, for more on the older APIs.
Instead, the newer thing to do is to send the geometry to the GL in a
big array buffer, and have the GL draw geometry from the buffer. The
newer functions like 'glGenBuffers' allocate buffers, returning an
integer that "names" a buffer managed by the GL. You as a user can
update the contents of the buffer, but when drawing you reference the
buffer by name. This has the advantage of reducing the chatter and data
transfer between you and the GL, though it can be less convenient to
use.
So which API should you use? Use what you feel like using, if you
have a choice. Legacy OpenGL isn't going away any time soon on the
desktop. Sometimes you don't have a choice, though; for example, when
targeting a device that only supports OpenGL ES 2.x, legacy OpenGL is
unavailable.
But if you want some advice, we suggest that you use the newer APIs.
Not only will your code be future-proof and more efficient on the GL
level, reducing the number of API calls improves performance, and it can
reduce the amount of heap allocation in your program. All
floating-point numbers are currently allocated on the heap in Guile, and
doing less floating-point math in tight loops can only be a good thing.
3.4 GL API
==========
The procedures exported from the '(gl)' module are documented below,
organized by their corresponding section in the OpenGL 2.1
specification.
(use-modules (gl))
See , for
more information.
3.4.1 OpenGL Operation
----------------------
3.4.1.1 Begin/End Paradigm
..........................
-- Macro: gl-begin begin-mode body ...
Begin immediate-mode drawing with BEGIN-MODE, evaluate the sequence
of BODY expressions, and then end drawing (as with 'glBegin' and
'glEnd').
The values produced by the last BODY expression are returned to the
continuation of the 'gl-begin'.
-- Function: gl-edge-flag boundary?
Flag edges as either boundary or nonboundary. Note that the edge
mode is only significant if the 'polygon-mode' is 'line' or
'point'.
3.4.1.2 Vertex Specification
............................
-- Function: gl-vertex x y [z=0.0] [w=1.0]
Draw a vertex at the given coordinates.
The following procedures modify the current per-vertex state.
Drawing a vertex captures the current state and associates it with the
vertex.
-- Function: gl-texture-coordinates s [t=0.0] [r=0.0] [q=1.0]
Set the current texture coordinate.
-- Function: gl-multi-texture-coordinates texture s [t=0.0] [r=0.0]
[q=1.0]
Set the current texture coordinate for a specific texture unit.
-- Function: gl-color red green blue [alpha=1.0]
Set the current color.
-- Function: gl-vertex-attribute index x [y=0.0] [z=0.0] [w=1.0]
Set the current value of a generic vertex attribute.
-- Function: gl-normal x y z
Set the current normal vector. By default the normal should have
unit length, though setting '(enable-cap rescale-normal)' or
'(enable-cap normalize)' can change this.
-- Function: gl-fog-coordinate coord
Set the current fog coordinate.
-- Function: gl-secondary-color red green blue
Set the current secondary color.
-- Function: gl-index c
Set the current color index.
3.4.1.3 Rectangles
..................
-- Function: gl-rectangle x1 y1 x2 y2
Draw a rectangle in immediate-mode with a given pair of corner
points.
3.4.1.4 Coordinate Transformation
.................................
-- Function: gl-depth-range near-val far-val
Specify the mapping of the near and far clipping planes,
respectively, to window coordinates.
-- Function: gl-viewport x y width height
Set the viewport: the pixel position of the lower-left corner of
the viewport rectangle, and the width and height of the viewport.
-- Function: gl-load-matrix m [#:transpose=#f]
Load a matrix. M should be a packed vector in column-major order.
Note that Guile's two-dimensional arrays are stored in row-major
order, so you might need to transpose the matrix as it is loaded
(via the '#:transpose' keyword argument).
-- Function: gl-multiply-matrix m [#:transpose=#f]
Multiply the current matrix by M. As with 'gl-load-matrix', you
might need to transpose the matrix first.
-- Function: set-gl-matrix-mode matrix-mode
Set the current matrix mode. See the 'matrix-mode' enumerator.
-- Macro: with-gl-push-matrix body ...
Save the current matrix, evaluate the sequence of BODY expressions,
and restore the saved matrix.
-- Function: gl-load-identity
Load the identity matrix.
-- Function: gl-rotate angle x y z
Rotate the current matrix about the vector '(X,Y,Z)'. ANGLE should
be specified in degrees.
-- Function: gl-translate x y z
Translate the current matrix.
-- Function: gl-scale x y z
Scale the current matrix.
-- Function: gl-frustum left right bottom top near-val far-val
Multiply the current matrix by a perspective matrix. LEFT, RIGHT,
BOTTOM, and TOP are the coordinates of the corresponding clipping
planes. NEAR-VAL and FAR-VAL specify the distances to the near and
far clipping planes.
-- Function: gl-ortho left right bottom top near-val far-val
Multiply the current matrix by a perspective matrix. LEFT, RIGHT,
BOTTOM, and TOP are the coordinates of the corresponding clipping
planes. NEAR-VAL and FAR-VAL specify the distances to the near and
far clipping planes.
-- Function: set-gl-active-texture texture
Set the active texture unit.
-- Function: gl-enable enable-cap
-- Function: gl-disable enable-cap
Enable or disable server-side GL capabilities.
3.4.1.5 Colors and Coloring
...........................
-- Function: set-gl-shade-model mode
Select flat or smooth shading.
3.4.2 Rasterization
-------------------
3.4.3 Per-Fragment Operations
-----------------------------
-- Function: set-gl-stencil-function stencil-function k [#:mask]
[#:face]
Set the front and/or back function and the reference value K for
stencil testing. Without the FACE keyword argument, both functions
are set. The default MASK is all-inclusive.
-- Function: set-gl-stencil-operation stencil-fail depth-fail
depth-pass [#:face]
Set the front and/or back stencil test actions. Without the FACE
keyword argument, both stencil test actions are set. See the
'stencil-op' enumeration for possible values for STENCIL-FAIL,
DEPTH-FAIL, and DEPTH-PASS.
-- Function: set-gl-blend-equation mode-rgb [mode-alpha=mode-rgb]
Set the blend equation. With one argument, set the same blend
equation for all components. Pass two arguments to specify a
separate equation for the alpha component.
-- Function: set-gl-blend-function src-rgb dest-rgb [src-alpha=src-rgb]
[dest-alpha=dest-rgb]
Set the blend function. With two arguments, set the same blend
function for all components. Pass an additional two arguments to
specify separate functions for the alpha components.
-- Function: set-gl-scissor x y width height
Define the scissor box. The box is defined in window coordinates,
with (X,Y) being the lower-left corner of the box.
-- Function: set-gl-sample-coverage value invert
Specify multisample coverage parameters.
-- Function: set-gl-alpha-function func ref
Specify the alpha test function. See the 'alpha-function'
enumerator.
-- Function: set-gl-depth-function func
Specify the depth test function. See the 'depth-function'
enumerator.
-- Function: set-gl-blend-color r g b a
Specify the blend color.
-- Function: set-gl-logic-operation opcode
Specify a logical pixel operation for color index rendering.
3.4.3.1 Whole Framebuffer Operations
....................................
-- Function: set-gl-draw-buffers buffers
Specify a list of color buffers to be drawn into. BUFFERS should
be a list of 'draw-buffer-mode' enumerated values.
-- Function: set-gl-stencil-mask mask [#:face]
Control the writing of individual bits into the front and/or back
stencil planes. With one argument, the stencil mask for both
states are set.
-- Function: set-gl-draw-buffer mode
Specify the buffer or buffers to draw into.
-- Function: set-gl-index-mask mask
Control the writing of individual bits into the color index
buffers.
-- Function: set-gl-color-mask red? green? blue? alpha?
Enable and disable writing of frame buffer color components.
-- Function: set-gl-depth-mask enable?
Enable and disable writing into the depth buffer.
-- Function: gl-clear mask
Clear a set of buffers to pre-set values. Use the
'clear-buffer-mask' enumerator to specify which buffers to clear.
-- Function: set-gl-clear-color r g b a
Set the clear color for the color buffers.
-- Function: set-gl-clear-index c
Set the clear index for the color index buffers.
-- Function: set-gl-clear-depth depth
Set the clear value for the depth buffer.
-- Function: set-gl-clear-stencil-value s
Set the clear value for the stencil buffer.
-- Function: set-gl-clear-accumulation-color r g b a
Set the clear color for the accumulation buffer.
-- Function: set-gl-accumulation-buffer-operation op value
Operate on the accumulation buffer. OP may be one of the
'accum-op' enumerated values. The interpretation of VALUE depends
on OP.
3.4.3.2 Drawing, Reading and Copying Pixels
...........................................
-- Function: set-gl-read-buffer mode
Select a color buffer source for pixels. Use 'read-buffer-mode' to
select a mode.
-- Function: gl-copy-pixels x y width height type
Copy pixels from a screen-aligned rectangle in the frame buffer to
a region relative to the current raster position. TYPE selects
which buffer to copy from.
3.4.4 Special Functions
-----------------------
3.4.5 State and State Requests
------------------------------
3.4.5.1 Querying GL State
.........................
-- Macro: with-gl-push-attrib bits body ...
Save part of the current state, evaluation the sequence of BODY
expressions, then restore the state. Use 'attrib-mask' to specify
which parts of the state to save.
3.5 GL Enumerations
===================
The functions from this section may be had by loading the module:
(use-modules (gl enums)
-- Macro: attrib-mask bit...
Bitfield constructor. The symbolic BIT arguments are replaced with
their corresponding numeric values and combined with 'logior' at
compile-time. The symbolic arguments known to this bitfield
constructor are:
'current', 'point', 'line', 'polygon', 'polygon-stipple',
'pixel-mode', 'lighting', 'fog', 'depth-buffer', 'accum-buffer',
'stencil-buffer', 'viewport', 'transform', 'enable',
'color-buffer', 'hint', 'eval', 'list', 'texture', 'scissor',
'all-attrib'.
-- Macro: version-1-3 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'multisample-bit', 'multisample', 'sample-alpha-to-coverage',
'sample-alpha-to-one', 'sample-coverage', 'sample-buffers',
'samples', 'sample-coverage-value', 'sample-coverage-invert',
'clamp-to-border', 'texture0', 'texture1', 'texture2', 'texture3',
'texture4', 'texture5', 'texture6', 'texture7', 'texture8',
'texture9', 'texture10', 'texture11', 'texture12', 'texture13',
'texture14', 'texture15', 'texture16', 'texture17', 'texture18',
'texture19', 'texture20', 'texture21', 'texture22', 'texture23',
'texture24', 'texture25', 'texture26', 'texture27', 'texture28',
'texture29', 'texture30', 'texture31', 'active-texture',
'client-active-texture', 'max-texture-units',
'transpose-modelview-matrix', 'transpose-projection-matrix',
'transpose-texture-matrix', 'transpose-color-matrix', 'subtract',
'compressed-alpha', 'compressed-luminance',
'compressed-luminance-alpha', 'compressed-intensity',
'compressed-rgb', 'compressed-rgba', 'texture-compression-hint',
'texture-compressed-image-size', 'texture-compressed',
'num-compressed-texture-formats', 'compressed-texture-formats',
'normal-map', 'reflection-map', 'texture-cube-map',
'texture-binding-cube-map', 'texture-cube-map-positive-x',
'texture-cube-map-negative-x', 'texture-cube-map-positive-y',
'texture-cube-map-negative-y', 'texture-cube-map-positive-z',
'texture-cube-map-negative-z', 'proxy-texture-cube-map',
'max-cube-map-texture-size', 'combine', 'combine-rgb',
'combine-alpha', 'rgb-scale', 'add-signed', 'interpolate',
'constant', 'primary-color', 'previous', 'source0-rgb',
'source1-rgb', 'source2-rgb', 'source0-alpha', 'source1-alpha',
'source2-alpha', 'operand0-rgb', 'operand1-rgb', 'operand2-rgb',
'operand0-alpha', 'operand1-alpha', 'operand2-alpha', 'dot3-rgb',
'dot3-rgba'.
-- Macro: arb-multisample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'multisample-bit-arb', 'multisample-arb',
'sample-alpha-to-coverage-arb', 'sample-alpha-to-one-arb',
'sample-coverage-arb', 'sample-buffers-arb', 'samples-arb',
'sample-coverage-value-arb', 'sample-coverage-invert-arb'.
-- Macro: ext-multisample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'multisample-bit-ext', 'multisample-ext',
'sample-alpha-to-mask-ext', 'sample-alpha-to-one-ext',
'sample-mask-ext', '1pass-ext', '2pass-0-ext', '2pass-1-ext',
'4pass-0-ext', '4pass-1-ext', '4pass-2-ext', '4pass-3-ext',
'sample-buffers-ext', 'samples-ext', 'sample-mask-value-ext',
'sample-mask-invert-ext', 'sample-pattern-ext',
'multisample-bit-ext'.
-- Macro: 3dfx-multisample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'multisample-bit-3dfx', 'multisample-3dfx', 'sample-buffers-3dfx',
'samples-3dfx', 'multisample-bit-3dfx'.
-- Macro: clear-buffer-mask bit...
Bitfield constructor. The symbolic BIT arguments are replaced with
their corresponding numeric values and combined with 'logior' at
compile-time. The symbolic arguments known to this bitfield
constructor are:
'depth-buffer', 'accum-buffer', 'stencil-buffer', 'color-buffer',
'coverage-buffer-bit-nv'.
-- Macro: client-attrib-mask bit...
Bitfield constructor. The symbolic BIT arguments are replaced with
their corresponding numeric values and combined with 'logior' at
compile-time. The symbolic arguments known to this bitfield
constructor are:
'client-pixel-store', 'client-vertex-array', 'client-all-attrib'.
-- Macro: version-3-0 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'map-read-bit', 'map-write-bit', 'map-invalidate-range-bit',
'map-invalidate-buffer-bit', 'map-flush-explicit-bit',
'map-unsynchronized-bit', 'context-flag-forward-compatible-bit',
'invalid-framebuffer-operation', 'half-float', 'clip-distance0',
'clip-distance1', 'clip-distance2', 'clip-distance3',
'clip-distance4', 'clip-distance5', 'clip-distance6',
'clip-distance7', 'framebuffer-attachment-color-encoding',
'framebuffer-attachment-component-type',
'framebuffer-attachment-red-size',
'framebuffer-attachment-green-size',
'framebuffer-attachment-blue-size',
'framebuffer-attachment-alpha-size',
'framebuffer-attachment-depth-size',
'framebuffer-attachment-stencil-size', 'framebuffer-default',
'framebuffer-undefined', 'depth-stencil-attachment',
'major-version', 'minor-version', 'num-extensions',
'context-flags', 'index', 'compressed-red', 'compressed-rg', 'rg',
'rg-integer', 'r8', 'r16', 'rg8', 'rg16', 'r16f', 'r32f', 'rg16f',
'rg32f', 'r8i', 'r8ui', 'r16i', 'r16ui', 'r32i', 'r32ui', 'rg8i',
'rg8ui', 'rg16i', 'rg16ui', 'rg32i', 'rg32ui',
'max-renderbuffer-size', 'depth-stencil', 'unsigned-int-24-8',
'vertex-array-binding', 'rgba32f', 'rgb32f', 'rgba16f', 'rgb16f',
'compare-ref-to-texture', 'depth24-stencil8',
'texture-stencil-size', 'vertex-attrib-array-integer',
'max-array-texture-layers', 'min-program-texel-offset',
'max-program-texel-offset', 'clamp-vertex-color',
'clamp-fragment-color', 'clamp-read-color', 'fixed-only',
'max-varying-components', 'texture-red-type', 'texture-green-type',
'texture-blue-type', 'texture-alpha-type',
'texture-luminance-type', 'texture-intensity-type',
'texture-depth-type', 'unsigned-normalized', 'texture-1d-array',
'proxy-texture-1d-array', 'texture-2d-array',
'proxy-texture-2d-array', 'texture-binding-1d-array',
'texture-binding-2d-array', 'r11f-g11f-b10f',
'unsigned-int-10f-11f-11f-rev', 'rgb9-e5',
'unsigned-int-5-9-9-9-rev', 'texture-shared-size',
'transform-feedback-varying-max-length',
'transform-feedback-varying-max-length-ext',
'back-primary-color-nv', 'back-secondary-color-nv',
'texture-coord-nv', 'clip-distance-nv', 'vertex-id-nv',
'primitive-id-nv', 'generic-attrib-nv',
'transform-feedback-attribs-nv', 'transform-feedback-buffer-mode',
'transform-feedback-buffer-mode-ext',
'transform-feedback-buffer-mode-nv',
'max-transform-feedback-separate-components',
'max-transform-feedback-separate-components-ext',
'max-transform-feedback-separate-components-nv',
'active-varyings-nv', 'active-varying-max-length-nv',
'transform-feedback-varyings', 'transform-feedback-varyings-ext',
'transform-feedback-varyings-nv',
'transform-feedback-buffer-start',
'transform-feedback-buffer-start-ext',
'transform-feedback-buffer-start-nv',
'transform-feedback-buffer-size',
'transform-feedback-buffer-size-ext',
'transform-feedback-buffer-size-nv',
'transform-feedback-record-nv', 'primitives-generated',
'primitives-generated-ext', 'primitives-generated-nv',
'transform-feedback-primitives-written',
'transform-feedback-primitives-written-ext',
'transform-feedback-primitives-written-nv', 'rasterizer-discard',
'rasterizer-discard-ext', 'rasterizer-discard-nv',
'max-transform-feedback-interleaved-components',
'max-transform-feedback-interleaved-components-ext',
'max-transform-feedback-interleaved-components-nv',
'max-transform-feedback-separate-attribs',
'max-transform-feedback-separate-attribs-ext',
'max-transform-feedback-separate-attribs-nv',
'interleaved-attribs', 'interleaved-attribs-ext',
'interleaved-attribs-nv', 'separate-attribs',
'separate-attribs-ext', 'separate-attribs-nv',
'transform-feedback-buffer', 'transform-feedback-buffer-ext',
'transform-feedback-buffer-nv',
'transform-feedback-buffer-binding',
'transform-feedback-buffer-binding-ext',
'transform-feedback-buffer-binding-nv', 'framebuffer-binding',
'draw-framebuffer-binding', 'renderbuffer-binding',
'read-framebuffer', 'draw-framebuffer', 'read-framebuffer-binding',
'renderbuffer-samples', 'depth-component32f', 'depth32f-stencil8',
'framebuffer-attachment-object-type',
'framebuffer-attachment-object-type-ext',
'framebuffer-attachment-object-name',
'framebuffer-attachment-object-name-ext',
'framebuffer-attachment-texture-level',
'framebuffer-attachment-texture-level-ext',
'framebuffer-attachment-texture-cube-map-face',
'framebuffer-attachment-texture-cube-map-face-ext',
'framebuffer-attachment-texture-layer',
'framebuffer-attachment-texture-3d-zoffset-ext',
'framebuffer-complete', 'framebuffer-complete-ext',
'framebuffer-incomplete-attachment',
'framebuffer-incomplete-attachment-ext',
'framebuffer-incomplete-missing-attachment',
'framebuffer-incomplete-missing-attachment-ext',
'framebuffer-incomplete-dimensions-ext',
'framebuffer-incomplete-formats-ext',
'framebuffer-incomplete-draw-buffer',
'framebuffer-incomplete-draw-buffer-ext',
'framebuffer-incomplete-read-buffer',
'framebuffer-incomplete-read-buffer-ext',
'framebuffer-unsupported', 'framebuffer-unsupported-ext',
'max-color-attachments', 'max-color-attachments-ext',
'color-attachment0', 'color-attachment0-ext', 'color-attachment1',
'color-attachment1-ext', 'color-attachment2',
'color-attachment2-ext', 'color-attachment3',
'color-attachment3-ext', 'color-attachment4',
'color-attachment4-ext', 'color-attachment5',
'color-attachment5-ext', 'color-attachment6',
'color-attachment6-ext', 'color-attachment7',
'color-attachment7-ext', 'color-attachment8',
'color-attachment8-ext', 'color-attachment9',
'color-attachment9-ext', 'color-attachment10',
'color-attachment10-ext', 'color-attachment11',
'color-attachment11-ext', 'color-attachment12',
'color-attachment12-ext', 'color-attachment13',
'color-attachment13-ext', 'color-attachment14',
'color-attachment14-ext', 'color-attachment15',
'color-attachment15-ext', 'depth-attachment',
'depth-attachment-ext', 'stencil-attachment',
'stencil-attachment-ext', 'framebuffer', 'framebuffer-ext',
'renderbuffer', 'renderbuffer-ext', 'renderbuffer-width',
'renderbuffer-width-ext', 'renderbuffer-height',
'renderbuffer-height-ext', 'renderbuffer-internal-format',
'renderbuffer-internal-format-ext', 'stencil-index1',
'stencil-index1-ext', 'stencil-index4', 'stencil-index4-ext',
'stencil-index8', 'stencil-index8-ext', 'stencil-index16',
'stencil-index16-ext', 'renderbuffer-red-size',
'renderbuffer-red-size-ext', 'renderbuffer-green-size',
'renderbuffer-green-size-ext', 'renderbuffer-blue-size',
'renderbuffer-blue-size-ext', 'renderbuffer-alpha-size',
'renderbuffer-alpha-size-ext', 'renderbuffer-depth-size',
'renderbuffer-depth-size-ext', 'renderbuffer-stencil-size',
'renderbuffer-stencil-size-ext',
'framebuffer-incomplete-multisample', 'max-samples', 'rgba32ui',
'rgba32ui-ext', 'rgb32ui', 'rgb32ui-ext', 'alpha32ui-ext',
'intensity32ui-ext', 'luminance32ui-ext',
'luminance-alpha32ui-ext', 'rgba16ui', 'rgba16ui-ext', 'rgb16ui',
'rgb16ui-ext', 'alpha16ui-ext', 'intensity16ui-ext',
'luminance16ui-ext', 'luminance-alpha16ui-ext', 'rgba8ui',
'rgba8ui-ext', 'rgb8ui', 'rgb8ui-ext', 'alpha8ui-ext',
'intensity8ui-ext', 'luminance8ui-ext', 'luminance-alpha8ui-ext',
'rgba32i', 'rgba32i-ext', 'rgb32i', 'rgb32i-ext', 'alpha32i-ext',
'intensity32i-ext', 'luminance32i-ext', 'luminance-alpha32i-ext',
'rgba16i', 'rgba16i-ext', 'rgb16i', 'rgb16i-ext', 'alpha16i-ext',
'intensity16i-ext', 'luminance16i-ext', 'luminance-alpha16i-ext',
'rgba8i', 'rgba8i-ext', 'rgb8i', 'rgb8i-ext', 'alpha8i-ext',
'intensity8i-ext', 'luminance8i-ext', 'luminance-alpha8i-ext',
'red-integer', 'red-integer-ext', 'green-integer',
'green-integer-ext', 'blue-integer', 'blue-integer-ext',
'alpha-integer', 'alpha-integer-ext', 'rgb-integer',
'rgb-integer-ext', 'rgba-integer', 'rgba-integer-ext',
'bgr-integer', 'bgr-integer-ext', 'bgra-integer',
'bgra-integer-ext', 'luminance-integer-ext',
'luminance-alpha-integer-ext', 'rgba-integer-mode-ext',
'float-32-unsigned-int-24-8-rev', 'framebuffer-srgb',
'compressed-red-rgtc1', 'compressed-signed-red-rgtc1',
'compressed-rg-rgtc2', 'compressed-signed-rg-rgtc2',
'sampler-1d-array', 'sampler-2d-array', 'sampler-1d-array-shadow',
'sampler-2d-array-shadow', 'sampler-cube-shadow',
'unsigned-int-vec2', 'unsigned-int-vec3', 'unsigned-int-vec4',
'int-sampler-1d', 'int-sampler-2d', 'int-sampler-3d',
'int-sampler-cube', 'int-sampler-1d-array', 'int-sampler-2d-array',
'unsigned-int-sampler-1d', 'unsigned-int-sampler-2d',
'unsigned-int-sampler-3d', 'unsigned-int-sampler-cube',
'unsigned-int-sampler-1d-array', 'unsigned-int-sampler-2d-array',
'query-wait', 'query-no-wait', 'query-by-region-wait',
'query-by-region-no-wait', 'buffer-access-flags',
'buffer-map-length', 'buffer-map-offset'.
-- Macro: arb-map-buffer-range bit...
Bitfield constructor. The symbolic BIT arguments are replaced with
their corresponding numeric values and combined with 'logior' at
compile-time. The symbolic arguments known to this bitfield
constructor are:
'map-read', 'map-write', 'map-invalidate-range',
'map-invalidate-buffer', 'map-flush-explicit',
'map-unsynchronized'.
-- Macro: ext-map-buffer-range enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'map-read-bit-ext', 'map-write-bit-ext',
'map-invalidate-range-bit-ext', 'map-invalidate-buffer-bit-ext',
'map-flush-explicit-bit-ext', 'map-unsynchronized-bit-ext'.
-- Macro: version-4-3 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'context-flag-debug-bit', 'num-shading-language-versions',
'vertex-attrib-array-long'.
-- Macro: khr-debug enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'context-flag-debug-bit', 'debug-output-synchronous',
'debug-next-logged-message-length', 'debug-callback-function',
'debug-callback-user-param', 'debug-source-api',
'debug-source-window-system', 'debug-source-shader-compiler',
'debug-source-third-party', 'debug-source-application',
'debug-source-other', 'debug-type-error',
'debug-type-deprecated-behavior', 'debug-type-undefined-behavior',
'debug-type-portability', 'debug-type-performance',
'debug-type-other', 'debug-type-marker', 'debug-type-push-group',
'debug-type-pop-group', 'debug-severity-notification',
'max-debug-group-stack-depth', 'debug-group-stack-depth', 'buffer',
'shader', 'program', 'query', 'program-pipeline', 'sampler',
'display-list', 'max-label-length', 'max-debug-message-length',
'max-debug-logged-messages', 'debug-logged-messages',
'debug-severity-high', 'debug-severity-medium',
'debug-severity-low', 'debug-output'.
-- Macro: arb-robustness enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'context-flag-robust-access-bit-arb', 'lose-context-on-reset-arb',
'guilty-context-reset-arb', 'innocent-context-reset-arb',
'unknown-context-reset-arb', 'reset-notification-strategy-arb',
'no-reset-notification-arb'.
-- Macro: arb-separate-shader-objects enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-shader-bit', 'fragment-shader-bit', 'geometry-shader-bit',
'tess-control-shader-bit', 'tess-evaluation-shader-bit',
'all-shader-bits', 'program-separable', 'active-program',
'program-pipeline-binding'.
-- Macro: arb-compute-shader enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compute-shader-bit', 'max-compute-shared-memory-size',
'max-compute-uniform-components',
'max-compute-atomic-counter-buffers',
'max-compute-atomic-counters',
'max-combined-compute-uniform-components',
'compute-local-work-size', 'max-compute-local-invocations',
'uniform-block-referenced-by-compute-shader',
'atomic-counter-buffer-referenced-by-compute-shader',
'dispatch-indirect-buffer', 'dispatch-indirect-buffer-binding',
'compute-shader', 'max-compute-uniform-blocks',
'max-compute-texture-image-units', 'max-compute-image-uniforms',
'max-compute-work-group-count', 'max-compute-work-group-size'.
-- Macro: ext-separate-shader-objects enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-shader-bit-ext', 'fragment-shader-bit-ext',
'all-shader-bits-ext', 'program-separable-ext',
'active-program-ext', 'program-pipeline-binding-ext',
'active-program-ext'.
-- Macro: ext-shader-image-load-store enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-attrib-array-barrier-bit-ext',
'element-array-barrier-bit-ext', 'uniform-barrier-bit-ext',
'texture-fetch-barrier-bit-ext',
'shader-image-access-barrier-bit-ext', 'command-barrier-bit-ext',
'pixel-buffer-barrier-bit-ext', 'texture-update-barrier-bit-ext',
'buffer-update-barrier-bit-ext', 'framebuffer-barrier-bit-ext',
'transform-feedback-barrier-bit-ext',
'atomic-counter-barrier-bit-ext', 'all-barrier-bits-ext',
'max-image-units-ext',
'max-combined-image-units-and-fragment-outputs-ext',
'image-binding-name-ext', 'image-binding-level-ext',
'image-binding-layered-ext', 'image-binding-layer-ext',
'image-binding-access-ext', 'image-1d-ext', 'image-2d-ext',
'image-3d-ext', 'image-2d-rect-ext', 'image-cube-ext',
'image-buffer-ext', 'image-1d-array-ext', 'image-2d-array-ext',
'image-cube-map-array-ext', 'image-2d-multisample-ext',
'image-2d-multisample-array-ext', 'int-image-1d-ext',
'int-image-2d-ext', 'int-image-3d-ext', 'int-image-2d-rect-ext',
'int-image-cube-ext', 'int-image-buffer-ext',
'int-image-1d-array-ext', 'int-image-2d-array-ext',
'int-image-cube-map-array-ext', 'int-image-2d-multisample-ext',
'int-image-2d-multisample-array-ext', 'unsigned-int-image-1d-ext',
'unsigned-int-image-2d-ext', 'unsigned-int-image-3d-ext',
'unsigned-int-image-2d-rect-ext', 'unsigned-int-image-cube-ext',
'unsigned-int-image-buffer-ext', 'unsigned-int-image-1d-array-ext',
'unsigned-int-image-2d-array-ext',
'unsigned-int-image-cube-map-array-ext',
'unsigned-int-image-2d-multisample-ext',
'unsigned-int-image-2d-multisample-array-ext',
'max-image-samples-ext', 'image-binding-format-ext'.
-- Macro: arb-shader-image-load-store enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-attrib-array-barrier-bit', 'element-array-barrier-bit',
'uniform-barrier-bit', 'texture-fetch-barrier-bit',
'shader-image-access-barrier-bit', 'command-barrier-bit',
'pixel-buffer-barrier-bit', 'texture-update-barrier-bit',
'buffer-update-barrier-bit', 'framebuffer-barrier-bit',
'transform-feedback-barrier-bit', 'atomic-counter-barrier-bit',
'all-barrier-bits', 'max-image-units',
'max-combined-image-units-and-fragment-outputs',
'image-binding-name', 'image-binding-level',
'image-binding-layered', 'image-binding-layer',
'image-binding-access', 'image-1d', 'image-2d', 'image-3d',
'image-2d-rect', 'image-cube', 'image-buffer', 'image-1d-array',
'image-2d-array', 'image-cube-map-array', 'image-2d-multisample',
'image-2d-multisample-array', 'int-image-1d', 'int-image-2d',
'int-image-3d', 'int-image-2d-rect', 'int-image-cube',
'int-image-buffer', 'int-image-1d-array', 'int-image-2d-array',
'int-image-cube-map-array', 'int-image-2d-multisample',
'int-image-2d-multisample-array', 'unsigned-int-image-1d',
'unsigned-int-image-2d', 'unsigned-int-image-3d',
'unsigned-int-image-2d-rect', 'unsigned-int-image-cube',
'unsigned-int-image-buffer', 'unsigned-int-image-1d-array',
'unsigned-int-image-2d-array', 'unsigned-int-image-cube-map-array',
'unsigned-int-image-2d-multisample',
'unsigned-int-image-2d-multisample-array', 'max-image-samples',
'image-binding-format', 'image-format-compatibility-type',
'image-format-compatibility-by-size',
'image-format-compatibility-by-class', 'max-vertex-image-uniforms',
'max-tess-control-image-uniforms',
'max-tess-evaluation-image-uniforms',
'max-geometry-image-uniforms', 'max-fragment-image-uniforms',
'max-combined-image-uniforms'.
-- Macro: arb-shader-storage-buffer-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'shader-storage-barrier-bit', 'shader-storage-buffer',
'shader-storage-buffer-binding', 'shader-storage-buffer-start',
'shader-storage-buffer-size', 'max-vertex-shader-storage-blocks',
'max-geometry-shader-storage-blocks',
'max-tess-control-shader-storage-blocks',
'max-tess-evaluation-shader-storage-blocks',
'max-fragment-shader-storage-blocks',
'max-compute-shader-storage-blocks',
'max-combined-shader-storage-blocks',
'max-shader-storage-buffer-bindings',
'max-shader-storage-block-size',
'shader-storage-buffer-offset-alignment',
'max-combined-shader-output-resources',
'max-combined-image-units-and-fragment-outputs'.
-- Macro: intel-map-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'layout-default-intel', 'layout-linear-intel',
'layout-linear-cpu-cached-intel', 'texture-memory-layout-intel'.
-- Macro: boolean enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'false', 'true'.
-- Macro: begin-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'points', 'lines', 'line-loop', 'line-strip', 'triangles',
'triangle-strip', 'triangle-fan', 'quads', 'quad-strip', 'polygon'.
-- Macro: version-3-2 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'lines-adjacency', 'line-strip-adjacency', 'triangles-adjacency',
'triangle-strip-adjacency', 'program-point-size', 'depth-clamp',
'texture-cube-map-seamless', 'geometry-vertices-out',
'geometry-input-type', 'geometry-output-type',
'max-geometry-texture-image-units',
'framebuffer-attachment-layered',
'framebuffer-incomplete-layer-targets', 'geometry-shader',
'max-geometry-uniform-components', 'max-geometry-output-vertices',
'max-geometry-total-output-components',
'quads-follow-provoking-vertex-convention',
'first-vertex-convention', 'last-vertex-convention',
'provoking-vertex', 'sample-position', 'sample-mask',
'sample-mask-value', 'max-sample-mask-words',
'texture-2d-multisample', 'proxy-texture-2d-multisample',
'texture-2d-multisample-array',
'proxy-texture-2d-multisample-array',
'texture-binding-2d-multisample',
'texture-binding-2d-multisample-array', 'texture-samples',
'texture-fixed-sample-locations', 'sampler-2d-multisample',
'int-sampler-2d-multisample',
'unsigned-int-sampler-2d-multisample',
'sampler-2d-multisample-array', 'int-sampler-2d-multisample-array',
'unsigned-int-sampler-2d-multisample-array',
'max-color-texture-samples', 'max-depth-texture-samples',
'max-integer-samples', 'max-server-wait-timeout', 'object-type',
'sync-condition', 'sync-status', 'sync-flags', 'sync-fence',
'sync-gpu-commands-complete', 'unsignaled', 'signaled',
'already-signaled', 'timeout-expired', 'condition-satisfied',
'wait-failed', 'timeout-ignored', 'sync-flush-commands-bit',
'timeout-ignored', 'max-vertex-output-components',
'max-geometry-input-components', 'max-geometry-output-components',
'max-fragment-input-components', 'context-core-profile-bit',
'context-compatibility-profile-bit', 'context-profile-mask'.
-- Macro: arb-geometry-shader-4 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'lines-adjacency-arb', 'line-strip-adjacency-arb',
'triangles-adjacency-arb', 'triangle-strip-adjacency-arb',
'program-point-size-arb', 'max-varying-components',
'max-geometry-texture-image-units-arb',
'framebuffer-attachment-object-type',
'framebuffer-attachment-object-type-ext',
'framebuffer-attachment-object-name',
'framebuffer-attachment-object-name-ext',
'framebuffer-attachment-texture-level',
'framebuffer-attachment-texture-level-ext',
'framebuffer-attachment-texture-cube-map-face',
'framebuffer-attachment-texture-cube-map-face-ext',
'framebuffer-attachment-texture-layer',
'framebuffer-attachment-texture-3d-zoffset-ext',
'framebuffer-complete', 'framebuffer-complete-ext',
'framebuffer-incomplete-attachment',
'framebuffer-incomplete-attachment-ext',
'framebuffer-incomplete-missing-attachment',
'framebuffer-incomplete-missing-attachment-ext',
'framebuffer-incomplete-dimensions-ext',
'framebuffer-incomplete-formats-ext',
'framebuffer-incomplete-draw-buffer',
'framebuffer-incomplete-draw-buffer-ext',
'framebuffer-incomplete-read-buffer',
'framebuffer-incomplete-read-buffer-ext',
'framebuffer-unsupported', 'framebuffer-unsupported-ext',
'max-color-attachments', 'max-color-attachments-ext',
'color-attachment0', 'color-attachment0-ext', 'color-attachment1',
'color-attachment1-ext', 'color-attachment2',
'color-attachment2-ext', 'color-attachment3',
'color-attachment3-ext', 'color-attachment4',
'color-attachment4-ext', 'color-attachment5',
'color-attachment5-ext', 'color-attachment6',
'color-attachment6-ext', 'color-attachment7',
'color-attachment7-ext', 'color-attachment8',
'color-attachment8-ext', 'color-attachment9',
'color-attachment9-ext', 'color-attachment10',
'color-attachment10-ext', 'color-attachment11',
'color-attachment11-ext', 'color-attachment12',
'color-attachment12-ext', 'color-attachment13',
'color-attachment13-ext', 'color-attachment14',
'color-attachment14-ext', 'color-attachment15',
'color-attachment15-ext', 'depth-attachment',
'depth-attachment-ext', 'stencil-attachment',
'stencil-attachment-ext', 'framebuffer', 'framebuffer-ext',
'renderbuffer', 'renderbuffer-ext', 'renderbuffer-width',
'renderbuffer-width-ext', 'renderbuffer-height',
'renderbuffer-height-ext', 'renderbuffer-internal-format',
'renderbuffer-internal-format-ext', 'stencil-index1',
'stencil-index1-ext', 'stencil-index4', 'stencil-index4-ext',
'stencil-index8', 'stencil-index8-ext', 'stencil-index16',
'stencil-index16-ext', 'renderbuffer-red-size',
'renderbuffer-red-size-ext', 'renderbuffer-green-size',
'renderbuffer-green-size-ext', 'renderbuffer-blue-size',
'renderbuffer-blue-size-ext', 'renderbuffer-alpha-size',
'renderbuffer-alpha-size-ext', 'renderbuffer-depth-size',
'renderbuffer-depth-size-ext', 'renderbuffer-stencil-size',
'renderbuffer-stencil-size-ext',
'framebuffer-attachment-layered-arb',
'framebuffer-incomplete-layer-targets-arb',
'framebuffer-incomplete-layer-count-arb', 'geometry-shader-arb',
'geometry-vertices-out-arb', 'geometry-input-type-arb',
'geometry-output-type-arb', 'max-geometry-varying-components-arb',
'max-vertex-varying-components-arb',
'max-geometry-uniform-components-arb',
'max-geometry-output-vertices-arb',
'max-geometry-total-output-components-arb'.
-- Macro: nv-geometry-program-4 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'lines-adjacency-ext', 'line-strip-adjacency-ext',
'triangles-adjacency-ext', 'triangle-strip-adjacency-ext',
'program-point-size-ext', 'geometry-program-nv',
'max-program-output-vertices-nv',
'max-program-total-output-components-nv',
'max-geometry-texture-image-units-ext',
'framebuffer-attachment-texture-layer-ext',
'framebuffer-attachment-layered-ext',
'framebuffer-incomplete-layer-targets-ext',
'framebuffer-incomplete-layer-count-ext',
'geometry-vertices-out-ext', 'geometry-input-type-ext',
'geometry-output-type-ext'.
-- Macro: arb-tessellation-shader enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'patches', 'uniform-block-referenced-by-tess-control-shader',
'uniform-block-referenced-by-tess-evaluation-shader',
'max-tess-control-input-components',
'max-tess-evaluation-input-components',
'max-combined-tess-control-uniform-components',
'max-combined-tess-evaluation-uniform-components',
'patch-vertices', 'patch-default-inner-level',
'patch-default-outer-level', 'tess-control-output-vertices',
'tess-gen-mode', 'tess-gen-spacing', 'tess-gen-vertex-order',
'tess-gen-point-mode', 'isolines', 'fractional-odd',
'fractional-even', 'max-patch-vertices', 'max-tess-gen-level',
'max-tess-control-uniform-components',
'max-tess-evaluation-uniform-components',
'max-tess-control-texture-image-units',
'max-tess-evaluation-texture-image-units',
'max-tess-control-output-components', 'max-tess-patch-components',
'max-tess-control-total-output-components',
'max-tess-evaluation-output-components', 'tess-evaluation-shader',
'tess-control-shader', 'max-tess-control-uniform-blocks',
'max-tess-evaluation-uniform-blocks'.
-- Macro: nv-gpu-shader-5 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'patches', 'int64-nv', 'unsigned-int64-nv', 'int8-nv',
'int8-vec2-nv', 'int8-vec3-nv', 'int8-vec4-nv', 'int16-nv',
'int16-vec2-nv', 'int16-vec3-nv', 'int16-vec4-nv', 'int64-vec2-nv',
'int64-vec3-nv', 'int64-vec4-nv', 'unsigned-int8-nv',
'unsigned-int8-vec2-nv', 'unsigned-int8-vec3-nv',
'unsigned-int8-vec4-nv', 'unsigned-int16-nv',
'unsigned-int16-vec2-nv', 'unsigned-int16-vec3-nv',
'unsigned-int16-vec4-nv', 'unsigned-int64-vec2-nv',
'unsigned-int64-vec3-nv', 'unsigned-int64-vec4-nv', 'float16-nv',
'float16-vec2-nv', 'float16-vec3-nv', 'float16-vec4-nv'.
-- Macro: accum-op enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'accum', 'load', 'return', 'mult', 'add'.
-- Macro: alpha-function enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'never', 'less', 'equal', 'lequal', 'greater', 'notequal',
'gequal', 'always'.
-- Macro: blending-factor-dest enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'zero', 'one', 'src-color', 'one-minus-src-color', 'src-alpha',
'one-minus-src-alpha', 'dst-alpha', 'one-minus-dst-alpha',
'constant-color-ext', 'one-minus-constant-color-ext',
'constant-alpha-ext', 'one-minus-constant-alpha-ext'.
-- Macro: blending-factor-src enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'zero', 'one', 'dst-color', 'one-minus-dst-color',
'src-alpha-saturate', 'src-alpha', 'one-minus-src-alpha',
'dst-alpha', 'one-minus-dst-alpha', 'constant-color-ext',
'one-minus-constant-color-ext', 'constant-alpha-ext',
'one-minus-constant-alpha-ext'.
-- Macro: blend-equation-mode-ext enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'logic-op', 'func-add-ext', 'min-ext', 'max-ext',
'func-subtract-ext', 'func-reverse-subtract-ext', 'alpha-min-sgix',
'alpha-max-sgix'.
-- Macro: color-material-face enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'front', 'back', 'front-and-back'.
-- Macro: color-material-parameter enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'ambient', 'diffuse', 'specular', 'emission',
'ambient-and-diffuse'.
-- Macro: color-pointer-type enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'byte', 'unsigned-byte', 'short', 'unsigned-short', 'int',
'unsigned-int', 'float', 'double'.
-- Macro: color-table-parameter-p-name-sgi enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'color-table-scale-sgi', 'color-table-bias-sgi'.
-- Macro: color-table-target-sgi enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'color-table-sgi', 'post-convolution-color-table-sgi',
'post-color-matrix-color-table-sgi', 'proxy-color-table-sgi',
'proxy-post-convolution-color-table-sgi',
'proxy-post-color-matrix-color-table-sgi',
'texture-color-table-sgi', 'proxy-texture-color-table-sgi'.
-- Macro: convolution-border-mode-ext enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'reduce-ext'.
-- Macro: convolution-parameter-ext enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'convolution-border-mode-ext', 'convolution-filter-scale-ext',
'convolution-filter-bias-ext'.
-- Macro: convolution-target-ext enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'convolution-1d-ext', 'convolution-2d-ext'.
-- Macro: cull-face-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'front', 'back', 'front-and-back'.
-- Macro: depth-function enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'never', 'less', 'equal', 'lequal', 'greater', 'notequal',
'gequal', 'always'.
-- Macro: draw-buffer-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'none', 'front-left', 'front-right', 'back-left', 'back-right',
'front', 'back', 'left', 'right', 'front-and-back', 'aux0', 'aux1',
'aux2', 'aux3'.
-- Macro: oes-framebuffer-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fog', 'lighting', 'texture-1d', 'texture-2d', 'line-stipple',
'polygon-stipple', 'cull-face', 'alpha-test', 'blend',
'index-logic-op', 'color-logic-op', 'dither', 'stencil-test',
'depth-test', 'clip-plane0', 'clip-plane1', 'clip-plane2',
'clip-plane3', 'clip-plane4', 'clip-plane5', 'light0', 'light1',
'light2', 'light3', 'light4', 'light5', 'light6', 'light7',
'texture-gen-s', 'texture-gen-t', 'texture-gen-r', 'texture-gen-q',
'map1-vertex-3', 'map1-vertex-4', 'map1-color-4', 'map1-index',
'map1-normal', 'map1-texture-coord-1', 'map1-texture-coord-2',
'map1-texture-coord-3', 'map1-texture-coord-4', 'map2-vertex-3',
'map2-vertex-4', 'map2-color-4', 'map2-index', 'map2-normal',
'map2-texture-coord-1', 'map2-texture-coord-2',
'map2-texture-coord-3', 'map2-texture-coord-4', 'point-smooth',
'line-smooth', 'polygon-smooth', 'scissor-test', 'color-material',
'normalize', 'auto-normal', 'polygon-offset-point',
'polygon-offset-line', 'polygon-offset-fill', 'vertex-array',
'normal-array', 'color-array', 'index-array',
'texture-coord-array', 'edge-flag-array', 'convolution-1d-ext',
'convolution-2d-ext', 'separable-2d-ext', 'histogram-ext',
'minmax-ext', 'rescale-normal-ext', 'shared-texture-palette-ext',
'texture-3d-ext', 'multisample-sgis', 'sample-alpha-to-mask-sgis',
'sample-alpha-to-one-sgis', 'sample-mask-sgis', 'texture-4d-sgis',
'async-histogram-sgix', 'async-tex-image-sgix',
'async-draw-pixels-sgix', 'async-read-pixels-sgix',
'calligraphic-fragment-sgix', 'fog-offset-sgix',
'fragment-lighting-sgix', 'fragment-color-material-sgix',
'fragment-light0-sgix', 'fragment-light1-sgix',
'fragment-light2-sgix', 'fragment-light3-sgix',
'fragment-light4-sgix', 'fragment-light5-sgix',
'fragment-light6-sgix', 'fragment-light7-sgix', 'framezoom-sgix',
'interlace-sgix', 'ir-instrument1-sgix', 'pixel-tex-gen-sgix',
'pixel-texture-sgis', 'reference-plane-sgix', 'sprite-sgix',
'color-table-sgi', 'post-convolution-color-table-sgi',
'post-color-matrix-color-table-sgi', 'texture-color-table-sgi',
'invalid-framebuffer-operation-oes', 'rgba4-oes', 'rgb5-a1-oes',
'depth-component16-oes', 'max-renderbuffer-size-oes',
'framebuffer-binding-oes', 'renderbuffer-binding-oes',
'framebuffer-attachment-object-type-oes',
'framebuffer-attachment-object-name-oes',
'framebuffer-attachment-texture-level-oes',
'framebuffer-attachment-texture-cube-map-face-oes',
'framebuffer-attachment-texture-3d-zoffset-oes',
'framebuffer-complete-oes',
'framebuffer-incomplete-attachment-oes',
'framebuffer-incomplete-missing-attachment-oes',
'framebuffer-incomplete-dimensions-oes',
'framebuffer-incomplete-formats-oes',
'framebuffer-incomplete-draw-buffer-oes',
'framebuffer-incomplete-read-buffer-oes',
'framebuffer-unsupported-oes', 'color-attachment0-oes',
'depth-attachment-oes', 'stencil-attachment-oes',
'framebuffer-oes', 'renderbuffer-oes', 'renderbuffer-width-oes',
'renderbuffer-height-oes', 'renderbuffer-internal-format-oes',
'stencil-index1-oes', 'stencil-index4-oes', 'stencil-index8-oes',
'renderbuffer-red-size-oes', 'renderbuffer-green-size-oes',
'renderbuffer-blue-size-oes', 'renderbuffer-alpha-size-oes',
'renderbuffer-depth-size-oes', 'renderbuffer-stencil-size-oes',
'rgb565-oes'.
-- Macro: enable-cap enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fog', 'lighting', 'texture-1d', 'texture-2d', 'line-stipple',
'polygon-stipple', 'cull-face', 'alpha-test', 'blend',
'index-logic-op', 'color-logic-op', 'dither', 'stencil-test',
'depth-test', 'clip-plane0', 'clip-plane1', 'clip-plane2',
'clip-plane3', 'clip-plane4', 'clip-plane5', 'light0', 'light1',
'light2', 'light3', 'light4', 'light5', 'light6', 'light7',
'texture-gen-s', 'texture-gen-t', 'texture-gen-r', 'texture-gen-q',
'map1-vertex-3', 'map1-vertex-4', 'map1-color-4', 'map1-index',
'map1-normal', 'map1-texture-coord-1', 'map1-texture-coord-2',
'map1-texture-coord-3', 'map1-texture-coord-4', 'map2-vertex-3',
'map2-vertex-4', 'map2-color-4', 'map2-index', 'map2-normal',
'map2-texture-coord-1', 'map2-texture-coord-2',
'map2-texture-coord-3', 'map2-texture-coord-4', 'point-smooth',
'line-smooth', 'polygon-smooth', 'scissor-test', 'color-material',
'normalize', 'auto-normal', 'polygon-offset-point',
'polygon-offset-line', 'polygon-offset-fill', 'vertex-array',
'normal-array', 'color-array', 'index-array',
'texture-coord-array', 'edge-flag-array', 'convolution-1d-ext',
'convolution-2d-ext', 'separable-2d-ext', 'histogram-ext',
'minmax-ext', 'rescale-normal-ext', 'shared-texture-palette-ext',
'texture-3d-ext', 'multisample-sgis', 'sample-alpha-to-mask-sgis',
'sample-alpha-to-one-sgis', 'sample-mask-sgis', 'texture-4d-sgis',
'async-histogram-sgix', 'async-tex-image-sgix',
'async-draw-pixels-sgix', 'async-read-pixels-sgix',
'calligraphic-fragment-sgix', 'fog-offset-sgix',
'fragment-lighting-sgix', 'fragment-color-material-sgix',
'fragment-light0-sgix', 'fragment-light1-sgix',
'fragment-light2-sgix', 'fragment-light3-sgix',
'fragment-light4-sgix', 'fragment-light5-sgix',
'fragment-light6-sgix', 'fragment-light7-sgix', 'framezoom-sgix',
'interlace-sgix', 'ir-instrument1-sgix', 'pixel-tex-gen-sgix',
'pixel-texture-sgis', 'reference-plane-sgix', 'sprite-sgix',
'color-table-sgi', 'post-convolution-color-table-sgi',
'post-color-matrix-color-table-sgi', 'texture-color-table-sgi'.
-- Macro: error-code enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'no-error', 'invalid-enum', 'invalid-value', 'invalid-operation',
'stack-overflow', 'stack-underflow', 'out-of-memory',
'table-too-large-ext', 'texture-too-large-ext'.
-- Macro: arb-framebuffer-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'invalid-framebuffer-operation',
'framebuffer-attachment-color-encoding',
'framebuffer-attachment-component-type',
'framebuffer-attachment-red-size',
'framebuffer-attachment-green-size',
'framebuffer-attachment-blue-size',
'framebuffer-attachment-alpha-size',
'framebuffer-attachment-depth-size',
'framebuffer-attachment-stencil-size', 'framebuffer-default',
'framebuffer-undefined', 'depth-stencil-attachment', 'index',
'max-renderbuffer-size', 'depth-stencil', 'unsigned-int-24-8',
'depth24-stencil8', 'texture-stencil-size', 'texture-red-type',
'texture-green-type', 'texture-blue-type', 'texture-alpha-type',
'texture-luminance-type', 'texture-intensity-type',
'texture-depth-type', 'unsigned-normalized', 'framebuffer-binding',
'draw-framebuffer-binding', 'renderbuffer-binding',
'read-framebuffer', 'draw-framebuffer', 'read-framebuffer-binding',
'renderbuffer-samples', 'framebuffer-attachment-object-type',
'framebuffer-attachment-object-type-ext',
'framebuffer-attachment-object-name',
'framebuffer-attachment-object-name-ext',
'framebuffer-attachment-texture-level',
'framebuffer-attachment-texture-level-ext',
'framebuffer-attachment-texture-cube-map-face',
'framebuffer-attachment-texture-cube-map-face-ext',
'framebuffer-attachment-texture-layer',
'framebuffer-attachment-texture-3d-zoffset-ext',
'framebuffer-complete', 'framebuffer-complete-ext',
'framebuffer-incomplete-attachment',
'framebuffer-incomplete-attachment-ext',
'framebuffer-incomplete-missing-attachment',
'framebuffer-incomplete-missing-attachment-ext',
'framebuffer-incomplete-dimensions-ext',
'framebuffer-incomplete-formats-ext',
'framebuffer-incomplete-draw-buffer',
'framebuffer-incomplete-draw-buffer-ext',
'framebuffer-incomplete-read-buffer',
'framebuffer-incomplete-read-buffer-ext',
'framebuffer-unsupported', 'framebuffer-unsupported-ext',
'max-color-attachments', 'max-color-attachments-ext',
'color-attachment0', 'color-attachment0-ext', 'color-attachment1',
'color-attachment1-ext', 'color-attachment2',
'color-attachment2-ext', 'color-attachment3',
'color-attachment3-ext', 'color-attachment4',
'color-attachment4-ext', 'color-attachment5',
'color-attachment5-ext', 'color-attachment6',
'color-attachment6-ext', 'color-attachment7',
'color-attachment7-ext', 'color-attachment8',
'color-attachment8-ext', 'color-attachment9',
'color-attachment9-ext', 'color-attachment10',
'color-attachment10-ext', 'color-attachment11',
'color-attachment11-ext', 'color-attachment12',
'color-attachment12-ext', 'color-attachment13',
'color-attachment13-ext', 'color-attachment14',
'color-attachment14-ext', 'color-attachment15',
'color-attachment15-ext', 'depth-attachment',
'depth-attachment-ext', 'stencil-attachment',
'stencil-attachment-ext', 'framebuffer', 'framebuffer-ext',
'renderbuffer', 'renderbuffer-ext', 'renderbuffer-width',
'renderbuffer-width-ext', 'renderbuffer-height',
'renderbuffer-height-ext', 'renderbuffer-internal-format',
'renderbuffer-internal-format-ext', 'stencil-index1',
'stencil-index1-ext', 'stencil-index4', 'stencil-index4-ext',
'stencil-index8', 'stencil-index8-ext', 'stencil-index16',
'stencil-index16-ext', 'renderbuffer-red-size',
'renderbuffer-red-size-ext', 'renderbuffer-green-size',
'renderbuffer-green-size-ext', 'renderbuffer-blue-size',
'renderbuffer-blue-size-ext', 'renderbuffer-alpha-size',
'renderbuffer-alpha-size-ext', 'renderbuffer-depth-size',
'renderbuffer-depth-size-ext', 'renderbuffer-stencil-size',
'renderbuffer-stencil-size-ext',
'framebuffer-incomplete-multisample', 'max-samples'.
-- Macro: ext-framebuffer-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'invalid-framebuffer-operation-ext', 'max-renderbuffer-size-ext',
'framebuffer-binding-ext', 'renderbuffer-binding-ext',
'framebuffer-attachment-object-type',
'framebuffer-attachment-object-type-ext',
'framebuffer-attachment-object-name',
'framebuffer-attachment-object-name-ext',
'framebuffer-attachment-texture-level',
'framebuffer-attachment-texture-level-ext',
'framebuffer-attachment-texture-cube-map-face',
'framebuffer-attachment-texture-cube-map-face-ext',
'framebuffer-attachment-texture-layer',
'framebuffer-attachment-texture-3d-zoffset-ext',
'framebuffer-complete', 'framebuffer-complete-ext',
'framebuffer-incomplete-attachment',
'framebuffer-incomplete-attachment-ext',
'framebuffer-incomplete-missing-attachment',
'framebuffer-incomplete-missing-attachment-ext',
'framebuffer-incomplete-dimensions-ext',
'framebuffer-incomplete-formats-ext',
'framebuffer-incomplete-draw-buffer',
'framebuffer-incomplete-draw-buffer-ext',
'framebuffer-incomplete-read-buffer',
'framebuffer-incomplete-read-buffer-ext',
'framebuffer-unsupported', 'framebuffer-unsupported-ext',
'max-color-attachments', 'max-color-attachments-ext',
'color-attachment0', 'color-attachment0-ext', 'color-attachment1',
'color-attachment1-ext', 'color-attachment2',
'color-attachment2-ext', 'color-attachment3',
'color-attachment3-ext', 'color-attachment4',
'color-attachment4-ext', 'color-attachment5',
'color-attachment5-ext', 'color-attachment6',
'color-attachment6-ext', 'color-attachment7',
'color-attachment7-ext', 'color-attachment8',
'color-attachment8-ext', 'color-attachment9',
'color-attachment9-ext', 'color-attachment10',
'color-attachment10-ext', 'color-attachment11',
'color-attachment11-ext', 'color-attachment12',
'color-attachment12-ext', 'color-attachment13',
'color-attachment13-ext', 'color-attachment14',
'color-attachment14-ext', 'color-attachment15',
'color-attachment15-ext', 'depth-attachment',
'depth-attachment-ext', 'stencil-attachment',
'stencil-attachment-ext', 'framebuffer', 'framebuffer-ext',
'renderbuffer', 'renderbuffer-ext', 'renderbuffer-width',
'renderbuffer-width-ext', 'renderbuffer-height',
'renderbuffer-height-ext', 'renderbuffer-internal-format',
'renderbuffer-internal-format-ext', 'stencil-index1',
'stencil-index1-ext', 'stencil-index4', 'stencil-index4-ext',
'stencil-index8', 'stencil-index8-ext', 'stencil-index16',
'stencil-index16-ext', 'renderbuffer-red-size',
'renderbuffer-red-size-ext', 'renderbuffer-green-size',
'renderbuffer-green-size-ext', 'renderbuffer-blue-size',
'renderbuffer-blue-size-ext', 'renderbuffer-alpha-size',
'renderbuffer-alpha-size-ext', 'renderbuffer-depth-size',
'renderbuffer-depth-size-ext', 'renderbuffer-stencil-size',
'renderbuffer-stencil-size-ext'.
-- Macro: feedback-type enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'2d', '3d', '3d-color', '3d-color-texture', '4d-color-texture'.
-- Macro: feed-back-token enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pass-through-token', 'point-token', 'line-token', 'polygon-token',
'bitmap-token', 'draw-pixel-token', 'copy-pixel-token',
'line-reset-token'.
-- Macro: ffd-mask-sgix bit...
Bitfield constructor. The symbolic BIT arguments are replaced with
their corresponding numeric values and combined with 'logior' at
compile-time. The symbolic arguments known to this bitfield
constructor are:
'texture-deformation-bit-sgix', 'geometry-deformation-bit-sgix'.
-- Macro: ffd-target-sgix enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'geometry-deformation-sgix', 'texture-deformation-sgix'.
-- Macro: fog-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'linear', 'exp', 'exp2', 'fog-func-sgis'.
-- Macro: fog-parameter enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fog-color', 'fog-density', 'fog-end', 'fog-index', 'fog-mode',
'fog-start', 'fog-offset-value-sgix'.
-- Macro: fragment-light-model-parameter-sgix enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fragment-light-model-local-viewer-sgix',
'fragment-light-model-two-side-sgix',
'fragment-light-model-ambient-sgix',
'fragment-light-model-normal-interpolation-sgix'.
-- Macro: front-face-direction enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'cw', 'ccw'.
-- Macro: get-color-table-parameter-p-name-sgi enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'color-table-scale-sgi', 'color-table-bias-sgi',
'color-table-format-sgi', 'color-table-width-sgi',
'color-table-red-size-sgi', 'color-table-green-size-sgi',
'color-table-blue-size-sgi', 'color-table-alpha-size-sgi',
'color-table-luminance-size-sgi', 'color-table-intensity-size-sgi'.
-- Macro: get-convolution-parameter enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'convolution-border-mode-ext', 'convolution-filter-scale-ext',
'convolution-filter-bias-ext', 'convolution-format-ext',
'convolution-width-ext', 'convolution-height-ext',
'max-convolution-width-ext', 'max-convolution-height-ext'.
-- Macro: get-histogram-parameter-p-name-ext enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'histogram-width-ext', 'histogram-format-ext',
'histogram-red-size-ext', 'histogram-green-size-ext',
'histogram-blue-size-ext', 'histogram-alpha-size-ext',
'histogram-luminance-size-ext', 'histogram-sink-ext'.
-- Macro: get-map-query enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'coeff', 'order', 'domain'.
-- Macro: get-minmax-parameter-p-name-ext enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'minmax-format-ext', 'minmax-sink-ext'.
-- Macro: get-pixel-map enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pixel-map-i-to-i', 'pixel-map-s-to-s', 'pixel-map-i-to-r',
'pixel-map-i-to-g', 'pixel-map-i-to-b', 'pixel-map-i-to-a',
'pixel-map-r-to-r', 'pixel-map-g-to-g', 'pixel-map-b-to-b',
'pixel-map-a-to-a'.
-- Macro: get-pointerv-p-name enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-array-pointer', 'normal-array-pointer',
'color-array-pointer', 'index-array-pointer',
'texture-coord-array-pointer', 'edge-flag-array-pointer',
'feedback-buffer-pointer', 'selection-buffer-pointer',
'instrument-buffer-pointer-sgix'.
-- Macro: get-p-name enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'current-color', 'current-index', 'current-normal',
'current-texture-coords', 'current-raster-color',
'current-raster-index', 'current-raster-texture-coords',
'current-raster-position', 'current-raster-position-valid',
'current-raster-distance', 'point-smooth', 'point-size',
'point-size-range', 'point-size-granularity', 'line-smooth',
'line-width', 'line-width-range', 'line-width-granularity',
'line-stipple', 'line-stipple-pattern', 'line-stipple-repeat',
'smooth-point-size-range', 'smooth-point-size-granularity',
'smooth-line-width-range', 'smooth-line-width-granularity',
'aliased-point-size-range', 'aliased-line-width-range',
'list-mode', 'max-list-nesting', 'list-base', 'list-index',
'polygon-mode', 'polygon-smooth', 'polygon-stipple', 'edge-flag',
'cull-face', 'cull-face-mode', 'front-face', 'lighting',
'light-model-local-viewer', 'light-model-two-side',
'light-model-ambient', 'shade-model', 'color-material-face',
'color-material-parameter', 'color-material', 'fog', 'fog-index',
'fog-density', 'fog-start', 'fog-end', 'fog-mode', 'fog-color',
'depth-range', 'depth-test', 'depth-writemask',
'depth-clear-value', 'depth-func', 'accum-clear-value',
'stencil-test', 'stencil-clear-value', 'stencil-func',
'stencil-value-mask', 'stencil-fail', 'stencil-pass-depth-fail',
'stencil-pass-depth-pass', 'stencil-ref', 'stencil-writemask',
'matrix-mode', 'normalize', 'viewport', 'modelview-stack-depth',
'projection-stack-depth', 'texture-stack-depth',
'modelview-matrix', 'projection-matrix', 'texture-matrix',
'attrib-stack-depth', 'client-attrib-stack-depth', 'alpha-test',
'alpha-test-func', 'alpha-test-ref', 'dither', 'blend-dst',
'blend-src', 'blend', 'logic-op-mode', 'index-logic-op',
'logic-op', 'color-logic-op', 'aux-buffers', 'draw-buffer',
'read-buffer', 'scissor-box', 'scissor-test', 'index-clear-value',
'index-writemask', 'color-clear-value', 'color-writemask',
'index-mode', 'rgba-mode', 'doublebuffer', 'stereo', 'render-mode',
'perspective-correction-hint', 'point-smooth-hint',
'line-smooth-hint', 'polygon-smooth-hint', 'fog-hint',
'texture-gen-s', 'texture-gen-t', 'texture-gen-r', 'texture-gen-q',
'pixel-map-i-to-i-size', 'pixel-map-s-to-s-size',
'pixel-map-i-to-r-size', 'pixel-map-i-to-g-size',
'pixel-map-i-to-b-size', 'pixel-map-i-to-a-size',
'pixel-map-r-to-r-size', 'pixel-map-g-to-g-size',
'pixel-map-b-to-b-size', 'pixel-map-a-to-a-size',
'unpack-swap-bytes', 'unpack-lsb-first', 'unpack-row-length',
'unpack-skip-rows', 'unpack-skip-pixels', 'unpack-alignment',
'pack-swap-bytes', 'pack-lsb-first', 'pack-row-length',
'pack-skip-rows', 'pack-skip-pixels', 'pack-alignment',
'map-color', 'map-stencil', 'index-shift', 'index-offset',
'red-scale', 'red-bias', 'zoom-x', 'zoom-y', 'green-scale',
'green-bias', 'blue-scale', 'blue-bias', 'alpha-scale',
'alpha-bias', 'depth-scale', 'depth-bias', 'max-eval-order',
'max-lights', 'max-clip-distances', 'max-clip-planes',
'max-texture-size', 'max-pixel-map-table',
'max-attrib-stack-depth', 'max-modelview-stack-depth',
'max-name-stack-depth', 'max-projection-stack-depth',
'max-texture-stack-depth', 'max-viewport-dims',
'max-client-attrib-stack-depth', 'subpixel-bits', 'index-bits',
'red-bits', 'green-bits', 'blue-bits', 'alpha-bits', 'depth-bits',
'stencil-bits', 'accum-red-bits', 'accum-green-bits',
'accum-blue-bits', 'accum-alpha-bits', 'name-stack-depth',
'auto-normal', 'map1-color-4', 'map1-index', 'map1-normal',
'map1-texture-coord-1', 'map1-texture-coord-2',
'map1-texture-coord-3', 'map1-texture-coord-4', 'map1-vertex-3',
'map1-vertex-4', 'map2-color-4', 'map2-index', 'map2-normal',
'map2-texture-coord-1', 'map2-texture-coord-2',
'map2-texture-coord-3', 'map2-texture-coord-4', 'map2-vertex-3',
'map2-vertex-4', 'map1-grid-domain', 'map1-grid-segments',
'map2-grid-domain', 'map2-grid-segments', 'texture-1d',
'texture-2d', 'feedback-buffer-size', 'feedback-buffer-type',
'selection-buffer-size', 'polygon-offset-units',
'polygon-offset-point', 'polygon-offset-line',
'polygon-offset-fill', 'polygon-offset-factor',
'texture-binding-1d', 'texture-binding-2d', 'texture-binding-3d',
'vertex-array', 'normal-array', 'color-array', 'index-array',
'texture-coord-array', 'edge-flag-array', 'vertex-array-size',
'vertex-array-type', 'vertex-array-stride', 'normal-array-type',
'normal-array-stride', 'color-array-size', 'color-array-type',
'color-array-stride', 'index-array-type', 'index-array-stride',
'texture-coord-array-size', 'texture-coord-array-type',
'texture-coord-array-stride', 'edge-flag-array-stride',
'clip-plane0', 'clip-plane1', 'clip-plane2', 'clip-plane3',
'clip-plane4', 'clip-plane5', 'light0', 'light1', 'light2',
'light3', 'light4', 'light5', 'light6', 'light7',
'light-model-color-control', 'blend-color-ext',
'blend-equation-ext', 'pack-cmyk-hint-ext', 'unpack-cmyk-hint-ext',
'convolution-1d-ext', 'convolution-2d-ext', 'separable-2d-ext',
'post-convolution-red-scale-ext',
'post-convolution-green-scale-ext',
'post-convolution-blue-scale-ext',
'post-convolution-alpha-scale-ext',
'post-convolution-red-bias-ext', 'post-convolution-green-bias-ext',
'post-convolution-blue-bias-ext',
'post-convolution-alpha-bias-ext', 'histogram-ext', 'minmax-ext',
'polygon-offset-bias-ext', 'rescale-normal-ext',
'shared-texture-palette-ext', 'texture-3d-binding-ext',
'pack-skip-images-ext', 'pack-image-height-ext',
'unpack-skip-images-ext', 'unpack-image-height-ext',
'texture-3d-ext', 'max-3d-texture-size-ext',
'vertex-array-count-ext', 'normal-array-count-ext',
'color-array-count-ext', 'index-array-count-ext',
'texture-coord-array-count-ext', 'edge-flag-array-count-ext',
'detail-texture-2d-binding-sgis', 'fog-func-points-sgis',
'max-fog-func-points-sgis', 'generate-mipmap-hint-sgis',
'multisample-sgis', 'sample-alpha-to-mask-sgis',
'sample-alpha-to-one-sgis', 'sample-mask-sgis',
'sample-buffers-sgis', 'samples-sgis', 'sample-mask-value-sgis',
'sample-mask-invert-sgis', 'sample-pattern-sgis',
'pixel-texture-sgis', 'point-size-min-sgis', 'point-size-max-sgis',
'point-fade-threshold-size-sgis', 'distance-attenuation-sgis',
'pack-skip-volumes-sgis', 'pack-image-depth-sgis',
'unpack-skip-volumes-sgis', 'unpack-image-depth-sgis',
'texture-4d-sgis', 'max-4d-texture-size-sgis',
'texture-4d-binding-sgis', 'async-marker-sgix',
'async-histogram-sgix', 'max-async-histogram-sgix',
'async-tex-image-sgix', 'async-draw-pixels-sgix',
'async-read-pixels-sgix', 'max-async-tex-image-sgix',
'max-async-draw-pixels-sgix', 'max-async-read-pixels-sgix',
'calligraphic-fragment-sgix', 'max-clipmap-virtual-depth-sgix',
'max-clipmap-depth-sgix', 'convolution-hint-sgix',
'fog-offset-sgix', 'fog-offset-value-sgix',
'fragment-lighting-sgix', 'fragment-color-material-sgix',
'fragment-color-material-face-sgix',
'fragment-color-material-parameter-sgix',
'max-fragment-lights-sgix', 'max-active-lights-sgix',
'light-env-mode-sgix', 'fragment-light-model-local-viewer-sgix',
'fragment-light-model-two-side-sgix',
'fragment-light-model-ambient-sgix',
'fragment-light-model-normal-interpolation-sgix',
'fragment-light0-sgix', 'framezoom-sgix', 'framezoom-factor-sgix',
'max-framezoom-factor-sgix', 'instrument-measurements-sgix',
'interlace-sgix', 'ir-instrument1-sgix', 'pixel-tex-gen-sgix',
'pixel-tex-gen-mode-sgix', 'pixel-tile-best-alignment-sgix',
'pixel-tile-cache-increment-sgix', 'pixel-tile-width-sgix',
'pixel-tile-height-sgix', 'pixel-tile-grid-width-sgix',
'pixel-tile-grid-height-sgix', 'pixel-tile-grid-depth-sgix',
'pixel-tile-cache-size-sgix', 'deformations-mask-sgix',
'reference-plane-equation-sgix', 'reference-plane-sgix',
'sprite-sgix', 'sprite-mode-sgix', 'sprite-axis-sgix',
'sprite-translation-sgix', 'pack-subsample-rate-sgix',
'unpack-subsample-rate-sgix', 'pack-resample-sgix',
'unpack-resample-sgix', 'post-texture-filter-bias-range-sgix',
'post-texture-filter-scale-range-sgix', 'vertex-preclip-sgix',
'vertex-preclip-hint-sgix', 'color-matrix-sgi',
'color-matrix-stack-depth-sgi', 'max-color-matrix-stack-depth-sgi',
'post-color-matrix-red-scale-sgi',
'post-color-matrix-green-scale-sgi',
'post-color-matrix-blue-scale-sgi',
'post-color-matrix-alpha-scale-sgi',
'post-color-matrix-red-bias-sgi',
'post-color-matrix-green-bias-sgi',
'post-color-matrix-blue-bias-sgi',
'post-color-matrix-alpha-bias-sgi', 'color-table-sgi',
'post-convolution-color-table-sgi',
'post-color-matrix-color-table-sgi', 'texture-color-table-sgi'.
-- Macro: qcom-alpha-test enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'alpha-test-qcom', 'alpha-test-func-qcom', 'alpha-test-ref-qcom'.
-- Macro: ext-unpack-subimage enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'unpack-row-length', 'unpack-skip-rows', 'unpack-skip-pixels'.
-- Macro: ext-multiview-draw-buffers enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'draw-buffer-ext', 'read-buffer-ext', 'draw-buffer-ext',
'read-buffer-ext', 'color-attachment-ext', 'multiview-ext',
'max-multiview-buffers-ext'.
-- Macro: nv-read-buffer enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'read-buffer-nv'.
-- Macro: get-texture-parameter enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-mag-filter', 'texture-min-filter', 'texture-wrap-s',
'texture-wrap-t', 'texture-width', 'texture-height',
'texture-internal-format', 'texture-components',
'texture-border-color', 'texture-border', 'texture-red-size',
'texture-green-size', 'texture-blue-size', 'texture-alpha-size',
'texture-luminance-size', 'texture-intensity-size',
'texture-priority', 'texture-resident', 'texture-depth-ext',
'texture-wrap-r-ext', 'detail-texture-level-sgis',
'detail-texture-mode-sgis', 'detail-texture-func-points-sgis',
'generate-mipmap-sgis', 'sharpen-texture-func-points-sgis',
'texture-filter4-size-sgis', 'texture-min-lod-sgis',
'texture-max-lod-sgis', 'texture-base-level-sgis',
'texture-max-level-sgis', 'dual-texture-select-sgis',
'quad-texture-select-sgis', 'texture-4dsize-sgis',
'texture-wrap-q-sgis', 'texture-clipmap-center-sgix',
'texture-clipmap-frame-sgix', 'texture-clipmap-offset-sgix',
'texture-clipmap-virtual-depth-sgix',
'texture-clipmap-lod-offset-sgix', 'texture-clipmap-depth-sgix',
'texture-compare-sgix', 'texture-compare-operator-sgix',
'texture-lequal-r-sgix', 'texture-gequal-r-sgix',
'shadow-ambient-sgix', 'texture-max-clamp-s-sgix',
'texture-max-clamp-t-sgix', 'texture-max-clamp-r-sgix',
'texture-lod-bias-s-sgix', 'texture-lod-bias-t-sgix',
'texture-lod-bias-r-sgix', 'post-texture-filter-bias-sgix',
'post-texture-filter-scale-sgix'.
-- Macro: nv-texture-border-clamp enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-border-color-nv', 'clamp-to-border-nv'.
-- Macro: hint-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'dont-care', 'fastest', 'nicest'.
-- Macro: hint-target enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'perspective-correction-hint', 'point-smooth-hint',
'line-smooth-hint', 'polygon-smooth-hint', 'fog-hint',
'pack-cmyk-hint-ext', 'unpack-cmyk-hint-ext',
'generate-mipmap-hint-sgis', 'convolution-hint-sgix',
'texture-multi-buffer-hint-sgix', 'vertex-preclip-hint-sgix'.
-- Macro: histogram-target-ext enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'histogram-ext', 'proxy-histogram-ext'.
-- Macro: index-pointer-type enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'short', 'int', 'float', 'double'.
-- Macro: light-env-mode-sgix enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'replace', 'modulate', 'add'.
-- Macro: light-env-parameter-sgix enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'light-env-mode-sgix'.
-- Macro: light-model-color-control enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'single-color', 'separate-specular-color'.
-- Macro: light-model-parameter enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'light-model-ambient', 'light-model-local-viewer',
'light-model-two-side', 'light-model-color-control'.
-- Macro: light-parameter enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'ambient', 'diffuse', 'specular', 'position', 'spot-direction',
'spot-exponent', 'spot-cutoff', 'constant-attenuation',
'linear-attenuation', 'quadratic-attenuation'.
-- Macro: list-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compile', 'compile-and-execute'.
-- Macro: data-type enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'byte', 'unsigned-byte', 'short', 'unsigned-short', 'int',
'unsigned-int', 'float', '2-bytes', '3-bytes', '4-bytes', 'double',
'double-ext'.
-- Macro: oes-element-index-uint bit...
Bitfield constructor. The symbolic BIT arguments are replaced with
their corresponding numeric values and combined with 'logior' at
compile-time. The symbolic arguments known to this bitfield
constructor are:
.
-- Macro: oes-texture-float enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'half-float-oes'.
-- Macro: ext-vertex-attrib-64-bit enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'double-mat2-ext', 'double-mat3-ext', 'double-mat4-ext',
'double-mat-2x-3-ext', 'double-mat-2x-4-ext',
'double-mat-3x-2-ext', 'double-mat-3x-4-ext',
'double-mat-4x-2-ext', 'double-mat-4x-3-ext', 'double-vec2-ext',
'double-vec3-ext', 'double-vec4-ext'.
-- Macro: arb-half-float-vertex enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'half-float'.
-- Macro: arb-half-float-pixel enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'half-float-arb'.
-- Macro: nv-half-float enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'half-float-nv'.
-- Macro: apple-float-pixels enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'half-apple', 'rgba-float32-apple', 'rgb-float32-apple',
'alpha-float32-apple', 'intensity-float32-apple',
'luminance-float32-apple', 'luminance-alpha-float32-apple',
'rgba-float16-apple', 'rgb-float16-apple', 'alpha-float16-apple',
'intensity-float16-apple', 'luminance-float16-apple',
'luminance-alpha-float16-apple', 'color-float-apple'.
-- Macro: arb-es2-compatibility enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fixed', 'implementation-color-read-type',
'implementation-color-read-format', 'rgb565', 'low-float',
'medium-float', 'high-float', 'low-int', 'medium-int', 'high-int',
'shader-binary-formats', 'num-shader-binary-formats',
'shader-compiler', 'max-vertex-uniform-vectors',
'max-varying-vectors', 'max-fragment-uniform-vectors'.
-- Macro: oes-fixed-point enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fixed-oes'.
-- Macro: nv-vertex-attrib-integer-64-bit enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'int64-nv', 'unsigned-int64-nv'.
-- Macro: list-name-type enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'byte', 'unsigned-byte', 'short', 'unsigned-short', 'int',
'unsigned-int', 'float', '2-bytes', '3-bytes', '4-bytes'.
-- Macro: list-parameter-name enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'list-priority-sgix'.
-- Macro: logic-op enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'clear', 'and', 'and-reverse', 'copy', 'and-inverted', 'noop',
'xor', 'or', 'nor', 'equiv', 'invert', 'or-reverse',
'copy-inverted', 'or-inverted', 'nand', 'set'.
-- Macro: map-target enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'map1-color-4', 'map1-index', 'map1-normal',
'map1-texture-coord-1', 'map1-texture-coord-2',
'map1-texture-coord-3', 'map1-texture-coord-4', 'map1-vertex-3',
'map1-vertex-4', 'map2-color-4', 'map2-index', 'map2-normal',
'map2-texture-coord-1', 'map2-texture-coord-2',
'map2-texture-coord-3', 'map2-texture-coord-4', 'map2-vertex-3',
'map2-vertex-4', 'geometry-deformation-sgix',
'texture-deformation-sgix'.
-- Macro: material-face enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'front', 'back', 'front-and-back'.
-- Macro: material-parameter enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'emission', 'shininess', 'ambient-and-diffuse', 'color-indexes',
'ambient', 'diffuse', 'specular'.
-- Macro: matrix-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'modelview', 'projection', 'texture'.
-- Macro: mesh-mode-1 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'point', 'line'.
-- Macro: mesh-mode-2 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'point', 'line', 'fill'.
-- Macro: minmax-target-ext enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'minmax-ext'.
-- Macro: normal-pointer-type enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'byte', 'short', 'int', 'float', 'double'.
-- Macro: pixel-copy-type enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'color', 'depth', 'stencil'.
-- Macro: ext-discard-framebuffer enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'color-ext', 'depth-ext', 'stencil-ext'.
-- Macro: pixel-format enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'color-index', 'stencil-index', 'depth-component', 'red', 'green',
'blue', 'alpha', 'rgb', 'rgba', 'luminance', 'luminance-alpha',
'abgr-ext', 'cmyk-ext', 'cmyka-ext', 'ycrcb-422-sgix',
'ycrcb-444-sgix'.
-- Macro: oes-depth-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'red-ext'.
-- Macro: ext-texture-rg enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'red-ext', 'rg-ext', 'r8-ext', 'rg8-ext'.
-- Macro: pixel-map enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pixel-map-i-to-i', 'pixel-map-s-to-s', 'pixel-map-i-to-r',
'pixel-map-i-to-g', 'pixel-map-i-to-b', 'pixel-map-i-to-a',
'pixel-map-r-to-r', 'pixel-map-g-to-g', 'pixel-map-b-to-b',
'pixel-map-a-to-a'.
-- Macro: pixel-store-parameter enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'unpack-swap-bytes', 'unpack-lsb-first', 'unpack-row-length',
'unpack-skip-rows', 'unpack-skip-pixels', 'unpack-alignment',
'pack-swap-bytes', 'pack-lsb-first', 'pack-row-length',
'pack-skip-rows', 'pack-skip-pixels', 'pack-alignment',
'pack-skip-images-ext', 'pack-image-height-ext',
'unpack-skip-images-ext', 'unpack-image-height-ext',
'pack-skip-volumes-sgis', 'pack-image-depth-sgis',
'unpack-skip-volumes-sgis', 'unpack-image-depth-sgis',
'pixel-tile-width-sgix', 'pixel-tile-height-sgix',
'pixel-tile-grid-width-sgix', 'pixel-tile-grid-height-sgix',
'pixel-tile-grid-depth-sgix', 'pixel-tile-cache-size-sgix',
'pack-subsample-rate-sgix', 'unpack-subsample-rate-sgix',
'pack-resample-sgix', 'unpack-resample-sgix'.
-- Macro: pixel-store-resample-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'resample-replicate-sgix', 'resample-zero-fill-sgix',
'resample-decimate-sgix'.
-- Macro: pixel-store-subsample-rate enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pixel-subsample-4444-sgix', 'pixel-subsample-2424-sgix',
'pixel-subsample-4242-sgix'.
-- Macro: pixel-tex-gen-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'none', 'rgb', 'rgba', 'luminance', 'luminance-alpha',
'pixel-tex-gen-alpha-replace-sgix',
'pixel-tex-gen-alpha-no-replace-sgix',
'pixel-tex-gen-alpha-ms-sgix', 'pixel-tex-gen-alpha-ls-sgix'.
-- Macro: pixel-tex-gen-parameter-name-sgis enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pixel-fragment-rgb-source-sgis',
'pixel-fragment-alpha-source-sgis'.
-- Macro: pixel-transfer-parameter enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'map-color', 'map-stencil', 'index-shift', 'index-offset',
'red-scale', 'red-bias', 'green-scale', 'green-bias', 'blue-scale',
'blue-bias', 'alpha-scale', 'alpha-bias', 'depth-scale',
'depth-bias', 'post-convolution-red-scale-ext',
'post-convolution-green-scale-ext',
'post-convolution-blue-scale-ext',
'post-convolution-alpha-scale-ext',
'post-convolution-red-bias-ext', 'post-convolution-green-bias-ext',
'post-convolution-blue-bias-ext',
'post-convolution-alpha-bias-ext',
'post-color-matrix-red-scale-sgi',
'post-color-matrix-green-scale-sgi',
'post-color-matrix-blue-scale-sgi',
'post-color-matrix-alpha-scale-sgi',
'post-color-matrix-red-bias-sgi',
'post-color-matrix-green-bias-sgi',
'post-color-matrix-blue-bias-sgi',
'post-color-matrix-alpha-bias-sgi'.
-- Macro: pixel-type enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'bitmap', 'byte', 'unsigned-byte', 'short', 'unsigned-short',
'int', 'unsigned-int', 'float', 'unsigned-byte-3-3-2-ext',
'unsigned-short-4-4-4-4-ext', 'unsigned-short-5-5-5-1-ext',
'unsigned-int-8-8-8-8-ext', 'unsigned-int-10-10-10-2-ext'.
-- Macro: point-parameter-name-sgis enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'point-size-min-sgis', 'point-size-max-sgis',
'point-fade-threshold-size-sgis', 'distance-attenuation-sgis'.
-- Macro: polygon-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'point', 'line', 'fill'.
-- Macro: read-buffer-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'front-left', 'front-right', 'back-left', 'back-right', 'front',
'back', 'left', 'right', 'aux0', 'aux1', 'aux2', 'aux3'.
-- Macro: rendering-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'render', 'feedback', 'select'.
-- Macro: sample-pattern-sgis enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'1pass-sgis', '2pass-0-sgis', '2pass-1-sgis', '4pass-0-sgis',
'4pass-1-sgis', '4pass-2-sgis', '4pass-3-sgis'.
-- Macro: separable-target-ext enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'separable-2d-ext'.
-- Macro: shading-model enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'flat', 'smooth'.
-- Macro: stencil-function enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'never', 'less', 'equal', 'lequal', 'greater', 'notequal',
'gequal', 'always'.
-- Macro: stencil-op enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'zero', 'keep', 'replace', 'incr', 'decr', 'invert'.
-- Macro: string-name enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vendor', 'renderer', 'version', 'extensions'.
-- Macro: tex-coord-pointer-type enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'short', 'int', 'float', 'double'.
-- Macro: texture-coord-name enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
's', 't', 'r', 'q'.
-- Macro: texture-env-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'modulate', 'decal', 'blend', 'replace-ext', 'add',
'texture-env-bias-sgix'.
-- Macro: texture-env-parameter enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-env-mode', 'texture-env-color'.
-- Macro: texture-env-target enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-env'.
-- Macro: texture-filter-func-sgis enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'filter4-sgis'.
-- Macro: texture-gen-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'eye-linear', 'object-linear', 'sphere-map',
'eye-distance-to-point-sgis', 'object-distance-to-point-sgis',
'eye-distance-to-line-sgis', 'object-distance-to-line-sgis'.
-- Macro: texture-gen-parameter enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-gen-mode', 'object-plane', 'eye-plane', 'eye-point-sgis',
'object-point-sgis', 'eye-line-sgis', 'object-line-sgis'.
-- Macro: oes-texture-cube-map enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-gen-mode', 'normal-map-oes', 'reflection-map-oes',
'texture-cube-map-oes', 'texture-binding-cube-map-oes',
'texture-cube-map-positive-x-oes',
'texture-cube-map-negative-x-oes',
'texture-cube-map-positive-y-oes',
'texture-cube-map-negative-y-oes',
'texture-cube-map-positive-z-oes',
'texture-cube-map-negative-z-oes', 'max-cube-map-texture-size-oes',
'texture-gen-str-oes'.
-- Macro: texture-mag-filter enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'nearest', 'linear', 'linear-detail-sgis',
'linear-detail-alpha-sgis', 'linear-detail-color-sgis',
'linear-sharpen-sgis', 'linear-sharpen-alpha-sgis',
'linear-sharpen-color-sgis', 'filter4-sgis',
'pixel-tex-gen-q-ceiling-sgix', 'pixel-tex-gen-q-round-sgix',
'pixel-tex-gen-q-floor-sgix'.
-- Macro: texture-min-filter enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'nearest', 'linear', 'nearest-mipmap-nearest',
'linear-mipmap-nearest', 'nearest-mipmap-linear',
'linear-mipmap-linear', 'filter4-sgis',
'linear-clipmap-linear-sgix', 'nearest-clipmap-nearest-sgix',
'nearest-clipmap-linear-sgix', 'linear-clipmap-nearest-sgix',
'pixel-tex-gen-q-ceiling-sgix', 'pixel-tex-gen-q-round-sgix',
'pixel-tex-gen-q-floor-sgix'.
-- Macro: texture-parameter-name enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-mag-filter', 'texture-min-filter', 'texture-wrap-s',
'texture-wrap-t', 'texture-border-color', 'texture-priority',
'texture-wrap-r-ext', 'detail-texture-level-sgis',
'detail-texture-mode-sgis', 'generate-mipmap-sgis',
'dual-texture-select-sgis', 'quad-texture-select-sgis',
'texture-wrap-q-sgis', 'texture-clipmap-center-sgix',
'texture-clipmap-frame-sgix', 'texture-clipmap-offset-sgix',
'texture-clipmap-virtual-depth-sgix',
'texture-clipmap-lod-offset-sgix', 'texture-clipmap-depth-sgix',
'texture-compare-sgix', 'texture-compare-operator-sgix',
'shadow-ambient-sgix', 'texture-max-clamp-s-sgix',
'texture-max-clamp-t-sgix', 'texture-max-clamp-r-sgix',
'texture-lod-bias-s-sgix', 'texture-lod-bias-t-sgix',
'texture-lod-bias-r-sgix', 'post-texture-filter-bias-sgix',
'post-texture-filter-scale-sgix'.
-- Macro: texture-target enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-1d', 'texture-2d', 'proxy-texture-1d', 'proxy-texture-2d',
'texture-3d-ext', 'proxy-texture-3d-ext', 'detail-texture-2d-sgis',
'texture-4d-sgis', 'proxy-texture-4d-sgis', 'texture-min-lod-sgis',
'texture-max-lod-sgis', 'texture-base-level-sgis',
'texture-max-level-sgis'.
-- Macro: texture-wrap-mode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'clamp', 'repeat', 'clamp-to-border-sgis', 'clamp-to-edge-sgis'.
-- Macro: pixel-internal-format enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'r3-g3-b2', 'alpha4', 'alpha8', 'alpha12', 'alpha16', 'luminance4',
'luminance8', 'luminance12', 'luminance16', 'luminance4-alpha4',
'luminance6-alpha2', 'luminance8-alpha8', 'luminance12-alpha4',
'luminance12-alpha12', 'luminance16-alpha16', 'intensity',
'intensity4', 'intensity8', 'intensity12', 'intensity16', 'rgb4',
'rgb5', 'rgb8', 'rgb10', 'rgb12', 'rgb16', 'rgba2', 'rgba4',
'rgb5-a1', 'rgba8', 'rgb10-a2', 'rgba12', 'rgba16', 'rgb2-ext',
'dual-alpha4-sgis', 'dual-alpha8-sgis', 'dual-alpha12-sgis',
'dual-alpha16-sgis', 'dual-luminance4-sgis',
'dual-luminance8-sgis', 'dual-luminance12-sgis',
'dual-luminance16-sgis', 'dual-intensity4-sgis',
'dual-intensity8-sgis', 'dual-intensity12-sgis',
'dual-intensity16-sgis', 'dual-luminance-alpha4-sgis',
'dual-luminance-alpha8-sgis', 'quad-alpha4-sgis',
'quad-alpha8-sgis', 'quad-luminance4-sgis', 'quad-luminance8-sgis',
'quad-intensity4-sgis', 'quad-intensity8-sgis',
'depth-component16-sgix', 'depth-component24-sgix',
'depth-component32-sgix'.
-- Macro: oes-rgb-8-rgba-8 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'rgb8', 'rgba8'.
-- Macro: interleaved-array-format enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'v2f', 'v3f', 'c4ub-v2f', 'c4ub-v3f', 'c3f-v3f', 'n3f-v3f',
'c4f-n3f-v3f', 't2f-v3f', 't4f-v4f', 't2f-c4ub-v3f', 't2f-c3f-v3f',
't2f-n3f-v3f', 't2f-c4f-n3f-v3f', 't4f-c4f-n3f-v4f'.
-- Macro: vertex-pointer-type enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'short', 'int', 'float', 'double'.
-- Macro: clip-plane-name enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'clip-plane0', 'clip-plane1', 'clip-plane2', 'clip-plane3',
'clip-plane4', 'clip-plane5'.
-- Macro: light-name enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'light0', 'light1', 'light2', 'light3', 'light4', 'light5',
'light6', 'light7', 'fragment-light0-sgix', 'fragment-light1-sgix',
'fragment-light2-sgix', 'fragment-light3-sgix',
'fragment-light4-sgix', 'fragment-light5-sgix',
'fragment-light6-sgix', 'fragment-light7-sgix'.
-- Macro: ext-abgr enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'abgr-ext'.
-- Macro: version-1-2 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'constant-color', 'one-minus-constant-color', 'constant-alpha',
'one-minus-constant-alpha', 'blend-color', 'func-add',
'func-add-ext', 'min', 'min-ext', 'max', 'max-ext',
'blend-equation', 'blend-equation-ext', 'func-subtract',
'func-subtract-ext', 'func-reverse-subtract',
'func-reverse-subtract-ext', 'convolution-1d', 'convolution-2d',
'separable-2d', 'convolution-border-mode',
'convolution-filter-scale', 'convolution-filter-bias', 'reduce',
'convolution-format', 'convolution-width', 'convolution-height',
'max-convolution-width', 'max-convolution-height',
'post-convolution-red-scale', 'post-convolution-green-scale',
'post-convolution-blue-scale', 'post-convolution-alpha-scale',
'post-convolution-red-bias', 'post-convolution-green-bias',
'post-convolution-blue-bias', 'post-convolution-alpha-bias',
'histogram', 'proxy-histogram', 'histogram-width',
'histogram-format', 'histogram-red-size', 'histogram-green-size',
'histogram-blue-size', 'histogram-alpha-size', 'histogram-sink',
'minmax', 'minmax-format', 'minmax-sink', 'table-too-large',
'unsigned-byte-3-3-2', 'unsigned-short-4-4-4-4',
'unsigned-short-5-5-5-1', 'unsigned-int-8-8-8-8',
'unsigned-int-10-10-10-2', 'unsigned-byte-2-3-3-rev',
'unsigned-short-5-6-5', 'unsigned-short-5-6-5-rev',
'unsigned-short-4-4-4-4-rev', 'unsigned-short-1-5-5-5-rev',
'unsigned-int-8-8-8-8-rev', 'unsigned-int-2-10-10-10-rev',
'rescale-normal', 'pack-skip-images', 'pack-image-height',
'unpack-skip-images', 'unpack-image-height', 'texture-3d',
'proxy-texture-3d', 'texture-depth', 'texture-wrap-r',
'max-3d-texture-size', 'color-matrix', 'color-matrix-stack-depth',
'max-color-matrix-stack-depth', 'post-color-matrix-red-scale',
'post-color-matrix-green-scale', 'post-color-matrix-blue-scale',
'post-color-matrix-alpha-scale', 'post-color-matrix-red-bias',
'post-color-matrix-green-bias', 'post-color-matrix-blue-bias',
'post-color-matrix-alpha-bias', 'color-table',
'post-convolution-color-table', 'post-color-matrix-color-table',
'proxy-color-table', 'proxy-post-convolution-color-table',
'proxy-post-color-matrix-color-table', 'color-table-scale',
'color-table-bias', 'color-table-format', 'color-table-width',
'color-table-red-size', 'color-table-green-size',
'color-table-blue-size', 'color-table-alpha-size',
'color-table-luminance-size', 'color-table-intensity-size', 'bgr',
'bgra', 'max-elements-vertices', 'max-elements-indices',
'clamp-to-edge', 'texture-min-lod', 'texture-max-lod',
'texture-base-level', 'texture-max-level', 'constant-border',
'replicate-border', 'convolution-border-color',
'light-model-color-control', 'single-color',
'separate-specular-color', 'smooth-point-size-range',
'smooth-point-size-granularity', 'smooth-line-width-range',
'smooth-line-width-granularity', 'aliased-point-size-range',
'aliased-line-width-range'.
-- Macro: ext-blend-color enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'constant-color-ext', 'one-minus-constant-color-ext',
'constant-alpha-ext', 'one-minus-constant-alpha-ext',
'blend-color-ext'.
-- Macro: ext-blend-minmax enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'func-add', 'func-add-ext', 'min', 'min-ext', 'max', 'max-ext',
'blend-equation', 'blend-equation-ext'.
-- Macro: version-2-0 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'blend-equation-rgb', 'vertex-attrib-array-enabled',
'vertex-attrib-array-size', 'vertex-attrib-array-stride',
'vertex-attrib-array-type', 'current-vertex-attrib',
'vertex-program-point-size', 'vertex-program-two-side',
'vertex-attrib-array-pointer', 'stencil-back-func',
'stencil-back-fail', 'stencil-back-pass-depth-fail',
'stencil-back-pass-depth-pass', 'stencil-back-fail-ati',
'max-draw-buffers', 'draw-buffer0', 'draw-buffer1', 'draw-buffer2',
'draw-buffer3', 'draw-buffer4', 'draw-buffer5', 'draw-buffer6',
'draw-buffer7', 'draw-buffer8', 'draw-buffer9', 'draw-buffer10',
'draw-buffer11', 'draw-buffer12', 'draw-buffer13', 'draw-buffer14',
'draw-buffer15', 'blend-equation-alpha', 'point-sprite',
'coord-replace', 'max-vertex-attribs',
'vertex-attrib-array-normalized', 'max-texture-coords',
'max-texture-image-units', 'fragment-shader',
'fragment-shader-arb', 'vertex-shader', 'vertex-shader-arb',
'program-object-arb', 'shader-object-arb',
'max-fragment-uniform-components',
'max-fragment-uniform-components-arb',
'max-vertex-uniform-components',
'max-vertex-uniform-components-arb', 'max-varying-floats',
'max-varying-floats-arb', 'max-vertex-texture-image-units',
'max-vertex-texture-image-units-arb',
'max-combined-texture-image-units',
'max-combined-texture-image-units-arb', 'object-type-arb',
'shader-type', 'object-subtype-arb', 'float-vec2',
'float-vec2-arb', 'float-vec3', 'float-vec3-arb', 'float-vec4',
'float-vec4-arb', 'int-vec2', 'int-vec2-arb', 'int-vec3',
'int-vec3-arb', 'int-vec4', 'int-vec4-arb', 'bool', 'bool-arb',
'bool-vec2', 'bool-vec2-arb', 'bool-vec3', 'bool-vec3-arb',
'bool-vec4', 'bool-vec4-arb', 'float-mat2', 'float-mat2-arb',
'float-mat3', 'float-mat3-arb', 'float-mat4', 'float-mat4-arb',
'sampler-1d', 'sampler-1d-arb', 'sampler-2d', 'sampler-2d-arb',
'sampler-3d', 'sampler-3d-arb', 'sampler-cube', 'sampler-cube-arb',
'sampler-1d-shadow', 'sampler-1d-shadow-arb', 'sampler-2d-shadow',
'sampler-2d-shadow-arb', 'sampler-2d-rect-arb',
'sampler-2d-rect-shadow-arb', 'float-mat-2x-3', 'float-mat-2x-4',
'float-mat-3x-2', 'float-mat-3x-4', 'float-mat-4x-2',
'float-mat-4x-3', 'delete-status', 'object-delete-status-arb',
'compile-status', 'object-compile-status-arb', 'link-status',
'object-link-status-arb', 'validate-status',
'object-validate-status-arb', 'info-log-length',
'object-info-log-length-arb', 'attached-shaders',
'object-attached-objects-arb', 'active-uniforms',
'object-active-uniforms-arb', 'active-uniform-max-length',
'object-active-uniform-max-length-arb', 'shader-source-length',
'object-shader-source-length-arb', 'active-attributes',
'object-active-attributes-arb', 'active-attribute-max-length',
'object-active-attribute-max-length-arb',
'fragment-shader-derivative-hint',
'fragment-shader-derivative-hint-arb', 'shading-language-version',
'shading-language-version-arb', 'current-program',
'point-sprite-coord-origin', 'lower-left', 'upper-left',
'stencil-back-ref', 'stencil-back-value-mask',
'stencil-back-writemask'.
-- Macro: ext-blend-equation-separate enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'blend-equation-rgb-ext', 'blend-equation-alpha-ext'.
-- Macro: oes-blend-equation-separate enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'blend-equation-rgb-oes', 'blend-equation-alpha-oes'.
-- Macro: ext-blend-subtract enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'func-subtract', 'func-subtract-ext', 'func-reverse-subtract',
'func-reverse-subtract-ext'.
-- Macro: oes-blend-subtract enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'func-add-oes', 'blend-equation-oes', 'func-subtract-oes',
'func-reverse-subtract-oes'.
-- Macro: ext-cmyka enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'cmyk-ext', 'cmyka-ext', 'pack-cmyk-hint-ext',
'unpack-cmyk-hint-ext'.
-- Macro: ext-convolution enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'convolution-1d-ext', 'convolution-2d-ext', 'separable-2d-ext',
'convolution-border-mode-ext', 'convolution-filter-scale-ext',
'convolution-filter-bias-ext', 'reduce-ext',
'convolution-format-ext', 'convolution-width-ext',
'convolution-height-ext', 'max-convolution-width-ext',
'max-convolution-height-ext', 'post-convolution-red-scale-ext',
'post-convolution-green-scale-ext',
'post-convolution-blue-scale-ext',
'post-convolution-alpha-scale-ext',
'post-convolution-red-bias-ext', 'post-convolution-green-bias-ext',
'post-convolution-blue-bias-ext',
'post-convolution-alpha-bias-ext'.
-- Macro: ext-histogram enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'histogram-ext', 'proxy-histogram-ext', 'histogram-width-ext',
'histogram-format-ext', 'histogram-red-size-ext',
'histogram-green-size-ext', 'histogram-blue-size-ext',
'histogram-alpha-size-ext', 'histogram-luminance-size',
'histogram-luminance-size-ext', 'histogram-sink-ext', 'minmax-ext',
'minmax-format-ext', 'minmax-sink-ext', 'table-too-large-ext'.
-- Macro: ext-packed-pixels enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'unsigned-byte-3-3-2-ext', 'unsigned-short-4-4-4-4-ext',
'unsigned-short-5-5-5-1-ext', 'unsigned-int-8-8-8-8-ext',
'unsigned-int-10-10-10-2-ext', 'unsigned-byte-2-3-3-rev-ext',
'unsigned-short-5-6-5-ext', 'unsigned-short-5-6-5-rev-ext',
'unsigned-short-4-4-4-4-rev-ext', 'unsigned-short-1-5-5-5-rev-ext',
'unsigned-int-8-8-8-8-rev-ext', 'unsigned-int-2-10-10-10-rev-ext'.
-- Macro: ext-texture-type-2-10-10-10-rev enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'polygon-offset-ext', 'polygon-offset-factor-ext',
'polygon-offset-bias-ext'.
-- Macro: ext-polygon-offset enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'polygon-offset-ext', 'polygon-offset-factor-ext',
'polygon-offset-bias-ext'.
-- Macro: ext-rescale-normal enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'rescale-normal-ext'.
-- Macro: ext-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'alpha4-ext', 'alpha8-ext', 'alpha12-ext', 'alpha16-ext',
'luminance4-ext', 'luminance8-ext', 'luminance12-ext',
'luminance16-ext', 'luminance4-alpha4-ext',
'luminance6-alpha2-ext', 'luminance8-alpha8-ext',
'luminance12-alpha4-ext', 'luminance12-alpha12-ext',
'luminance16-alpha16-ext', 'intensity-ext', 'intensity4-ext',
'intensity8-ext', 'intensity12-ext', 'intensity16-ext', 'rgb2-ext',
'rgb4-ext', 'rgb5-ext', 'rgb8-ext', 'rgb10-ext', 'rgb12-ext',
'rgb16-ext', 'rgba2-ext', 'rgba4-ext', 'rgb5-a1-ext', 'rgba8-ext',
'rgb10-a2-ext', 'rgba12-ext', 'rgba16-ext', 'texture-red-size-ext',
'texture-green-size-ext', 'texture-blue-size-ext',
'texture-alpha-size-ext', 'texture-luminance-size-ext',
'texture-intensity-size-ext', 'replace-ext',
'proxy-texture-1d-ext', 'proxy-texture-2d-ext',
'texture-too-large-ext'.
-- Macro: ext-texture-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-priority-ext', 'texture-resident-ext',
'texture-1d-binding-ext', 'texture-2d-binding-ext',
'texture-3d-binding-ext'.
-- Macro: ext-texture-3d enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pack-skip-images-ext', 'pack-image-height-ext',
'unpack-skip-images-ext', 'unpack-image-height-ext',
'texture-3d-ext', 'proxy-texture-3d-ext', 'texture-depth-ext',
'texture-wrap-r-ext', 'max-3d-texture-size-ext'.
-- Macro: oes-texture-3d enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-3d-binding-oes', 'texture-3d-oes', 'texture-wrap-r-oes',
'max-3d-texture-size-oes', 'sampler-3d-oes',
'framebuffer-attachment-texture-3d-zoffset-oes'.
-- Macro: ext-vertex-array enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-array-ext', 'normal-array-ext', 'color-array-ext',
'index-array-ext', 'texture-coord-array-ext',
'edge-flag-array-ext', 'vertex-array-size-ext',
'vertex-array-type-ext', 'vertex-array-stride-ext',
'vertex-array-count-ext', 'normal-array-type-ext',
'normal-array-stride-ext', 'normal-array-count-ext',
'color-array-size-ext', 'color-array-type-ext',
'color-array-stride-ext', 'color-array-count-ext',
'index-array-type-ext', 'index-array-stride-ext',
'index-array-count-ext', 'texture-coord-array-size-ext',
'texture-coord-array-type-ext', 'texture-coord-array-stride-ext',
'texture-coord-array-count-ext', 'edge-flag-array-stride-ext',
'edge-flag-array-count-ext', 'vertex-array-pointer-ext',
'normal-array-pointer-ext', 'color-array-pointer-ext',
'index-array-pointer-ext', 'texture-coord-array-pointer-ext',
'edge-flag-array-pointer-ext'.
-- Macro: sgix-interlace enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'interlace-sgix'.
-- Macro: sgis-detail-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'detail-texture-2d-sgis', 'detail-texture-2d-binding-sgis',
'linear-detail-sgis', 'linear-detail-alpha-sgis',
'linear-detail-color-sgis', 'detail-texture-level-sgis',
'detail-texture-mode-sgis', 'detail-texture-func-points-sgis'.
-- Macro: sgis-multisample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'multisample-sgis', 'sample-alpha-to-mask-sgis',
'sample-alpha-to-one-sgis', 'sample-mask-sgis', '1pass-sgis',
'2pass-0-sgis', '2pass-1-sgis', '4pass-0-sgis', '4pass-1-sgis',
'4pass-2-sgis', '4pass-3-sgis', 'sample-buffers-sgis',
'samples-sgis', 'sample-mask-value-sgis',
'sample-mask-invert-sgis', 'sample-pattern-sgis'.
-- Macro: nv-multisample-coverage enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'coverage-samples-nv', 'color-samples-nv'.
-- Macro: sgis-sharpen-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'linear-sharpen-sgis', 'linear-sharpen-alpha-sgis',
'linear-sharpen-color-sgis', 'sharpen-texture-func-points-sgis'.
-- Macro: sgi-color-matrix enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'color-matrix-sgi', 'color-matrix-stack-depth-sgi',
'max-color-matrix-stack-depth-sgi',
'post-color-matrix-red-scale-sgi',
'post-color-matrix-green-scale-sgi',
'post-color-matrix-blue-scale-sgi',
'post-color-matrix-alpha-scale-sgi',
'post-color-matrix-red-bias-sgi',
'post-color-matrix-green-bias-sgi',
'post-color-matrix-blue-bias-sgi',
'post-color-matrix-alpha-bias-sgi'.
-- Macro: sgi-texture-color-table enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-color-table-sgi', 'proxy-texture-color-table-sgi'.
-- Macro: sgix-texture-add-env enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-env-bias-sgix'.
-- Macro: sgix-shadow-ambient enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'shadow-ambient-sgix'.
-- Macro: version-1-4 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'blend-dst-rgb', 'blend-src-rgb', 'blend-dst-alpha',
'blend-src-alpha', 'point-size-min', 'point-size-max',
'point-fade-threshold-size', 'point-distance-attenuation',
'generate-mipmap', 'generate-mipmap-hint', 'depth-component16',
'depth-component24', 'depth-component32', 'mirrored-repeat',
'fog-coordinate-source', 'fog-coordinate', 'fragment-depth',
'current-fog-coordinate', 'fog-coordinate-array-type',
'fog-coordinate-array-stride', 'fog-coordinate-array-pointer',
'fog-coordinate-array', 'color-sum', 'current-secondary-color',
'secondary-color-array-size', 'secondary-color-array-type',
'secondary-color-array-stride', 'secondary-color-array-pointer',
'secondary-color-array', 'max-texture-lod-bias',
'texture-filter-control', 'texture-lod-bias', 'incr-wrap',
'decr-wrap', 'texture-depth-size', 'depth-texture-mode',
'texture-compare-mode', 'texture-compare-func',
'compare-r-to-texture'.
-- Macro: ext-blend-func-separate enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'blend-dst-rgb-ext', 'blend-src-rgb-ext', 'blend-dst-alpha-ext',
'blend-src-alpha-ext'.
-- Macro: oes-blend-func-separate enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'blend-dst-rgb-oes', 'blend-src-rgb-oes', 'blend-dst-alpha-oes',
'blend-src-alpha-oes'.
-- Macro: ext-422-pixels enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'422-ext', '422-rev-ext', '422-average-ext', '422-rev-average-ext'.
-- Macro: sgi-color-table enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'color-table-sgi', 'post-convolution-color-table-sgi',
'post-color-matrix-color-table-sgi', 'proxy-color-table-sgi',
'proxy-post-convolution-color-table-sgi',
'proxy-post-color-matrix-color-table-sgi', 'color-table-scale-sgi',
'color-table-bias-sgi', 'color-table-format-sgi',
'color-table-width-sgi', 'color-table-red-size-sgi',
'color-table-green-size-sgi', 'color-table-blue-size-sgi',
'color-table-alpha-size-sgi', 'color-table-luminance-size-sgi',
'color-table-intensity-size-sgi'.
-- Macro: arb-vertex-array-bgra enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'bgr-ext', 'bgra-ext'.
-- Macro: ext-bgra enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'bgr-ext', 'bgra-ext'.
-- Macro: sgis-texture-select enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'dual-alpha4-sgis', 'dual-alpha8-sgis', 'dual-alpha12-sgis',
'dual-alpha16-sgis', 'dual-luminance4-sgis',
'dual-luminance8-sgis', 'dual-luminance12-sgis',
'dual-luminance16-sgis', 'dual-intensity4-sgis',
'dual-intensity8-sgis', 'dual-intensity12-sgis',
'dual-intensity16-sgis', 'dual-luminance-alpha4-sgis',
'dual-luminance-alpha8-sgis', 'quad-alpha4-sgis',
'quad-alpha8-sgis', 'quad-luminance4-sgis', 'quad-luminance8-sgis',
'quad-intensity4-sgis', 'quad-intensity8-sgis',
'dual-texture-select-sgis', 'quad-texture-select-sgis'.
-- Macro: arb-point-parameters enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'point-size-min-arb', 'point-size-max-arb',
'point-fade-threshold-size-arb', 'point-distance-attenuation-arb'.
-- Macro: ext-point-parameters enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'point-size-min-ext', 'point-size-max-ext',
'point-fade-threshold-size-ext', 'distance-attenuation-ext'.
-- Macro: sgis-point-parameters enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'point-size-min-sgis', 'point-size-max-sgis',
'point-fade-threshold-size-sgis', 'distance-attenuation-sgis'.
-- Macro: sgis-fog-function enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fog-func-sgis', 'fog-func-points-sgis',
'max-fog-func-points-sgis'.
-- Macro: arb-texture-border-clamp enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'clamp-to-border-arb'.
-- Macro: sgis-texture-border-clamp enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'clamp-to-border-sgis'.
-- Macro: sgix-texture-multi-buffer enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-multi-buffer-hint-sgix'.
-- Macro: sgis-texture-edge-clamp enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'clamp-to-edge-sgis'.
-- Macro: sgis-texture-4d enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pack-skip-volumes-sgis', 'pack-image-depth-sgis',
'unpack-skip-volumes-sgis', 'unpack-image-depth-sgis',
'texture-4d-sgis', 'proxy-texture-4d-sgis', 'texture-4dsize-sgis',
'texture-wrap-q-sgis', 'max-4d-texture-size-sgis',
'texture-4d-binding-sgis'.
-- Macro: sgix-pixel-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pixel-tex-gen-sgix', 'pixel-tex-gen-mode-sgix'.
-- Macro: sgis-texture-lod enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-min-lod-sgis', 'texture-max-lod-sgis',
'texture-base-level-sgis', 'texture-max-level-sgis'.
-- Macro: sgix-pixel-tiles enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pixel-tile-best-alignment-sgix',
'pixel-tile-cache-increment-sgix', 'pixel-tile-width-sgix',
'pixel-tile-height-sgix', 'pixel-tile-grid-width-sgix',
'pixel-tile-grid-height-sgix', 'pixel-tile-grid-depth-sgix',
'pixel-tile-cache-size-sgix'.
-- Macro: sgis-texture-filter-4 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'filter4-sgis', 'texture-filter4-size-sgis'.
-- Macro: sgix-sprite enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sprite-sgix', 'sprite-mode-sgix', 'sprite-axis-sgix',
'sprite-translation-sgix', 'sprite-axial-sgix',
'sprite-object-aligned-sgix', 'sprite-eye-aligned-sgix'.
-- Macro: hp-convolution-border-modes enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'ignore-border-hp', 'constant-border-hp', 'replicate-border-hp',
'convolution-border-color-hp'.
-- Macro: sgix-clipmap enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'linear-clipmap-linear-sgix', 'texture-clipmap-center-sgix',
'texture-clipmap-frame-sgix', 'texture-clipmap-offset-sgix',
'texture-clipmap-virtual-depth-sgix',
'texture-clipmap-lod-offset-sgix', 'texture-clipmap-depth-sgix',
'max-clipmap-depth-sgix', 'max-clipmap-virtual-depth-sgix',
'nearest-clipmap-nearest-sgix', 'nearest-clipmap-linear-sgix',
'linear-clipmap-nearest-sgix'.
-- Macro: sgix-texture-scale-bias enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'post-texture-filter-bias-sgix', 'post-texture-filter-scale-sgix',
'post-texture-filter-bias-range-sgix',
'post-texture-filter-scale-range-sgix'.
-- Macro: sgix-reference-plane enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'reference-plane-sgix', 'reference-plane-equation-sgix'.
-- Macro: sgix-ir-instrument-1 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'ir-instrument1-sgix'.
-- Macro: sgix-instruments enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'instrument-buffer-pointer-sgix', 'instrument-measurements-sgix'.
-- Macro: sgix-list-priority enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'list-priority-sgix'.
-- Macro: sgix-calligraphic-fragment enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'calligraphic-fragment-sgix'.
-- Macro: sgix-impact-pixel-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pixel-tex-gen-q-ceiling-sgix', 'pixel-tex-gen-q-round-sgix',
'pixel-tex-gen-q-floor-sgix', 'pixel-tex-gen-alpha-replace-sgix',
'pixel-tex-gen-alpha-no-replace-sgix',
'pixel-tex-gen-alpha-ls-sgix', 'pixel-tex-gen-alpha-ms-sgix'.
-- Macro: sgix-framezoom enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'framezoom-sgix', 'framezoom-factor-sgix',
'max-framezoom-factor-sgix'.
-- Macro: sgix-texture-lod-bias enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-lod-bias-s-sgix', 'texture-lod-bias-t-sgix',
'texture-lod-bias-r-sgix'.
-- Macro: sgis-generate-mipmap enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'generate-mipmap-sgis', 'generate-mipmap-hint-sgis'.
-- Macro: sgix-polynomial-ffd enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'geometry-deformation-sgix', 'texture-deformation-sgix',
'deformations-mask-sgix', 'max-deformation-order-sgix'.
-- Macro: sgix-fog-offset enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fog-offset-sgix', 'fog-offset-value-sgix'.
-- Macro: sgix-shadow enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-compare-sgix', 'texture-compare-operator-sgix',
'texture-lequal-r-sgix', 'texture-gequal-r-sgix'.
-- Macro: arb-depth-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-component16-arb', 'depth-component24-arb',
'depth-component32-arb', 'texture-depth-size-arb',
'depth-texture-mode-arb'.
-- Macro: sgix-depth-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-component16-sgix', 'depth-component24-sgix',
'depth-component32-sgix'.
-- Macro: oes-depth-24 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-component24-oes'.
-- Macro: oes-depth-32 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-component32-oes'.
-- Macro: ext-compiled-vertex-array enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'array-element-lock-first-ext', 'array-element-lock-count-ext'.
-- Macro: ext-cull-vertex enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'cull-vertex-ext', 'cull-vertex-eye-position-ext',
'cull-vertex-object-position-ext'.
-- Macro: ext-index-array-formats enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'iui-v2f-ext', 'iui-v3f-ext', 'iui-n3f-v2f-ext', 'iui-n3f-v3f-ext',
't2f-iui-v2f-ext', 't2f-iui-v3f-ext', 't2f-iui-n3f-v2f-ext',
't2f-iui-n3f-v3f-ext'.
-- Macro: ext-index-func enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'index-test-ext', 'index-test-func-ext', 'index-test-ref-ext'.
-- Macro: ext-index-material enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'index-material-ext', 'index-material-parameter-ext',
'index-material-face-ext'.
-- Macro: sgix-ycrcb enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'ycrcb-422-sgix', 'ycrcb-444-sgix'.
-- Macro: sunx-general-triangle-list enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'restart-sun', 'replace-middle-sun', 'replace-oldest-sun',
'wrap-border-sun', 'triangle-list-sun', 'replacement-code-sun',
'replacement-code-array-sun', 'replacement-code-array-type-sun',
'replacement-code-array-stride-sun',
'replacement-code-array-pointer-sun', 'r1ui-v3f-sun',
'r1ui-c4ub-v3f-sun', 'r1ui-c3f-v3f-sun', 'r1ui-n3f-v3f-sun',
'r1ui-c4f-n3f-v3f-sun', 'r1ui-t2f-v3f-sun', 'r1ui-t2f-n3f-v3f-sun',
'r1ui-t2f-c4f-n3f-v3f-sun'.
-- Macro: sunx-constant-data enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'unpack-constant-data-sunx', 'texture-constant-data-sunx'.
-- Macro: sun-global-alpha enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'global-alpha-sun', 'global-alpha-factor-sun'.
-- Macro: sgis-texture-color-mask enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-color-writemask-sgis'.
-- Macro: sgis-point-line-texgen enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'eye-distance-to-point-sgis', 'object-distance-to-point-sgis',
'eye-distance-to-line-sgis', 'object-distance-to-line-sgis',
'eye-point-sgis', 'object-point-sgis', 'eye-line-sgis',
'object-line-sgis'.
-- Macro: ext-separate-specular-color enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'light-model-color-control-ext', 'single-color-ext',
'separate-specular-color-ext'.
-- Macro: ext-shared-texture-palette enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'shared-texture-palette-ext'.
-- Macro: ati-text-fragment-shader enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'text-fragment-shader-ati'.
-- Macro: ext-color-buffer-half-float enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'framebuffer-attachment-component-type-ext', 'r16f-ext',
'rg16f-ext', 'rgba16f-ext', 'rgb16f-ext',
'unsigned-normalized-ext'.
-- Macro: oes-surfaceless-context enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'framebuffer-undefined-oes'.
-- Macro: arb-texture-rg enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'rg', 'rg-integer', 'r8', 'r16', 'rg8', 'rg16', 'r16f', 'r32f',
'rg16f', 'rg32f', 'r8i', 'r8ui', 'r16i', 'r16ui', 'r32i', 'r32ui',
'rg8i', 'rg8ui', 'rg16i', 'rg16ui', 'rg32i', 'rg32ui'.
-- Macro: arb-cl-event enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sync-cl-event-arb', 'sync-cl-event-complete-arb'.
-- Macro: arb-debug-output enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'debug-output-synchronous-arb',
'debug-next-logged-message-length-arb',
'debug-callback-function-arb', 'debug-callback-user-param-arb',
'debug-source-api-arb', 'debug-source-window-system-arb',
'debug-source-shader-compiler-arb', 'debug-source-third-party-arb',
'debug-source-application-arb', 'debug-source-other-arb',
'debug-type-error-arb', 'debug-type-deprecated-behavior-arb',
'debug-type-undefined-behavior-arb', 'debug-type-portability-arb',
'debug-type-performance-arb', 'debug-type-other-arb',
'max-debug-message-length-arb', 'max-debug-logged-messages-arb',
'debug-logged-messages-arb', 'debug-severity-high-arb',
'debug-severity-medium-arb', 'debug-severity-low-arb'.
-- Macro: arb-get-program-binary enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'program-binary-retrievable-hint', 'program-binary-length',
'num-program-binary-formats', 'program-binary-formats'.
-- Macro: arb-viewport-array enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-viewports', 'viewport-subpixel-bits', 'viewport-bounds-range',
'layer-provoking-vertex', 'viewport-index-provoking-vertex',
'undefined-vertex', 'first-vertex-convention',
'last-vertex-convention', 'provoking-vertex'.
-- Macro: arb-explicit-uniform-location enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-uniform-locations'.
-- Macro: arb-internalformat-query-2 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'internalformat-supported', 'internalformat-preferred',
'internalformat-red-size', 'internalformat-green-size',
'internalformat-blue-size', 'internalformat-alpha-size',
'internalformat-depth-size', 'internalformat-stencil-size',
'internalformat-shared-size', 'internalformat-red-type',
'internalformat-green-type', 'internalformat-blue-type',
'internalformat-alpha-type', 'internalformat-depth-type',
'internalformat-stencil-type', 'max-width', 'max-height',
'max-depth', 'max-layers', 'max-combined-dimensions',
'color-components', 'depth-components', 'stencil-components',
'color-renderable', 'depth-renderable', 'stencil-renderable',
'framebuffer-renderable', 'framebuffer-renderable-layered',
'framebuffer-blend', 'read-pixels', 'read-pixels-format',
'read-pixels-type', 'texture-image-format', 'texture-image-type',
'get-texture-image-format', 'get-texture-image-type', 'mipmap',
'manual-generate-mipmap', 'auto-generate-mipmap', 'color-encoding',
'srgb-read', 'srgb-write', 'srgb-decode-arb', 'filter',
'vertex-texture', 'tess-control-texture',
'tess-evaluation-texture', 'geometry-texture', 'fragment-texture',
'compute-texture', 'texture-shadow', 'texture-gather',
'texture-gather-shadow', 'shader-image-load', 'shader-image-store',
'shader-image-atomic', 'image-texel-size',
'image-compatibility-class', 'image-pixel-format',
'image-pixel-type', 'simultaneous-texture-and-depth-test',
'simultaneous-texture-and-stencil-test',
'simultaneous-texture-and-depth-write',
'simultaneous-texture-and-stencil-write',
'texture-compressed-block-width',
'texture-compressed-block-height', 'texture-compressed-block-size',
'clear-buffer', 'texture-view', 'view-compatibility-class',
'full-support', 'caveat-support', 'image-class-4-x-32',
'image-class-2-x-32', 'image-class-1-x-32', 'image-class-4-x-16',
'image-class-2-x-16', 'image-class-1-x-16', 'image-class-4-x-8',
'image-class-2-x-8', 'image-class-1-x-8', 'image-class-11-11-10',
'image-class-10-10-10-2', 'view-class-128-bits',
'view-class-96-bits', 'view-class-64-bits', 'view-class-48-bits',
'view-class-32-bits', 'view-class-24-bits', 'view-class-16-bits',
'view-class-8-bits', 'view-class-s3tc-dxt1-rgb',
'view-class-s3tc-dxt1-rgba', 'view-class-s3tc-dxt3-rgba',
'view-class-s3tc-dxt5-rgba', 'view-class-rgtc1-red',
'view-class-rgtc2-rg', 'view-class-bptc-unorm',
'view-class-bptc-float'.
-- Macro: arb-vertex-attrib-binding enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-attrib-binding', 'vertex-attrib-relative-offset',
'vertex-binding-divisor', 'vertex-binding-offset',
'vertex-binding-stride', 'max-vertex-attrib-relative-offset',
'max-vertex-attrib-bindings'.
-- Macro: arb-texture-view enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-view-min-level', 'texture-view-num-levels',
'texture-view-min-layer', 'texture-view-num-layers',
'texture-immutable-levels'.
-- Macro: sgix-depth-pass-instrument enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-pass-instrument-sgix',
'depth-pass-instrument-counters-sgix',
'depth-pass-instrument-max-sgix'.
-- Macro: sgix-fragments-instrument enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fragments-instrument-sgix', 'fragments-instrument-counters-sgix',
'fragments-instrument-max-sgix'.
-- Macro: sgix-convolution-accuracy enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'convolution-hint-sgix'.
-- Macro: sgix-ycrcba enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'ycrcb-sgix', 'ycrcba-sgix'.
-- Macro: sgix-slim enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'unpack-compressed-size-sgix', 'pack-max-compressed-size-sgix',
'pack-compressed-size-sgix', 'slim8u-sgix', 'slim10u-sgix',
'slim12s-sgix'.
-- Macro: sgix-blend-alpha-minmax enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'alpha-min-sgix', 'alpha-max-sgix'.
-- Macro: sgix-scalebias-hint enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'scalebias-hint-sgix'.
-- Macro: sgix-async enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'async-marker-sgix'.
-- Macro: sgix-async-histogram enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'async-histogram-sgix', 'max-async-histogram-sgix'.
-- Macro: ext-pixel-transform enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pixel-transform-2d-ext', 'pixel-mag-filter-ext',
'pixel-min-filter-ext', 'pixel-cubic-weight-ext', 'cubic-ext',
'average-ext', 'pixel-transform-2d-stack-depth-ext',
'max-pixel-transform-2d-stack-depth-ext',
'pixel-transform-2d-matrix-ext'.
-- Macro: ext-light-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fragment-material-ext', 'fragment-normal-ext',
'fragment-color-ext', 'attenuation-ext', 'shadow-attenuation-ext',
'texture-application-mode-ext', 'texture-light-ext',
'texture-material-face-ext', 'texture-material-parameter-ext',
'fragment-depth-ext'.
-- Macro: sgis-pixel-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pixel-texture-sgis', 'pixel-fragment-rgb-source-sgis',
'pixel-fragment-alpha-source-sgis', 'pixel-group-color-sgis'.
-- Macro: sgix-line-quality-hint enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'line-quality-hint-sgix'.
-- Macro: sgix-async-pixel enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'async-tex-image-sgix', 'async-draw-pixels-sgix',
'async-read-pixels-sgix', 'max-async-tex-image-sgix',
'max-async-draw-pixels-sgix', 'max-async-read-pixels-sgix'.
-- Macro: sgix-texture-coordinate-clamp enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-max-clamp-s-sgix', 'texture-max-clamp-t-sgix',
'texture-max-clamp-r-sgix', 'fog-factor-to-alpha-sgix'.
-- Macro: arb-texture-mirrored-repeat enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'mirrored-repeat-arb'.
-- Macro: ibm-texture-mirrored-repeat enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'mirrored-repeat-ibm'.
-- Macro: oes-texture-mirrored-repeat enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'mirrored-repeat-oes'.
-- Macro: s3-s-3-tc enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'rgb-s3tc', 'rgb4-s3tc', 'rgba-s3tc', 'rgba4-s3tc',
'rgba-dxt5-s3tc', 'rgba4-dxt5-s3tc'.
-- Macro: sgix-vertex-preclip enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-preclip-sgix', 'vertex-preclip-hint-sgix'.
-- Macro: ext-texture-compression-s-3-tc enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compressed-rgb-s3tc-dxt1-ext', 'compressed-rgba-s3tc-dxt1-ext',
'compressed-rgba-s3tc-dxt3-ext', 'compressed-rgba-s3tc-dxt5-ext'.
-- Macro: angle-texture-compression-dxt-3 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compressed-rgba-s3tc-dxt3-angle'.
-- Macro: angle-texture-compression-dxt-5 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compressed-rgba-s3tc-dxt5-angle'.
-- Macro: intel-parallel-arrays enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'parallel-arrays-intel', 'vertex-array-parallel-pointers-intel',
'normal-array-parallel-pointers-intel',
'color-array-parallel-pointers-intel',
'texture-coord-array-parallel-pointers-intel'.
-- Macro: sgix-fragment-lighting enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fragment-lighting-sgix', 'fragment-color-material-sgix',
'fragment-color-material-face-sgix',
'fragment-color-material-parameter-sgix',
'max-fragment-lights-sgix', 'max-active-lights-sgix',
'current-raster-normal-sgix', 'light-env-mode-sgix',
'fragment-light-model-local-viewer-sgix',
'fragment-light-model-two-side-sgix',
'fragment-light-model-ambient-sgix',
'fragment-light-model-normal-interpolation-sgix',
'fragment-light0-sgix', 'fragment-light1-sgix',
'fragment-light2-sgix', 'fragment-light3-sgix',
'fragment-light4-sgix', 'fragment-light5-sgix',
'fragment-light6-sgix', 'fragment-light7-sgix'.
-- Macro: sgix-resample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pack-resample-sgix', 'unpack-resample-sgix',
'resample-replicate-sgix', 'resample-zero-fill-sgix',
'resample-decimate-sgix'.
-- Macro: version-1-5 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fog-coord-src', 'fog-coord', 'current-fog-coord',
'fog-coord-array-type', 'fog-coord-array-stride',
'fog-coord-array-pointer', 'fog-coord-array', 'src0-rgb',
'src1-rgb', 'src2-rgb', 'src0-alpha', 'src1-alpha', 'src2-alpha',
'buffer-size', 'buffer-usage', 'query-counter-bits',
'current-query', 'query-result', 'query-result-available',
'array-buffer', 'element-array-buffer', 'array-buffer-binding',
'element-array-buffer-binding', 'vertex-array-buffer-binding',
'normal-array-buffer-binding', 'color-array-buffer-binding',
'index-array-buffer-binding', 'texture-coord-array-buffer-binding',
'edge-flag-array-buffer-binding',
'secondary-color-array-buffer-binding',
'fog-coord-array-buffer-binding',
'fog-coordinate-array-buffer-binding',
'weight-array-buffer-binding',
'vertex-attrib-array-buffer-binding', 'read-only', 'write-only',
'read-write', 'buffer-access', 'buffer-mapped',
'buffer-map-pointer', 'stream-draw', 'stream-read', 'stream-copy',
'static-draw', 'static-read', 'static-copy', 'dynamic-draw',
'dynamic-read', 'dynamic-copy', 'samples-passed'.
-- Macro: ext-fog-coord enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fog-coordinate-source-ext', 'fog-coordinate-ext',
'fragment-depth-ext', 'current-fog-coordinate-ext',
'fog-coordinate-array-type-ext', 'fog-coordinate-array-stride-ext',
'fog-coordinate-array-pointer-ext', 'fog-coordinate-array-ext'.
-- Macro: ext-secondary-color enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'color-sum-ext', 'current-secondary-color-ext',
'secondary-color-array-size-ext', 'secondary-color-array-type-ext',
'secondary-color-array-stride-ext',
'secondary-color-array-pointer-ext', 'secondary-color-array-ext'.
-- Macro: arb-vertex-program enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'color-sum-arb', 'vertex-program-arb',
'vertex-attrib-array-enabled-arb', 'vertex-attrib-array-size-arb',
'vertex-attrib-array-stride-arb', 'vertex-attrib-array-type-arb',
'current-vertex-attrib-arb', 'program-length-arb',
'program-string-arb', 'max-program-matrix-stack-depth-arb',
'max-program-matrices-arb', 'current-matrix-stack-depth-arb',
'current-matrix-arb', 'vertex-program-point-size-arb',
'vertex-program-two-side-arb', 'vertex-attrib-array-pointer-arb',
'program-error-position-arb', 'program-binding-arb',
'max-vertex-attribs-arb', 'vertex-attrib-array-normalized-arb',
'max-texture-coords-arb', 'max-texture-image-units-arb',
'program-error-string-arb', 'program-format-ascii-arb',
'program-format-arb', 'program-instructions-arb',
'max-program-instructions-arb', 'program-native-instructions-arb',
'max-program-native-instructions-arb', 'program-temporaries-arb',
'max-program-temporaries-arb', 'program-native-temporaries-arb',
'max-program-native-temporaries-arb', 'program-parameters-arb',
'max-program-parameters-arb', 'program-native-parameters-arb',
'max-program-native-parameters-arb', 'program-attribs-arb',
'max-program-attribs-arb', 'program-native-attribs-arb',
'max-program-native-attribs-arb', 'program-address-registers-arb',
'max-program-address-registers-arb',
'program-native-address-registers-arb',
'max-program-native-address-registers-arb',
'max-program-local-parameters-arb',
'max-program-env-parameters-arb',
'program-under-native-limits-arb', 'transpose-current-matrix-arb',
'matrix0-arb', 'matrix1-arb', 'matrix2-arb', 'matrix3-arb',
'matrix4-arb', 'matrix5-arb', 'matrix6-arb', 'matrix7-arb',
'matrix8-arb', 'matrix9-arb', 'matrix10-arb', 'matrix11-arb',
'matrix12-arb', 'matrix13-arb', 'matrix14-arb', 'matrix15-arb',
'matrix16-arb', 'matrix17-arb', 'matrix18-arb', 'matrix19-arb',
'matrix20-arb', 'matrix21-arb', 'matrix22-arb', 'matrix23-arb',
'matrix24-arb', 'matrix25-arb', 'matrix26-arb', 'matrix27-arb',
'matrix28-arb', 'matrix29-arb', 'matrix30-arb', 'matrix31-arb'.
-- Macro: version-2-1 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'current-raster-secondary-color', 'pixel-pack-buffer',
'pixel-unpack-buffer', 'pixel-pack-buffer-binding',
'pixel-unpack-buffer-binding', 'srgb', 'srgb8', 'srgb-alpha',
'srgb8-alpha8', 'sluminance-alpha', 'sluminance8-alpha8',
'sluminance', 'sluminance8', 'compressed-srgb',
'compressed-srgb-alpha', 'compressed-sluminance',
'compressed-sluminance-alpha'.
-- Macro: sgix-icc-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'smooth-point-size-range', 'smooth-point-size-granularity',
'smooth-line-width-range', 'smooth-line-width-granularity',
'aliased-point-size-range', 'aliased-line-width-range'.
-- Macro: rend-screen-coordinates enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'screen-coordinates-rend', 'inverted-screen-w-rend'.
-- Macro: arb-multitexture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture0-arb', 'texture1-arb', 'texture2-arb', 'texture3-arb',
'texture4-arb', 'texture5-arb', 'texture6-arb', 'texture7-arb',
'texture8-arb', 'texture9-arb', 'texture10-arb', 'texture11-arb',
'texture12-arb', 'texture13-arb', 'texture14-arb', 'texture15-arb',
'texture16-arb', 'texture17-arb', 'texture18-arb', 'texture19-arb',
'texture20-arb', 'texture21-arb', 'texture22-arb', 'texture23-arb',
'texture24-arb', 'texture25-arb', 'texture26-arb', 'texture27-arb',
'texture28-arb', 'texture29-arb', 'texture30-arb', 'texture31-arb',
'active-texture-arb', 'client-active-texture-arb',
'max-texture-units-arb'.
-- Macro: oes-texture-env-crossbar enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture0', 'texture1', 'texture2', 'texture3', 'texture4',
'texture5', 'texture6', 'texture7', 'texture8', 'texture9',
'texture10', 'texture11', 'texture12', 'texture13', 'texture14',
'texture15', 'texture16', 'texture17', 'texture18', 'texture19',
'texture20', 'texture21', 'texture22', 'texture23', 'texture24',
'texture25', 'texture26', 'texture27', 'texture28', 'texture29',
'texture30', 'texture31'.
-- Macro: arb-transpose-matrix enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'transpose-modelview-matrix-arb',
'transpose-projection-matrix-arb', 'transpose-texture-matrix-arb',
'transpose-color-matrix-arb'.
-- Macro: arb-texture-env-combine enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'subtract-arb'.
-- Macro: arb-texture-compression enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compressed-alpha-arb', 'compressed-luminance-arb',
'compressed-luminance-alpha-arb', 'compressed-intensity-arb',
'compressed-rgb-arb', 'compressed-rgba-arb',
'texture-compression-hint-arb',
'texture-compressed-image-size-arb', 'texture-compressed-arb',
'num-compressed-texture-formats-arb',
'compressed-texture-formats-arb'.
-- Macro: nv-fence enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'all-completed-nv', 'fence-status-nv', 'fence-condition-nv'.
-- Macro: version-3-1 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-rectangle', 'texture-binding-rectangle',
'proxy-texture-rectangle', 'max-rectangle-texture-size',
'uniform-buffer', 'uniform-buffer-binding', 'uniform-buffer-start',
'uniform-buffer-size', 'max-vertex-uniform-blocks',
'max-geometry-uniform-blocks', 'max-fragment-uniform-blocks',
'max-combined-uniform-blocks', 'max-uniform-buffer-bindings',
'max-uniform-block-size', 'max-combined-vertex-uniform-components',
'max-combined-geometry-uniform-components',
'max-combined-fragment-uniform-components',
'uniform-buffer-offset-alignment',
'active-uniform-block-max-name-length', 'active-uniform-blocks',
'uniform-type', 'uniform-size', 'uniform-name-length',
'uniform-block-index', 'uniform-offset', 'uniform-array-stride',
'uniform-matrix-stride', 'uniform-is-row-major',
'uniform-block-binding', 'uniform-block-data-size',
'uniform-block-name-length', 'uniform-block-active-uniforms',
'uniform-block-active-uniform-indices',
'uniform-block-referenced-by-vertex-shader',
'uniform-block-referenced-by-geometry-shader',
'uniform-block-referenced-by-fragment-shader', 'invalid-index',
'sampler-2d-rect', 'sampler-2d-rect-shadow', 'texture-buffer',
'max-texture-buffer-size', 'texture-binding-buffer',
'texture-buffer-data-store-binding', 'sampler-buffer',
'int-sampler-2d-rect', 'int-sampler-buffer',
'unsigned-int-sampler-2d-rect', 'unsigned-int-sampler-buffer',
'copy-read-buffer', 'copy-write-buffer', 'red-snorm', 'rg-snorm',
'rgb-snorm', 'rgba-snorm', 'r8-snorm', 'rg8-snorm', 'rgb8-snorm',
'rgba8-snorm', 'r16-snorm', 'rg16-snorm', 'rgb16-snorm',
'rgba16-snorm', 'signed-normalized', 'primitive-restart',
'primitive-restart-index'.
-- Macro: arb-texture-rectangle enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-rectangle-arb', 'texture-binding-rectangle-arb',
'proxy-texture-rectangle-arb', 'max-rectangle-texture-size-arb'.
-- Macro: nv-texture-rectangle enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-rectangle-nv', 'texture-binding-rectangle-nv',
'proxy-texture-rectangle-nv', 'max-rectangle-texture-size-nv'.
-- Macro: ext-packed-depth-stencil enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-stencil-ext', 'unsigned-int-24-8-ext',
'depth24-stencil8-ext', 'texture-stencil-size-ext'.
-- Macro: nv-packed-depth-stencil enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-stencil-nv', 'unsigned-int-24-8-nv'.
-- Macro: oes-packed-depth-stencil enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-stencil-oes', 'unsigned-int-24-8-oes',
'depth24-stencil8-oes'.
-- Macro: ext-texture-lod-bias enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-texture-lod-bias-ext', 'texture-filter-control-ext',
'texture-lod-bias-ext'.
-- Macro: ext-texture-filter-anisotropic enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-max-anisotropy-ext', 'max-texture-max-anisotropy-ext'.
-- Macro: ext-vertex-weighting enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'modelview1-stack-depth-ext', 'modelview-matrix1-ext',
'vertex-weighting-ext', 'modelview1-ext',
'current-vertex-weight-ext', 'vertex-weight-array-ext',
'vertex-weight-array-size-ext', 'vertex-weight-array-type-ext',
'vertex-weight-array-stride-ext',
'vertex-weight-array-pointer-ext'.
-- Macro: nv-light-max-exponent enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-shininess-nv', 'max-spot-exponent-nv'.
-- Macro: ext-stencil-wrap enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'incr-wrap-ext', 'decr-wrap-ext'.
-- Macro: oes-stencil-wrap enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'incr-wrap-oes', 'decr-wrap-oes'.
-- Macro: ext-texture-cube-map enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'normal-map-ext', 'reflection-map-ext', 'texture-cube-map-ext',
'texture-binding-cube-map-ext', 'texture-cube-map-positive-x-ext',
'texture-cube-map-negative-x-ext',
'texture-cube-map-positive-y-ext',
'texture-cube-map-negative-y-ext',
'texture-cube-map-positive-z-ext',
'texture-cube-map-negative-z-ext', 'proxy-texture-cube-map-ext',
'max-cube-map-texture-size-ext'.
-- Macro: nv-texgen-reflection enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'normal-map', 'reflection-map'.
-- Macro: arb-texture-cube-map enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'normal-map-arb', 'reflection-map-arb', 'texture-cube-map-arb',
'texture-binding-cube-map-arb', 'texture-cube-map-positive-x-arb',
'texture-cube-map-negative-x-arb',
'texture-cube-map-positive-y-arb',
'texture-cube-map-negative-y-arb',
'texture-cube-map-positive-z-arb',
'texture-cube-map-negative-z-arb', 'proxy-texture-cube-map-arb',
'max-cube-map-texture-size-arb'.
-- Macro: nv-vertex-array-range enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-array-range-nv', 'vertex-array-range-length-nv',
'vertex-array-range-valid-nv', 'max-vertex-array-range-element-nv',
'vertex-array-range-pointer-nv'.
-- Macro: apple-vertex-array-range enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-array-range-apple', 'vertex-array-range-length-apple',
'vertex-array-storage-hint-apple',
'vertex-array-range-pointer-apple', 'storage-client-apple',
'storage-cached-apple', 'storage-shared-apple'.
-- Macro: nv-register-combiners enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'register-combiners-nv', 'variable-a-nv', 'variable-b-nv',
'variable-c-nv', 'variable-d-nv', 'variable-e-nv', 'variable-f-nv',
'variable-g-nv', 'constant-color0-nv', 'constant-color1-nv',
'primary-color-nv', 'secondary-color-nv', 'spare0-nv', 'spare1-nv',
'discard-nv', 'e-times-f-nv', 'spare0-plus-secondary-color-nv',
'vertex-array-range-without-flush-nv',
'multisample-filter-hint-nv', 'unsigned-identity-nv',
'unsigned-invert-nv', 'expand-normal-nv', 'expand-negate-nv',
'half-bias-normal-nv', 'half-bias-negate-nv', 'signed-identity-nv',
'unsigned-negate-nv', 'scale-by-two-nv', 'scale-by-four-nv',
'scale-by-one-half-nv', 'bias-by-negative-one-half-nv',
'combiner-input-nv', 'combiner-mapping-nv',
'combiner-component-usage-nv', 'combiner-ab-dot-product-nv',
'combiner-cd-dot-product-nv', 'combiner-mux-sum-nv',
'combiner-scale-nv', 'combiner-bias-nv', 'combiner-ab-output-nv',
'combiner-cd-output-nv', 'combiner-sum-output-nv',
'max-general-combiners-nv', 'num-general-combiners-nv',
'color-sum-clamp-nv', 'combiner0-nv', 'combiner1-nv',
'combiner2-nv', 'combiner3-nv', 'combiner4-nv', 'combiner5-nv',
'combiner6-nv', 'combiner7-nv'.
-- Macro: nv-register-combiners-2 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'per-stage-constants-nv'.
-- Macro: nv-primitive-restart enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'primitive-restart-nv', 'primitive-restart-index-nv'.
-- Macro: nv-fog-distance enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fog-gen-mode-nv', 'eye-radial-nv', 'eye-plane-absolute-nv'.
-- Macro: nv-texgen-emboss enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'emboss-light-nv', 'emboss-constant-nv', 'emboss-map-nv'.
-- Macro: ingr-color-clamp enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'red-min-clamp-ingr', 'green-min-clamp-ingr',
'blue-min-clamp-ingr', 'alpha-min-clamp-ingr',
'red-max-clamp-ingr', 'green-max-clamp-ingr',
'blue-max-clamp-ingr', 'alpha-max-clamp-ingr'.
-- Macro: ingr-interlace-read enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'interlace-read-ingr'.
-- Macro: ext-texture-env-combine enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'combine-ext', 'combine-rgb-ext', 'combine-alpha-ext',
'rgb-scale-ext', 'add-signed-ext', 'interpolate-ext',
'constant-ext', 'primary-color-ext', 'previous-ext',
'source0-rgb-ext', 'source1-rgb-ext', 'source2-rgb-ext',
'source0-alpha-ext', 'source1-alpha-ext', 'source2-alpha-ext',
'operand0-rgb-ext', 'operand1-rgb-ext', 'operand2-rgb-ext',
'operand0-alpha-ext', 'operand1-alpha-ext', 'operand2-alpha-ext'.
-- Macro: nv-texture-env-combine-4 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'combine4-nv', 'source3-rgb-nv', 'source3-alpha-nv',
'operand3-rgb-nv', 'operand3-alpha-nv'.
-- Macro: sgix-subsample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pack-subsample-rate-sgix', 'unpack-subsample-rate-sgix',
'pixel-subsample-4444-sgix', 'pixel-subsample-2424-sgix',
'pixel-subsample-4242-sgix'.
-- Macro: ext-texture-perturb-normal enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'perturb-ext', 'texture-normal-ext'.
-- Macro: apple-specular-vector enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'light-model-specular-vector-apple'.
-- Macro: apple-transform-hint enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'transform-hint-apple'.
-- Macro: apple-client-storage enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'unpack-client-storage-apple'.
-- Macro: apple-object-purgeable enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'buffer-object-apple', 'released-apple', 'volatile-apple',
'retained-apple', 'undefined-apple', 'purgeable-apple'.
-- Macro: arb-vertex-array-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-array-binding'.
-- Macro: apple-vertex-array-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-array-binding-apple'.
-- Macro: apple-texture-range enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-range-length-apple', 'texture-range-pointer-apple',
'texture-storage-hint-apple', 'storage-private-apple',
'storage-cached-apple', 'storage-shared-apple'.
-- Macro: apple-ycbcr-422 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'ycbcr-422-apple', 'unsigned-short-8-8-apple',
'unsigned-short-8-8-rev-apple'.
-- Macro: mesa-ycbcr-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'unsigned-short-8-8-mesa', 'unsigned-short-8-8-rev-mesa',
'ycbcr-mesa'.
-- Macro: sun-slice-accum enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'slice-accum-sun'.
-- Macro: sun-mesh-array enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'quad-mesh-sun', 'triangle-mesh-sun'.
-- Macro: nv-vertex-program enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-program-nv', 'vertex-state-program-nv',
'attrib-array-size-nv', 'attrib-array-stride-nv',
'attrib-array-type-nv', 'current-attrib-nv', 'program-length-nv',
'program-string-nv', 'modelview-projection-nv', 'identity-nv',
'inverse-nv', 'transpose-nv', 'inverse-transpose-nv',
'max-track-matrix-stack-depth-nv', 'max-track-matrices-nv',
'matrix0-nv', 'matrix1-nv', 'matrix2-nv', 'matrix3-nv',
'matrix4-nv', 'matrix5-nv', 'matrix6-nv', 'matrix7-nv',
'current-matrix-stack-depth-nv', 'current-matrix-nv',
'vertex-program-point-size-nv', 'vertex-program-two-side-nv',
'program-parameter-nv', 'attrib-array-pointer-nv',
'program-target-nv', 'program-resident-nv', 'track-matrix-nv',
'track-matrix-transform-nv', 'vertex-program-binding-nv',
'program-error-position-nv', 'vertex-attrib-array0-nv',
'vertex-attrib-array1-nv', 'vertex-attrib-array2-nv',
'vertex-attrib-array3-nv', 'vertex-attrib-array4-nv',
'vertex-attrib-array5-nv', 'vertex-attrib-array6-nv',
'vertex-attrib-array7-nv', 'vertex-attrib-array8-nv',
'vertex-attrib-array9-nv', 'vertex-attrib-array10-nv',
'vertex-attrib-array11-nv', 'vertex-attrib-array12-nv',
'vertex-attrib-array13-nv', 'vertex-attrib-array14-nv',
'vertex-attrib-array15-nv', 'map1-vertex-attrib0-4-nv',
'map1-vertex-attrib1-4-nv', 'map1-vertex-attrib2-4-nv',
'map1-vertex-attrib3-4-nv', 'map1-vertex-attrib4-4-nv',
'map1-vertex-attrib5-4-nv', 'map1-vertex-attrib6-4-nv',
'map1-vertex-attrib7-4-nv', 'map1-vertex-attrib8-4-nv',
'map1-vertex-attrib9-4-nv', 'map1-vertex-attrib10-4-nv',
'map1-vertex-attrib11-4-nv', 'map1-vertex-attrib12-4-nv',
'map1-vertex-attrib13-4-nv', 'map1-vertex-attrib14-4-nv',
'map1-vertex-attrib15-4-nv', 'map2-vertex-attrib0-4-nv',
'map2-vertex-attrib1-4-nv', 'map2-vertex-attrib2-4-nv',
'map2-vertex-attrib3-4-nv', 'map2-vertex-attrib4-4-nv',
'map2-vertex-attrib5-4-nv', 'map2-vertex-attrib6-4-nv',
'map2-vertex-attrib7-4-nv', 'map2-vertex-attrib8-4-nv',
'map2-vertex-attrib9-4-nv', 'map2-vertex-attrib10-4-nv',
'map2-vertex-attrib11-4-nv', 'map2-vertex-attrib12-4-nv',
'map2-vertex-attrib13-4-nv', 'map2-vertex-attrib14-4-nv',
'map2-vertex-attrib15-4-nv'.
-- Macro: arb-depth-clamp enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-clamp'.
-- Macro: nv-depth-clamp enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-clamp-nv'.
-- Macro: arb-fragment-program enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-program-arb', 'vertex-attrib-array-enabled-arb',
'vertex-attrib-array-size-arb', 'vertex-attrib-array-stride-arb',
'vertex-attrib-array-type-arb', 'current-vertex-attrib-arb',
'program-length-arb', 'program-string-arb',
'max-program-matrix-stack-depth-arb', 'max-program-matrices-arb',
'current-matrix-stack-depth-arb', 'current-matrix-arb',
'vertex-program-point-size-arb', 'vertex-program-two-side-arb',
'vertex-attrib-array-pointer-arb', 'program-error-position-arb',
'program-binding-arb', 'fragment-program-arb',
'program-alu-instructions-arb', 'program-tex-instructions-arb',
'program-tex-indirections-arb',
'program-native-alu-instructions-arb',
'program-native-tex-instructions-arb',
'program-native-tex-indirections-arb',
'max-program-alu-instructions-arb',
'max-program-tex-instructions-arb',
'max-program-tex-indirections-arb',
'max-program-native-alu-instructions-arb',
'max-program-native-tex-instructions-arb',
'max-program-native-tex-indirections-arb',
'max-texture-coords-arb', 'max-texture-image-units-arb',
'program-error-string-arb', 'program-format-ascii-arb',
'program-format-arb', 'program-instructions-arb',
'max-program-instructions-arb', 'program-native-instructions-arb',
'max-program-native-instructions-arb', 'program-temporaries-arb',
'max-program-temporaries-arb', 'program-native-temporaries-arb',
'max-program-native-temporaries-arb', 'program-parameters-arb',
'max-program-parameters-arb', 'program-native-parameters-arb',
'max-program-native-parameters-arb', 'program-attribs-arb',
'max-program-attribs-arb', 'program-native-attribs-arb',
'max-program-native-attribs-arb', 'program-address-registers-arb',
'max-program-address-registers-arb',
'program-native-address-registers-arb',
'max-program-native-address-registers-arb',
'max-program-local-parameters-arb',
'max-program-env-parameters-arb',
'program-under-native-limits-arb', 'transpose-current-matrix-arb',
'matrix0-arb', 'matrix1-arb', 'matrix2-arb', 'matrix3-arb',
'matrix4-arb', 'matrix5-arb', 'matrix6-arb', 'matrix7-arb',
'matrix8-arb', 'matrix9-arb', 'matrix10-arb', 'matrix11-arb',
'matrix12-arb', 'matrix13-arb', 'matrix14-arb', 'matrix15-arb',
'matrix16-arb', 'matrix17-arb', 'matrix18-arb', 'matrix19-arb',
'matrix20-arb', 'matrix21-arb', 'matrix22-arb', 'matrix23-arb',
'matrix24-arb', 'matrix25-arb', 'matrix26-arb', 'matrix27-arb',
'matrix28-arb', 'matrix29-arb', 'matrix30-arb', 'matrix31-arb'.
-- Macro: arb-vertex-blend enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-vertex-units-arb', 'active-vertex-units-arb',
'weight-sum-unity-arb', 'vertex-blend-arb', 'current-weight-arb',
'weight-array-type-arb', 'weight-array-stride-arb',
'weight-array-size-arb', 'weight-array-pointer-arb',
'weight-array-arb', 'modelview0-arb', 'modelview1-arb',
'modelview2-arb', 'modelview3-arb', 'modelview4-arb',
'modelview5-arb', 'modelview6-arb', 'modelview7-arb',
'modelview8-arb', 'modelview9-arb', 'modelview10-arb',
'modelview11-arb', 'modelview12-arb', 'modelview13-arb',
'modelview14-arb', 'modelview15-arb', 'modelview16-arb',
'modelview17-arb', 'modelview18-arb', 'modelview19-arb',
'modelview20-arb', 'modelview21-arb', 'modelview22-arb',
'modelview23-arb', 'modelview24-arb', 'modelview25-arb',
'modelview26-arb', 'modelview27-arb', 'modelview28-arb',
'modelview29-arb', 'modelview30-arb', 'modelview31-arb'.
-- Macro: oes-matrix-palette enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-vertex-units-oes', 'weight-array-oes',
'weight-array-type-oes', 'weight-array-stride-oes',
'weight-array-size-oes', 'weight-array-pointer-oes',
'matrix-palette-oes', 'max-palette-matrices-oes',
'current-palette-matrix-oes', 'matrix-index-array-oes',
'matrix-index-array-size-oes', 'matrix-index-array-type-oes',
'matrix-index-array-stride-oes', 'matrix-index-array-pointer-oes',
'weight-array-buffer-binding-oes',
'matrix-index-array-buffer-binding-oes'.
-- Macro: arb-texture-env-dot-3 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'dot3-rgb-arb', 'dot3-rgba-arb'.
-- Macro: img-texture-env-enhanced-fixed-function enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'dot3-rgba-img', 'modulate-color-img',
'recip-add-signed-alpha-img', 'texture-alpha-modulate-img',
'factor-alpha-modulate-img', 'fragment-alpha-modulate-img',
'add-blend-img'.
-- Macro: 3dfx-texture-compression-fxt1 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compressed-rgb-fxt1-3dfx', 'compressed-rgba-fxt1-3dfx'.
-- Macro: nv-evaluators enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'eval-2d-nv', 'eval-triangular-2d-nv', 'map-tessellation-nv',
'map-attrib-u-order-nv', 'map-attrib-v-order-nv',
'eval-fractional-tessellation-nv', 'eval-vertex-atrrib0-nv',
'eval-vertex-atrrib1-nv', 'eval-vertex-atrrib2-nv',
'eval-vertex-atrrib3-nv', 'eval-vertex-atrrib4-nv',
'eval-vertex-atrrib5-nv', 'eval-vertex-atrrib6-nv',
'eval-vertex-atrrib7-nv', 'eval-vertex-atrrib8-nv',
'eval-vertex-atrrib9-nv', 'eval-vertex-atrrib10-nv',
'eval-vertex-atrrib11-nv', 'eval-vertex-atrrib12-nv',
'eval-vertex-atrrib13-nv', 'eval-vertex-atrrib14-nv',
'eval-vertex-atrrib15-nv', 'max-map-tessellation-nv',
'max-rational-eval-order-nv'.
-- Macro: nv-tessellation-program-5 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-program-patch-attribs-nv', 'tess-control-program-nv',
'tess-evaluation-program-nv',
'tess-control-program-parameter-buffer-nv',
'tess-evaluation-program-parameter-buffer-nv'.
-- Macro: nv-texture-shader enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'offset-texture-rectangle-nv', 'offset-texture-rectangle-scale-nv',
'dot-product-texture-rectangle-nv',
'rgba-unsigned-dot-product-mapping-nv',
'unsigned-int-s8-s8-8-8-nv', 'unsigned-int-8-8-s8-s8-rev-nv',
'dsdt-mag-intensity-nv', 'shader-consistent-nv',
'texture-shader-nv', 'shader-operation-nv', 'cull-modes-nv',
'offset-texture-matrix-nv', 'offset-texture-scale-nv',
'offset-texture-bias-nv', 'offset-texture-2d-matrix-nv',
'offset-texture-2d-scale-nv', 'offset-texture-2d-bias-nv',
'previous-texture-input-nv', 'const-eye-nv', 'pass-through-nv',
'cull-fragment-nv', 'offset-texture-2d-nv',
'dependent-ar-texture-2d-nv', 'dependent-gb-texture-2d-nv',
'dot-product-nv', 'dot-product-depth-replace-nv',
'dot-product-texture-2d-nv', 'dot-product-texture-cube-map-nv',
'dot-product-diffuse-cube-map-nv',
'dot-product-reflect-cube-map-nv',
'dot-product-const-eye-reflect-cube-map-nv', 'hilo-nv', 'dsdt-nv',
'dsdt-mag-nv', 'dsdt-mag-vib-nv', 'hilo16-nv', 'signed-hilo-nv',
'signed-hilo16-nv', 'signed-rgba-nv', 'signed-rgba8-nv',
'signed-rgb-nv', 'signed-rgb8-nv', 'signed-luminance-nv',
'signed-luminance8-nv', 'signed-luminance-alpha-nv',
'signed-luminance8-alpha8-nv', 'signed-alpha-nv',
'signed-alpha8-nv', 'signed-intensity-nv', 'signed-intensity8-nv',
'dsdt8-nv', 'dsdt8-mag8-nv', 'dsdt8-mag8-intensity8-nv',
'signed-rgb-unsigned-alpha-nv', 'signed-rgb8-unsigned-alpha8-nv',
'hi-scale-nv', 'lo-scale-nv', 'ds-scale-nv', 'dt-scale-nv',
'magnitude-scale-nv', 'vibrance-scale-nv', 'hi-bias-nv',
'lo-bias-nv', 'ds-bias-nv', 'dt-bias-nv', 'magnitude-bias-nv',
'vibrance-bias-nv', 'texture-border-values-nv',
'texture-hi-size-nv', 'texture-lo-size-nv', 'texture-ds-size-nv',
'texture-dt-size-nv', 'texture-mag-size-nv'.
-- Macro: nv-vdpau-interop enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'surface-state-nv', 'surface-registered-nv', 'surface-mapped-nv',
'write-discard-nv'.
-- Macro: nv-texture-shader-2 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'dot-product-texture-3d-nv'.
-- Macro: ext-texture-env-dot-3 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'dot3-rgb-ext', 'dot3-rgba-ext'.
-- Macro: amd-program-binary-z400 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'z400-binary-amd'.
-- Macro: oes-get-program-binary enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'program-binary-length-oes', 'num-program-binary-formats-oes',
'program-binary-formats-oes'.
-- Macro: ati-texture-mirror-once enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'mirror-clamp-ati', 'mirror-clamp-to-edge-ati'.
-- Macro: ext-texture-mirror-clamp enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'mirror-clamp-ext', 'mirror-clamp-to-edge-ext',
'mirror-clamp-to-border-ext'.
-- Macro: ati-texture-env-combine-3 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'modulate-add-ati', 'modulate-signed-add-ati',
'modulate-subtract-ati'.
-- Macro: amd-stencil-operation-extended enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'set-amd', 'replace-value-amd', 'stencil-op-value-amd',
'stencil-back-op-value-amd'.
-- Macro: mesa-packed-depth-stencil enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-stencil-mesa', 'unsigned-int-24-8-mesa',
'unsigned-int-8-24-rev-mesa', 'unsigned-short-15-1-mesa',
'unsigned-short-1-15-rev-mesa'.
-- Macro: mesa-trace enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'trace-all-bits-mesa', 'trace-operations-bit-mesa',
'trace-primitives-bit-mesa', 'trace-arrays-bit-mesa',
'trace-textures-bit-mesa', 'trace-pixels-bit-mesa',
'trace-errors-bit-mesa', 'trace-mask-mesa', 'trace-name-mesa'.
-- Macro: mesa-pack-invert enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pack-invert-mesa'.
-- Macro: mesax-texture-stack enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-1d-stack-mesax', 'texture-2d-stack-mesax',
'proxy-texture-1d-stack-mesax', 'proxy-texture-2d-stack-mesax',
'texture-1d-stack-binding-mesax', 'texture-2d-stack-binding-mesax'.
-- Macro: mesa-shader-debug enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'debug-object-mesa', 'debug-print-mesa', 'debug-assert-mesa'.
-- Macro: ati-vertex-array-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'static-ati', 'dynamic-ati', 'preserve-ati', 'discard-ati',
'object-buffer-size-ati', 'object-buffer-usage-ati',
'array-object-buffer-ati', 'array-object-offset-ati'.
-- Macro: arb-vertex-buffer-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'buffer-size-arb', 'buffer-usage-arb', 'array-buffer-arb',
'element-array-buffer-arb', 'array-buffer-binding-arb',
'element-array-buffer-binding-arb',
'vertex-array-buffer-binding-arb',
'normal-array-buffer-binding-arb',
'color-array-buffer-binding-arb', 'index-array-buffer-binding-arb',
'texture-coord-array-buffer-binding-arb',
'edge-flag-array-buffer-binding-arb',
'secondary-color-array-buffer-binding-arb',
'fog-coordinate-array-buffer-binding-arb',
'weight-array-buffer-binding-arb',
'vertex-attrib-array-buffer-binding-arb', 'read-only-arb',
'write-only-arb', 'read-write-arb', 'buffer-access-arb',
'buffer-mapped-arb', 'buffer-map-pointer-arb', 'stream-draw-arb',
'stream-read-arb', 'stream-copy-arb', 'static-draw-arb',
'static-read-arb', 'static-copy-arb', 'dynamic-draw-arb',
'dynamic-read-arb', 'dynamic-copy-arb'.
-- Macro: ati-element-array enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'element-array-ati', 'element-array-type-ati',
'element-array-pointer-ati'.
-- Macro: ati-vertex-streams enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-vertex-streams-ati', 'vertex-stream0-ati',
'vertex-stream1-ati', 'vertex-stream2-ati', 'vertex-stream3-ati',
'vertex-stream4-ati', 'vertex-stream5-ati', 'vertex-stream6-ati',
'vertex-stream7-ati', 'vertex-source-ati'.
-- Macro: ati-envmap-bumpmap enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'bump-rot-matrix-ati', 'bump-rot-matrix-size-ati',
'bump-num-tex-units-ati', 'bump-tex-units-ati', 'dudv-ati',
'du8dv8-ati', 'bump-envmap-ati', 'bump-target-ati'.
-- Macro: ext-vertex-shader enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-shader-ext', 'vertex-shader-binding-ext', 'op-index-ext',
'op-negate-ext', 'op-dot3-ext', 'op-dot4-ext', 'op-mul-ext',
'op-add-ext', 'op-madd-ext', 'op-frac-ext', 'op-max-ext',
'op-min-ext', 'op-set-ge-ext', 'op-set-lt-ext', 'op-clamp-ext',
'op-floor-ext', 'op-round-ext', 'op-exp-base-2-ext',
'op-log-base-2-ext', 'op-power-ext', 'op-recip-ext',
'op-recip-sqrt-ext', 'op-sub-ext', 'op-cross-product-ext',
'op-multiply-matrix-ext', 'op-mov-ext', 'output-vertex-ext',
'output-color0-ext', 'output-color1-ext',
'output-texture-coord0-ext', 'output-texture-coord1-ext',
'output-texture-coord2-ext', 'output-texture-coord3-ext',
'output-texture-coord4-ext', 'output-texture-coord5-ext',
'output-texture-coord6-ext', 'output-texture-coord7-ext',
'output-texture-coord8-ext', 'output-texture-coord9-ext',
'output-texture-coord10-ext', 'output-texture-coord11-ext',
'output-texture-coord12-ext', 'output-texture-coord13-ext',
'output-texture-coord14-ext', 'output-texture-coord15-ext',
'output-texture-coord16-ext', 'output-texture-coord17-ext',
'output-texture-coord18-ext', 'output-texture-coord19-ext',
'output-texture-coord20-ext', 'output-texture-coord21-ext',
'output-texture-coord22-ext', 'output-texture-coord23-ext',
'output-texture-coord24-ext', 'output-texture-coord25-ext',
'output-texture-coord26-ext', 'output-texture-coord27-ext',
'output-texture-coord28-ext', 'output-texture-coord29-ext',
'output-texture-coord30-ext', 'output-texture-coord31-ext',
'output-fog-ext', 'scalar-ext', 'vector-ext', 'matrix-ext',
'variant-ext', 'invariant-ext', 'local-constant-ext', 'local-ext',
'max-vertex-shader-instructions-ext',
'max-vertex-shader-variants-ext',
'max-vertex-shader-invariants-ext',
'max-vertex-shader-local-constants-ext',
'max-vertex-shader-locals-ext',
'max-optimized-vertex-shader-instructions-ext',
'max-optimized-vertex-shader-variants-ext',
'max-optimized-vertex-shader-local-constants-ext',
'max-optimized-vertex-shader-invariants-ext',
'max-optimized-vertex-shader-locals-ext',
'vertex-shader-instructions-ext', 'vertex-shader-variants-ext',
'vertex-shader-invariants-ext',
'vertex-shader-local-constants-ext', 'vertex-shader-locals-ext',
'vertex-shader-optimized-ext', 'x-ext', 'y-ext', 'z-ext', 'w-ext',
'negative-x-ext', 'negative-y-ext', 'negative-z-ext',
'negative-w-ext', 'zero-ext', 'one-ext', 'negative-one-ext',
'normalized-range-ext', 'full-range-ext', 'current-vertex-ext',
'mvp-matrix-ext', 'variant-value-ext', 'variant-datatype-ext',
'variant-array-stride-ext', 'variant-array-type-ext',
'variant-array-ext', 'variant-array-pointer-ext',
'invariant-value-ext', 'invariant-datatype-ext',
'local-constant-value-ext', 'local-constant-datatype-ext'.
-- Macro: amd-compressed-atc-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'atc-rgba-interpolated-alpha-amd', 'atc-rgb-amd',
'atc-rgba-explicit-alpha-amd'.
-- Macro: ati-pn-triangles enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pn-triangles-ati', 'max-pn-triangles-tesselation-level-ati',
'pn-triangles-point-mode-ati', 'pn-triangles-normal-mode-ati',
'pn-triangles-tesselation-level-ati',
'pn-triangles-point-mode-linear-ati',
'pn-triangles-point-mode-cubic-ati',
'pn-triangles-normal-mode-linear-ati',
'pn-triangles-normal-mode-quadratic-ati'.
-- Macro: amd-compressed-3dc-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'3dc-x-amd', '3dc-xy-amd'.
-- Macro: ati-meminfo enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vbo-free-memory-ati', 'texture-free-memory-ati',
'renderbuffer-free-memory-ati'.
-- Macro: ati-separate-stencil enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'stencil-back-func-ati', 'stencil-back-pass-depth-fail-ati',
'stencil-back-pass-depth-pass-ati'.
-- Macro: arb-texture-float enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'rgba32f-arb', 'rgb32f-arb', 'alpha32f-arb', 'intensity32f-arb',
'luminance32f-arb', 'luminance-alpha32f-arb', 'rgba16f-arb',
'rgb16f-arb', 'alpha16f-arb', 'intensity16f-arb',
'luminance16f-arb', 'luminance-alpha16f-arb',
'texture-red-type-arb', 'texture-green-type-arb',
'texture-blue-type-arb', 'texture-alpha-type-arb',
'texture-luminance-type-arb', 'texture-intensity-type-arb',
'texture-depth-type-arb', 'unsigned-normalized-arb'.
-- Macro: ati-texture-float enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'rgba-float32-ati', 'rgb-float32-ati', 'alpha-float32-ati',
'intensity-float32-ati', 'luminance-float32-ati',
'luminance-alpha-float32-ati', 'rgba-float16-ati',
'rgb-float16-ati', 'alpha-float16-ati', 'intensity-float16-ati',
'luminance-float16-ati', 'luminance-alpha-float16-ati'.
-- Macro: arb-color-buffer-float enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'rgba-float-mode-arb', 'clamp-vertex-color-arb',
'clamp-fragment-color-arb', 'clamp-read-color-arb',
'fixed-only-arb'.
-- Macro: ati-pixel-format-float enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'type-rgba-float-ati', 'color-clear-unclamped-value-ati'.
-- Macro: qcom-writeonly-rendering enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'writeonly-rendering-qcom'.
-- Macro: arb-draw-buffers enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-draw-buffers-arb', 'draw-buffer0-arb', 'draw-buffer1-arb',
'draw-buffer2-arb', 'draw-buffer3-arb', 'draw-buffer4-arb',
'draw-buffer5-arb', 'draw-buffer6-arb', 'draw-buffer7-arb',
'draw-buffer8-arb', 'draw-buffer9-arb', 'draw-buffer10-arb',
'draw-buffer11-arb', 'draw-buffer12-arb', 'draw-buffer13-arb',
'draw-buffer14-arb', 'draw-buffer15-arb'.
-- Macro: ati-draw-buffers enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-draw-buffers-ati', 'draw-buffer0-ati', 'draw-buffer1-ati',
'draw-buffer2-ati', 'draw-buffer3-ati', 'draw-buffer4-ati',
'draw-buffer5-ati', 'draw-buffer6-ati', 'draw-buffer7-ati',
'draw-buffer8-ati', 'draw-buffer9-ati', 'draw-buffer10-ati',
'draw-buffer11-ati', 'draw-buffer12-ati', 'draw-buffer13-ati',
'draw-buffer14-ati', 'draw-buffer15-ati'.
-- Macro: nv-draw-buffers enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-draw-buffers-nv', 'draw-buffer0-nv', 'draw-buffer1-nv',
'draw-buffer2-nv', 'draw-buffer3-nv', 'draw-buffer4-nv',
'draw-buffer5-nv', 'draw-buffer6-nv', 'draw-buffer7-nv',
'draw-buffer8-nv', 'draw-buffer9-nv', 'draw-buffer10-nv',
'draw-buffer11-nv', 'draw-buffer12-nv', 'draw-buffer13-nv',
'draw-buffer14-nv', 'draw-buffer15-nv', 'color-attachment0-nv',
'color-attachment1-nv', 'color-attachment2-nv',
'color-attachment3-nv', 'color-attachment4-nv',
'color-attachment5-nv', 'color-attachment6-nv',
'color-attachment7-nv', 'color-attachment8-nv',
'color-attachment9-nv', 'color-attachment10-nv',
'color-attachment11-nv', 'color-attachment12-nv',
'color-attachment13-nv', 'color-attachment14-nv',
'color-attachment15-nv'.
-- Macro: amd-sample-positions enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'subsample-distance-amd'.
-- Macro: arb-matrix-palette enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'matrix-palette-arb', 'max-matrix-palette-stack-depth-arb',
'max-palette-matrices-arb', 'current-palette-matrix-arb',
'matrix-index-array-arb', 'current-matrix-index-arb',
'matrix-index-array-size-arb', 'matrix-index-array-type-arb',
'matrix-index-array-stride-arb', 'matrix-index-array-pointer-arb'.
-- Macro: arb-shadow enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-compare-mode-arb', 'texture-compare-func-arb',
'compare-r-to-texture-arb'.
-- Macro: ext-shadow-samplers enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-compare-mode-ext', 'texture-compare-func-ext',
'compare-ref-to-texture-ext', 'sampler-2d-shadow-ext'.
-- Macro: ext-texture-array enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compare-ref-depth-to-texture-ext', 'max-array-texture-layers-ext',
'texture-1d-array-ext', 'proxy-texture-1d-array-ext',
'texture-2d-array-ext', 'proxy-texture-2d-array-ext',
'texture-binding-1d-array-ext', 'texture-binding-2d-array-ext'.
-- Macro: arb-seamless-cube-map enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-cube-map-seamless'.
-- Macro: nv-texture-shader-3 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'offset-projective-texture-2d-nv',
'offset-projective-texture-2d-scale-nv',
'offset-projective-texture-rectangle-nv',
'offset-projective-texture-rectangle-scale-nv',
'offset-hilo-texture-2d-nv', 'offset-hilo-texture-rectangle-nv',
'offset-hilo-projective-texture-2d-nv',
'offset-hilo-projective-texture-rectangle-nv',
'dependent-hilo-texture-2d-nv', 'dependent-rgb-texture-3d-nv',
'dependent-rgb-texture-cube-map-nv', 'dot-product-pass-through-nv',
'dot-product-texture-1d-nv', 'dot-product-affine-depth-replace-nv',
'hilo8-nv', 'signed-hilo8-nv', 'force-blue-to-one-nv'.
-- Macro: arb-point-sprite enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'point-sprite-arb', 'coord-replace-arb'.
-- Macro: nv-point-sprite enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'point-sprite-nv', 'coord-replace-nv', 'point-sprite-r-mode-nv'.
-- Macro: oes-point-sprite enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'point-sprite-arb', 'coord-replace-arb'.
-- Macro: arb-occlusion-query enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'query-counter-bits-arb', 'current-query-arb', 'query-result-arb',
'query-result-available-arb', 'samples-passed-arb'.
-- Macro: nv-occlusion-query enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pixel-counter-bits-nv', 'current-occlusion-query-id-nv',
'pixel-count-nv', 'pixel-count-available-nv'.
-- Macro: ext-occlusion-query-boolean enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'current-query-ext', 'query-result-ext',
'query-result-available-ext', 'any-samples-passed-ext',
'any-samples-passed-conservative-ext'.
-- Macro: nv-fragment-program enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-fragment-program-local-parameters-nv', 'fragment-program-nv',
'max-texture-coords-nv', 'max-texture-image-units-nv',
'fragment-program-binding-nv', 'program-error-string-nv'.
-- Macro: nv-copy-depth-to-color enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-stencil-to-rgba-nv', 'depth-stencil-to-bgra-nv'.
-- Macro: nv-pixel-data-range enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'write-pixel-data-range-nv', 'read-pixel-data-range-nv',
'write-pixel-data-range-length-nv',
'read-pixel-data-range-length-nv',
'write-pixel-data-range-pointer-nv',
'read-pixel-data-range-pointer-nv'.
-- Macro: arb-gpu-shader-5 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'geometry-shader-invocations', 'max-geometry-shader-invocations',
'min-fragment-interpolation-offset',
'max-fragment-interpolation-offset',
'fragment-interpolation-offset-bits'.
-- Macro: nv-float-buffer enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'float-r-nv', 'float-rg-nv', 'float-rgb-nv', 'float-rgba-nv',
'float-r16-nv', 'float-r32-nv', 'float-rg16-nv', 'float-rg32-nv',
'float-rgb16-nv', 'float-rgb32-nv', 'float-rgba16-nv',
'float-rgba32-nv', 'texture-float-components-nv',
'float-clear-color-value-nv', 'float-rgba-mode-nv'.
-- Macro: nv-texture-expand-normal enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-unsigned-remap-mode-nv'.
-- Macro: ext-depth-bounds-test enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-bounds-test-ext', 'depth-bounds-ext'.
-- Macro: oes-mapbuffer enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'write-only-oes', 'buffer-access-oes', 'buffer-mapped-oes',
'buffer-map-pointer-oes'.
-- Macro: nv-shader-buffer-store enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'read-write', 'write-only', 'shader-global-access-barrier-bit-nv'.
-- Macro: arb-timer-query enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'time-elapsed', 'timestamp'.
-- Macro: ext-timer-query enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'time-elapsed-ext'.
-- Macro: arb-pixel-buffer-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pixel-pack-buffer-arb', 'pixel-unpack-buffer-arb',
'pixel-pack-buffer-binding-arb', 'pixel-unpack-buffer-binding-arb'.
-- Macro: ext-pixel-buffer-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pixel-pack-buffer-ext', 'pixel-unpack-buffer-ext',
'pixel-pack-buffer-binding-ext', 'pixel-unpack-buffer-binding-ext'.
-- Macro: nv-s-rgb-formats enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'etc1-srgb8-nv', 'srgb8-nv', 'sluminance-alpha-nv',
'sluminance8-alpha8-nv', 'sluminance-nv', 'sluminance8-nv',
'compressed-srgb-s3tc-dxt1-nv',
'compressed-srgb-alpha-s3tc-dxt1-nv',
'compressed-srgb-alpha-s3tc-dxt3-nv',
'compressed-srgb-alpha-s3tc-dxt5-nv'.
-- Macro: ext-stencil-clear-tag enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'stencil-tag-bits-ext', 'stencil-clear-tag-value-ext'.
-- Macro: nv-vertex-program-2-option enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-program-exec-instructions-nv', 'max-program-call-depth-nv'.
-- Macro: nv-fragment-program-2 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-program-exec-instructions-nv', 'max-program-call-depth-nv',
'max-program-if-depth-nv', 'max-program-loop-depth-nv',
'max-program-loop-count-nv'.
-- Macro: arb-blend-func-extended enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'src1-color', 'one-minus-src1-color', 'one-minus-src1-alpha',
'max-dual-source-draw-buffers'.
-- Macro: nv-vertex-program-4 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-attrib-array-integer-nv'.
-- Macro: version-3-3 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-attrib-array-divisor'.
-- Macro: arb-instanced-arrays enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-attrib-array-divisor-arb'.
-- Macro: angle-instanced-arrays enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-attrib-array-divisor-angle'.
-- Macro: nv-instanced-arrays enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-attrib-array-divisor-nv'.
-- Macro: nv-gpu-program-4 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'min-program-texel-offset-nv', 'max-program-texel-offset-nv',
'program-attrib-components-nv', 'program-result-components-nv',
'max-program-attrib-components-nv',
'max-program-result-components-nv',
'max-program-generic-attribs-nv', 'max-program-generic-results-nv'.
-- Macro: ext-stencil-two-side enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'stencil-test-two-side-ext', 'active-stencil-face-ext'.
-- Macro: arb-sampler-objects enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sampler-binding'.
-- Macro: ati-fragment-shader enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fragment-shader-ati', 'reg-0-ati', 'reg-1-ati', 'reg-2-ati',
'reg-3-ati', 'reg-4-ati', 'reg-5-ati', 'reg-6-ati', 'reg-7-ati',
'reg-8-ati', 'reg-9-ati', 'reg-10-ati', 'reg-11-ati', 'reg-12-ati',
'reg-13-ati', 'reg-14-ati', 'reg-15-ati', 'reg-16-ati',
'reg-17-ati', 'reg-18-ati', 'reg-19-ati', 'reg-20-ati',
'reg-21-ati', 'reg-22-ati', 'reg-23-ati', 'reg-24-ati',
'reg-25-ati', 'reg-26-ati', 'reg-27-ati', 'reg-28-ati',
'reg-29-ati', 'reg-30-ati', 'reg-31-ati', 'con-0-ati', 'con-1-ati',
'con-2-ati', 'con-3-ati', 'con-4-ati', 'con-5-ati', 'con-6-ati',
'con-7-ati', 'con-8-ati', 'con-9-ati', 'con-10-ati', 'con-11-ati',
'con-12-ati', 'con-13-ati', 'con-14-ati', 'con-15-ati',
'con-16-ati', 'con-17-ati', 'con-18-ati', 'con-19-ati',
'con-20-ati', 'con-21-ati', 'con-22-ati', 'con-23-ati',
'con-24-ati', 'con-25-ati', 'con-26-ati', 'con-27-ati',
'con-28-ati', 'con-29-ati', 'con-30-ati', 'con-31-ati', 'mov-ati',
'add-ati', 'mul-ati', 'sub-ati', 'dot3-ati', 'dot4-ati', 'mad-ati',
'lerp-ati', 'cnd-ati', 'cnd0-ati', 'dot2-add-ati',
'secondary-interpolator-ati', 'num-fragment-registers-ati',
'num-fragment-constants-ati', 'num-passes-ati',
'num-instructions-per-pass-ati', 'num-instructions-total-ati',
'num-input-interpolator-components-ati',
'num-loopback-components-ati', 'color-alpha-pairing-ati',
'swizzle-str-ati', 'swizzle-stq-ati', 'swizzle-str-dr-ati',
'swizzle-stq-dq-ati', 'swizzle-strq-ati', 'swizzle-strq-dq-ati',
'red-bit-ati', 'green-bit-ati', 'blue-bit-ati', '2x-bit-ati',
'4x-bit-ati', '8x-bit-ati', 'half-bit-ati', 'quarter-bit-ati',
'eighth-bit-ati', 'saturate-bit-ati', '2x-bit-ati', 'comp-bit-ati',
'negate-bit-ati', 'bias-bit-ati'.
-- Macro: oml-interlace enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'interlace-oml', 'interlace-read-oml'.
-- Macro: oml-subsample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'format-subsample-24-24-oml', 'format-subsample-244-244-oml'.
-- Macro: oml-resample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pack-resample-oml', 'unpack-resample-oml',
'resample-replicate-oml', 'resample-zero-fill-oml',
'resample-average-oml', 'resample-decimate-oml'.
-- Macro: oes-point-size-array enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'point-size-array-type-oes', 'point-size-array-stride-oes',
'point-size-array-pointer-oes', 'point-size-array-oes',
'point-size-array-buffer-binding-oes'.
-- Macro: oes-matrix-get enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'modelview-matrix-float-as-int-bits-oes',
'projection-matrix-float-as-int-bits-oes',
'texture-matrix-float-as-int-bits-oes'.
-- Macro: apple-vertex-program-evaluators enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-attrib-map1-apple', 'vertex-attrib-map2-apple',
'vertex-attrib-map1-size-apple', 'vertex-attrib-map1-coeff-apple',
'vertex-attrib-map1-order-apple',
'vertex-attrib-map1-domain-apple', 'vertex-attrib-map2-size-apple',
'vertex-attrib-map2-coeff-apple', 'vertex-attrib-map2-order-apple',
'vertex-attrib-map2-domain-apple'.
-- Macro: apple-fence enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'draw-pixels-apple', 'fence-apple'.
-- Macro: apple-element-array enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'element-array-apple', 'element-array-type-apple',
'element-array-pointer-apple'.
-- Macro: arb-uniform-buffer-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'uniform-buffer', 'uniform-buffer-binding', 'uniform-buffer-start',
'uniform-buffer-size', 'max-vertex-uniform-blocks',
'max-geometry-uniform-blocks', 'max-fragment-uniform-blocks',
'max-combined-uniform-blocks', 'max-uniform-buffer-bindings',
'max-uniform-block-size', 'max-combined-vertex-uniform-components',
'max-combined-geometry-uniform-components',
'max-combined-fragment-uniform-components',
'uniform-buffer-offset-alignment',
'active-uniform-block-max-name-length', 'active-uniform-blocks',
'uniform-type', 'uniform-size', 'uniform-name-length',
'uniform-block-index', 'uniform-offset', 'uniform-array-stride',
'uniform-matrix-stride', 'uniform-is-row-major',
'uniform-block-binding', 'uniform-block-data-size',
'uniform-block-name-length', 'uniform-block-active-uniforms',
'uniform-block-active-uniform-indices',
'uniform-block-referenced-by-vertex-shader',
'uniform-block-referenced-by-geometry-shader',
'uniform-block-referenced-by-fragment-shader', 'invalid-index'.
-- Macro: apple-flush-buffer-range enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'buffer-serialized-modify-apple', 'buffer-flushing-unmap-apple'.
-- Macro: apple-aux-depth-stencil enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'aux-depth-stencil-apple'.
-- Macro: apple-row-bytes enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pack-row-bytes-apple', 'unpack-row-bytes-apple'.
-- Macro: apple-rgb-422 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'rgb-422-apple', 'unsigned-short-8-8-apple',
'unsigned-short-8-8-rev-apple'.
-- Macro: ext-texture-s-rgb-decode enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-srgb-decode-ext', 'decode-ext', 'skip-decode-ext'.
-- Macro: ext-debug-label enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'program-pipeline-object-ext', 'program-object-ext',
'shader-object-ext', 'buffer-object-ext', 'query-object-ext',
'vertex-array-object-ext'.
-- Macro: ext-shader-framebuffer-fetch enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fragment-shader-discards-samples-ext'.
-- Macro: apple-sync enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sync-object-apple', 'max-server-wait-timeout-apple',
'object-type-apple', 'sync-condition-apple', 'sync-status-apple',
'sync-flags-apple', 'sync-fence-apple',
'sync-gpu-commands-complete-apple', 'unsignaled-apple',
'signaled-apple', 'already-signaled-apple',
'timeout-expired-apple', 'condition-satisfied-apple',
'wait-failed-apple', 'sync-flush-commands-bit-apple',
'timeout-ignored-apple'.
-- Macro: arb-shader-objects enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fragment-shader', 'fragment-shader-arb', 'vertex-shader',
'vertex-shader-arb', 'program-object-arb', 'shader-object-arb',
'max-fragment-uniform-components',
'max-fragment-uniform-components-arb',
'max-vertex-uniform-components',
'max-vertex-uniform-components-arb', 'max-varying-floats',
'max-varying-floats-arb', 'max-vertex-texture-image-units',
'max-vertex-texture-image-units-arb',
'max-combined-texture-image-units',
'max-combined-texture-image-units-arb', 'object-type-arb',
'shader-type', 'object-subtype-arb', 'float-vec2',
'float-vec2-arb', 'float-vec3', 'float-vec3-arb', 'float-vec4',
'float-vec4-arb', 'int-vec2', 'int-vec2-arb', 'int-vec3',
'int-vec3-arb', 'int-vec4', 'int-vec4-arb', 'bool', 'bool-arb',
'bool-vec2', 'bool-vec2-arb', 'bool-vec3', 'bool-vec3-arb',
'bool-vec4', 'bool-vec4-arb', 'float-mat2', 'float-mat2-arb',
'float-mat3', 'float-mat3-arb', 'float-mat4', 'float-mat4-arb',
'sampler-1d', 'sampler-1d-arb', 'sampler-2d', 'sampler-2d-arb',
'sampler-3d', 'sampler-3d-arb', 'sampler-cube', 'sampler-cube-arb',
'sampler-1d-shadow', 'sampler-1d-shadow-arb', 'sampler-2d-shadow',
'sampler-2d-shadow-arb', 'sampler-2d-rect-arb',
'sampler-2d-rect-shadow-arb', 'float-mat-2x-3', 'float-mat-2x-4',
'float-mat-3x-2', 'float-mat-3x-4', 'float-mat-4x-2',
'float-mat-4x-3', 'delete-status', 'object-delete-status-arb',
'compile-status', 'object-compile-status-arb', 'link-status',
'object-link-status-arb', 'validate-status',
'object-validate-status-arb', 'info-log-length',
'object-info-log-length-arb', 'attached-shaders',
'object-attached-objects-arb', 'active-uniforms',
'object-active-uniforms-arb', 'active-uniform-max-length',
'object-active-uniform-max-length-arb', 'shader-source-length',
'object-shader-source-length-arb', 'active-attributes',
'object-active-attributes-arb', 'active-attribute-max-length',
'object-active-attribute-max-length-arb',
'fragment-shader-derivative-hint',
'fragment-shader-derivative-hint-arb', 'shading-language-version',
'shading-language-version-arb'.
-- Macro: arb-vertex-shader enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fragment-shader', 'fragment-shader-arb', 'vertex-shader',
'vertex-shader-arb', 'program-object-arb', 'shader-object-arb',
'max-fragment-uniform-components',
'max-fragment-uniform-components-arb',
'max-vertex-uniform-components',
'max-vertex-uniform-components-arb', 'max-varying-floats',
'max-varying-floats-arb', 'max-vertex-texture-image-units',
'max-vertex-texture-image-units-arb',
'max-combined-texture-image-units',
'max-combined-texture-image-units-arb', 'object-type-arb',
'shader-type', 'object-subtype-arb', 'float-vec2',
'float-vec2-arb', 'float-vec3', 'float-vec3-arb', 'float-vec4',
'float-vec4-arb', 'int-vec2', 'int-vec2-arb', 'int-vec3',
'int-vec3-arb', 'int-vec4', 'int-vec4-arb', 'bool', 'bool-arb',
'bool-vec2', 'bool-vec2-arb', 'bool-vec3', 'bool-vec3-arb',
'bool-vec4', 'bool-vec4-arb', 'float-mat2', 'float-mat2-arb',
'float-mat3', 'float-mat3-arb', 'float-mat4', 'float-mat4-arb',
'sampler-1d', 'sampler-1d-arb', 'sampler-2d', 'sampler-2d-arb',
'sampler-3d', 'sampler-3d-arb', 'sampler-cube', 'sampler-cube-arb',
'sampler-1d-shadow', 'sampler-1d-shadow-arb', 'sampler-2d-shadow',
'sampler-2d-shadow-arb', 'sampler-2d-rect-arb',
'sampler-2d-rect-shadow-arb', 'float-mat-2x-3', 'float-mat-2x-4',
'float-mat-3x-2', 'float-mat-3x-4', 'float-mat-4x-2',
'float-mat-4x-3', 'delete-status', 'object-delete-status-arb',
'compile-status', 'object-compile-status-arb', 'link-status',
'object-link-status-arb', 'validate-status',
'object-validate-status-arb', 'info-log-length',
'object-info-log-length-arb', 'attached-shaders',
'object-attached-objects-arb', 'active-uniforms',
'object-active-uniforms-arb', 'active-uniform-max-length',
'object-active-uniform-max-length-arb', 'shader-source-length',
'object-shader-source-length-arb', 'active-attributes',
'object-active-attributes-arb', 'active-attribute-max-length',
'object-active-attribute-max-length-arb',
'fragment-shader-derivative-hint',
'fragment-shader-derivative-hint-arb', 'shading-language-version',
'shading-language-version-arb'.
-- Macro: arb-fragment-shader enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fragment-shader', 'fragment-shader-arb', 'vertex-shader',
'vertex-shader-arb', 'program-object-arb', 'shader-object-arb',
'max-fragment-uniform-components',
'max-fragment-uniform-components-arb',
'max-vertex-uniform-components',
'max-vertex-uniform-components-arb', 'max-varying-floats',
'max-varying-floats-arb', 'max-vertex-texture-image-units',
'max-vertex-texture-image-units-arb',
'max-combined-texture-image-units',
'max-combined-texture-image-units-arb', 'object-type-arb',
'shader-type', 'object-subtype-arb', 'float-vec2',
'float-vec2-arb', 'float-vec3', 'float-vec3-arb', 'float-vec4',
'float-vec4-arb', 'int-vec2', 'int-vec2-arb', 'int-vec3',
'int-vec3-arb', 'int-vec4', 'int-vec4-arb', 'bool', 'bool-arb',
'bool-vec2', 'bool-vec2-arb', 'bool-vec3', 'bool-vec3-arb',
'bool-vec4', 'bool-vec4-arb', 'float-mat2', 'float-mat2-arb',
'float-mat3', 'float-mat3-arb', 'float-mat4', 'float-mat4-arb',
'sampler-1d', 'sampler-1d-arb', 'sampler-2d', 'sampler-2d-arb',
'sampler-3d', 'sampler-3d-arb', 'sampler-cube', 'sampler-cube-arb',
'sampler-1d-shadow', 'sampler-1d-shadow-arb', 'sampler-2d-shadow',
'sampler-2d-shadow-arb', 'sampler-2d-rect-arb',
'sampler-2d-rect-shadow-arb', 'float-mat-2x-3', 'float-mat-2x-4',
'float-mat-3x-2', 'float-mat-3x-4', 'float-mat-4x-2',
'float-mat-4x-3', 'delete-status', 'object-delete-status-arb',
'compile-status', 'object-compile-status-arb', 'link-status',
'object-link-status-arb', 'validate-status',
'object-validate-status-arb', 'info-log-length',
'object-info-log-length-arb', 'attached-shaders',
'object-attached-objects-arb', 'active-uniforms',
'object-active-uniforms-arb', 'active-uniform-max-length',
'object-active-uniform-max-length-arb', 'shader-source-length',
'object-shader-source-length-arb', 'active-attributes',
'object-active-attributes-arb', 'active-attribute-max-length',
'object-active-attribute-max-length-arb',
'fragment-shader-derivative-hint',
'fragment-shader-derivative-hint-arb', 'shading-language-version',
'shading-language-version-arb'.
-- Macro: nv-vertex-program-3 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fragment-shader', 'fragment-shader-arb', 'vertex-shader',
'vertex-shader-arb', 'program-object-arb', 'shader-object-arb',
'max-fragment-uniform-components',
'max-fragment-uniform-components-arb',
'max-vertex-uniform-components',
'max-vertex-uniform-components-arb', 'max-varying-floats',
'max-varying-floats-arb', 'max-vertex-texture-image-units',
'max-vertex-texture-image-units-arb',
'max-combined-texture-image-units',
'max-combined-texture-image-units-arb', 'object-type-arb',
'shader-type', 'object-subtype-arb', 'float-vec2',
'float-vec2-arb', 'float-vec3', 'float-vec3-arb', 'float-vec4',
'float-vec4-arb', 'int-vec2', 'int-vec2-arb', 'int-vec3',
'int-vec3-arb', 'int-vec4', 'int-vec4-arb', 'bool', 'bool-arb',
'bool-vec2', 'bool-vec2-arb', 'bool-vec3', 'bool-vec3-arb',
'bool-vec4', 'bool-vec4-arb', 'float-mat2', 'float-mat2-arb',
'float-mat3', 'float-mat3-arb', 'float-mat4', 'float-mat4-arb',
'sampler-1d', 'sampler-1d-arb', 'sampler-2d', 'sampler-2d-arb',
'sampler-3d', 'sampler-3d-arb', 'sampler-cube', 'sampler-cube-arb',
'sampler-1d-shadow', 'sampler-1d-shadow-arb', 'sampler-2d-shadow',
'sampler-2d-shadow-arb', 'sampler-2d-rect-arb',
'sampler-2d-rect-shadow-arb', 'float-mat-2x-3', 'float-mat-2x-4',
'float-mat-3x-2', 'float-mat-3x-4', 'float-mat-4x-2',
'float-mat-4x-3', 'delete-status', 'object-delete-status-arb',
'compile-status', 'object-compile-status-arb', 'link-status',
'object-link-status-arb', 'validate-status',
'object-validate-status-arb', 'info-log-length',
'object-info-log-length-arb', 'attached-shaders',
'object-attached-objects-arb', 'active-uniforms',
'object-active-uniforms-arb', 'active-uniform-max-length',
'object-active-uniform-max-length-arb', 'shader-source-length',
'object-shader-source-length-arb', 'active-attributes',
'object-active-attributes-arb', 'active-attribute-max-length',
'object-active-attribute-max-length-arb',
'fragment-shader-derivative-hint',
'fragment-shader-derivative-hint-arb', 'shading-language-version',
'shading-language-version-arb'.
-- Macro: oes-standard-derivatives enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fragment-shader-derivative-hint-oes'.
-- Macro: ext-geometry-shader-4 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-varying-components-ext', 'geometry-shader-ext',
'max-geometry-varying-components-ext',
'max-vertex-varying-components-ext',
'max-geometry-uniform-components-ext',
'max-geometry-output-vertices-ext',
'max-geometry-total-output-components-ext'.
-- Macro: oes-compressed-paletted-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'palette4-rgb8-oes', 'palette4-rgba8-oes', 'palette4-r5-g6-b5-oes',
'palette4-rgba4-oes', 'palette4-rgb5-a1-oes', 'palette8-rgb8-oes',
'palette8-rgba8-oes', 'palette8-r5-g6-b5-oes',
'palette8-rgba4-oes', 'palette8-rgb5-a1-oes'.
-- Macro: oes-read-format enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'implementation-color-read-type-oes',
'implementation-color-read-format-oes'.
-- Macro: oes-draw-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-crop-rect-oes'.
-- Macro: mesa-program-debug enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'fragment-program-position-mesa', 'fragment-program-callback-mesa',
'fragment-program-callback-func-mesa',
'fragment-program-callback-data-mesa',
'vertex-program-callback-mesa', 'vertex-program-position-mesa',
'vertex-program-callback-func-mesa',
'vertex-program-callback-data-mesa'.
-- Macro: amd-performance-monitor enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'counter-type-amd', 'counter-range-amd', 'unsigned-int64-amd',
'percentage-amd', 'perfmon-result-available-amd',
'perfmon-result-size-amd', 'perfmon-result-amd'.
-- Macro: qcom-extended-get enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-width-qcom', 'texture-height-qcom', 'texture-depth-qcom',
'texture-internal-format-qcom', 'texture-format-qcom',
'texture-type-qcom', 'texture-image-valid-qcom',
'texture-num-levels-qcom', 'texture-target-qcom',
'texture-object-valid-qcom', 'state-restore'.
-- Macro: img-texture-compression-pvrtc enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compressed-rgb-pvrtc-4bppv1-img',
'compressed-rgb-pvrtc-2bppv1-img',
'compressed-rgba-pvrtc-4bppv1-img',
'compressed-rgba-pvrtc-2bppv1-img'.
-- Macro: img-shader-binary enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sgx-binary-img'.
-- Macro: arb-texture-buffer-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-buffer-arb', 'max-texture-buffer-size-arb',
'texture-binding-buffer-arb',
'texture-buffer-data-store-binding-arb',
'texture-buffer-format-arb'.
-- Macro: ext-texture-buffer-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-buffer-ext', 'max-texture-buffer-size-ext',
'texture-binding-buffer-ext',
'texture-buffer-data-store-binding-ext',
'texture-buffer-format-ext'.
-- Macro: arb-occlusion-query-2 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'any-samples-passed'.
-- Macro: arb-sample-shading enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sample-shading-arb', 'min-sample-shading-value-arb'.
-- Macro: ext-packed-float enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'r11f-g11f-b10f-ext', 'unsigned-int-10f-11f-11f-rev-ext',
'rgba-signed-components-ext'.
-- Macro: ext-texture-shared-exponent enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'rgb9-e5-ext', 'unsigned-int-5-9-9-9-rev-ext',
'texture-shared-size-ext'.
-- Macro: ext-texture-s-rgb enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'srgb-ext', 'srgb8-ext', 'srgb-alpha-ext', 'srgb8-alpha8-ext',
'sluminance-alpha-ext', 'sluminance8-alpha8-ext', 'sluminance-ext',
'sluminance8-ext', 'compressed-srgb-ext',
'compressed-srgb-alpha-ext', 'compressed-sluminance-ext',
'compressed-sluminance-alpha-ext', 'compressed-srgb-s3tc-dxt1-ext',
'compressed-srgb-alpha-s3tc-dxt1-ext',
'compressed-srgb-alpha-s3tc-dxt3-ext',
'compressed-srgb-alpha-s3tc-dxt5-ext'.
-- Macro: ext-texture-compression-latc enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compressed-luminance-latc1-ext',
'compressed-signed-luminance-latc1-ext',
'compressed-luminance-alpha-latc2-ext',
'compressed-signed-luminance-alpha-latc2-ext'.
-- Macro: ext-transform-feedback enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'transform-feedback-varying-max-length',
'transform-feedback-varying-max-length-ext',
'back-primary-color-nv', 'back-secondary-color-nv',
'texture-coord-nv', 'clip-distance-nv', 'vertex-id-nv',
'primitive-id-nv', 'generic-attrib-nv',
'transform-feedback-attribs-nv', 'transform-feedback-buffer-mode',
'transform-feedback-buffer-mode-ext',
'transform-feedback-buffer-mode-nv',
'max-transform-feedback-separate-components',
'max-transform-feedback-separate-components-ext',
'max-transform-feedback-separate-components-nv',
'active-varyings-nv', 'active-varying-max-length-nv',
'transform-feedback-varyings', 'transform-feedback-varyings-ext',
'transform-feedback-varyings-nv',
'transform-feedback-buffer-start',
'transform-feedback-buffer-start-ext',
'transform-feedback-buffer-start-nv',
'transform-feedback-buffer-size',
'transform-feedback-buffer-size-ext',
'transform-feedback-buffer-size-nv',
'transform-feedback-record-nv', 'primitives-generated',
'primitives-generated-ext', 'primitives-generated-nv',
'transform-feedback-primitives-written',
'transform-feedback-primitives-written-ext',
'transform-feedback-primitives-written-nv', 'rasterizer-discard',
'rasterizer-discard-ext', 'rasterizer-discard-nv',
'max-transform-feedback-interleaved-components',
'max-transform-feedback-interleaved-components-ext',
'max-transform-feedback-interleaved-components-nv',
'max-transform-feedback-separate-attribs',
'max-transform-feedback-separate-attribs-ext',
'max-transform-feedback-separate-attribs-nv',
'interleaved-attribs', 'interleaved-attribs-ext',
'interleaved-attribs-nv', 'separate-attribs',
'separate-attribs-ext', 'separate-attribs-nv',
'transform-feedback-buffer', 'transform-feedback-buffer-ext',
'transform-feedback-buffer-nv',
'transform-feedback-buffer-binding',
'transform-feedback-buffer-binding-ext',
'transform-feedback-buffer-binding-nv'.
-- Macro: nv-transform-feedback enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'transform-feedback-varying-max-length',
'transform-feedback-varying-max-length-ext',
'back-primary-color-nv', 'back-secondary-color-nv',
'texture-coord-nv', 'clip-distance-nv', 'vertex-id-nv',
'primitive-id-nv', 'generic-attrib-nv',
'transform-feedback-attribs-nv', 'transform-feedback-buffer-mode',
'transform-feedback-buffer-mode-ext',
'transform-feedback-buffer-mode-nv',
'max-transform-feedback-separate-components',
'max-transform-feedback-separate-components-ext',
'max-transform-feedback-separate-components-nv',
'active-varyings-nv', 'active-varying-max-length-nv',
'transform-feedback-varyings', 'transform-feedback-varyings-ext',
'transform-feedback-varyings-nv',
'transform-feedback-buffer-start',
'transform-feedback-buffer-start-ext',
'transform-feedback-buffer-start-nv',
'transform-feedback-buffer-size',
'transform-feedback-buffer-size-ext',
'transform-feedback-buffer-size-nv',
'transform-feedback-record-nv', 'primitives-generated',
'primitives-generated-ext', 'primitives-generated-nv',
'transform-feedback-primitives-written',
'transform-feedback-primitives-written-ext',
'transform-feedback-primitives-written-nv', 'rasterizer-discard',
'rasterizer-discard-ext', 'rasterizer-discard-nv',
'max-transform-feedback-interleaved-components',
'max-transform-feedback-interleaved-components-ext',
'max-transform-feedback-interleaved-components-nv',
'max-transform-feedback-separate-attribs',
'max-transform-feedback-separate-attribs-ext',
'max-transform-feedback-separate-attribs-nv',
'interleaved-attribs', 'interleaved-attribs-ext',
'interleaved-attribs-nv', 'separate-attribs',
'separate-attribs-ext', 'separate-attribs-nv',
'transform-feedback-buffer', 'transform-feedback-buffer-ext',
'transform-feedback-buffer-nv',
'transform-feedback-buffer-binding',
'transform-feedback-buffer-binding-ext',
'transform-feedback-buffer-binding-nv', 'layer-nv',
'next-buffer-nv', 'skip-components4-nv', 'skip-components3-nv',
'skip-components2-nv', 'skip-components1-nv'.
-- Macro: ext-framebuffer-blit enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'draw-framebuffer-binding-ext', 'read-framebuffer-ext',
'draw-framebuffer-ext', 'draw-framebuffer-binding-ext',
'read-framebuffer-binding-ext'.
-- Macro: angle-framebuffer-blit enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'framebuffer-binding-angle', 'renderbuffer-binding-angle',
'read-framebuffer-angle', 'draw-framebuffer-angle'.
-- Macro: nv-framebuffer-blit enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'read-framebuffer-nv', 'draw-framebuffer-nv',
'draw-framebuffer-binding-nv', 'read-framebuffer-binding-nv'.
-- Macro: angle-framebuffer-multisample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'renderbuffer-samples-angle',
'framebuffer-incomplete-multisample-angle', 'max-samples-angle'.
-- Macro: ext-framebuffer-multisample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'renderbuffer-samples-ext',
'framebuffer-incomplete-multisample-ext', 'max-samples-ext'.
-- Macro: nv-framebuffer-multisample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'renderbuffer-samples-nv', 'framebuffer-incomplete-multisample-nv',
'max-samples-nv'.
-- Macro: nv-framebuffer-multisample-coverage enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'renderbuffer-coverage-samples-nv',
'renderbuffer-color-samples-nv',
'max-multisample-coverage-modes-nv',
'multisample-coverage-modes-nv'.
-- Macro: arb-depth-buffer-float enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-component32f', 'depth32f-stencil8',
'float-32-unsigned-int-24-8-rev'.
-- Macro: nv-fbo-color-attachments enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-color-attachments-nv'.
-- Macro: oes-stencil-1 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'stencil-index1-oes'.
-- Macro: oes-stencil-4 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'stencil-index4-oes'.
-- Macro: oes-stencil-8 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'stencil-index8-oes'.
-- Macro: oes-vertex-half-float enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'half-float-oes'.
-- Macro: version-4-1 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'rgb565'.
-- Macro: oes-compressed-etc1-rgb8-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'etc1-rgb8-oes'.
-- Macro: oes-egl-image-external enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-external-oes', 'sampler-external-oes',
'texture-binding-external-oes', 'required-texture-image-units-oes'.
-- Macro: arb-es3-compatibility enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'primitive-restart-fixed-index', 'any-samples-passed-conservative',
'max-element-index', 'compressed-r11-eac',
'compressed-signed-r11-eac', 'compressed-rg11-eac',
'compressed-signed-rg11-eac', 'compressed-rgb8-etc2',
'compressed-srgb8-etc2',
'compressed-rgb8-punchthrough-alpha1-etc2',
'compressed-srgb8-punchthrough-alpha1-etc2',
'compressed-rgba8-etc2-eac', 'compressed-srgb8-alpha8-etc2-eac'.
-- Macro: ext-multisampled-render-to-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'framebuffer-attachment-texture-samples-ext'.
-- Macro: ext-texture-integer enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'rgba32ui', 'rgba32ui-ext', 'rgb32ui', 'rgb32ui-ext',
'alpha32ui-ext', 'intensity32ui-ext', 'luminance32ui-ext',
'luminance-alpha32ui-ext', 'rgba16ui', 'rgba16ui-ext', 'rgb16ui',
'rgb16ui-ext', 'alpha16ui-ext', 'intensity16ui-ext',
'luminance16ui-ext', 'luminance-alpha16ui-ext', 'rgba8ui',
'rgba8ui-ext', 'rgb8ui', 'rgb8ui-ext', 'alpha8ui-ext',
'intensity8ui-ext', 'luminance8ui-ext', 'luminance-alpha8ui-ext',
'rgba32i', 'rgba32i-ext', 'rgb32i', 'rgb32i-ext', 'alpha32i-ext',
'intensity32i-ext', 'luminance32i-ext', 'luminance-alpha32i-ext',
'rgba16i', 'rgba16i-ext', 'rgb16i', 'rgb16i-ext', 'alpha16i-ext',
'intensity16i-ext', 'luminance16i-ext', 'luminance-alpha16i-ext',
'rgba8i', 'rgba8i-ext', 'rgb8i', 'rgb8i-ext', 'alpha8i-ext',
'intensity8i-ext', 'luminance8i-ext', 'luminance-alpha8i-ext',
'red-integer', 'red-integer-ext', 'green-integer',
'green-integer-ext', 'blue-integer', 'blue-integer-ext',
'alpha-integer', 'alpha-integer-ext', 'rgb-integer',
'rgb-integer-ext', 'rgba-integer', 'rgba-integer-ext',
'bgr-integer', 'bgr-integer-ext', 'bgra-integer',
'bgra-integer-ext', 'luminance-integer-ext',
'luminance-alpha-integer-ext', 'rgba-integer-mode-ext'.
-- Macro: arb-vertex-type-2-10-10-10-rev enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'int-2-10-10-10-rev'.
-- Macro: nv-parameter-buffer-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-program-parameter-buffer-bindings-nv',
'max-program-parameter-buffer-size-nv',
'vertex-program-parameter-buffer-nv',
'geometry-program-parameter-buffer-nv',
'fragment-program-parameter-buffer-nv'.
-- Macro: nv-depth-buffer-float enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-component32f-nv', 'depth32f-stencil8-nv',
'float-32-unsigned-int-24-8-rev-nv', 'depth-buffer-float-mode-nv'.
-- Macro: arb-shading-language-include enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'shader-include-arb', 'named-string-length-arb',
'named-string-type-arb'.
-- Macro: arb-framebuffer-s-rgb enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'framebuffer-srgb'.
-- Macro: ext-framebuffer-s-rgb enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'framebuffer-srgb-ext', 'framebuffer-srgb-capable-ext'.
-- Macro: arb-texture-compression-rgtc enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compressed-red-rgtc1', 'compressed-signed-red-rgtc1',
'compressed-rg-rgtc2', 'compressed-signed-rg-rgtc2'.
-- Macro: ext-texture-compression-rgtc enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compressed-red-rgtc1-ext', 'compressed-signed-red-rgtc1-ext',
'compressed-red-green-rgtc2-ext',
'compressed-signed-red-green-rgtc2-ext'.
-- Macro: ext-gpu-shader-4 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sampler-1d-array-ext', 'sampler-2d-array-ext',
'sampler-buffer-ext', 'sampler-1d-array-shadow-ext',
'sampler-2d-array-shadow-ext', 'sampler-cube-shadow-ext',
'unsigned-int-vec2-ext', 'unsigned-int-vec3-ext',
'unsigned-int-vec4-ext', 'int-sampler-1d-ext',
'int-sampler-2d-ext', 'int-sampler-3d-ext', 'int-sampler-cube-ext',
'int-sampler-2d-rect-ext', 'int-sampler-1d-array-ext',
'int-sampler-2d-array-ext', 'int-sampler-buffer-ext',
'unsigned-int-sampler-1d-ext', 'unsigned-int-sampler-2d-ext',
'unsigned-int-sampler-3d-ext', 'unsigned-int-sampler-cube-ext',
'unsigned-int-sampler-2d-rect-ext',
'unsigned-int-sampler-1d-array-ext',
'unsigned-int-sampler-2d-array-ext',
'unsigned-int-sampler-buffer-ext'.
-- Macro: nv-shadow-samplers-array enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sampler-2d-array-shadow-nv'.
-- Macro: nv-shadow-samplers-cube enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sampler-cube-shadow-nv'.
-- Macro: ext-bindable-uniform enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-vertex-bindable-uniforms-ext',
'max-fragment-bindable-uniforms-ext',
'max-geometry-bindable-uniforms-ext',
'max-bindable-uniform-size-ext', 'uniform-buffer-ext',
'uniform-buffer-binding-ext'.
-- Macro: arb-shader-subroutine enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'active-subroutines', 'active-subroutine-uniforms',
'max-subroutines', 'max-subroutine-uniform-locations',
'active-subroutine-uniform-locations',
'active-subroutine-max-length',
'active-subroutine-uniform-max-length',
'num-compatible-subroutines', 'compatible-subroutines'.
-- Macro: oes-vertex-type-10-10-10-2 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'unsigned-int-10-10-10-2-oes', 'int-10-10-10-2-oes'.
-- Macro: nv-conditional-render enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'query-wait-nv', 'query-no-wait-nv', 'query-by-region-wait-nv',
'query-by-region-no-wait-nv'.
-- Macro: arb-transform-feedback-2 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'transform-feedback', 'transform-feedback-paused',
'transform-feedback-buffer-paused', 'transform-feedback-active',
'transform-feedback-buffer-active', 'transform-feedback-binding'.
-- Macro: nv-transform-feedback-2 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'transform-feedback-nv', 'transform-feedback-buffer-paused-nv',
'transform-feedback-buffer-active-nv',
'transform-feedback-binding-nv'.
-- Macro: nv-present-video enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'frame-nv', 'fields-nv', 'current-time-nv', 'num-fill-streams-nv',
'present-time-nv', 'present-duration-nv'.
-- Macro: nv-depth-nonlinear enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-component16-nonlinear-nv'.
-- Macro: ext-direct-state-access enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'program-matrix-ext', 'transpose-program-matrix-ext',
'program-matrix-stack-depth-ext'.
-- Macro: arb-texture-swizzle enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-swizzle-r', 'texture-swizzle-g', 'texture-swizzle-b',
'texture-swizzle-a', 'texture-swizzle-rgba'.
-- Macro: ext-texture-swizzle enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-swizzle-r-ext', 'texture-swizzle-g-ext',
'texture-swizzle-b-ext', 'texture-swizzle-a-ext',
'texture-swizzle-rgba-ext'.
-- Macro: arb-provoking-vertex enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'quads-follow-provoking-vertex-convention',
'first-vertex-convention', 'last-vertex-convention',
'provoking-vertex'.
-- Macro: ext-provoking-vertex enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'quads-follow-provoking-vertex-convention-ext',
'first-vertex-convention-ext', 'last-vertex-convention-ext',
'provoking-vertex-ext'.
-- Macro: arb-texture-multisample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sample-position', 'sample-mask', 'sample-mask-value',
'max-sample-mask-words', 'texture-2d-multisample',
'proxy-texture-2d-multisample', 'texture-2d-multisample-array',
'proxy-texture-2d-multisample-array',
'texture-binding-2d-multisample',
'texture-binding-2d-multisample-array', 'texture-samples',
'texture-fixed-sample-locations', 'sampler-2d-multisample',
'int-sampler-2d-multisample',
'unsigned-int-sampler-2d-multisample',
'sampler-2d-multisample-array', 'int-sampler-2d-multisample-array',
'unsigned-int-sampler-2d-multisample-array',
'max-color-texture-samples', 'max-depth-texture-samples',
'max-integer-samples'.
-- Macro: nv-explicit-multisample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sample-position-nv', 'sample-mask-nv', 'sample-mask-value-nv',
'texture-binding-renderbuffer-nv',
'texture-renderbuffer-data-store-binding-nv',
'texture-renderbuffer-nv', 'sampler-renderbuffer-nv',
'int-sampler-renderbuffer-nv',
'unsigned-int-sampler-renderbuffer-nv', 'max-sample-mask-words-nv'.
-- Macro: nv-gpu-program-5 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-geometry-program-invocations-nv',
'min-fragment-interpolation-offset-nv',
'max-fragment-interpolation-offset-nv',
'fragment-program-interpolation-offset-bits-nv',
'min-program-texture-gather-offset-nv',
'max-program-texture-gather-offset-nv',
'max-program-subroutine-parameters-nv',
'max-program-subroutine-num-nv'.
-- Macro: arb-texture-gather enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'min-program-texture-gather-offset',
'max-program-texture-gather-offset',
'max-program-texture-gather-components-arb',
'max-program-texture-gather-components'.
-- Macro: arb-transform-feedback-3 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-transform-feedback-buffers', 'max-vertex-streams'.
-- Macro: arb-texture-compression-bptc enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compressed-rgba-bptc-unorm-arb',
'compressed-srgb-alpha-bptc-unorm-arb',
'compressed-rgb-bptc-signed-float-arb',
'compressed-rgb-bptc-unsigned-float-arb'.
-- Macro: nv-coverage-sample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'coverage-component-nv', 'coverage-component4-nv',
'coverage-attachment-nv', 'coverage-buffers-nv',
'coverage-samples-nv', 'coverage-all-fragments-nv',
'coverage-edge-fragments-nv', 'coverage-automatic-nv',
'coverage-buffer-bit-nv'.
-- Macro: nv-shader-buffer-load enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'buffer-gpu-address-nv', 'gpu-address-nv',
'max-shader-buffer-address-nv'.
-- Macro: nv-vertex-buffer-unified-memory enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vertex-attrib-array-unified-nv', 'element-array-unified-nv',
'vertex-attrib-array-address-nv', 'vertex-array-address-nv',
'normal-array-address-nv', 'color-array-address-nv',
'index-array-address-nv', 'texture-coord-array-address-nv',
'edge-flag-array-address-nv', 'secondary-color-array-address-nv',
'fog-coord-array-address-nv', 'element-array-address-nv',
'vertex-attrib-array-length-nv', 'vertex-array-length-nv',
'normal-array-length-nv', 'color-array-length-nv',
'index-array-length-nv', 'texture-coord-array-length-nv',
'edge-flag-array-length-nv', 'secondary-color-array-length-nv',
'fog-coord-array-length-nv', 'element-array-length-nv',
'draw-indirect-unified-nv', 'draw-indirect-address-nv',
'draw-indirect-length-nv'.
-- Macro: arb-copy-buffer enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'copy-read-buffer-binding', 'copy-read-buffer',
'copy-write-buffer-binding', 'copy-write-buffer'.
-- Macro: arb-draw-indirect enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'draw-indirect-buffer', 'draw-indirect-buffer-binding'.
-- Macro: arb-gpu-shader-fp-64 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'double-mat2', 'double-mat3', 'double-mat4', 'double-mat-2x-3',
'double-mat-2x-4', 'double-mat-3x-2', 'double-mat-3x-4',
'double-mat-4x-2', 'double-mat-4x-3', 'double-vec2', 'double-vec3',
'double-vec4'.
-- Macro: arm-mali-shader-binary enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'mali-shader-binary-arm'.
-- Macro: qcom-driver-control enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'perfmon-global-mode-qcom'.
-- Macro: qcom-binning-control enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'binning-control-hint-qcom', 'cpu-optimized-qcom',
'gpu-optimized-qcom', 'render-direct-to-framebuffer-qcom'.
-- Macro: viv-shader-binary enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'shader-binary-viv'.
-- Macro: amd-vertex-shader-tesselator enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sampler-buffer-amd', 'int-sampler-buffer-amd',
'unsigned-int-sampler-buffer-amd', 'tessellation-mode-amd',
'tessellation-factor-amd', 'discrete-amd', 'continuous-amd'.
-- Macro: arb-texture-cube-map-array enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-cube-map-array', 'texture-binding-cube-map-array',
'proxy-texture-cube-map-array', 'sampler-cube-map-array',
'sampler-cube-map-array-shadow', 'int-sampler-cube-map-array',
'unsigned-int-sampler-cube-map-array'.
-- Macro: ext-texture-snorm enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'alpha-snorm', 'luminance-snorm', 'luminance-alpha-snorm',
'intensity-snorm', 'alpha8-snorm', 'luminance8-snorm',
'luminance8-alpha8-snorm', 'intensity8-snorm', 'alpha16-snorm',
'luminance16-snorm', 'luminance16-alpha16-snorm',
'intensity16-snorm'.
-- Macro: amd-blend-minmax-factor enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'factor-min-amd', 'factor-max-amd'.
-- Macro: amd-depth-clamp-separate enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-clamp-near-amd', 'depth-clamp-far-amd'.
-- Macro: nv-video-capture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'video-buffer-nv', 'video-buffer-binding-nv', 'field-upper-nv',
'field-lower-nv', 'num-video-capture-streams-nv',
'next-video-capture-buffer-status-nv',
'video-capture-to-422-supported-nv',
'last-video-capture-status-nv', 'video-buffer-pitch-nv',
'video-color-conversion-matrix-nv',
'video-color-conversion-max-nv', 'video-color-conversion-min-nv',
'video-color-conversion-offset-nv',
'video-buffer-internal-format-nv', 'partial-success-nv',
'success-nv', 'failure-nv', 'ycbycr8-422-nv', 'ycbaycr8a-4224-nv',
'z6y10z6cb10z6y10z6cr10-422-nv',
'z6y10z6cb10z6a10z6y10z6cr10z6a10-4224-nv',
'z4y12z4cb12z4y12z4cr12-422-nv',
'z4y12z4cb12z4a12z4y12z4cr12z4a12-4224-nv',
'z4y12z4cb12z4cr12-444-nv', 'video-capture-frame-width-nv',
'video-capture-frame-height-nv',
'video-capture-field-upper-height-nv',
'video-capture-field-lower-height-nv',
'video-capture-surface-origin-nv'.
-- Macro: nv-texture-multisample enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-coverage-samples-nv', 'texture-color-samples-nv'.
-- Macro: arb-texture-rgb-10-a-2-ui enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'rgb10-a2ui'.
-- Macro: nv-path-rendering enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'path-format-svg-nv', 'path-format-ps-nv', 'standard-font-name-nv',
'system-font-name-nv', 'file-name-nv', 'path-stroke-width-nv',
'path-end-caps-nv', 'path-initial-end-cap-nv',
'path-terminal-end-cap-nv', 'path-join-style-nv',
'path-miter-limit-nv', 'path-dash-caps-nv',
'path-initial-dash-cap-nv', 'path-terminal-dash-cap-nv',
'path-dash-offset-nv', 'path-client-length-nv',
'path-fill-mode-nv', 'path-fill-mask-nv',
'path-fill-cover-mode-nv', 'path-stroke-cover-mode-nv',
'path-stroke-mask-nv', 'count-up-nv', 'count-down-nv',
'path-object-bounding-box-nv', 'convex-hull-nv', 'bounding-box-nv',
'translate-x-nv', 'translate-y-nv', 'translate-2d-nv',
'translate-3d-nv', 'affine-2d-nv', 'affine-3d-nv',
'transpose-affine-2d-nv', 'transpose-affine-3d-nv', 'utf8-nv',
'utf16-nv', 'bounding-box-of-bounding-boxes-nv',
'path-command-count-nv', 'path-coord-count-nv',
'path-dash-array-count-nv', 'path-computed-length-nv',
'path-fill-bounding-box-nv', 'path-stroke-bounding-box-nv',
'square-nv', 'round-nv', 'triangular-nv', 'bevel-nv',
'miter-revert-nv', 'miter-truncate-nv', 'skip-missing-glyph-nv',
'use-missing-glyph-nv', 'path-error-position-nv',
'path-fog-gen-mode-nv', 'accum-adjacent-pairs-nv',
'adjacent-pairs-nv', 'first-to-rest-nv', 'path-gen-mode-nv',
'path-gen-coeff-nv', 'path-gen-color-format-nv',
'path-gen-components-nv', 'path-dash-offset-reset-nv',
'move-to-resets-nv', 'move-to-continues-nv',
'path-stencil-func-nv', 'path-stencil-ref-nv',
'path-stencil-value-mask-nv', 'close-path-nv', 'move-to-nv',
'relative-move-to-nv', 'line-to-nv', 'relative-line-to-nv',
'horizontal-line-to-nv', 'relative-horizontal-line-to-nv',
'vertical-line-to-nv', 'relative-vertical-line-to-nv',
'quadratic-curve-to-nv', 'relative-quadratic-curve-to-nv',
'cubic-curve-to-nv', 'relative-cubic-curve-to-nv',
'smooth-quadratic-curve-to-nv',
'relative-smooth-quadratic-curve-to-nv',
'smooth-cubic-curve-to-nv', 'relative-smooth-cubic-curve-to-nv',
'small-ccw-arc-to-nv', 'relative-small-ccw-arc-to-nv',
'small-cw-arc-to-nv', 'relative-small-cw-arc-to-nv',
'large-ccw-arc-to-nv', 'relative-large-ccw-arc-to-nv',
'large-cw-arc-to-nv', 'relative-large-cw-arc-to-nv',
'restart-path-nv', 'dup-first-cubic-curve-to-nv',
'dup-last-cubic-curve-to-nv', 'rect-nv', 'circular-ccw-arc-to-nv',
'circular-cw-arc-to-nv', 'circular-tangent-arc-to-nv', 'arc-to-nv',
'relative-arc-to-nv', 'bold-bit-nv', 'italic-bit-nv',
'glyph-width-bit-nv', 'glyph-height-bit-nv',
'glyph-horizontal-bearing-x-bit-nv',
'glyph-horizontal-bearing-y-bit-nv',
'glyph-horizontal-bearing-advance-bit-nv',
'glyph-vertical-bearing-x-bit-nv',
'glyph-vertical-bearing-y-bit-nv',
'glyph-vertical-bearing-advance-bit-nv',
'glyph-has-kerning-bit-nv', 'font-x-min-bounds-bit-nv',
'font-y-min-bounds-bit-nv', 'font-x-max-bounds-bit-nv',
'font-y-max-bounds-bit-nv', 'font-units-per-em-bit-nv',
'font-ascender-bit-nv', 'font-descender-bit-nv',
'font-height-bit-nv', 'font-max-advance-width-bit-nv',
'font-max-advance-height-bit-nv', 'font-underline-position-bit-nv',
'font-underline-thickness-bit-nv', 'font-has-kerning-bit-nv',
'path-stencil-depth-offset-factor-nv',
'path-stencil-depth-offset-units-nv', 'path-cover-depth-func-nv'.
-- Macro: ext-framebuffer-multisample-blit-scaled enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'scaled-resolve-fastest-ext', 'scaled-resolve-nicest-ext'.
-- Macro: arb-map-buffer-alignment enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'min-map-buffer-alignment'.
-- Macro: nv-deep-texture-3d enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-deep-3d-texture-width-height-nv',
'max-deep-3d-texture-depth-nv'.
-- Macro: ext-x-11-sync-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sync-x11-fence-ext'.
-- Macro: arb-stencil-texturing enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'depth-stencil-texture-mode'.
-- Macro: nv-compute-program-5 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compute-program-nv', 'compute-program-parameter-buffer-nv'.
-- Macro: arb-sync enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-server-wait-timeout', 'object-type', 'sync-condition',
'sync-status', 'sync-flags', 'sync-fence',
'sync-gpu-commands-complete', 'unsignaled', 'signaled',
'already-signaled', 'timeout-expired', 'condition-satisfied',
'wait-failed', 'sync-flush-commands-bit', 'timeout-ignored'.
-- Macro: arb-compressed-texture-pixel-storage enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'unpack-compressed-block-width', 'unpack-compressed-block-height',
'unpack-compressed-block-depth', 'unpack-compressed-block-size',
'pack-compressed-block-width', 'pack-compressed-block-height',
'pack-compressed-block-depth', 'pack-compressed-block-size'.
-- Macro: arb-texture-storage enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-immutable-format'.
-- Macro: img-program-binary enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sgx-program-binary-img'.
-- Macro: img-multisampled-render-to-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'renderbuffer-samples-img',
'framebuffer-incomplete-multisample-img', 'max-samples-img',
'texture-samples-img'.
-- Macro: img-texture-compression-pvrtc-2 enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compressed-rgba-pvrtc-2bppv2-img',
'compressed-rgba-pvrtc-4bppv2-img'.
-- Macro: amd-debug-output enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'max-debug-message-length-amd', 'max-debug-logged-messages-amd',
'debug-logged-messages-amd', 'debug-severity-high-amd',
'debug-severity-medium-amd', 'debug-severity-low-amd',
'debug-category-api-error-amd', 'debug-category-window-system-amd',
'debug-category-deprecation-amd',
'debug-category-undefined-behavior-amd',
'debug-category-performance-amd',
'debug-category-shader-compiler-amd',
'debug-category-application-amd', 'debug-category-other-amd'.
-- Macro: amd-name-gen-delete enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'data-buffer-amd', 'performance-monitor-amd', 'query-object-amd',
'vertex-array-object-amd', 'sampler-object-amd'.
-- Macro: amd-pinned-memory enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'external-virtual-memory-buffer-amd'.
-- Macro: amd-query-buffer-object enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'query-buffer-amd', 'query-buffer-binding-amd',
'query-result-no-wait-amd'.
-- Macro: amd-sparse-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'virtual-page-size-x-amd', 'virtual-page-size-y-amd',
'virtual-page-size-z-amd', 'max-sparse-texture-size-amd',
'max-sparse-3d-texture-size-amd',
'max-sparse-array-texture-layers', 'min-sparse-level-amd',
'min-lod-warning-amd', 'texture-storage-sparse-bit-amd'.
-- Macro: arb-texture-buffer-range enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-buffer-offset', 'texture-buffer-size',
'texture-buffer-offset-alignment'.
-- Macro: dmp-shader-binary enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'shader-binary-dmp'.
-- Macro: fj-shader-binary-gccso enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'gccso-shader-binary-fj'.
-- Macro: arb-shader-atomic-counters enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'atomic-counter-buffer', 'atomic-counter-buffer-binding',
'atomic-counter-buffer-start', 'atomic-counter-buffer-size',
'atomic-counter-buffer-data-size',
'atomic-counter-buffer-active-atomic-counters',
'atomic-counter-buffer-active-atomic-counter-indices',
'atomic-counter-buffer-referenced-by-vertex-shader',
'atomic-counter-buffer-referenced-by-tess-control-shader',
'atomic-counter-buffer-referenced-by-tess-evaluation-shader',
'atomic-counter-buffer-referenced-by-geometry-shader',
'atomic-counter-buffer-referenced-by-fragment-shader',
'max-vertex-atomic-counter-buffers',
'max-tess-control-atomic-counter-buffers',
'max-tess-evaluation-atomic-counter-buffers',
'max-geometry-atomic-counter-buffers',
'max-fragment-atomic-counter-buffers',
'max-combined-atomic-counter-buffers',
'max-vertex-atomic-counters', 'max-tess-control-atomic-counters',
'max-tess-evaluation-atomic-counters',
'max-geometry-atomic-counters', 'max-fragment-atomic-counters',
'max-combined-atomic-counters', 'max-atomic-counter-buffer-size',
'max-atomic-counter-buffer-bindings',
'active-atomic-counter-buffers',
'uniform-atomic-counter-buffer-index',
'unsigned-int-atomic-counter'.
-- Macro: arb-program-interface-query enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'uniform', 'uniform-block', 'program-input', 'program-output',
'buffer-variable', 'shader-storage-block', 'is-per-patch',
'vertex-subroutine', 'tess-control-subroutine',
'tess-evaluation-subroutine', 'geometry-subroutine',
'fragment-subroutine', 'compute-subroutine',
'vertex-subroutine-uniform', 'tess-control-subroutine-uniform',
'tess-evaluation-subroutine-uniform',
'geometry-subroutine-uniform', 'fragment-subroutine-uniform',
'compute-subroutine-uniform', 'transform-feedback-varying',
'active-resources', 'max-name-length', 'max-num-active-variables',
'max-num-compatible-subroutines', 'name-length', 'type',
'array-size', 'offset', 'block-index', 'array-stride',
'matrix-stride', 'is-row-major', 'atomic-counter-buffer-index',
'buffer-binding', 'buffer-data-size', 'num-active-variables',
'active-variables', 'referenced-by-vertex-shader',
'referenced-by-tess-control-shader',
'referenced-by-tess-evaluation-shader',
'referenced-by-geometry-shader', 'referenced-by-fragment-shader',
'referenced-by-compute-shader', 'top-level-array-size',
'top-level-array-stride', 'location', 'location-index'.
-- Macro: arb-framebuffer-no-attachments enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'framebuffer-default-width', 'framebuffer-default-height',
'framebuffer-default-layers', 'framebuffer-default-samples',
'framebuffer-default-fixed-sample-locations',
'max-framebuffer-width', 'max-framebuffer-height',
'max-framebuffer-layers', 'max-framebuffer-samples'.
-- Macro: arb-internalformat-query enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'num-sample-counts'.
-- Macro: angle-translated-shader-source enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'translated-shader-source-length-angle'.
-- Macro: angle-texture-usage enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-usage-angle', 'framebuffer-attachment-angle', 'none'.
-- Macro: angle-pack-reverse-row-order enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pack-reverse-row-order-angle'.
-- Macro: angle-depth-texture enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'program-binary-angle'.
-- Macro: gl-khr-texture-compression-astc-ldr enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'compressed-rgba-astc-4x4-khr', 'compressed-rgba-astc-5x4-khr',
'compressed-rgba-astc-5x5-khr', 'compressed-rgba-astc-6x5-khr',
'compressed-rgba-astc-6x6-khr', 'compressed-rgba-astc-8x5-khr',
'compressed-rgba-astc-8x6-khr', 'compressed-rgba-astc-8x8-khr',
'compressed-rgba-astc-10x5-khr', 'compressed-rgba-astc-10x6-khr',
'compressed-rgba-astc-10x8-khr', 'compressed-rgba-astc-10x10-khr',
'compressed-rgba-astc-12x10-khr', 'compressed-rgba-astc-12x12-khr',
'compressed-srgb8-alpha8-astc-4x4-khr',
'compressed-srgb8-alpha8-astc-5x4-khr',
'compressed-srgb8-alpha8-astc-5x5-khr',
'compressed-srgb8-alpha8-astc-6x5-khr',
'compressed-srgb8-alpha8-astc-6x6-khr',
'compressed-srgb8-alpha8-astc-8x5-khr',
'compressed-srgb8-alpha8-astc-8x6-khr',
'compressed-srgb8-alpha8-astc-8x8-khr',
'compressed-srgb8-alpha8-astc-10x5-khr',
'compressed-srgb8-alpha8-astc-10x6-khr',
'compressed-srgb8-alpha8-astc-10x8-khr',
'compressed-srgb8-alpha8-astc-10x10-khr',
'compressed-srgb8-alpha8-astc-12x10-khr',
'compressed-srgb8-alpha8-astc-12x12-khr'.
3.6 Low-Level GL
================
The functions from this section may be had by loading the module:
(use-modules (gl low-level)
This section of the manual was derived from the upstream OpenGL
documentation. Each function's documentation has its own copyright
statement; for full details, see the upstream documentation. The
copyright notices and licenses present in this section are as follows.
Copyright (C) 1991-2006 Silicon Graphics, Inc. This document is
licensed under the SGI Free Software B License. For details, see
http://oss.sgi.com/projects/FreeB/ (http://oss.sgi.com/projects/FreeB/).
Copyright (C) 2003-2005 3Dlabs Inc. Ltd. This material may be
distributed subject to the terms and conditions set forth in the Open
Publication License, v 1.0, 8 June 1999.
http://opencontent.org/openpub/ (http://opencontent.org/openpub/).
Copyright (C) 2005 Addison-Wesley. This material may be distributed
subject to the terms and conditions set forth in the Open Publication
License, v 1.0, 8 June 1999. http://opencontent.org/openpub/
(http://opencontent.org/openpub/).
Copyright (C) 2006 Khronos Group. This material may be distributed
subject to the terms and conditions set forth in the Open Publication
License, v 1.0, 8 June 1999. http://opencontent.org/openpub/
(http://opencontent.org/openpub/).
-- Function: void glAccum op value
Operate on the accumulation buffer.
OP
Specifies the accumulation buffer operation. Symbolic
constants 'GL_ACCUM', 'GL_LOAD', 'GL_ADD', 'GL_MULT', and
'GL_RETURN' are accepted.
VALUE
Specifies a floating-point value used in the accumulation
buffer operation. OP determines how VALUE is used.
The accumulation buffer is an extended-range color buffer. Images
are not rendered into it. Rather, images rendered into one of the
color buffers are added to the contents of the accumulation buffer
after rendering. Effects such as antialiasing (of points, lines,
and polygons), motion blur, and depth of field can be created by
accumulating images generated with different transformation
matrices.
Each pixel in the accumulation buffer consists of red, green, blue,
and alpha values. The number of bits per component in the
accumulation buffer depends on the implementation. You can examine
this number by calling 'glGetIntegerv' four times, with arguments
'GL_ACCUM_RED_BITS', 'GL_ACCUM_GREEN_BITS', 'GL_ACCUM_BLUE_BITS',
and 'GL_ACCUM_ALPHA_BITS'. Regardless of the number of bits per
component, the range of values stored by each component is [-1,1].
The accumulation buffer pixels are mapped one-to-one with frame
buffer pixels.
'glAccum' operates on the accumulation buffer. The first argument,
OP, is a symbolic constant that selects an accumulation buffer
operation. The second argument, VALUE, is a floating-point value
to be used in that operation. Five operations are specified:
'GL_ACCUM', 'GL_LOAD', 'GL_ADD', 'GL_MULT', and 'GL_RETURN'.
All accumulation buffer operations are limited to the area of the
current scissor box and applied identically to the red, green,
blue, and alpha components of each pixel. If a 'glAccum' operation
results in a value outside the range [-1,1], the contents of an
accumulation buffer pixel component are undefined.
The operations are as follows:
'GL_ACCUM'
Obtains R, G, B, and A values from the buffer currently
selected for reading (see 'glReadBuffer'). Each component
value is divided by 2^N-1, where N is the number of bits
allocated to each color component in the currently selected
buffer. The result is a floating-point value in the range
[0,1], which is multiplied by VALUE and added to the
corresponding pixel component in the accumulation buffer,
thereby updating the accumulation buffer.
'GL_LOAD'
Similar to 'GL_ACCUM', except that the current value in the
accumulation buffer is not used in the calculation of the new
value. That is, the R, G, B, and A values from the currently
selected buffer are divided by 2^N-1, multiplied by VALUE, and
then stored in the corresponding accumulation buffer cell,
overwriting the current value.
'GL_ADD'
Adds VALUE to each R, G, B, and A in the accumulation buffer.
'GL_MULT'
Multiplies each R, G, B, and A in the accumulation buffer by
VALUE and returns the scaled component to its corresponding
accumulation buffer location.
'GL_RETURN'
Transfers accumulation buffer values to the color buffer or
buffers currently selected for writing. Each R, G, B, and A
component is multiplied by VALUE, then multiplied by 2^N-1,
clamped to the range [0,2^N-1], and stored in the
corresponding display buffer cell. The only fragment
operations that are applied to this transfer are pixel
ownership, scissor, dithering, and color writemasks.
To clear the accumulation buffer, call 'glClearAccum' with R, G, B,
and A values to set it to, then call 'glClear' with the
accumulation buffer enabled.
'GL_INVALID_ENUM' is generated if OP is not an accepted value.
'GL_INVALID_OPERATION' is generated if there is no accumulation
buffer.
'GL_INVALID_OPERATION' is generated if 'glAccum' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glActiveTexture texture
Select active texture unit.
TEXTURE
Specifies which texture unit to make active. The number of
texture units is implementation dependent, but must be at
least two. TEXTURE must be one of 'GL_TEXTURE'I, where i
ranges from 0 to the larger of ('GL_MAX_TEXTURE_COORDS' - 1)
and ('GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS' - 1). The initial
value is 'GL_TEXTURE0'.
'glActiveTexture' selects which texture unit subsequent texture
state calls will affect. The number of texture units an
implementation supports is implementation dependent, but must be at
least 2.
Vertex arrays are client-side GL resources, which are selected by
the 'glClientActiveTexture' routine.
'GL_INVALID_ENUM' is generated if TEXTURE is not one of
'GL_TEXTURE'I, where i ranges from 0 to the larger of
('GL_MAX_TEXTURE_COORDS' - 1) and
('GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS' - 1).
-- Function: void glAlphaFunc func ref
Specify the alpha test function.
FUNC
Specifies the alpha comparison function. Symbolic constants
'GL_NEVER', 'GL_LESS', 'GL_EQUAL', 'GL_LEQUAL', 'GL_GREATER',
'GL_NOTEQUAL', 'GL_GEQUAL', and 'GL_ALWAYS' are accepted. The
initial value is 'GL_ALWAYS'.
REF
Specifies the reference value that incoming alpha values are
compared to. This value is clamped to the range [0,1], where
0 represents the lowest possible alpha value and 1 the highest
possible value. The initial reference value is 0.
The alpha test discards fragments depending on the outcome of a
comparison between an incoming fragment's alpha value and a
constant reference value. 'glAlphaFunc' specifies the reference
value and the comparison function. The comparison is performed
only if alpha testing is enabled. By default, it is not enabled.
(See 'glEnable' and 'glDisable' of 'GL_ALPHA_TEST'.)
FUNC and REF specify the conditions under which the pixel is drawn.
The incoming alpha value is compared to REF using the function
specified by FUNC. If the value passes the comparison, the
incoming fragment is drawn if it also passes subsequent stencil and
depth buffer tests. If the value fails the comparison, no change
is made to the frame buffer at that pixel location. The comparison
functions are as follows:
'GL_NEVER'
Never passes.
'GL_LESS'
Passes if the incoming alpha value is less than the reference
value.
'GL_EQUAL'
Passes if the incoming alpha value is equal to the reference
value.
'GL_LEQUAL'
Passes if the incoming alpha value is less than or equal to
the reference value.
'GL_GREATER'
Passes if the incoming alpha value is greater than the
reference value.
'GL_NOTEQUAL'
Passes if the incoming alpha value is not equal to the
reference value.
'GL_GEQUAL'
Passes if the incoming alpha value is greater than or equal to
the reference value.
'GL_ALWAYS'
Always passes (initial value).
'glAlphaFunc' operates on all pixel write operations, including
those resulting from the scan conversion of points, lines,
polygons, and bitmaps, and from pixel draw and copy operations.
'glAlphaFunc' does not affect screen clear operations.
'GL_INVALID_ENUM' is generated if FUNC is not an accepted value.
'GL_INVALID_OPERATION' is generated if 'glAlphaFunc' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: GLboolean glAreTexturesResident n textures residences
Determine if textures are loaded in texture memory.
N
Specifies the number of textures to be queried.
TEXTURES
Specifies an array containing the names of the textures to be
queried.
RESIDENCES
Specifies an array in which the texture residence status is
returned. The residence status of a texture named by an
element of TEXTURES is returned in the corresponding element
of RESIDENCES.
GL establishes a "working set" of textures that are resident in
texture memory. These textures can be bound to a texture target
much more efficiently than textures that are not resident.
'glAreTexturesResident' queries the texture residence status of the
N textures named by the elements of TEXTURES. If all the named
textures are resident, 'glAreTexturesResident' returns 'GL_TRUE',
and the contents of RESIDENCES are undisturbed. If not all the
named textures are resident, 'glAreTexturesResident' returns
'GL_FALSE', and detailed status is returned in the N elements of
RESIDENCES. If an element of RESIDENCES is 'GL_TRUE', then the
texture named by the corresponding element of TEXTURES is resident.
The residence status of a single bound texture may also be queried
by calling 'glGetTexParameter' with the TARGET argument set to the
target to which the texture is bound, and the PNAME argument set to
'GL_TEXTURE_RESIDENT'. This is the only way that the residence
status of a default texture can be queried.
'GL_INVALID_VALUE' is generated if N is negative.
'GL_INVALID_VALUE' is generated if any element in TEXTURES is 0 or
does not name a texture. In that case, the function returns
'GL_FALSE' and the contents of RESIDENCES is indeterminate.
'GL_INVALID_OPERATION' is generated if 'glAreTexturesResident' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glArrayElement i
Render a vertex using the specified vertex array element.
I
Specifies an index into the enabled vertex data arrays.
'glArrayElement' commands are used within 'glBegin'/'glEnd' pairs
to specify vertex and attribute data for point, line, and polygon
primitives. If 'GL_VERTEX_ARRAY' is enabled when 'glArrayElement'
is called, a single vertex is drawn, using vertex and attribute
data taken from location I of the enabled arrays. If
'GL_VERTEX_ARRAY' is not enabled, no drawing occurs but the
attributes corresponding to the enabled arrays are modified.
Use 'glArrayElement' to construct primitives by indexing vertex
data, rather than by streaming through arrays of data in
first-to-last order. Because each call specifies only a single
vertex, it is possible to explicitly specify per-primitive
attributes such as a single normal for each triangle.
Changes made to array data between the execution of 'glBegin' and
the corresponding execution of 'glEnd' may affect calls to
'glArrayElement' that are made within the same 'glBegin'/'glEnd'
period in nonsequential ways. That is, a call to 'glArrayElement'
that precedes a change to array data may access the changed data,
and a call that follows a change to array data may access original
data.
'GL_INVALID_VALUE' may be generated if I is negative.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to an enabled array and the buffer object's data
store is currently mapped.
-- Function: void glAttachShader program shader
Attaches a shader object to a program object.
PROGRAM
Specifies the program object to which a shader object will be
attached.
SHADER
Specifies the shader object that is to be attached.
In order to create an executable, there must be a way to specify
the list of things that will be linked together. Program objects
provide this mechanism. Shaders that are to be linked together in
a program object must first be attached to that program object.
'glAttachShader' attaches the shader object specified by SHADER to
the program object specified by PROGRAM. This indicates that
SHADER will be included in link operations that will be performed
on PROGRAM.
All operations that can be performed on a shader object are valid
whether or not the shader object is attached to a program object.
It is permissible to attach a shader object to a program object
before source code has been loaded into the shader object or before
the shader object has been compiled. It is permissible to attach
multiple shader objects of the same type because each may contain a
portion of the complete shader. It is also permissible to attach a
shader object to more than one program object. If a shader object
is deleted while it is attached to a program object, it will be
flagged for deletion, and deletion will not occur until
'glDetachShader' is called to detach it from all program objects to
which it is attached.
'GL_INVALID_VALUE' is generated if either PROGRAM or SHADER is not
a value generated by OpenGL.
'GL_INVALID_OPERATION' is generated if PROGRAM is not a program
object.
'GL_INVALID_OPERATION' is generated if SHADER is not a shader
object.
'GL_INVALID_OPERATION' is generated if SHADER is already attached
to PROGRAM.
'GL_INVALID_OPERATION' is generated if 'glAttachShader' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glBeginQuery target id
-- Function: void glEndQuery target
Delimit the boundaries of a query object.
TARGET
Specifies the target type of query object established between
'glBeginQuery' and the subsequent 'glEndQuery'. The symbolic
constant must be 'GL_SAMPLES_PASSED'.
ID
Specifies the name of a query object.
'glBeginQuery' and 'glEndQuery' delimit the boundaries of a query
object. If a query object with name ID does not yet exist it is
created.
When 'glBeginQuery' is executed, the query object's samples-passed
counter is reset to 0. Subsequent rendering will increment the
counter once for every sample that passes the depth test. When
'glEndQuery' is executed, the samples-passed counter is assigned to
the query object's result value. This value can be queried by
calling 'glGetQueryObject' with PNAME'GL_QUERY_RESULT'.
Querying the 'GL_QUERY_RESULT' implicitly flushes the GL pipeline
until the rendering delimited by the query object has completed and
the result is available. 'GL_QUERY_RESULT_AVAILABLE' can be
queried to determine if the result is immediately available or if
the rendering is not yet complete.
'GL_INVALID_ENUM' is generated if TARGET is not
'GL_SAMPLES_PASSED'.
'GL_INVALID_OPERATION' is generated if 'glBeginQuery' is executed
while a query object of the same TARGET is already active.
'GL_INVALID_OPERATION' is generated if 'glEndQuery' is executed
when a query object of the same TARGET is not active.
'GL_INVALID_OPERATION' is generated if ID is 0.
'GL_INVALID_OPERATION' is generated if ID is the name of an already
active query object.
'GL_INVALID_OPERATION' is generated if 'glBeginQuery' or
'glEndQuery' is executed between the execution of 'glBegin' and the
corresponding execution of 'glEnd'.
-- Function: void glBegin mode
-- Function: void glEnd
Delimit the vertices of a primitive or a group of like primitives.
MODE
Specifies the primitive or primitives that will be created
from vertices presented between 'glBegin' and the subsequent
'glEnd'. Ten symbolic constants are accepted: 'GL_POINTS',
'GL_LINES', 'GL_LINE_STRIP', 'GL_LINE_LOOP', 'GL_TRIANGLES',
'GL_TRIANGLE_STRIP', 'GL_TRIANGLE_FAN', 'GL_QUADS',
'GL_QUAD_STRIP', and 'GL_POLYGON'.
'glBegin' and 'glEnd' delimit the vertices that define a primitive
or a group of like primitives. 'glBegin' accepts a single argument
that specifies in which of ten ways the vertices are interpreted.
Taking N as an integer count starting at one, and N as the total
number of vertices specified, the interpretations are as follows:
'GL_POINTS'
Treats each vertex as a single point. Vertex N defines point
N. N points are drawn.
'GL_LINES'
Treats each pair of vertices as an independent line segment.
Vertices 2N-1 and 2N define line N. N/2 lines are
drawn.
'GL_LINE_STRIP'
Draws a connected group of line segments from the first vertex
to the last. Vertices N and N+1 define line N. N-1 lines are
drawn.
'GL_LINE_LOOP'
Draws a connected group of line segments from the first vertex
to the last, then back to the first. Vertices N and N+1
define line N. The last line, however, is defined by vertices
N and 1. N lines are drawn.
'GL_TRIANGLES'
Treats each triplet of vertices as an independent triangle.
Vertices 3N-2, 3N-1, and 3N define triangle N. N/3
triangles are drawn.
'GL_TRIANGLE_STRIP'
Draws a connected group of triangles. One triangle is defined
for each vertex presented after the first two vertices. For
odd N, vertices N, N+1, and N+2 define triangle N. For even
N, vertices N+1, N, and N+2 define triangle N. N-2 triangles
are drawn.
'GL_TRIANGLE_FAN'
Draws a connected group of triangles. One triangle is defined
for each vertex presented after the first two vertices.
Vertices 1, N+1, and N+2 define triangle N. N-2 triangles are
drawn.
'GL_QUADS'
Treats each group of four vertices as an independent
quadrilateral. Vertices 4N-3, 4N-2, 4N-1, and 4N
define quadrilateral N. N/4 quadrilaterals are drawn.
'GL_QUAD_STRIP'
Draws a connected group of quadrilaterals. One quadrilateral
is defined for each pair of vertices presented after the first
pair. Vertices 2N-1, 2N, 2N+2, and 2N+1 define
quadrilateral N. N/2-1 quadrilaterals are drawn. Note that
the order in which vertices are used to construct a
quadrilateral from strip data is different from that used with
independent data.
'GL_POLYGON'
Draws a single, convex polygon. Vertices 1 through N define
this polygon.
Only a subset of GL commands can be used between 'glBegin' and
'glEnd'. The commands are 'glVertex', 'glColor',
'glSecondaryColor', 'glIndex', 'glNormal', 'glFogCoord',
'glTexCoord', 'glMultiTexCoord', 'glVertexAttrib', 'glEvalCoord',
'glEvalPoint', 'glArrayElement', 'glMaterial', and 'glEdgeFlag'.
Also, it is acceptable to use 'glCallList' or 'glCallLists' to
execute display lists that include only the preceding commands. If
any other GL command is executed between 'glBegin' and 'glEnd', the
error flag is set and the command is ignored.
Regardless of the value chosen for MODE, there is no limit to the
number of vertices that can be defined between 'glBegin' and
'glEnd'. Lines, triangles, quadrilaterals, and polygons that are
incompletely specified are not drawn. Incomplete specification
results when either too few vertices are provided to specify even a
single primitive or when an incorrect multiple of vertices is
specified. The incomplete primitive is ignored; the rest are
drawn.
The minimum specification of vertices for each primitive is as
follows: 1 for a point, 2 for a line, 3 for a triangle, 4 for a
quadrilateral, and 3 for a polygon. Modes that require a certain
multiple of vertices are 'GL_LINES' (2), 'GL_TRIANGLES' (3),
'GL_QUADS' (4), and 'GL_QUAD_STRIP' (2).
'GL_INVALID_ENUM' is generated if MODE is set to an unaccepted
value.
'GL_INVALID_OPERATION' is generated if 'glBegin' is executed
between a 'glBegin' and the corresponding execution of 'glEnd'.
'GL_INVALID_OPERATION' is generated if 'glEnd' is executed without
being preceded by a 'glBegin'.
'GL_INVALID_OPERATION' is generated if a command other than
'glVertex', 'glColor', 'glSecondaryColor', 'glIndex', 'glNormal',
'glFogCoord', 'glTexCoord', 'glMultiTexCoord', 'glVertexAttrib',
'glEvalCoord', 'glEvalPoint', 'glArrayElement', 'glMaterial',
'glEdgeFlag', 'glCallList', or 'glCallLists' is executed between
the execution of 'glBegin' and the corresponding execution 'glEnd'.
Execution of 'glEnableClientState', 'glDisableClientState',
'glEdgeFlagPointer', 'glFogCoordPointer', 'glTexCoordPointer',
'glColorPointer', 'glSecondaryColorPointer', 'glIndexPointer',
'glNormalPointer', 'glVertexPointer', 'glVertexAttribPointer',
'glInterleavedArrays', or 'glPixelStore' is not allowed after a
call to 'glBegin' and before the corresponding call to 'glEnd', but
an error may or may not be generated.
-- Function: void glBindAttribLocation program index name
Associates a generic vertex attribute index with a named attribute
variable.
PROGRAM
Specifies the handle of the program object in which the
association is to be made.
INDEX
Specifies the index of the generic vertex attribute to be
bound.
NAME
Specifies a null terminated string containing the name of the
vertex shader attribute variable to which INDEX is to be
bound.
'glBindAttribLocation' is used to associate a user-defined
attribute variable in the program object specified by PROGRAM with
a generic vertex attribute index. The name of the user-defined
attribute variable is passed as a null terminated string in NAME.
The generic vertex attribute index to be bound to this variable is
specified by INDEX. When PROGRAM is made part of current state,
values provided via the generic vertex attribute INDEX will modify
the value of the user-defined attribute variable specified by NAME.
If NAME refers to a matrix attribute variable, INDEX refers to the
first column of the matrix. Other matrix columns are then
automatically bound to locations INDEX+1 for a matrix of type mat2;
INDEX+1 and INDEX+2 for a matrix of type mat3; and INDEX+1,
INDEX+2, and INDEX+3 for a matrix of type mat4.
This command makes it possible for vertex shaders to use
descriptive names for attribute variables rather than generic
variables that are numbered from 0 to 'GL_MAX_VERTEX_ATTRIBS' -1.
The values sent to each generic attribute index are part of current
state, just like standard vertex attributes such as color, normal,
and vertex position. If a different program object is made current
by calling 'glUseProgram', the generic vertex attributes are
tracked in such a way that the same values will be observed by
attributes in the new program object that are also bound to INDEX.
Attribute variable name-to-generic attribute index bindings for a
program object can be explicitly assigned at any time by calling
'glBindAttribLocation'. Attribute bindings do not go into effect
until 'glLinkProgram' is called. After a program object has been
linked successfully, the index values for generic attributes remain
fixed (and their values can be queried) until the next link command
occurs.
Applications are not allowed to bind any of the standard OpenGL
vertex attributes using this command, as they are bound
automatically when needed. Any attribute binding that occurs after
the program object has been linked will not take effect until the
next time the program object is linked.
'GL_INVALID_VALUE' is generated if INDEX is greater than or equal
to 'GL_MAX_VERTEX_ATTRIBS'.
'GL_INVALID_OPERATION' is generated if NAME starts with the
reserved prefix "gl_".
'GL_INVALID_VALUE' is generated if PROGRAM is not a value generated
by OpenGL.
'GL_INVALID_OPERATION' is generated if PROGRAM is not a program
object.
'GL_INVALID_OPERATION' is generated if 'glBindAttribLocation' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glBindBuffer target buffer
Bind a named buffer object.
TARGET
Specifies the target to which the buffer object is bound. The
symbolic constant must be 'GL_ARRAY_BUFFER',
'GL_ELEMENT_ARRAY_BUFFER', 'GL_PIXEL_PACK_BUFFER', or
'GL_PIXEL_UNPACK_BUFFER'.
BUFFER
Specifies the name of a buffer object.
'glBindBuffer' lets you create or use a named buffer object.
Calling 'glBindBuffer' with TARGET set to 'GL_ARRAY_BUFFER',
'GL_ELEMENT_ARRAY_BUFFER', 'GL_PIXEL_PACK_BUFFER' or
'GL_PIXEL_UNPACK_BUFFER' and BUFFER set to the name of the new
buffer object binds the buffer object name to the target. When a
buffer object is bound to a target, the previous binding for that
target is automatically broken.
Buffer object names are unsigned integers. The value zero is
reserved, but there is no default buffer object for each buffer
object target. Instead, BUFFER set to zero effectively unbinds any
buffer object previously bound, and restores client memory usage
for that buffer object target. Buffer object names and the
corresponding buffer object contents are local to the shared
display-list space (see 'glXCreateContext') of the current GL
rendering context; two rendering contexts share buffer object names
only if they also share display lists.
You may use 'glGenBuffers' to generate a set of new buffer object
names.
The state of a buffer object immediately after it is first bound is
an unmapped zero-sized memory buffer with 'GL_READ_WRITE' access
and 'GL_STATIC_DRAW' usage.
While a non-zero buffer object name is bound, GL operations on the
target to which it is bound affect the bound buffer object, and
queries of the target to which it is bound return state from the
bound buffer object. While buffer object name zero is bound, as in
the initial state, attempts to modify or query state on the target
to which it is bound generates an 'GL_INVALID_OPERATION' error.
When vertex array pointer state is changed, for example by a call
to 'glNormalPointer', the current buffer object binding
('GL_ARRAY_BUFFER_BINDING') is copied into the corresponding client
state for the vertex array type being changed, for example
'GL_NORMAL_ARRAY_BUFFER_BINDING'. While a non-zero buffer object
is bound to the 'GL_ARRAY_BUFFER' target, the vertex array pointer
parameter that is traditionally interpreted as a pointer to
client-side memory is instead interpreted as an offset within the
buffer object measured in basic machine units.
While a non-zero buffer object is bound to the
'GL_ELEMENT_ARRAY_BUFFER' target, the indices parameter of
'glDrawElements', 'glDrawRangeElements', or 'glMultiDrawElements'
that is traditionally interpreted as a pointer to client-side
memory is instead interpreted as an offset within the buffer object
measured in basic machine units.
While a non-zero buffer object is bound to the
'GL_PIXEL_PACK_BUFFER' target, the following commands are affected:
'glGetCompressedTexImage', 'glGetConvolutionFilter',
'glGetHistogram', 'glGetMinmax', 'glGetPixelMap',
'glGetPolygonStipple', 'glGetSeparableFilter', 'glGetTexImage', and
'glReadPixels'. The pointer parameter that is traditionally
interpreted as a pointer to client-side memory where the pixels are
to be packed is instead interpreted as an offset within the buffer
object measured in basic machine units.
While a non-zero buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target, the following commands are
affected: 'glBitmap', 'glColorSubTable', 'glColorTable',
'glCompressedTexImage1D', 'glCompressedTexImage2D',
'glCompressedTexImage3D', 'glCompressedTexSubImage1D',
'glCompressedTexSubImage2D', 'glCompressedTexSubImage3D',
'glConvolutionFilter1D', 'glConvolutionFilter2D', 'glDrawPixels',
'glPixelMap', 'glPolygonStipple', 'glSeparableFilter2D',
'glTexImage1D', 'glTexImage2D', 'glTexImage3D', 'glTexSubImage1D',
'glTexSubImage2D', and 'glTexSubImage3D'. The pointer parameter
that is traditionally interpreted as a pointer to client-side
memory from which the pixels are to be unpacked is instead
interpreted as an offset within the buffer object measured in basic
machine units.
A buffer object binding created with 'glBindBuffer' remains active
until a different buffer object name is bound to the same target,
or until the bound buffer object is deleted with 'glDeleteBuffers'.
Once created, a named buffer object may be re-bound to any target
as often as needed. However, the GL implementation may make
choices about how to optimize the storage of a buffer object based
on its initial binding target.
'GL_INVALID_ENUM' is generated if TARGET is not one of the
allowable values.
'GL_INVALID_OPERATION' is generated if 'glBindBuffer' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glBindTexture target texture
Bind a named texture to a texturing target.
TARGET
Specifies the target to which the texture is bound. Must be
either 'GL_TEXTURE_1D', 'GL_TEXTURE_2D', 'GL_TEXTURE_3D', or
'GL_TEXTURE_CUBE_MAP'.
TEXTURE
Specifies the name of a texture.
'glBindTexture' lets you create or use a named texture. Calling
'glBindTexture' with TARGET set to 'GL_TEXTURE_1D',
'GL_TEXTURE_2D', 'GL_TEXTURE_3D' or 'GL_TEXTURE_CUBE_MAP' and
TEXTURE set to the name of the new texture binds the texture name
to the target. When a texture is bound to a target, the previous
binding for that target is automatically broken.
Texture names are unsigned integers. The value zero is reserved to
represent the default texture for each texture target. Texture
names and the corresponding texture contents are local to the
shared display-list space (see 'glXCreateContext') of the current
GL rendering context; two rendering contexts share texture names
only if they also share display lists.
You may use 'glGenTextures' to generate a set of new texture names.
When a texture is first bound, it assumes the specified target: A
texture first bound to 'GL_TEXTURE_1D' becomes one-dimensional
texture, a texture first bound to 'GL_TEXTURE_2D' becomes
two-dimensional texture, a texture first bound to 'GL_TEXTURE_3D'
becomes three-dimensional texture, and a texture first bound to
'GL_TEXTURE_CUBE_MAP' becomes a cube-mapped texture. The state of
a one-dimensional texture immediately after it is first bound is
equivalent to the state of the default 'GL_TEXTURE_1D' at GL
initialization, and similarly for two- and three-dimensional
textures and cube-mapped textures.
While a texture is bound, GL operations on the target to which it
is bound affect the bound texture, and queries of the target to
which it is bound return state from the bound texture. If texture
mapping is active on the target to which a texture is bound, the
bound texture is used. In effect, the texture targets become
aliases for the textures currently bound to them, and the texture
name zero refers to the default textures that were bound to them at
initialization.
A texture binding created with 'glBindTexture' remains active until
a different texture is bound to the same target, or until the bound
texture is deleted with 'glDeleteTextures'.
Once created, a named texture may be re-bound to its same original
target as often as needed. It is usually much faster to use
'glBindTexture' to bind an existing named texture to one of the
texture targets than it is to reload the texture image using
'glTexImage1D', 'glTexImage2D', or 'glTexImage3D'. For additional
control over performance, use 'glPrioritizeTextures'.
'glBindTexture' is included in display lists.
'GL_INVALID_ENUM' is generated if TARGET is not one of the
allowable values.
'GL_INVALID_OPERATION' is generated if TEXTURE was previously
created with a target that doesn't match that of TARGET.
'GL_INVALID_OPERATION' is generated if 'glBindTexture' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glBitmap width height xorig yorig xmove ymove bitmap
Draw a bitmap.
WIDTH
HEIGHT
Specify the pixel width and height of the bitmap image.
XORIG
YORIG
Specify the location of the origin in the bitmap image. The
origin is measured from the lower left corner of the bitmap,
with right and up being the positive axes.
XMOVE
YMOVE
Specify the X and Y offsets to be added to the current raster
position after the bitmap is drawn.
BITMAP
Specifies the address of the bitmap image.
A bitmap is a binary image. When drawn, the bitmap is positioned
relative to the current raster position, and frame buffer pixels
corresponding to 1's in the bitmap are written using the current
raster color or index. Frame buffer pixels corresponding to 0's in
the bitmap are not modified.
'glBitmap' takes seven arguments. The first pair specifies the
width and height of the bitmap image. The second pair specifies
the location of the bitmap origin relative to the lower left corner
of the bitmap image. The third pair of arguments specifies X and Y
offsets to be added to the current raster position after the bitmap
has been drawn. The final argument is a pointer to the bitmap
image itself.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a bitmap
image is specified, BITMAP is treated as a byte offset into the
buffer object's data store.
The bitmap image is interpreted like image data for the
'glDrawPixels' command, with WIDTH and HEIGHT corresponding to the
width and height arguments of that command, and with TYPE set to
'GL_BITMAP' and FORMAT set to 'GL_COLOR_INDEX'. Modes specified
using 'glPixelStore' affect the interpretation of bitmap image
data; modes specified using 'glPixelTransfer' do not.
If the current raster position is invalid, 'glBitmap' is ignored.
Otherwise, the lower left corner of the bitmap image is positioned
at the window coordinates
X_W=⌊X_R-X_O,⌋
Y_W=⌊Y_R-Y_O,⌋
where (X_R,Y_R) is the raster position and (X_O,Y_O) is the bitmap
origin. Fragments are then generated for each pixel corresponding
to a 1 (one) in the bitmap image. These fragments are generated
using the current raster Z coordinate, color or color index, and
current raster texture coordinates. They are then treated just as
if they had been generated by a point, line, or polygon, including
texture mapping, fogging, and all per-fragment operations such as
alpha and depth testing.
After the bitmap has been drawn, the X and Y coordinates of the
current raster position are offset by XMOVE and YMOVE. No change
is made to the Z coordinate of the current raster position, or to
the current raster color, texture coordinates, or index.
'GL_INVALID_VALUE' is generated if WIDTH or HEIGHT is negative.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if 'glBitmap' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glBlendColor red green blue alpha
Set the blend color.
RED
GREEN
BLUE
ALPHA
specify the components of 'GL_BLEND_COLOR'
The 'GL_BLEND_COLOR' may be used to calculate the source and
destination blending factors. The color components are clamped to
the range [0,1] before being stored. See 'glBlendFunc' for a
complete description of the blending operations. Initially the
'GL_BLEND_COLOR' is set to (0, 0, 0, 0).
'GL_INVALID_OPERATION' is generated if 'glBlendColor' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glBlendEquationSeparate modeRGB modeAlpha
Set the RGB blend equation and the alpha blend equation separately.
MODERGB
specifies the RGB blend equation, how the red, green, and blue
components of the source and destination colors are combined.
It must be 'GL_FUNC_ADD', 'GL_FUNC_SUBTRACT',
'GL_FUNC_REVERSE_SUBTRACT', 'GL_MIN', 'GL_MAX'.
MODEALPHA
specifies the alpha blend equation, how the alpha component of
the source and destination colors are combined. It must be
'GL_FUNC_ADD', 'GL_FUNC_SUBTRACT', 'GL_FUNC_REVERSE_SUBTRACT',
'GL_MIN', 'GL_MAX'.
The blend equations determines how a new pixel (the "source" color)
is combined with a pixel already in the framebuffer (the
"destination" color). This function specifies one blend equation
for the RGB-color components and one blend equation for the alpha
component.
The blend equations use the source and destination blend factors
specified by either 'glBlendFunc' or 'glBlendFuncSeparate'. See
'glBlendFunc' or 'glBlendFuncSeparate' for a description of the
various blend factors.
In the equations that follow, source and destination color
components are referred to as (R_S,G_SB_SA_S) and (R_D,G_DB_DA_D),
respectively. The result color is referred to as (R_R,G_RB_RA_R).
The source and destination blend factors are denoted
(S_R,S_GS_BS_A) and (D_R,D_GD_BD_A), respectively. For these
equations all color components are understood to have values in the
range [0,1].
*Mode*
*RGB Components*, *Alpha Component*
'GL_FUNC_ADD'
RR=R_SS_R+R_DD_RGR=G_SS_G+G_DD_GBR=B_SS_B+B_DD_B,
AR=A_SS_A+A_DD_A
'GL_FUNC_SUBTRACT'
RR=R_SS_R-R_DD_RGR=G_SS_G-G_DD_GBR=B_SS_B-B_DD_B,
AR=A_SS_A-A_DD_A
'GL_FUNC_REVERSE_SUBTRACT'
RR=R_DD_R-R_SS_RGR=G_DD_G-G_SS_GBR=B_DD_B-B_SS_B,
AR=A_DD_A-A_SS_A
'GL_MIN'
RR=MIN(R_S,R_D)GR=MIN(G_S,G_D)BR=MIN(B_S,B_D),
AR=MIN(A_S,A_D)
'GL_MAX'
RR=MAX(R_S,R_D)GR=MAX(G_S,G_D)BR=MAX(B_S,B_D),
AR=MAX(A_S,A_D)
The results of these equations are clamped to the range [0,1].
The 'GL_MIN' and 'GL_MAX' equations are useful for applications
that analyze image data (image thresholding against a constant
color, for example). The 'GL_FUNC_ADD' equation is useful for
antialiasing and transparency, among other things.
Initially, both the RGB blend equation and the alpha blend equation
are set to 'GL_FUNC_ADD'.
'GL_INVALID_ENUM' is generated if either MODERGB or MODEALPHA is
not one of 'GL_FUNC_ADD', 'GL_FUNC_SUBTRACT',
'GL_FUNC_REVERSE_SUBTRACT', 'GL_MAX', or 'GL_MIN'.
'GL_INVALID_OPERATION' is generated if 'glBlendEquationSeparate' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glBlendEquation mode
Specify the equation used for both the RGB blend equation and the
Alpha blend equation.
MODE
specifies how source and destination colors are combined. It
must be 'GL_FUNC_ADD', 'GL_FUNC_SUBTRACT',
'GL_FUNC_REVERSE_SUBTRACT', 'GL_MIN', 'GL_MAX'.
The blend equations determine how a new pixel (the "source" color)
is combined with a pixel already in the framebuffer (the
"destination" color). This function sets both the RGB blend
equation and the alpha blend equation to a single equation.
These equations use the source and destination blend factors
specified by either 'glBlendFunc' or 'glBlendFuncSeparate'. See
'glBlendFunc' or 'glBlendFuncSeparate' for a description of the
various blend factors.
In the equations that follow, source and destination color
components are referred to as (R_S,G_SB_SA_S) and (R_D,G_DB_DA_D),
respectively. The result color is referred to as (R_R,G_RB_RA_R).
The source and destination blend factors are denoted
(S_R,S_GS_BS_A) and (D_R,D_GD_BD_A), respectively. For these
equations all color components are understood to have values in the
range [0,1].
*Mode*
*RGB Components*, *Alpha Component*
'GL_FUNC_ADD'
RR=R_SS_R+R_DD_RGR=G_SS_G+G_DD_GBR=B_SS_B+B_DD_B,
AR=A_SS_A+A_DD_A
'GL_FUNC_SUBTRACT'
RR=R_SS_R-R_DD_RGR=G_SS_G-G_DD_GBR=B_SS_B-B_DD_B,
AR=A_SS_A-A_DD_A
'GL_FUNC_REVERSE_SUBTRACT'
RR=R_DD_R-R_SS_RGR=G_DD_G-G_SS_GBR=B_DD_B-B_SS_B,
AR=A_DD_A-A_SS_A
'GL_MIN'
RR=MIN(R_S,R_D)GR=MIN(G_S,G_D)BR=MIN(B_S,B_D),
AR=MIN(A_S,A_D)
'GL_MAX'
RR=MAX(R_S,R_D)GR=MAX(G_S,G_D)BR=MAX(B_S,B_D),
AR=MAX(A_S,A_D)
The results of these equations are clamped to the range [0,1].
The 'GL_MIN' and 'GL_MAX' equations are useful for applications
that analyze image data (image thresholding against a constant
color, for example). The 'GL_FUNC_ADD' equation is useful for
antialiasing and transparency, among other things.
Initially, both the RGB blend equation and the alpha blend equation
are set to 'GL_FUNC_ADD'.
'GL_INVALID_ENUM' is generated if MODE is not one of 'GL_FUNC_ADD',
'GL_FUNC_SUBTRACT', 'GL_FUNC_REVERSE_SUBTRACT', 'GL_MAX', or
'GL_MIN'.
'GL_INVALID_OPERATION' is generated if 'glBlendEquation' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glBlendFuncSeparate srcRGB dstRGB srcAlpha dstAlpha
Specify pixel arithmetic for RGB and alpha components separately.
SRCRGB
Specifies how the red, green, and blue blending factors are
computed. The following symbolic constants are accepted:
'GL_ZERO', 'GL_ONE', 'GL_SRC_COLOR', 'GL_ONE_MINUS_SRC_COLOR',
'GL_DST_COLOR', 'GL_ONE_MINUS_DST_COLOR', 'GL_SRC_ALPHA',
'GL_ONE_MINUS_SRC_ALPHA', 'GL_DST_ALPHA',
'GL_ONE_MINUS_DST_ALPHA', 'GL_CONSTANT_COLOR',
'GL_ONE_MINUS_CONSTANT_COLOR', 'GL_CONSTANT_ALPHA',
'GL_ONE_MINUS_CONSTANT_ALPHA', and 'GL_SRC_ALPHA_SATURATE'.
The initial value is 'GL_ONE'.
DSTRGB
Specifies how the red, green, and blue destination blending
factors are computed. The following symbolic constants are
accepted: 'GL_ZERO', 'GL_ONE', 'GL_SRC_COLOR',
'GL_ONE_MINUS_SRC_COLOR', 'GL_DST_COLOR',
'GL_ONE_MINUS_DST_COLOR', 'GL_SRC_ALPHA',
'GL_ONE_MINUS_SRC_ALPHA', 'GL_DST_ALPHA',
'GL_ONE_MINUS_DST_ALPHA'. 'GL_CONSTANT_COLOR',
'GL_ONE_MINUS_CONSTANT_COLOR', 'GL_CONSTANT_ALPHA', and
'GL_ONE_MINUS_CONSTANT_ALPHA'. The initial value is
'GL_ZERO'.
SRCALPHA
Specified how the alpha source blending factor is computed.
The same symbolic constants are accepted as for SRCRGB. The
initial value is 'GL_ONE'.
DSTALPHA
Specified how the alpha destination blending factor is
computed. The same symbolic constants are accepted as for
DSTRGB. The initial value is 'GL_ZERO'.
In RGBA mode, pixels can be drawn using a function that blends the
incoming (source) RGBA values with the RGBA values that are already
in the frame buffer (the destination values). Blending is
initially disabled. Use 'glEnable' and 'glDisable' with argument
'GL_BLEND' to enable and disable blending.
'glBlendFuncSeparate' defines the operation of blending when it is
enabled. SRCRGB specifies which method is used to scale the source
RGB-color components. DSTRGB specifies which method is used to
scale the destination RGB-color components. Likewise, SRCALPHA
specifies which method is used to scale the source alpha color
component, and DSTALPHA specifies which method is used to scale the
destination alpha component. The possible methods are described in
the following table. Each method defines four scale factors, one
each for red, green, blue, and alpha.
In the table and in subsequent equations, source and destination
color components are referred to as (R_S,G_SB_SA_S) and
(R_D,G_DB_DA_D). The color specified by 'glBlendColor' is referred
to as (R_C,G_CB_CA_C). They are understood to have integer values
between 0 and (K_R,K_GK_BK_A), where
K_C=2^M_C,-1
and (M_R,M_GM_BM_A) is the number of red, green, blue, and alpha
bitplanes.
Source and destination scale factors are referred to as
(S_R,S_GS_BS_A) and (D_R,D_GD_BD_A). All scale factors have range
[0,1].
*Parameter*
*RGB Factor*, *Alpha Factor*
'GL_ZERO'
(0,00), 0
'GL_ONE'
(1,11), 1
'GL_SRC_COLOR'
(R_S/K_R,G_S/K_GB_S/K_B), A_S/K_A
'GL_ONE_MINUS_SRC_COLOR'
(1,111)-(R_S/K_R,G_S/K_GB_S/K_B), 1-A_S/K_A
'GL_DST_COLOR'
(R_D/K_R,G_D/K_GB_D/K_B), A_D/K_A
'GL_ONE_MINUS_DST_COLOR'
(1,11)-(R_D/K_R,G_D/K_GB_D/K_B), 1-A_D/K_A
'GL_SRC_ALPHA'
(A_S/K_A,A_S/K_AA_S/K_A), A_S/K_A
'GL_ONE_MINUS_SRC_ALPHA'
(1,11)-(A_S/K_A,A_S/K_AA_S/K_A), 1-A_S/K_A
'GL_DST_ALPHA'
(A_D/K_A,A_D/K_AA_D/K_A), A_D/K_A
'GL_ONE_MINUS_DST_ALPHA'
(1,11)-(A_D/K_A,A_D/K_AA_D/K_A), 1-A_D/K_A
'GL_CONSTANT_COLOR'
(R_C,G_CB_C), A_C
'GL_ONE_MINUS_CONSTANT_COLOR'
(1,11)-(R_C,G_CB_C), 1-A_C
'GL_CONSTANT_ALPHA'
(A_C,A_CA_C), A_C
'GL_ONE_MINUS_CONSTANT_ALPHA'
(1,11)-(A_C,A_CA_C), 1-A_C
'GL_SRC_ALPHA_SATURATE'
(I,II), 1
In the table,
I=MIN(A_S,1-A_D,)
To determine the blended RGBA values of a pixel when drawing in
RGBA mode, the system uses the following equations:
R_D=MIN(K_R,R_SS_R+R_DD_R)G_D=MIN(K_G,G_SS_G+G_DD_G)B_D=MIN(K_B,B_SS_B+B_DD_B)A_D=MIN(K_A,A_SS_A+A_DD_A)
Despite the apparent precision of the above equations, blending
arithmetic is not exactly specified, because blending operates with
imprecise integer color values. However, a blend factor that
should be equal to 1 is guaranteed not to modify its multiplicand,
and a blend factor equal to 0 reduces its multiplicand to 0. For
example, when SRCRGB is 'GL_SRC_ALPHA', DSTRGB is
'GL_ONE_MINUS_SRC_ALPHA', and A_S is equal to K_A, the equations
reduce to simple replacement:
R_D=R_SG_D=G_SB_D=B_SA_D=A_S
'GL_INVALID_ENUM' is generated if either SRCRGB or DSTRGB is not an
accepted value.
'GL_INVALID_OPERATION' is generated if 'glBlendFuncSeparate' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glBlendFunc sfactor dfactor
Specify pixel arithmetic.
SFACTOR
Specifies how the red, green, blue, and alpha source blending
factors are computed. The following symbolic constants are
accepted: 'GL_ZERO', 'GL_ONE', 'GL_SRC_COLOR',
'GL_ONE_MINUS_SRC_COLOR', 'GL_DST_COLOR',
'GL_ONE_MINUS_DST_COLOR', 'GL_SRC_ALPHA',
'GL_ONE_MINUS_SRC_ALPHA', 'GL_DST_ALPHA',
'GL_ONE_MINUS_DST_ALPHA', 'GL_CONSTANT_COLOR',
'GL_ONE_MINUS_CONSTANT_COLOR', 'GL_CONSTANT_ALPHA',
'GL_ONE_MINUS_CONSTANT_ALPHA', and 'GL_SRC_ALPHA_SATURATE'.
The initial value is 'GL_ONE'.
DFACTOR
Specifies how the red, green, blue, and alpha destination
blending factors are computed. The following symbolic
constants are accepted: 'GL_ZERO', 'GL_ONE', 'GL_SRC_COLOR',
'GL_ONE_MINUS_SRC_COLOR', 'GL_DST_COLOR',
'GL_ONE_MINUS_DST_COLOR', 'GL_SRC_ALPHA',
'GL_ONE_MINUS_SRC_ALPHA', 'GL_DST_ALPHA',
'GL_ONE_MINUS_DST_ALPHA'. 'GL_CONSTANT_COLOR',
'GL_ONE_MINUS_CONSTANT_COLOR', 'GL_CONSTANT_ALPHA', and
'GL_ONE_MINUS_CONSTANT_ALPHA'. The initial value is
'GL_ZERO'.
In RGBA mode, pixels can be drawn using a function that blends the
incoming (source) RGBA values with the RGBA values that are already
in the frame buffer (the destination values). Blending is
initially disabled. Use 'glEnable' and 'glDisable' with argument
'GL_BLEND' to enable and disable blending.
'glBlendFunc' defines the operation of blending when it is enabled.
SFACTOR specifies which method is used to scale the source color
components. DFACTOR specifies which method is used to scale the
destination color components. The possible methods are described
in the following table. Each method defines four scale factors,
one each for red, green, blue, and alpha. In the table and in
subsequent equations, source and destination color components are
referred to as (R_S,G_SB_SA_S) and (R_D,G_DB_DA_D). The color
specified by 'glBlendColor' is referred to as (R_C,G_CB_CA_C).
They are understood to have integer values between 0 and
(K_R,K_GK_BK_A), where
K_C=2^M_C,-1
and (M_R,M_GM_BM_A) is the number of red, green, blue, and alpha
bitplanes.
Source and destination scale factors are referred to as
(S_R,S_GS_BS_A) and (D_R,D_GD_BD_A). The scale factors described
in the table, denoted (F_R,F_GF_BF_A), represent either source or
destination factors. All scale factors have range [0,1].
*Parameter*
*(F_R,F_GF_BF_A)*
'GL_ZERO'
(0,000)
'GL_ONE'
(1,111)
'GL_SRC_COLOR'
(R_S/K_R,G_S/K_GB_S/K_BA_S/K_A)
'GL_ONE_MINUS_SRC_COLOR'
(1,111)-(R_S/K_R,G_S/K_GB_S/K_BA_S/K_A)
'GL_DST_COLOR'
(R_D/K_R,G_D/K_GB_D/K_BA_D/K_A)
'GL_ONE_MINUS_DST_COLOR'
(1,111)-(R_D/K_R,G_D/K_GB_D/K_BA_D/K_A)
'GL_SRC_ALPHA'
(A_S/K_A,A_S/K_AA_S/K_AA_S/K_A)
'GL_ONE_MINUS_SRC_ALPHA'
(1,111)-(A_S/K_A,A_S/K_AA_S/K_AA_S/K_A)
'GL_DST_ALPHA'
(A_D/K_A,A_D/K_AA_D/K_AA_D/K_A)
'GL_ONE_MINUS_DST_ALPHA'
(1,111)-(A_D/K_A,A_D/K_AA_D/K_AA_D/K_A)
'GL_CONSTANT_COLOR'
(R_C,G_CB_CA_C)
'GL_ONE_MINUS_CONSTANT_COLOR'
(1,111)-(R_C,G_CB_CA_C)
'GL_CONSTANT_ALPHA'
(A_C,A_CA_CA_C)
'GL_ONE_MINUS_CONSTANT_ALPHA'
(1,111)-(A_C,A_CA_CA_C)
'GL_SRC_ALPHA_SATURATE'
(I,II1)
In the table,
I=MIN(A_S,K_A-A_D)/K_A
To determine the blended RGBA values of a pixel when drawing in
RGBA mode, the system uses the following equations:
R_D=MIN(K_R,R_SS_R+R_DD_R)G_D=MIN(K_G,G_SS_G+G_DD_G)B_D=MIN(K_B,B_SS_B+B_DD_B)A_D=MIN(K_A,A_SS_A+A_DD_A)
Despite the apparent precision of the above equations, blending
arithmetic is not exactly specified, because blending operates with
imprecise integer color values. However, a blend factor that
should be equal to 1 is guaranteed not to modify its multiplicand,
and a blend factor equal to 0 reduces its multiplicand to 0. For
example, when SFACTOR is 'GL_SRC_ALPHA', DFACTOR is
'GL_ONE_MINUS_SRC_ALPHA', and A_S is equal to K_A, the equations
reduce to simple replacement:
R_D=R_SG_D=G_SB_D=B_SA_D=A_S
'GL_INVALID_ENUM' is generated if either SFACTOR or DFACTOR is not
an accepted value.
'GL_INVALID_OPERATION' is generated if 'glBlendFunc' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glBufferData target size data usage
Creates and initializes a buffer object's data store.
TARGET
Specifies the target buffer object. The symbolic constant
must be 'GL_ARRAY_BUFFER', 'GL_ELEMENT_ARRAY_BUFFER',
'GL_PIXEL_PACK_BUFFER', or 'GL_PIXEL_UNPACK_BUFFER'.
SIZE
Specifies the size in bytes of the buffer object's new data
store.
DATA
Specifies a pointer to data that will be copied into the data
store for initialization, or 'NULL' if no data is to be
copied.
USAGE
Specifies the expected usage pattern of the data store. The
symbolic constant must be 'GL_STREAM_DRAW', 'GL_STREAM_READ',
'GL_STREAM_COPY', 'GL_STATIC_DRAW', 'GL_STATIC_READ',
'GL_STATIC_COPY', 'GL_DYNAMIC_DRAW', 'GL_DYNAMIC_READ', or
'GL_DYNAMIC_COPY'.
'glBufferData' creates a new data store for the buffer object
currently bound to TARGET. Any pre-existing data store is deleted.
The new data store is created with the specified SIZE in bytes and
USAGE. If DATA is not 'NULL', the data store is initialized with
data from this pointer. In its initial state, the new data store
is not mapped, it has a 'NULL' mapped pointer, and its mapped
access is 'GL_READ_WRITE'.
USAGE is a hint to the GL implementation as to how a buffer
object's data store will be accessed. This enables the GL
implementation to make more intelligent decisions that may
significantly impact buffer object performance. It does not,
however, constrain the actual usage of the data store. USAGE can
be broken down into two parts: first, the frequency of access
(modification and usage), and second, the nature of that access.
The frequency of access may be one of these:
STREAM
The data store contents will be modified once and used at most
a few times.
STATIC
The data store contents will be modified once and used many
times.
DYNAMIC
The data store contents will be modified repeatedly and used
many times.
The nature of access may be one of these:
DRAW
The data store contents are modified by the application, and
used as the source for GL drawing and image specification
commands.
READ
The data store contents are modified by reading data from the
GL, and used to return that data when queried by the
application.
COPY
The data store contents are modified by reading data from the
GL, and used as the source for GL drawing and image
specification commands.
'GL_INVALID_ENUM' is generated if TARGET is not 'GL_ARRAY_BUFFER',
'GL_ELEMENT_ARRAY_BUFFER', 'GL_PIXEL_PACK_BUFFER', or
'GL_PIXEL_UNPACK_BUFFER'.
'GL_INVALID_ENUM' is generated if USAGE is not 'GL_STREAM_DRAW',
'GL_STREAM_READ', 'GL_STREAM_COPY', 'GL_STATIC_DRAW',
'GL_STATIC_READ', 'GL_STATIC_COPY', 'GL_DYNAMIC_DRAW',
'GL_DYNAMIC_READ', or 'GL_DYNAMIC_COPY'.
'GL_INVALID_VALUE' is generated if SIZE is negative.
'GL_INVALID_OPERATION' is generated if the reserved buffer object
name 0 is bound to TARGET.
'GL_OUT_OF_MEMORY' is generated if the GL is unable to create a
data store with the specified SIZE.
'GL_INVALID_OPERATION' is generated if 'glBufferData' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glBufferSubData target offset size data
Updates a subset of a buffer object's data store.
TARGET
Specifies the target buffer object. The symbolic constant
must be 'GL_ARRAY_BUFFER', 'GL_ELEMENT_ARRAY_BUFFER',
'GL_PIXEL_PACK_BUFFER', or 'GL_PIXEL_UNPACK_BUFFER'.
OFFSET
Specifies the offset into the buffer object's data store where
data replacement will begin, measured in bytes.
SIZE
Specifies the size in bytes of the data store region being
replaced.
DATA
Specifies a pointer to the new data that will be copied into
the data store.
'glBufferSubData' redefines some or all of the data store for the
buffer object currently bound to TARGET. Data starting at byte
offset OFFSET and extending for SIZE bytes is copied to the data
store from the memory pointed to by DATA. An error is thrown if
OFFSET and SIZE together define a range beyond the bounds of the
buffer object's data store.
'GL_INVALID_ENUM' is generated if TARGET is not 'GL_ARRAY_BUFFER',
'GL_ELEMENT_ARRAY_BUFFER', 'GL_PIXEL_PACK_BUFFER', or
'GL_PIXEL_UNPACK_BUFFER'.
'GL_INVALID_VALUE' is generated if OFFSET or SIZE is negative, or
if together they define a region of memory that extends beyond the
buffer object's allocated data store.
'GL_INVALID_OPERATION' is generated if the reserved buffer object
name 0 is bound to TARGET.
'GL_INVALID_OPERATION' is generated if the buffer object being
updated is mapped.
'GL_INVALID_OPERATION' is generated if 'glBufferSubData' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glCallLists n type lists
Execute a list of display lists.
N
Specifies the number of display lists to be executed.
TYPE
Specifies the type of values in LISTS. Symbolic constants
'GL_BYTE', 'GL_UNSIGNED_BYTE', 'GL_SHORT',
'GL_UNSIGNED_SHORT', 'GL_INT', 'GL_UNSIGNED_INT', 'GL_FLOAT',
'GL_2_BYTES', 'GL_3_BYTES', and 'GL_4_BYTES' are accepted.
LISTS
Specifies the address of an array of name offsets in the
display list. The pointer type is void because the offsets
can be bytes, shorts, ints, or floats, depending on the value
of TYPE.
'glCallLists' causes each display list in the list of names passed
as LISTS to be executed. As a result, the commands saved in each
display list are executed in order, just as if they were called
without using a display list. Names of display lists that have not
been defined are ignored.
'glCallLists' provides an efficient means for executing more than
one display list. TYPE allows lists with various name formats to
be accepted. The formats are as follows:
'GL_BYTE'
LISTS is treated as an array of signed bytes, each in the
range -128 through 127.
'GL_UNSIGNED_BYTE'
LISTS is treated as an array of unsigned bytes, each in the
range 0 through 255.
'GL_SHORT'
LISTS is treated as an array of signed two-byte integers, each
in the range -32768 through 32767.
'GL_UNSIGNED_SHORT'
LISTS is treated as an array of unsigned two-byte integers,
each in the range 0 through 65535.
'GL_INT'
LISTS is treated as an array of signed four-byte integers.
'GL_UNSIGNED_INT'
LISTS is treated as an array of unsigned four-byte integers.
'GL_FLOAT'
LISTS is treated as an array of four-byte floating-point
values.
'GL_2_BYTES'
LISTS is treated as an array of unsigned bytes. Each pair of
bytes specifies a single display-list name. The value of the
pair is computed as 256 times the unsigned value of the first
byte plus the unsigned value of the second byte.
'GL_3_BYTES'
LISTS is treated as an array of unsigned bytes. Each triplet
of bytes specifies a single display-list name. The value of
the triplet is computed as 65536 times the unsigned value of
the first byte, plus 256 times the unsigned value of the
second byte, plus the unsigned value of the third byte.
'GL_4_BYTES'
LISTS is treated as an array of unsigned bytes. Each
quadruplet of bytes specifies a single display-list name. The
value of the quadruplet is computed as 16777216 times the
unsigned value of the first byte, plus 65536 times the
unsigned value of the second byte, plus 256 times the unsigned
value of the third byte, plus the unsigned value of the fourth
byte.
The list of display-list names is not null-terminated. Rather, N
specifies how many names are to be taken from LISTS.
An additional level of indirection is made available with the
'glListBase' command, which specifies an unsigned offset that is
added to each display-list name specified in LISTS before that
display list is executed.
'glCallLists' can appear inside a display list. To avoid the
possibility of infinite recursion resulting from display lists
calling one another, a limit is placed on the nesting level of
display lists during display-list execution. This limit must be at
least 64, and it depends on the implementation.
GL state is not saved and restored across a call to 'glCallLists'.
Thus, changes made to GL state during the execution of the display
lists remain after execution is completed. Use 'glPushAttrib',
'glPopAttrib', 'glPushMatrix', and 'glPopMatrix' to preserve GL
state across 'glCallLists' calls.
'GL_INVALID_VALUE' is generated if N is negative.
'GL_INVALID_ENUM' is generated if TYPE is not one of 'GL_BYTE',
'GL_UNSIGNED_BYTE', 'GL_SHORT', 'GL_UNSIGNED_SHORT', 'GL_INT',
'GL_UNSIGNED_INT', 'GL_FLOAT', 'GL_2_BYTES', 'GL_3_BYTES',
'GL_4_BYTES'.
-- Function: void glCallList list
Execute a display list.
LIST
Specifies the integer name of the display list to be executed.
'glCallList' causes the named display list to be executed. The
commands saved in the display list are executed in order, just as
if they were called without using a display list. If LIST has not
been defined as a display list, 'glCallList' is ignored.
'glCallList' can appear inside a display list. To avoid the
possibility of infinite recursion resulting from display lists
calling one another, a limit is placed on the nesting level of
display lists during display-list execution. This limit is at
least 64, and it depends on the implementation.
GL state is not saved and restored across a call to 'glCallList'.
Thus, changes made to GL state during the execution of a display
list remain after execution of the display list is completed. Use
'glPushAttrib', 'glPopAttrib', 'glPushMatrix', and 'glPopMatrix' to
preserve GL state across 'glCallList' calls.
-- Function: void glClearAccum red green blue alpha
Specify clear values for the accumulation buffer.
RED
GREEN
BLUE
ALPHA
Specify the red, green, blue, and alpha values used when the
accumulation buffer is cleared. The initial values are all 0.
'glClearAccum' specifies the red, green, blue, and alpha values
used by 'glClear' to clear the accumulation buffer.
Values specified by 'glClearAccum' are clamped to the range [-1,1].
'GL_INVALID_OPERATION' is generated if 'glClearAccum' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glClearColor red green blue alpha
Specify clear values for the color buffers.
RED
GREEN
BLUE
ALPHA
Specify the red, green, blue, and alpha values used when the
color buffers are cleared. The initial values are all 0.
'glClearColor' specifies the red, green, blue, and alpha values
used by 'glClear' to clear the color buffers. Values specified by
'glClearColor' are clamped to the range [0,1].
'GL_INVALID_OPERATION' is generated if 'glClearColor' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glClearDepth depth
Specify the clear value for the depth buffer.
DEPTH
Specifies the depth value used when the depth buffer is
cleared. The initial value is 1.
'glClearDepth' specifies the depth value used by 'glClear' to clear
the depth buffer. Values specified by 'glClearDepth' are clamped
to the range [0,1].
'GL_INVALID_OPERATION' is generated if 'glClearDepth' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glClearIndex c
Specify the clear value for the color index buffers.
C
Specifies the index used when the color index buffers are
cleared. The initial value is 0.
'glClearIndex' specifies the index used by 'glClear' to clear the
color index buffers. C is not clamped. Rather, C is converted to
a fixed-point value with unspecified precision to the right of the
binary point. The integer part of this value is then masked with
2^M-1, where M is the number of bits in a color index stored in the
frame buffer.
'GL_INVALID_OPERATION' is generated if 'glClearIndex' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glClearStencil s
Specify the clear value for the stencil buffer.
S
Specifies the index used when the stencil buffer is cleared.
The initial value is 0.
'glClearStencil' specifies the index used by 'glClear' to clear the
stencil buffer. S is masked with 2^M-1, where M is the number of
bits in the stencil buffer.
'GL_INVALID_OPERATION' is generated if 'glClearStencil' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glClear mask
Clear buffers to preset values.
MASK
Bitwise OR of masks that indicate the buffers to be cleared.
The four masks are 'GL_COLOR_BUFFER_BIT',
'GL_DEPTH_BUFFER_BIT', 'GL_ACCUM_BUFFER_BIT', and
'GL_STENCIL_BUFFER_BIT'.
'glClear' sets the bitplane area of the window to values previously
selected by 'glClearColor', 'glClearIndex', 'glClearDepth',
'glClearStencil', and 'glClearAccum'. Multiple color buffers can
be cleared simultaneously by selecting more than one buffer at a
time using 'glDrawBuffer'.
The pixel ownership test, the scissor test, dithering, and the
buffer writemasks affect the operation of 'glClear'. The scissor
box bounds the cleared region. Alpha function, blend function,
logical operation, stenciling, texture mapping, and depth-buffering
are ignored by 'glClear'.
'glClear' takes a single argument that is the bitwise OR of several
values indicating which buffer is to be cleared.
The values are as follows:
'GL_COLOR_BUFFER_BIT'
Indicates the buffers currently enabled for color writing.
'GL_DEPTH_BUFFER_BIT'
Indicates the depth buffer.
'GL_ACCUM_BUFFER_BIT'
Indicates the accumulation buffer.
'GL_STENCIL_BUFFER_BIT'
Indicates the stencil buffer.
The value to which each buffer is cleared depends on the setting of
the clear value for that buffer.
'GL_INVALID_VALUE' is generated if any bit other than the four
defined bits is set in MASK.
'GL_INVALID_OPERATION' is generated if 'glClear' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glClientActiveTexture texture
Select active texture unit.
TEXTURE
Specifies which texture unit to make active. The number of
texture units is implementation dependent, but must be at
least two. TEXTURE must be one of 'GL_TEXTURE'I, where i
ranges from 0 to the value of 'GL_MAX_TEXTURE_COORDS' - 1,
which is an implementation-dependent value. The initial value
is 'GL_TEXTURE0'.
'glClientActiveTexture' selects the vertex array client state
parameters to be modified by 'glTexCoordPointer', and enabled or
disabled with 'glEnableClientState' or 'glDisableClientState',
respectively, when called with a parameter of
'GL_TEXTURE_COORD_ARRAY'.
'GL_INVALID_ENUM' is generated if TEXTURE is not one of
'GL_TEXTURE'I, where i ranges from 0 to the value of
'GL_MAX_TEXTURE_COORDS' - 1.
-- Function: void glClipPlane plane equation
Specify a plane against which all geometry is clipped.
PLANE
Specifies which clipping plane is being positioned. Symbolic
names of the form 'GL_CLIP_PLANE'I, where I is an integer
between 0 and 'GL_MAX_CLIP_PLANES'-1, are accepted.
EQUATION
Specifies the address of an array of four double-precision
floating-point values. These values are interpreted as a
plane equation.
Geometry is always clipped against the boundaries of a six-plane
frustum in X, Y, and Z. 'glClipPlane' allows the specification of
additional planes, not necessarily perpendicular to the X, Y, or Z
axis, against which all geometry is clipped. To determine the
maximum number of additional clipping planes, call 'glGetIntegerv'
with argument 'GL_MAX_CLIP_PLANES'. All implementations support at
least six such clipping planes. Because the resulting clipping
region is the intersection of the defined half-spaces, it is always
convex.
'glClipPlane' specifies a half-space using a four-component plane
equation. When 'glClipPlane' is called, EQUATION is transformed by
the inverse of the modelview matrix and stored in the resulting eye
coordinates. Subsequent changes to the modelview matrix have no
effect on the stored plane-equation components. If the dot product
of the eye coordinates of a vertex with the stored plane equation
components is positive or zero, the vertex is IN with respect to
that clipping plane. Otherwise, it is OUT.
To enable and disable clipping planes, call 'glEnable' and
'glDisable' with the argument 'GL_CLIP_PLANE'I, where I is the
plane number.
All clipping planes are initially defined as (0, 0, 0, 0) in eye
coordinates and are disabled.
'GL_INVALID_ENUM' is generated if PLANE is not an accepted value.
'GL_INVALID_OPERATION' is generated if 'glClipPlane' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glColorMask red green blue alpha
Enable and disable writing of frame buffer color components.
RED
GREEN
BLUE
ALPHA
Specify whether red, green, blue, and alpha can or cannot be
written into the frame buffer. The initial values are all
'GL_TRUE', indicating that the color components can be
written.
'glColorMask' specifies whether the individual color components in
the frame buffer can or cannot be written. If RED is 'GL_FALSE',
for example, no change is made to the red component of any pixel in
any of the color buffers, regardless of the drawing operation
attempted.
Changes to individual bits of components cannot be controlled.
Rather, changes are either enabled or disabled for entire color
components.
'GL_INVALID_OPERATION' is generated if 'glColorMask' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glColorMaterial face mode
Cause a material color to track the current color.
FACE
Specifies whether front, back, or both front and back material
parameters should track the current color. Accepted values
are 'GL_FRONT', 'GL_BACK', and 'GL_FRONT_AND_BACK'. The
initial value is 'GL_FRONT_AND_BACK'.
MODE
Specifies which of several material parameters track the
current color. Accepted values are 'GL_EMISSION',
'GL_AMBIENT', 'GL_DIFFUSE', 'GL_SPECULAR', and
'GL_AMBIENT_AND_DIFFUSE'. The initial value is
'GL_AMBIENT_AND_DIFFUSE'.
'glColorMaterial' specifies which material parameters track the
current color. When 'GL_COLOR_MATERIAL' is enabled, the material
parameter or parameters specified by MODE, of the material or
materials specified by FACE, track the current color at all times.
To enable and disable 'GL_COLOR_MATERIAL', call 'glEnable' and
'glDisable' with argument 'GL_COLOR_MATERIAL'. 'GL_COLOR_MATERIAL'
is initially disabled.
'GL_INVALID_ENUM' is generated if FACE or MODE is not an accepted
value.
'GL_INVALID_OPERATION' is generated if 'glColorMaterial' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glColorPointer size type stride pointer
Define an array of colors.
SIZE
Specifies the number of components per color. Must be 3 or 4.
The initial value is 4.
TYPE
Specifies the data type of each color component in the array.
Symbolic constants 'GL_BYTE', 'GL_UNSIGNED_BYTE', 'GL_SHORT',
'GL_UNSIGNED_SHORT', 'GL_INT', 'GL_UNSIGNED_INT', 'GL_FLOAT',
and 'GL_DOUBLE' are accepted. The initial value is
'GL_FLOAT'.
STRIDE
Specifies the byte offset between consecutive colors. If
STRIDE is 0, the colors are understood to be tightly packed in
the array. The initial value is 0.
POINTER
Specifies a pointer to the first component of the first color
element in the array. The initial value is 0.
'glColorPointer' specifies the location and data format of an array
of color components to use when rendering. SIZE specifies the
number of components per color, and must be 3 or 4. TYPE specifies
the data type of each color component, and STRIDE specifies the
byte stride from one color to the next, allowing vertices and
attributes to be packed into a single array or stored in separate
arrays. (Single-array storage may be more efficient on some
implementations; see 'glInterleavedArrays'.)
If a non-zero named buffer object is bound to the 'GL_ARRAY_BUFFER'
target (see 'glBindBuffer') while a color array is specified,
POINTER is treated as a byte offset into the buffer object's data
store. Also, the buffer object binding ('GL_ARRAY_BUFFER_BINDING')
is saved as color vertex array client-side state
('GL_COLOR_ARRAY_BUFFER_BINDING').
When a color array is specified, SIZE, TYPE, STRIDE, and POINTER
are saved as client-side state, in addition to the current vertex
array buffer object binding.
To enable and disable the color array, call 'glEnableClientState'
and 'glDisableClientState' with the argument 'GL_COLOR_ARRAY'. If
enabled, the color array is used when 'glDrawArrays',
'glMultiDrawArrays', 'glDrawElements', 'glMultiDrawElements',
'glDrawRangeElements', or 'glArrayElement' is called.
'GL_INVALID_VALUE' is generated if SIZE is not 3 or 4.
'GL_INVALID_ENUM' is generated if TYPE is not an accepted value.
'GL_INVALID_VALUE' is generated if STRIDE is negative.
-- Function: void glColorSubTable target start count format type data
Respecify a portion of a color table.
TARGET
Must be one of 'GL_COLOR_TABLE',
'GL_POST_CONVOLUTION_COLOR_TABLE', or
'GL_POST_COLOR_MATRIX_COLOR_TABLE'.
START
The starting index of the portion of the color table to be
replaced.
COUNT
The number of table entries to replace.
FORMAT
The format of the pixel data in DATA. The allowable values
are 'GL_RED', 'GL_GREEN', 'GL_BLUE', 'GL_ALPHA',
'GL_LUMINANCE', 'GL_LUMINANCE_ALPHA', 'GL_RGB', 'GL_BGR',
'GL_RGBA', and 'GL_BGRA'.
TYPE
The type of the pixel data in DATA. The allowable values are
'GL_UNSIGNED_BYTE', 'GL_BYTE', 'GL_UNSIGNED_SHORT',
'GL_SHORT', 'GL_UNSIGNED_INT', 'GL_INT', 'GL_FLOAT',
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', 'GL_UNSIGNED_SHORT_5_6_5_REV',
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', and
'GL_UNSIGNED_INT_2_10_10_10_REV'.
DATA
Pointer to a one-dimensional array of pixel data that is
processed to replace the specified region of the color table.
'glColorSubTable' is used to respecify a contiguous portion of a
color table previously defined using 'glColorTable'. The pixels
referenced by DATA replace the portion of the existing table from
indices START to START+COUNT-1, inclusive. This region may not
include any entries outside the range of the color table as it was
originally specified. It is not an error to specify a subtexture
with width of 0, but such a specification has no effect.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
portion of a color table is respecified, DATA is treated as a byte
offset into the buffer object's data store.
'GL_INVALID_ENUM' is generated if TARGET is not one of the
allowable values.
'GL_INVALID_ENUM' is generated if FORMAT is not one of the
allowable values.
'GL_INVALID_ENUM' is generated if TYPE is not one of the allowable
values.
'GL_INVALID_VALUE' is generated if START+COUNT>WIDTH.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and DATA is
not evenly divisible into the number of bytes needed to store in
memory a datum indicated by TYPE.
'GL_INVALID_OPERATION' is generated if 'glColorSubTable' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glColorTableParameterfv target pname params
-- Function: void glColorTableParameteriv target pname params
Set color lookup table parameters.
TARGET
The target color table. Must be 'GL_COLOR_TABLE',
'GL_POST_CONVOLUTION_COLOR_TABLE', or
'GL_POST_COLOR_MATRIX_COLOR_TABLE'.
PNAME
The symbolic name of a texture color lookup table parameter.
Must be one of 'GL_COLOR_TABLE_SCALE' or
'GL_COLOR_TABLE_BIAS'.
PARAMS
A pointer to an array where the values of the parameters are
stored.
'glColorTableParameter' is used to specify the scale factors and
bias terms applied to color components when they are loaded into a
color table. TARGET indicates which color table the scale and bias
terms apply to; it must be set to 'GL_COLOR_TABLE',
'GL_POST_CONVOLUTION_COLOR_TABLE', or
'GL_POST_COLOR_MATRIX_COLOR_TABLE'.
PNAME must be 'GL_COLOR_TABLE_SCALE' to set the scale factors. In
this case, PARAMS points to an array of four values, which are the
scale factors for red, green, blue, and alpha, in that order.
PNAME must be 'GL_COLOR_TABLE_BIAS' to set the bias terms. In this
case, PARAMS points to an array of four values, which are the bias
terms for red, green, blue, and alpha, in that order.
The color tables themselves are specified by calling
'glColorTable'.
'GL_INVALID_ENUM' is generated if TARGET or PNAME is not an
acceptable value.
'GL_INVALID_OPERATION' is generated if 'glColorTableParameter' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glColorTable target internalformat width format type
data
Define a color lookup table.
TARGET
Must be one of 'GL_COLOR_TABLE',
'GL_POST_CONVOLUTION_COLOR_TABLE',
'GL_POST_COLOR_MATRIX_COLOR_TABLE', 'GL_PROXY_COLOR_TABLE',
'GL_PROXY_POST_CONVOLUTION_COLOR_TABLE', or
'GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE'.
INTERNALFORMAT
The internal format of the color table. The allowable values
are 'GL_ALPHA', 'GL_ALPHA4', 'GL_ALPHA8', 'GL_ALPHA12',
'GL_ALPHA16', 'GL_LUMINANCE', 'GL_LUMINANCE4',
'GL_LUMINANCE8', 'GL_LUMINANCE12', 'GL_LUMINANCE16',
'GL_LUMINANCE_ALPHA', 'GL_LUMINANCE4_ALPHA4',
'GL_LUMINANCE6_ALPHA2', 'GL_LUMINANCE8_ALPHA8',
'GL_LUMINANCE12_ALPHA4', 'GL_LUMINANCE12_ALPHA12',
'GL_LUMINANCE16_ALPHA16', 'GL_INTENSITY', 'GL_INTENSITY4',
'GL_INTENSITY8', 'GL_INTENSITY12', 'GL_INTENSITY16',
'GL_R3_G3_B2', 'GL_RGB', 'GL_RGB4', 'GL_RGB5', 'GL_RGB8',
'GL_RGB10', 'GL_RGB12', 'GL_RGB16', 'GL_RGBA', 'GL_RGBA2',
'GL_RGBA4', 'GL_RGB5_A1', 'GL_RGBA8', 'GL_RGB10_A2',
'GL_RGBA12', and 'GL_RGBA16'.
WIDTH
The number of entries in the color lookup table specified by
DATA.
FORMAT
The format of the pixel data in DATA. The allowable values
are 'GL_RED', 'GL_GREEN', 'GL_BLUE', 'GL_ALPHA',
'GL_LUMINANCE', 'GL_LUMINANCE_ALPHA', 'GL_RGB', 'GL_BGR',
'GL_RGBA', and 'GL_BGRA'.
TYPE
The type of the pixel data in DATA. The allowable values are
'GL_UNSIGNED_BYTE', 'GL_BYTE', 'GL_UNSIGNED_SHORT',
'GL_SHORT', 'GL_UNSIGNED_INT', 'GL_INT', 'GL_FLOAT',
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', 'GL_UNSIGNED_SHORT_5_6_5_REV',
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', and
'GL_UNSIGNED_INT_2_10_10_10_REV'.
DATA
Pointer to a one-dimensional array of pixel data that is
processed to build the color table.
'glColorTable' may be used in two ways: to test the actual size and
color resolution of a lookup table given a particular set of
parameters, or to load the contents of a color lookup table. Use
the targets 'GL_PROXY_*' for the first case and the other targets
for the second case.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a color
table is specified, DATA is treated as a byte offset into the
buffer object's data store.
If TARGET is 'GL_COLOR_TABLE', 'GL_POST_CONVOLUTION_COLOR_TABLE',
or 'GL_POST_COLOR_MATRIX_COLOR_TABLE', 'glColorTable' builds a
color lookup table from an array of pixels. The pixel array
specified by WIDTH, FORMAT, TYPE, and DATA is extracted from memory
and processed just as if 'glDrawPixels' were called, but processing
stops after the final expansion to RGBA is completed.
The four scale parameters and the four bias parameters that are
defined for the table are then used to scale and bias the R, G, B,
and A components of each pixel. (Use 'glColorTableParameter' to
set these scale and bias parameters.)
Next, the R, G, B, and A values are clamped to the range [0,1].
Each pixel is then converted to the internal format specified by
INTERNALFORMAT. This conversion simply maps the component values
of the pixel (R, G, B, and A) to the values included in the
internal format (red, green, blue, alpha, luminance, and
intensity). The mapping is as follows:
*Internal Format*
*Red*, *Green*, *Blue*, *Alpha*, *Luminance*, *Intensity*
'GL_ALPHA'
, , , A , ,
'GL_LUMINANCE'
, , , , R ,
'GL_LUMINANCE_ALPHA'
, , , A , R ,
'GL_INTENSITY'
, , , , , R
'GL_RGB'
R , G , B , , ,
'GL_RGBA'
R , G , B , A , ,
Finally, the red, green, blue, alpha, luminance, and/or intensity
components of the resulting pixels are stored in the color table.
They form a one-dimensional table with indices in the range
[0,WIDTH-1].
If TARGET is 'GL_PROXY_*', 'glColorTable' recomputes and stores the
values of the proxy color table's state variables
'GL_COLOR_TABLE_FORMAT', 'GL_COLOR_TABLE_WIDTH',
'GL_COLOR_TABLE_RED_SIZE', 'GL_COLOR_TABLE_GREEN_SIZE',
'GL_COLOR_TABLE_BLUE_SIZE', 'GL_COLOR_TABLE_ALPHA_SIZE',
'GL_COLOR_TABLE_LUMINANCE_SIZE', and
'GL_COLOR_TABLE_INTENSITY_SIZE'. There is no effect on the image
or state of any actual color table. If the specified color table
is too large to be supported, then all the proxy state variables
listed above are set to zero. Otherwise, the color table could be
supported by 'glColorTable' using the corresponding non-proxy
target, and the proxy state variables are set as if that target
were being defined.
The proxy state variables can be retrieved by calling
'glGetColorTableParameter' with a target of 'GL_PROXY_*'. This
allows the application to decide if a particular 'glColorTable'
command would succeed, and to determine what the resulting color
table attributes would be.
If a color table is enabled, and its width is non-zero, then its
contents are used to replace a subset of the components of each
RGBA pixel group, based on the internal format of the table.
Each pixel group has color components (R, G, B, A) that are in the
range [0.0,1.0]. The color components are rescaled to the size of
the color lookup table to form an index. Then a subset of the
components based on the internal format of the table are replaced
by the table entry selected by that index. If the color components
and contents of the table are represented as follows:
*Representation*
*Meaning*
'r'
Table index computed from 'R'
'g'
Table index computed from 'G'
'b'
Table index computed from 'B'
'a'
Table index computed from 'A'
'L[i]'
Luminance value at table index 'i'
'I[i]'
Intensity value at table index 'i'
'R[i]'
Red value at table index 'i'
'G[i]'
Green value at table index 'i'
'B[i]'
Blue value at table index 'i'
'A[i]'
Alpha value at table index 'i'
then the result of color table lookup is as follows:
**
*Resulting Texture Components*
*Table Internal Format*
*R*, *G*, *B*, *A*
'GL_ALPHA'
'R', 'G', 'B', 'A[a]'
'GL_LUMINANCE'
'L[r]', 'L[g]', 'L[b]', 'At'
'GL_LUMINANCE_ALPHA'
'L[r]', 'L[g]', 'L[b]', 'A[a]'
'GL_INTENSITY'
'I[r]', 'I[g]', 'I[b]', 'I[a]'
'GL_RGB'
'R[r]', 'G[g]', 'B[b]', 'A'
'GL_RGBA'
'R[r]', 'G[g]', 'B[b]', 'A[a]'
When 'GL_COLOR_TABLE' is enabled, the colors resulting from the
pixel map operation (if it is enabled) are mapped by the color
lookup table before being passed to the convolution operation. The
colors resulting from the convolution operation are modified by the
post convolution color lookup table when
'GL_POST_CONVOLUTION_COLOR_TABLE' is enabled. These modified
colors are then sent to the color matrix operation. Finally, if
'GL_POST_COLOR_MATRIX_COLOR_TABLE' is enabled, the colors resulting
from the color matrix operation are mapped by the post color matrix
color lookup table before being used by the histogram operation.
'GL_INVALID_ENUM' is generated if TARGET is not one of the
allowable values.
'GL_INVALID_ENUM' is generated if INTERNALFORMAT is not one of the
allowable values.
'GL_INVALID_ENUM' is generated if FORMAT is not one of the
allowable values.
'GL_INVALID_ENUM' is generated if TYPE is not one of the allowable
values.
'GL_INVALID_VALUE' is generated if WIDTH is less than zero.
'GL_TABLE_TOO_LARGE' is generated if the requested color table is
too large to be supported by the implementation, and TARGET is not
a 'GL_PROXY_*' target.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and DATA is
not evenly divisible into the number of bytes needed to store in
memory a datum indicated by TYPE.
'GL_INVALID_OPERATION' is generated if 'glColorTable' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glColor3b red green blue
-- Function: void glColor3s red green blue
-- Function: void glColor3i red green blue
-- Function: void glColor3f red green blue
-- Function: void glColor3d red green blue
-- Function: void glColor3ub red green blue
-- Function: void glColor3us red green blue
-- Function: void glColor3ui red green blue
-- Function: void glColor4b red green blue alpha
-- Function: void glColor4s red green blue alpha
-- Function: void glColor4i red green blue alpha
-- Function: void glColor4f red green blue alpha
-- Function: void glColor4d red green blue alpha
-- Function: void glColor4ub red green blue alpha
-- Function: void glColor4us red green blue alpha
-- Function: void glColor4ui red green blue alpha
-- Function: void glColor3bv v
-- Function: void glColor3sv v
-- Function: void glColor3iv v
-- Function: void glColor3fv v
-- Function: void glColor3dv v
-- Function: void glColor3ubv v
-- Function: void glColor3usv v
-- Function: void glColor3uiv v
-- Function: void glColor4bv v
-- Function: void glColor4sv v
-- Function: void glColor4iv v
-- Function: void glColor4fv v
-- Function: void glColor4dv v
-- Function: void glColor4ubv v
-- Function: void glColor4usv v
-- Function: void glColor4uiv v
Set the current color.
RED
GREEN
BLUE
Specify new red, green, and blue values for the current color.
ALPHA
Specifies a new alpha value for the current color. Included
only in the four-argument 'glColor4' commands.
The GL stores both a current single-valued color index and a
current four-valued RGBA color. 'glColor' sets a new four-valued
RGBA color. 'glColor' has two major variants: 'glColor3' and
'glColor4'. 'glColor3' variants specify new red, green, and blue
values explicitly and set the current alpha value to 1.0 (full
intensity) implicitly. 'glColor4' variants specify all four color
components explicitly.
'glColor3b', 'glColor4b', 'glColor3s', 'glColor4s', 'glColor3i',
and 'glColor4i' take three or four signed byte, short, or long
integers as arguments. When *v* is appended to the name, the color
commands can take a pointer to an array of such values.
Current color values are stored in floating-point format, with
unspecified mantissa and exponent sizes. Unsigned integer color
components, when specified, are linearly mapped to floating-point
values such that the largest representable value maps to 1.0 (full
intensity), and 0 maps to 0.0 (zero intensity). Signed integer
color components, when specified, are linearly mapped to
floating-point values such that the most positive representable
value maps to 1.0, and the most negative representable value maps
to -1.0. (Note that this mapping does not convert 0 precisely to
0.0.) Floating-point values are mapped directly.
Neither floating-point nor signed integer values are clamped to the
range [0,1] before the current color is updated. However, color
components are clamped to this range before they are interpolated
or written into a color buffer.
-- Function: void glCompileShader shader
Compiles a shader object.
SHADER
Specifies the shader object to be compiled.
'glCompileShader' compiles the source code strings that have been
stored in the shader object specified by SHADER.
The compilation status will be stored as part of the shader
object's state. This value will be set to 'GL_TRUE' if the shader
was compiled without errors and is ready for use, and 'GL_FALSE'
otherwise. It can be queried by calling 'glGetShader' with
arguments SHADER and 'GL_COMPILE_STATUS'.
Compilation of a shader can fail for a number of reasons as
specified by the OpenGL Shading Language Specification. Whether or
not the compilation was successful, information about the
compilation can be obtained from the shader object's information
log by calling 'glGetShaderInfoLog'.
'GL_INVALID_VALUE' is generated if SHADER is not a value generated
by OpenGL.
'GL_INVALID_OPERATION' is generated if SHADER is not a shader
object.
'GL_INVALID_OPERATION' is generated if 'glCompileShader' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glCompressedTexImage1D target level internalformat
width border imageSize data
Specify a one-dimensional texture image in a compressed format.
TARGET
Specifies the target texture. Must be 'GL_TEXTURE_1D' or
'GL_PROXY_TEXTURE_1D'.
LEVEL
Specifies the level-of-detail number. Level 0 is the base
image level. Level N is the Nth mipmap reduction image.
INTERNALFORMAT
Specifies the format of the compressed image data stored at
address DATA.
WIDTH
Specifies the width of the texture image including the border
if any. If the GL version does not support non-power-of-two
sizes, this value must be 2^N+2(BORDER,) for some integer
N. All implementations support texture images that are at
least 64 texels wide. The height of the 1D texture image is
1.
BORDER
Specifies the width of the border. Must be either 0 or 1.
IMAGESIZE
Specifies the number of unsigned bytes of image data starting
at the address specified by DATA.
DATA
Specifies a pointer to the compressed image data in memory.
Texturing maps a portion of a specified texture image onto each
graphical primitive for which texturing is enabled. To enable and
disable one-dimensional texturing, call 'glEnable' and 'glDisable'
with argument 'GL_TEXTURE_1D'.
'glCompressedTexImage1D' loads a previously defined, and retrieved,
compressed one-dimensional texture image if TARGET is
'GL_TEXTURE_1D' (see 'glTexImage1D').
If TARGET is 'GL_PROXY_TEXTURE_1D', no data is read from DATA, but
all of the texture image state is recalculated, checked for
consistency, and checked against the implementation's capabilities.
If the implementation cannot handle a texture of the requested
texture size, it sets all of the image state to 0, but does not
generate an error (see 'glGetError'). To query for an entire
mipmap array, use an image array level greater than or equal to 1.
INTERNALFORMAT must be extension-specified compressed-texture
format. When a texture is loaded with 'glTexImage1D' using a
generic compressed texture format (e.g., 'GL_COMPRESSED_RGB') the
GL selects from one of its extensions supporting compressed
textures. In order to load the compressed texture image using
'glCompressedTexImage1D', query the compressed texture image's size
and format using 'glGetTexLevelParameter'.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
texture image is specified, DATA is treated as a byte offset into
the buffer object's data store.
'GL_INVALID_ENUM' is generated if INTERNALFORMAT is one of the
generic compressed internal formats: 'GL_COMPRESSED_ALPHA',
'GL_COMPRESSED_LUMINANCE', 'GL_COMPRESSED_LUMINANCE_ALPHA',
'GL_COMPRESSED_INTENSITY', 'GL_COMPRESSED_RGB', or
'GL_COMPRESSED_RGBA'.
'GL_INVALID_VALUE' is generated if IMAGESIZE is not consistent with
the format, dimensions, and contents of the specified compressed
image data.
'GL_INVALID_OPERATION' is generated if parameter combinations are
not supported by the specific compressed internal format as
specified in the specific texture compression extension.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if 'glCompressedTexImage1D' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
Undefined results, including abnormal program termination, are
generated if DATA is not encoded in a manner consistent with the
extension specification defining the internal compression format.
-- Function: void glCompressedTexImage2D target level internalformat
width height border imageSize data
Specify a two-dimensional texture image in a compressed format.
TARGET
Specifies the target texture. Must be 'GL_TEXTURE_2D',
'GL_PROXY_TEXTURE_2D', 'GL_TEXTURE_CUBE_MAP_POSITIVE_X',
'GL_TEXTURE_CUBE_MAP_NEGATIVE_X',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Y',
'GL_TEXTURE_CUBE_MAP_NEGATIVE_Y',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Z',
'GL_TEXTURE_CUBE_MAP_NEGATIVE_Z', or
'GL_PROXY_TEXTURE_CUBE_MAP'.
LEVEL
Specifies the level-of-detail number. Level 0 is the base
image level. Level N is the Nth mipmap reduction image.
INTERNALFORMAT
Specifies the format of the compressed image data stored at
address DATA.
WIDTH
Specifies the width of the texture image including the border
if any. If the GL version does not support non-power-of-two
sizes, this value must be 2^N+2(BORDER,) for some integer
N. All implementations support 2D texture images that are at
least 64 texels wide and cube-mapped texture images that are
at least 16 texels wide.
HEIGHT
Specifies the height of the texture image including the border
if any. If the GL version does not support non-power-of-two
sizes, this value must be Must be 2^N+2(BORDER,) for some
integer N. All implementations support 2D texture images that
are at least 64 texels high and cube-mapped texture images
that are at least 16 texels high.
BORDER
Specifies the width of the border. Must be either 0 or 1.
IMAGESIZE
Specifies the number of unsigned bytes of image data starting
at the address specified by DATA.
DATA
Specifies a pointer to the compressed image data in memory.
Texturing maps a portion of a specified texture image onto each
graphical primitive for which texturing is enabled. To enable and
disable two-dimensional texturing, call 'glEnable' and 'glDisable'
with argument 'GL_TEXTURE_2D'. To enable and disable texturing
using cube-mapped textures, call 'glEnable' and 'glDisable' with
argument 'GL_TEXTURE_CUBE_MAP'.
'glCompressedTexImage2D' loads a previously defined, and retrieved,
compressed two-dimensional texture image if TARGET is
'GL_TEXTURE_2D' (see 'glTexImage2D').
If TARGET is 'GL_PROXY_TEXTURE_2D', no data is read from DATA, but
all of the texture image state is recalculated, checked for
consistency, and checked against the implementation's capabilities.
If the implementation cannot handle a texture of the requested
texture size, it sets all of the image state to 0, but does not
generate an error (see 'glGetError'). To query for an entire
mipmap array, use an image array level greater than or equal to 1.
INTERNALFORMAT must be an extension-specified compressed-texture
format. When a texture is loaded with 'glTexImage2D' using a
generic compressed texture format (e.g., 'GL_COMPRESSED_RGB'), the
GL selects from one of its extensions supporting compressed
textures. In order to load the compressed texture image using
'glCompressedTexImage2D', query the compressed texture image's size
and format using 'glGetTexLevelParameter'.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
texture image is specified, DATA is treated as a byte offset into
the buffer object's data store.
'GL_INVALID_ENUM' is generated if INTERNALFORMAT is one of the
generic compressed internal formats: 'GL_COMPRESSED_ALPHA',
'GL_COMPRESSED_LUMINANCE', 'GL_COMPRESSED_LUMINANCE_ALPHA',
'GL_COMPRESSED_INTENSITY', 'GL_COMPRESSED_RGB', or
'GL_COMPRESSED_RGBA'.
'GL_INVALID_VALUE' is generated if IMAGESIZE is not consistent with
the format, dimensions, and contents of the specified compressed
image data.
'GL_INVALID_OPERATION' is generated if parameter combinations are
not supported by the specific compressed internal format as
specified in the specific texture compression extension.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if 'glCompressedTexImage2D' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
Undefined results, including abnormal program termination, are
generated if DATA is not encoded in a manner consistent with the
extension specification defining the internal compression format.
-- Function: void glCompressedTexImage3D target level internalformat
width height depth border imageSize data
Specify a three-dimensional texture image in a compressed format.
TARGET
Specifies the target texture. Must be 'GL_TEXTURE_3D' or
'GL_PROXY_TEXTURE_3D'.
LEVEL
Specifies the level-of-detail number. Level 0 is the base
image level. Level N is the Nth mipmap reduction image.
INTERNALFORMAT
Specifies the format of the compressed image data stored at
address DATA.
WIDTH
Specifies the width of the texture image including the border
if any. If the GL version does not support non-power-of-two
sizes, this value must be 2^N+2(BORDER,) for some integer
N. All implementations support 3D texture images that are at
least 16 texels wide.
HEIGHT
Specifies the height of the texture image including the border
if any. If the GL version does not support non-power-of-two
sizes, this value must be 2^N+2(BORDER,) for some integer
N. All implementations support 3D texture images that are at
least 16 texels high.
DEPTH
Specifies the depth of the texture image including the border
if any. If the GL version does not support non-power-of-two
sizes, this value must be 2^N+2(BORDER,) for some integer
N. All implementations support 3D texture images that are at
least 16 texels deep.
BORDER
Specifies the width of the border. Must be either 0 or 1.
IMAGESIZE
Specifies the number of unsigned bytes of image data starting
at the address specified by DATA.
DATA
Specifies a pointer to the compressed image data in memory.
Texturing maps a portion of a specified texture image onto each
graphical primitive for which texturing is enabled. To enable and
disable three-dimensional texturing, call 'glEnable' and
'glDisable' with argument 'GL_TEXTURE_3D'.
'glCompressedTexImage3D' loads a previously defined, and retrieved,
compressed three-dimensional texture image if TARGET is
'GL_TEXTURE_3D' (see 'glTexImage3D').
If TARGET is 'GL_PROXY_TEXTURE_3D', no data is read from DATA, but
all of the texture image state is recalculated, checked for
consistency, and checked against the implementation's capabilities.
If the implementation cannot handle a texture of the requested
texture size, it sets all of the image state to 0, but does not
generate an error (see 'glGetError'). To query for an entire
mipmap array, use an image array level greater than or equal to 1.
INTERNALFORMAT must be an extension-specified compressed-texture
format. When a texture is loaded with 'glTexImage2D' using a
generic compressed texture format (e.g., 'GL_COMPRESSED_RGB'), the
GL selects from one of its extensions supporting compressed
textures. In order to load the compressed texture image using
'glCompressedTexImage3D', query the compressed texture image's size
and format using 'glGetTexLevelParameter'.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
texture image is specified, DATA is treated as a byte offset into
the buffer object's data store.
'GL_INVALID_ENUM' is generated if INTERNALFORMAT is one of the
generic compressed internal formats: 'GL_COMPRESSED_ALPHA',
'GL_COMPRESSED_LUMINANCE', 'GL_COMPRESSED_LUMINANCE_ALPHA',
'GL_COMPRESSED_INTENSITY', 'GL_COMPRESSED_RGB', or
'GL_COMPRESSED_RGBA'.
'GL_INVALID_VALUE' is generated if IMAGESIZE is not consistent with
the format, dimensions, and contents of the specified compressed
image data.
'GL_INVALID_OPERATION' is generated if parameter combinations are
not supported by the specific compressed internal format as
specified in the specific texture compression extension.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if 'glCompressedTexImage3D' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
Undefined results, including abnormal program termination, are
generated if DATA is not encoded in a manner consistent with the
extension specification defining the internal compression format.
-- Function: void glCompressedTexSubImage1D target level xoffset width
format imageSize data
Specify a one-dimensional texture subimage in a compressed format.
TARGET
Specifies the target texture. Must be 'GL_TEXTURE_1D'.
LEVEL
Specifies the level-of-detail number. Level 0 is the base
image level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
array.
WIDTH
Specifies the width of the texture subimage.
FORMAT
Specifies the format of the compressed image data stored at
address DATA.
IMAGESIZE
Specifies the number of unsigned bytes of image data starting
at the address specified by DATA.
DATA
Specifies a pointer to the compressed image data in memory.
Texturing maps a portion of a specified texture image onto each
graphical primitive for which texturing is enabled. To enable and
disable one-dimensional texturing, call 'glEnable' and 'glDisable'
with argument 'GL_TEXTURE_1D'.
'glCompressedTexSubImage1D' redefines a contiguous subregion of an
existing one-dimensional texture image. The texels referenced by
DATA replace the portion of the existing texture array with x
indices XOFFSET and XOFFSET+WIDTH-1, inclusive. This region may
not include any texels outside the range of the texture array as it
was originally specified. It is not an error to specify a
subtexture with width of 0, but such a specification has no effect.
FORMAT must be an extension-specified compressed-texture format.
The FORMAT of the compressed texture image is selected by the GL
implementation that compressed it (see 'glTexImage1D'), and should
be queried at the time the texture was compressed with
'glGetTexLevelParameter'.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
texture image is specified, DATA is treated as a byte offset into
the buffer object's data store.
'GL_INVALID_ENUM' is generated if FORMAT is one of these generic
compressed internal formats: 'GL_COMPRESSED_ALPHA',
'GL_COMPRESSED_LUMINANCE', 'GL_COMPRESSED_LUMINANCE_ALPHA',
'GL_COMPRESSED_INTENSITY', 'GL_COMPRESSED_RGB',
'GL_COMPRESSED_RGBA', 'GL_COMPRESSED_SLUMINANCE',
'GL_COMPRESSED_SLUMINANCE_ALPHA', 'GL_COMPRESSED_SRGB',
'GL_COMPRESSED_SRGBA', or 'GL_COMPRESSED_SRGB_ALPHA'.
'GL_INVALID_VALUE' is generated if IMAGESIZE is not consistent with
the format, dimensions, and contents of the specified compressed
image data.
'GL_INVALID_OPERATION' is generated if parameter combinations are
not supported by the specific compressed internal format as
specified in the specific texture compression extension.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if 'glCompressedTexSubImage1D'
is executed between the execution of 'glBegin' and the
corresponding execution of 'glEnd'.
Undefined results, including abnormal program termination, are
generated if DATA is not encoded in a manner consistent with the
extension specification defining the internal compression format.
-- Function: void glCompressedTexSubImage2D target level xoffset
yoffset width height format imageSize data
Specify a two-dimensional texture subimage in a compressed format.
TARGET
Specifies the target texture. Must be 'GL_TEXTURE_2D',
'GL_TEXTURE_CUBE_MAP_POSITIVE_X',
'GL_TEXTURE_CUBE_MAP_NEGATIVE_X',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Y',
'GL_TEXTURE_CUBE_MAP_NEGATIVE_Y',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Z', or
'GL_TEXTURE_CUBE_MAP_NEGATIVE_Z'.
LEVEL
Specifies the level-of-detail number. Level 0 is the base
image level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
array.
YOFFSET
Specifies a texel offset in the y direction within the texture
array.
WIDTH
Specifies the width of the texture subimage.
HEIGHT
Specifies the height of the texture subimage.
FORMAT
Specifies the format of the compressed image data stored at
address DATA.
IMAGESIZE
Specifies the number of unsigned bytes of image data starting
at the address specified by DATA.
DATA
Specifies a pointer to the compressed image data in memory.
Texturing maps a portion of a specified texture image onto each
graphical primitive for which texturing is enabled. To enable and
disable two-dimensional texturing, call 'glEnable' and 'glDisable'
with argument 'GL_TEXTURE_2D'. To enable and disable texturing
using cube-mapped texture, call 'glEnable' and 'glDisable' with
argument 'GL_TEXTURE_CUBE_MAP'.
'glCompressedTexSubImage2D' redefines a contiguous subregion of an
existing two-dimensional texture image. The texels referenced by
DATA replace the portion of the existing texture array with x
indices XOFFSET and XOFFSET+WIDTH-1, and the y indices YOFFSET and
YOFFSET+HEIGHT-1, inclusive. This region may not include any
texels outside the range of the texture array as it was originally
specified. It is not an error to specify a subtexture with width
of 0, but such a specification has no effect.
FORMAT must be an extension-specified compressed-texture format.
The FORMAT of the compressed texture image is selected by the GL
implementation that compressed it (see 'glTexImage2D') and should
be queried at the time the texture was compressed with
'glGetTexLevelParameter'.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
texture image is specified, DATA is treated as a byte offset into
the buffer object's data store.
'GL_INVALID_ENUM' is generated if FORMAT is one of these generic
compressed internal formats: 'GL_COMPRESSED_ALPHA',
'GL_COMPRESSED_LUMINANCE', 'GL_COMPRESSED_LUMINANCE_ALPHA',
'GL_COMPRESSED_INTENSITY', 'GL_COMPRESSED_RGB',
'GL_COMPRESSED_RGBA', 'GL_COMPRESSED_SLUMINANCE',
'GL_COMPRESSED_SLUMINANCE_ALPHA', 'GL_COMPRESSED_SRGB',
'GL_COMPRESSED_SRGBA', or 'GL_COMPRESSED_SRGB_ALPHA'.
'GL_INVALID_VALUE' is generated if IMAGESIZE is not consistent with
the format, dimensions, and contents of the specified compressed
image data.
'GL_INVALID_OPERATION' is generated if parameter combinations are
not supported by the specific compressed internal format as
specified in the specific texture compression extension.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if 'glCompressedTexSubImage2D'
is executed between the execution of 'glBegin' and the
corresponding execution of 'glEnd'.
Undefined results, including abnormal program termination, are
generated if DATA is not encoded in a manner consistent with the
extension specification defining the internal compression format.
-- Function: void glCompressedTexSubImage3D target level xoffset
yoffset zoffset width height depth format imageSize data
Specify a three-dimensional texture subimage in a compressed
format.
TARGET
Specifies the target texture. Must be 'GL_TEXTURE_3D'.
LEVEL
Specifies the level-of-detail number. Level 0 is the base
image level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
array.
YOFFSET
Specifies a texel offset in the y direction within the texture
array.
WIDTH
Specifies the width of the texture subimage.
HEIGHT
Specifies the height of the texture subimage.
DEPTH
Specifies the depth of the texture subimage.
FORMAT
Specifies the format of the compressed image data stored at
address DATA.
IMAGESIZE
Specifies the number of unsigned bytes of image data starting
at the address specified by DATA.
DATA
Specifies a pointer to the compressed image data in memory.
Texturing maps a portion of a specified texture image onto each
graphical primitive for which texturing is enabled. To enable and
disable three-dimensional texturing, call 'glEnable' and
'glDisable' with argument 'GL_TEXTURE_3D'.
'glCompressedTexSubImage3D' redefines a contiguous subregion of an
existing three-dimensional texture image. The texels referenced by
DATA replace the portion of the existing texture array with x
indices XOFFSET and XOFFSET+WIDTH-1, and the y indices YOFFSET and
YOFFSET+HEIGHT-1, and the z indices ZOFFSET and ZOFFSET+DEPTH-1,
inclusive. This region may not include any texels outside the
range of the texture array as it was originally specified. It is
not an error to specify a subtexture with width of 0, but such a
specification has no effect.
FORMAT must be an extension-specified compressed-texture format.
The FORMAT of the compressed texture image is selected by the GL
implementation that compressed it (see 'glTexImage3D') and should
be queried at the time the texture was compressed with
'glGetTexLevelParameter'.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
texture image is specified, DATA is treated as a byte offset into
the buffer object's data store.
'GL_INVALID_ENUM' is generated if FORMAT is one of these generic
compressed internal formats: 'GL_COMPRESSED_ALPHA',
'GL_COMPRESSED_LUMINANCE', 'GL_COMPRESSED_LUMINANCE_ALPHA',
'GL_COMPRESSED_INTENSITY', 'GL_COMPRESSED_RGB',
'GL_COMPRESSED_RGBA', 'GL_COMPRESSED_SLUMINANCE',
'GL_COMPRESSED_SLUMINANCE_ALPHA', 'GL_COMPRESSED_SRGB',
'GL_COMPRESSED_SRGBA', or 'GL_COMPRESSED_SRGB_ALPHA'.
'GL_INVALID_VALUE' is generated if IMAGESIZE is not consistent with
the format, dimensions, and contents of the specified compressed
image data.
'GL_INVALID_OPERATION' is generated if parameter combinations are
not supported by the specific compressed internal format as
specified in the specific texture compression extension.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if 'glCompressedTexSubImage3D'
is executed between the execution of 'glBegin' and the
corresponding execution of 'glEnd'.
Undefined results, including abnormal program termination, are
generated if DATA is not encoded in a manner consistent with the
extension specification defining the internal compression format.
-- Function: void glConvolutionFilter1D target internalformat width
format type data
Define a one-dimensional convolution filter.
TARGET
Must be 'GL_CONVOLUTION_1D'.
INTERNALFORMAT
The internal format of the convolution filter kernel. The
allowable values are 'GL_ALPHA', 'GL_ALPHA4', 'GL_ALPHA8',
'GL_ALPHA12', 'GL_ALPHA16', 'GL_LUMINANCE', 'GL_LUMINANCE4',
'GL_LUMINANCE8', 'GL_LUMINANCE12', 'GL_LUMINANCE16',
'GL_LUMINANCE_ALPHA', 'GL_LUMINANCE4_ALPHA4',
'GL_LUMINANCE6_ALPHA2', 'GL_LUMINANCE8_ALPHA8',
'GL_LUMINANCE12_ALPHA4', 'GL_LUMINANCE12_ALPHA12',
'GL_LUMINANCE16_ALPHA16', 'GL_INTENSITY', 'GL_INTENSITY4',
'GL_INTENSITY8', 'GL_INTENSITY12', 'GL_INTENSITY16',
'GL_R3_G3_B2', 'GL_RGB', 'GL_RGB4', 'GL_RGB5', 'GL_RGB8',
'GL_RGB10', 'GL_RGB12', 'GL_RGB16', 'GL_RGBA', 'GL_RGBA2',
'GL_RGBA4', 'GL_RGB5_A1', 'GL_RGBA8', 'GL_RGB10_A2',
'GL_RGBA12', or 'GL_RGBA16'.
WIDTH
The width of the pixel array referenced by DATA.
FORMAT
The format of the pixel data in DATA. The allowable values
are 'GL_ALPHA', 'GL_LUMINANCE', 'GL_LUMINANCE_ALPHA',
'GL_INTENSITY', 'GL_RGB', and 'GL_RGBA'.
TYPE
The type of the pixel data in DATA. Symbolic constants
'GL_UNSIGNED_BYTE', 'GL_BYTE', 'GL_BITMAP',
'GL_UNSIGNED_SHORT', 'GL_SHORT', 'GL_UNSIGNED_INT', 'GL_INT',
'GL_FLOAT', 'GL_UNSIGNED_BYTE_3_3_2',
'GL_UNSIGNED_BYTE_2_3_3_REV', 'GL_UNSIGNED_SHORT_5_6_5',
'GL_UNSIGNED_SHORT_5_6_5_REV', 'GL_UNSIGNED_SHORT_4_4_4_4',
'GL_UNSIGNED_SHORT_4_4_4_4_REV', 'GL_UNSIGNED_SHORT_5_5_5_1',
'GL_UNSIGNED_SHORT_1_5_5_5_REV', 'GL_UNSIGNED_INT_8_8_8_8',
'GL_UNSIGNED_INT_8_8_8_8_REV', 'GL_UNSIGNED_INT_10_10_10_2',
and 'GL_UNSIGNED_INT_2_10_10_10_REV' are accepted.
DATA
Pointer to a one-dimensional array of pixel data that is
processed to build the convolution filter kernel.
'glConvolutionFilter1D' builds a one-dimensional convolution filter
kernel from an array of pixels.
The pixel array specified by WIDTH, FORMAT, TYPE, and DATA is
extracted from memory and processed just as if 'glDrawPixels' were
called, but processing stops after the final expansion to RGBA is
completed.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
convolution filter is specified, DATA is treated as a byte offset
into the buffer object's data store.
The R, G, B, and A components of each pixel are next scaled by the
four 1D 'GL_CONVOLUTION_FILTER_SCALE' parameters and biased by the
four 1D 'GL_CONVOLUTION_FILTER_BIAS' parameters. (The scale and
bias parameters are set by 'glConvolutionParameter' using the
'GL_CONVOLUTION_1D' target and the names
'GL_CONVOLUTION_FILTER_SCALE' and 'GL_CONVOLUTION_FILTER_BIAS'.
The parameters themselves are vectors of four values that are
applied to red, green, blue, and alpha, in that order.) The R, G,
B, and A values are not clamped to [0,1] at any time during this
process.
Each pixel is then converted to the internal format specified by
INTERNALFORMAT. This conversion simply maps the component values
of the pixel (R, G, B, and A) to the values included in the
internal format (red, green, blue, alpha, luminance, and
intensity). The mapping is as follows:
*Internal Format*
*Red*, *Green*, *Blue*, *Alpha*, *Luminance*, *Intensity*
'GL_ALPHA'
, , , A , ,
'GL_LUMINANCE'
, , , , R ,
'GL_LUMINANCE_ALPHA'
, , , A , R ,
'GL_INTENSITY'
, , , , , R
'GL_RGB'
R , G , B , , ,
'GL_RGBA'
R , G , B , A , ,
The red, green, blue, alpha, luminance, and/or intensity components
of the resulting pixels are stored in floating-point rather than
integer format. They form a one-dimensional filter kernel image
indexed with coordinate I such that I starts at 0 and increases
from left to right. Kernel location I is derived from the Ith
pixel, counting from 0.
Note that after a convolution is performed, the resulting color
components are also scaled by their corresponding
'GL_POST_CONVOLUTION_c_SCALE' parameters and biased by their
corresponding 'GL_POST_CONVOLUTION_c_BIAS' parameters (where C
takes on the values *RED*, *GREEN*, *BLUE*, and *ALPHA*). These
parameters are set by 'glPixelTransfer'.
'GL_INVALID_ENUM' is generated if TARGET is not
'GL_CONVOLUTION_1D'.
'GL_INVALID_ENUM' is generated if INTERNALFORMAT is not one of the
allowable values.
'GL_INVALID_ENUM' is generated if FORMAT is not one of the
allowable values.
'GL_INVALID_ENUM' is generated if TYPE is not one of the allowable
values.
'GL_INVALID_VALUE' is generated if WIDTH is less than zero or
greater than the maximum supported value. This value may be
queried with 'glGetConvolutionParameter' using target
'GL_CONVOLUTION_1D' and name 'GL_MAX_CONVOLUTION_WIDTH'.
'GL_INVALID_OPERATION' is generated if FORMAT is one of
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', or 'GL_UNSIGNED_SHORT_5_6_5_REV' and
TYPE is not 'GL_RGB'.
'GL_INVALID_OPERATION' is generated if FORMAT is one of
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', or 'GL_UNSIGNED_INT_2_10_10_10_REV'
and TYPE is neither 'GL_RGBA' nor 'GL_BGRA'.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and DATA is
not evenly divisible into the number of bytes needed to store in
memory a datum indicated by TYPE.
'GL_INVALID_OPERATION' is generated if 'glConvolutionFilter1D' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glConvolutionFilter2D target internalformat width
height format type data
Define a two-dimensional convolution filter.
TARGET
Must be 'GL_CONVOLUTION_2D'.
INTERNALFORMAT
The internal format of the convolution filter kernel. The
allowable values are 'GL_ALPHA', 'GL_ALPHA4', 'GL_ALPHA8',
'GL_ALPHA12', 'GL_ALPHA16', 'GL_LUMINANCE', 'GL_LUMINANCE4',
'GL_LUMINANCE8', 'GL_LUMINANCE12', 'GL_LUMINANCE16',
'GL_LUMINANCE_ALPHA', 'GL_LUMINANCE4_ALPHA4',
'GL_LUMINANCE6_ALPHA2', 'GL_LUMINANCE8_ALPHA8',
'GL_LUMINANCE12_ALPHA4', 'GL_LUMINANCE12_ALPHA12',
'GL_LUMINANCE16_ALPHA16', 'GL_INTENSITY', 'GL_INTENSITY4',
'GL_INTENSITY8', 'GL_INTENSITY12', 'GL_INTENSITY16',
'GL_R3_G3_B2', 'GL_RGB', 'GL_RGB4', 'GL_RGB5', 'GL_RGB8',
'GL_RGB10', 'GL_RGB12', 'GL_RGB16', 'GL_RGBA', 'GL_RGBA2',
'GL_RGBA4', 'GL_RGB5_A1', 'GL_RGBA8', 'GL_RGB10_A2',
'GL_RGBA12', or 'GL_RGBA16'.
WIDTH
The width of the pixel array referenced by DATA.
HEIGHT
The height of the pixel array referenced by DATA.
FORMAT
The format of the pixel data in DATA. The allowable values
are 'GL_RED', 'GL_GREEN', 'GL_BLUE', 'GL_ALPHA', 'GL_RGB',
'GL_BGR', 'GL_RGBA', 'GL_BGRA', 'GL_LUMINANCE', and
'GL_LUMINANCE_ALPHA'.
TYPE
The type of the pixel data in DATA. Symbolic constants
'GL_UNSIGNED_BYTE', 'GL_BYTE', 'GL_BITMAP',
'GL_UNSIGNED_SHORT', 'GL_SHORT', 'GL_UNSIGNED_INT', 'GL_INT',
'GL_FLOAT', 'GL_UNSIGNED_BYTE_3_3_2',
'GL_UNSIGNED_BYTE_2_3_3_REV', 'GL_UNSIGNED_SHORT_5_6_5',
'GL_UNSIGNED_SHORT_5_6_5_REV', 'GL_UNSIGNED_SHORT_4_4_4_4',
'GL_UNSIGNED_SHORT_4_4_4_4_REV', 'GL_UNSIGNED_SHORT_5_5_5_1',
'GL_UNSIGNED_SHORT_1_5_5_5_REV', 'GL_UNSIGNED_INT_8_8_8_8',
'GL_UNSIGNED_INT_8_8_8_8_REV', 'GL_UNSIGNED_INT_10_10_10_2',
and 'GL_UNSIGNED_INT_2_10_10_10_REV' are accepted.
DATA
Pointer to a two-dimensional array of pixel data that is
processed to build the convolution filter kernel.
'glConvolutionFilter2D' builds a two-dimensional convolution filter
kernel from an array of pixels.
The pixel array specified by WIDTH, HEIGHT, FORMAT, TYPE, and DATA
is extracted from memory and processed just as if 'glDrawPixels'
were called, but processing stops after the final expansion to RGBA
is completed.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
convolution filter is specified, DATA is treated as a byte offset
into the buffer object's data store.
The R, G, B, and A components of each pixel are next scaled by the
four 2D 'GL_CONVOLUTION_FILTER_SCALE' parameters and biased by the
four 2D 'GL_CONVOLUTION_FILTER_BIAS' parameters. (The scale and
bias parameters are set by 'glConvolutionParameter' using the
'GL_CONVOLUTION_2D' target and the names
'GL_CONVOLUTION_FILTER_SCALE' and 'GL_CONVOLUTION_FILTER_BIAS'.
The parameters themselves are vectors of four values that are
applied to red, green, blue, and alpha, in that order.) The R, G,
B, and A values are not clamped to [0,1] at any time during this
process.
Each pixel is then converted to the internal format specified by
INTERNALFORMAT. This conversion simply maps the component values
of the pixel (R, G, B, and A) to the values included in the
internal format (red, green, blue, alpha, luminance, and
intensity). The mapping is as follows:
*Internal Format*
*Red*, *Green*, *Blue*, *Alpha*, *Luminance*, *Intensity*
'GL_ALPHA'
, , , A , ,
'GL_LUMINANCE'
, , , , R ,
'GL_LUMINANCE_ALPHA'
, , , A , R ,
'GL_INTENSITY'
, , , , , R
'GL_RGB'
R , G , B , , ,
'GL_RGBA'
R , G , B , A , ,
The red, green, blue, alpha, luminance, and/or intensity components
of the resulting pixels are stored in floating-point rather than
integer format. They form a two-dimensional filter kernel image
indexed with coordinates I and J such that I starts at zero and
increases from left to right, and J starts at zero and increases
from bottom to top. Kernel location I,J is derived from the Nth
pixel, where N is I+J*WIDTH.
Note that after a convolution is performed, the resulting color
components are also scaled by their corresponding
'GL_POST_CONVOLUTION_c_SCALE' parameters and biased by their
corresponding 'GL_POST_CONVOLUTION_c_BIAS' parameters (where C
takes on the values *RED*, *GREEN*, *BLUE*, and *ALPHA*). These
parameters are set by 'glPixelTransfer'.
'GL_INVALID_ENUM' is generated if TARGET is not
'GL_CONVOLUTION_2D'.
'GL_INVALID_ENUM' is generated if INTERNALFORMAT is not one of the
allowable values.
'GL_INVALID_ENUM' is generated if FORMAT is not one of the
allowable values.
'GL_INVALID_ENUM' is generated if TYPE is not one of the allowable
values.
'GL_INVALID_VALUE' is generated if WIDTH is less than zero or
greater than the maximum supported value. This value may be
queried with 'glGetConvolutionParameter' using target
'GL_CONVOLUTION_2D' and name 'GL_MAX_CONVOLUTION_WIDTH'.
'GL_INVALID_VALUE' is generated if HEIGHT is less than zero or
greater than the maximum supported value. This value may be
queried with 'glGetConvolutionParameter' using target
'GL_CONVOLUTION_2D' and name 'GL_MAX_CONVOLUTION_HEIGHT'.
'GL_INVALID_OPERATION' is generated if HEIGHT is one of
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', or 'GL_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GL_RGB'.
'GL_INVALID_OPERATION' is generated if HEIGHT is one of
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', or 'GL_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GL_RGBA' nor 'GL_BGRA'.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and DATA is
not evenly divisible into the number of bytes needed to store in
memory a datum indicated by TYPE.
'GL_INVALID_OPERATION' is generated if 'glConvolutionFilter2D' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glConvolutionParameterf target pname params
-- Function: void glConvolutionParameteri target pname params
-- Function: void glConvolutionParameterfv target pname params
-- Function: void glConvolutionParameteriv target pname params
Set convolution parameters.
TARGET
The target for the convolution parameter. Must be one of
'GL_CONVOLUTION_1D', 'GL_CONVOLUTION_2D', or
'GL_SEPARABLE_2D'.
PNAME
The parameter to be set. Must be
'GL_CONVOLUTION_BORDER_MODE'.
PARAMS
The parameter value. Must be one of 'GL_REDUCE',
'GL_CONSTANT_BORDER', 'GL_REPLICATE_BORDER'.
'glConvolutionParameter' sets the value of a convolution parameter.
TARGET selects the convolution filter to be affected:
'GL_CONVOLUTION_1D', 'GL_CONVOLUTION_2D', or 'GL_SEPARABLE_2D' for
the 1D, 2D, or separable 2D filter, respectively.
PNAME selects the parameter to be changed.
'GL_CONVOLUTION_FILTER_SCALE' and 'GL_CONVOLUTION_FILTER_BIAS'
affect the definition of the convolution filter kernel; see
'glConvolutionFilter1D', 'glConvolutionFilter2D', and
'glSeparableFilter2D' for details. In these cases, PARAMSv is an
array of four values to be applied to red, green, blue, and alpha
values, respectively. The initial value for
'GL_CONVOLUTION_FILTER_SCALE' is (1, 1, 1, 1), and the initial
value for 'GL_CONVOLUTION_FILTER_BIAS' is (0, 0, 0, 0).
A PNAME value of 'GL_CONVOLUTION_BORDER_MODE' controls the
convolution border mode. The accepted modes are:
'GL_REDUCE'
The image resulting from convolution is smaller than the
source image. If the filter width is WF and height is HF, and
the source image width is WS and height is HS, then the
convolved image width will be WS-WF+1 and height will be
HS-HF+1. (If this reduction would generate an image with zero
or negative width and/or height, the output is simply null,
with no error generated.) The coordinates of the image
resulting from convolution are zero through WS-WF in width and
zero through HS-HF in height.
'GL_CONSTANT_BORDER'
The image resulting from convolution is the same size as the
source image, and processed as if the source image were
surrounded by pixels with their color specified by the
'GL_CONVOLUTION_BORDER_COLOR'.
'GL_REPLICATE_BORDER'
The image resulting from convolution is the same size as the
source image, and processed as if the outermost pixel on the
border of the source image were replicated.
'GL_INVALID_ENUM' is generated if TARGET is not one of the
allowable values.
'GL_INVALID_ENUM' is generated if PNAME is not one of the allowable
values.
'GL_INVALID_ENUM' is generated if PNAME is
'GL_CONVOLUTION_BORDER_MODE' and PARAMS is not one of 'GL_REDUCE',
'GL_CONSTANT_BORDER', or 'GL_REPLICATE_BORDER'.
'GL_INVALID_OPERATION' is generated if 'glConvolutionParameter' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glCopyColorSubTable target start x y width
Respecify a portion of a color table.
TARGET
Must be one of 'GL_COLOR_TABLE',
'GL_POST_CONVOLUTION_COLOR_TABLE', or
'GL_POST_COLOR_MATRIX_COLOR_TABLE'.
START
The starting index of the portion of the color table to be
replaced.
X
Y
The window coordinates of the left corner of the row of pixels
to be copied.
WIDTH
The number of table entries to replace.
'glCopyColorSubTable' is used to respecify a contiguous portion of
a color table previously defined using 'glColorTable'. The pixels
copied from the framebuffer replace the portion of the existing
table from indices START to START+X-1, inclusive. This region may
not include any entries outside the range of the color table, as
was originally specified. It is not an error to specify a
subtexture with width of 0, but such a specification has no effect.
'GL_INVALID_VALUE' is generated if TARGET is not a previously
defined color table.
'GL_INVALID_VALUE' is generated if TARGET is not one of the
allowable values.
'GL_INVALID_VALUE' is generated if START+X>WIDTH.
'GL_INVALID_OPERATION' is generated if 'glCopyColorSubTable' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glCopyColorTable target internalformat x y width
Copy pixels into a color table.
TARGET
The color table target. Must be 'GL_COLOR_TABLE',
'GL_POST_CONVOLUTION_COLOR_TABLE', or
'GL_POST_COLOR_MATRIX_COLOR_TABLE'.
INTERNALFORMAT
The internal storage format of the texture image. Must be one
of the following symbolic constants: 'GL_ALPHA', 'GL_ALPHA4',
'GL_ALPHA8', 'GL_ALPHA12', 'GL_ALPHA16', 'GL_LUMINANCE',
'GL_LUMINANCE4', 'GL_LUMINANCE8', 'GL_LUMINANCE12',
'GL_LUMINANCE16', 'GL_LUMINANCE_ALPHA',
'GL_LUMINANCE4_ALPHA4', 'GL_LUMINANCE6_ALPHA2',
'GL_LUMINANCE8_ALPHA8', 'GL_LUMINANCE12_ALPHA4',
'GL_LUMINANCE12_ALPHA12', 'GL_LUMINANCE16_ALPHA16',
'GL_INTENSITY', 'GL_INTENSITY4', 'GL_INTENSITY8',
'GL_INTENSITY12', 'GL_INTENSITY16', 'GL_R3_G3_B2', 'GL_RGB',
'GL_RGB4', 'GL_RGB5', 'GL_RGB8', 'GL_RGB10', 'GL_RGB12',
'GL_RGB16', 'GL_RGBA', 'GL_RGBA2', 'GL_RGBA4', 'GL_RGB5_A1',
'GL_RGBA8', 'GL_RGB10_A2', 'GL_RGBA12', or 'GL_RGBA16'.
X
The x coordinate of the lower-left corner of the pixel
rectangle to be transferred to the color table.
Y
The y coordinate of the lower-left corner of the pixel
rectangle to be transferred to the color table.
WIDTH
The width of the pixel rectangle.
'glCopyColorTable' loads a color table with pixels from the current
'GL_READ_BUFFER' (rather than from main memory, as is the case for
'glColorTable').
The screen-aligned pixel rectangle with lower-left corner at (X,\
Y) having width WIDTH and height 1 is loaded into the color table.
If any pixels within this region are outside the window that is
associated with the GL context, the values obtained for those
pixels are undefined.
The pixels in the rectangle are processed just as if 'glReadPixels'
were called, with INTERNALFORMAT set to RGBA, but processing stops
after the final conversion to RGBA.
The four scale parameters and the four bias parameters that are
defined for the table are then used to scale and bias the R, G, B,
and A components of each pixel. The scale and bias parameters are
set by calling 'glColorTableParameter'.
Next, the R, G, B, and A values are clamped to the range [0,1].
Each pixel is then converted to the internal format specified by
INTERNALFORMAT. This conversion simply maps the component values
of the pixel (R, G, B, and A) to the values included in the
internal format (red, green, blue, alpha, luminance, and
intensity). The mapping is as follows:
*Internal Format*
*Red*, *Green*, *Blue*, *Alpha*, *Luminance*, *Intensity*
'GL_ALPHA'
, , , A , ,
'GL_LUMINANCE'
, , , , R ,
'GL_LUMINANCE_ALPHA'
, , , A , R ,
'GL_INTENSITY'
, , , , , R
'GL_RGB'
R , G , B , , ,
'GL_RGBA'
R , G , B , A , ,
Finally, the red, green, blue, alpha, luminance, and/or intensity
components of the resulting pixels are stored in the color table.
They form a one-dimensional table with indices in the range
[0,WIDTH-1].
'GL_INVALID_ENUM' is generated when TARGET is not one of the
allowable values.
'GL_INVALID_VALUE' is generated if WIDTH is less than zero.
'GL_INVALID_VALUE' is generated if INTERNALFORMAT is not one of the
allowable values.
'GL_TABLE_TOO_LARGE' is generated if the requested color table is
too large to be supported by the implementation.
'GL_INVALID_OPERATION' is generated if 'glCopyColorTable' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glCopyConvolutionFilter1D target internalformat x y
width
Copy pixels into a one-dimensional convolution filter.
TARGET
Must be 'GL_CONVOLUTION_1D'.
INTERNALFORMAT
The internal format of the convolution filter kernel. The
allowable values are 'GL_ALPHA', 'GL_ALPHA4', 'GL_ALPHA8',
'GL_ALPHA12', 'GL_ALPHA16', 'GL_LUMINANCE', 'GL_LUMINANCE4',
'GL_LUMINANCE8', 'GL_LUMINANCE12', 'GL_LUMINANCE16',
'GL_LUMINANCE_ALPHA', 'GL_LUMINANCE4_ALPHA4',
'GL_LUMINANCE6_ALPHA2', 'GL_LUMINANCE8_ALPHA8',
'GL_LUMINANCE12_ALPHA4', 'GL_LUMINANCE12_ALPHA12',
'GL_LUMINANCE16_ALPHA16', 'GL_INTENSITY', 'GL_INTENSITY4',
'GL_INTENSITY8', 'GL_INTENSITY12', 'GL_INTENSITY16',
'GL_R3_G3_B2', 'GL_RGB', 'GL_RGB4', 'GL_RGB5', 'GL_RGB8',
'GL_RGB10', 'GL_RGB12', 'GL_RGB16', 'GL_RGBA', 'GL_RGBA2',
'GL_RGBA4', 'GL_RGB5_A1', 'GL_RGBA8', 'GL_RGB10_A2',
'GL_RGBA12', or 'GL_RGBA16'.
X
Y
The window space coordinates of the lower-left coordinate of
the pixel array to copy.
WIDTH
The width of the pixel array to copy.
'glCopyConvolutionFilter1D' defines a one-dimensional convolution
filter kernel with pixels from the current 'GL_READ_BUFFER' (rather
than from main memory, as is the case for 'glConvolutionFilter1D').
The screen-aligned pixel rectangle with lower-left corner at (X,\
Y), width WIDTH and height 1 is used to define the convolution
filter. If any pixels within this region are outside the window
that is associated with the GL context, the values obtained for
those pixels are undefined.
The pixels in the rectangle are processed exactly as if
'glReadPixels' had been called with FORMAT set to RGBA, but the
process stops just before final conversion. The R, G, B, and A
components of each pixel are next scaled by the four 1D
'GL_CONVOLUTION_FILTER_SCALE' parameters and biased by the four 1D
'GL_CONVOLUTION_FILTER_BIAS' parameters. (The scale and bias
parameters are set by 'glConvolutionParameter' using the
'GL_CONVOLUTION_1D' target and the names
'GL_CONVOLUTION_FILTER_SCALE' and 'GL_CONVOLUTION_FILTER_BIAS'.
The parameters themselves are vectors of four values that are
applied to red, green, blue, and alpha, in that order.) The R, G,
B, and A values are not clamped to [0,1] at any time during this
process.
Each pixel is then converted to the internal format specified by
INTERNALFORMAT. This conversion simply maps the component values
of the pixel (R, G, B, and A) to the values included in the
internal format (red, green, blue, alpha, luminance, and
intensity). The mapping is as follows:
*Internal Format*
*Red*, *Green*, *Blue*, *Alpha*, *Luminance*, *Intensity*
'GL_ALPHA'
, , , A , ,
'GL_LUMINANCE'
, , , , R ,
'GL_LUMINANCE_ALPHA'
, , , A , R ,
'GL_INTENSITY'
, , , , , R
'GL_RGB'
R , G , B , , ,
'GL_RGBA'
R , G , B , A , ,
The red, green, blue, alpha, luminance, and/or intensity components
of the resulting pixels are stored in floating-point rather than
integer format.
Pixel ordering is such that lower x screen coordinates correspond
to lower I filter image coordinates.
Note that after a convolution is performed, the resulting color
components are also scaled by their corresponding
'GL_POST_CONVOLUTION_c_SCALE' parameters and biased by their
corresponding 'GL_POST_CONVOLUTION_c_BIAS' parameters (where C
takes on the values *RED*, *GREEN*, *BLUE*, and *ALPHA*). These
parameters are set by 'glPixelTransfer'.
'GL_INVALID_ENUM' is generated if TARGET is not
'GL_CONVOLUTION_1D'.
'GL_INVALID_ENUM' is generated if INTERNALFORMAT is not one of the
allowable values.
'GL_INVALID_VALUE' is generated if WIDTH is less than zero or
greater than the maximum supported value. This value may be
queried with 'glGetConvolutionParameter' using target
'GL_CONVOLUTION_1D' and name 'GL_MAX_CONVOLUTION_WIDTH'.
'GL_INVALID_OPERATION' is generated if 'glCopyConvolutionFilter1D'
is executed between the execution of 'glBegin' and the
corresponding execution of 'glEnd'.
-- Function: void glCopyConvolutionFilter2D target internalformat x y
width height
Copy pixels into a two-dimensional convolution filter.
TARGET
Must be 'GL_CONVOLUTION_2D'.
INTERNALFORMAT
The internal format of the convolution filter kernel. The
allowable values are 'GL_ALPHA', 'GL_ALPHA4', 'GL_ALPHA8',
'GL_ALPHA12', 'GL_ALPHA16', 'GL_LUMINANCE', 'GL_LUMINANCE4',
'GL_LUMINANCE8', 'GL_LUMINANCE12', 'GL_LUMINANCE16',
'GL_LUMINANCE_ALPHA', 'GL_LUMINANCE4_ALPHA4',
'GL_LUMINANCE6_ALPHA2', 'GL_LUMINANCE8_ALPHA8',
'GL_LUMINANCE12_ALPHA4', 'GL_LUMINANCE12_ALPHA12',
'GL_LUMINANCE16_ALPHA16', 'GL_INTENSITY', 'GL_INTENSITY4',
'GL_INTENSITY8', 'GL_INTENSITY12', 'GL_INTENSITY16',
'GL_R3_G3_B2', 'GL_RGB', 'GL_RGB4', 'GL_RGB5', 'GL_RGB8',
'GL_RGB10', 'GL_RGB12', 'GL_RGB16', 'GL_RGBA', 'GL_RGBA2',
'GL_RGBA4', 'GL_RGB5_A1', 'GL_RGBA8', 'GL_RGB10_A2',
'GL_RGBA12', or 'GL_RGBA16'.
X
Y
The window space coordinates of the lower-left coordinate of
the pixel array to copy.
WIDTH
The width of the pixel array to copy.
HEIGHT
The height of the pixel array to copy.
'glCopyConvolutionFilter2D' defines a two-dimensional convolution
filter kernel with pixels from the current 'GL_READ_BUFFER' (rather
than from main memory, as is the case for 'glConvolutionFilter2D').
The screen-aligned pixel rectangle with lower-left corner at (X,\
Y), width WIDTH and height HEIGHT is used to define the convolution
filter. If any pixels within this region are outside the window
that is associated with the GL context, the values obtained for
those pixels are undefined.
The pixels in the rectangle are processed exactly as if
'glReadPixels' had been called with FORMAT set to RGBA, but the
process stops just before final conversion. The R, G, B, and A
components of each pixel are next scaled by the four 2D
'GL_CONVOLUTION_FILTER_SCALE' parameters and biased by the four 2D
'GL_CONVOLUTION_FILTER_BIAS' parameters. (The scale and bias
parameters are set by 'glConvolutionParameter' using the
'GL_CONVOLUTION_2D' target and the names
'GL_CONVOLUTION_FILTER_SCALE' and 'GL_CONVOLUTION_FILTER_BIAS'.
The parameters themselves are vectors of four values that are
applied to red, green, blue, and alpha, in that order.) The R, G,
B, and A values are not clamped to [0,1] at any time during this
process.
Each pixel is then converted to the internal format specified by
INTERNALFORMAT. This conversion simply maps the component values
of the pixel (R, G, B, and A) to the values included in the
internal format (red, green, blue, alpha, luminance, and
intensity). The mapping is as follows:
*Internal Format*
*Red*, *Green*, *Blue*, *Alpha*, *Luminance*, *Intensity*
'GL_ALPHA'
, , , A , ,
'GL_LUMINANCE'
, , , , R ,
'GL_LUMINANCE_ALPHA'
, , , A , R ,
'GL_INTENSITY'
, , , , , R
'GL_RGB'
R , G , B , , ,
'GL_RGBA'
R , G , B , A , ,
The red, green, blue, alpha, luminance, and/or intensity components
of the resulting pixels are stored in floating-point rather than
integer format.
Pixel ordering is such that lower x screen coordinates correspond
to lower I filter image coordinates, and lower y screen coordinates
correspond to lower J filter image coordinates.
Note that after a convolution is performed, the resulting color
components are also scaled by their corresponding
'GL_POST_CONVOLUTION_c_SCALE' parameters and biased by their
corresponding 'GL_POST_CONVOLUTION_c_BIAS' parameters (where C
takes on the values *RED*, *GREEN*, *BLUE*, and *ALPHA*). These
parameters are set by 'glPixelTransfer'.
'GL_INVALID_ENUM' is generated if TARGET is not
'GL_CONVOLUTION_2D'.
'GL_INVALID_ENUM' is generated if INTERNALFORMAT is not one of the
allowable values.
'GL_INVALID_VALUE' is generated if WIDTH is less than zero or
greater than the maximum supported value. This value may be
queried with 'glGetConvolutionParameter' using target
'GL_CONVOLUTION_2D' and name 'GL_MAX_CONVOLUTION_WIDTH'.
'GL_INVALID_VALUE' is generated if HEIGHT is less than zero or
greater than the maximum supported value. This value may be
queried with 'glGetConvolutionParameter' using target
'GL_CONVOLUTION_2D' and name 'GL_MAX_CONVOLUTION_HEIGHT'.
'GL_INVALID_OPERATION' is generated if 'glCopyConvolutionFilter2D'
is executed between the execution of 'glBegin' and the
corresponding execution of 'glEnd'.
-- Function: void glCopyPixels x y width height type
Copy pixels in the frame buffer.
X
Y
Specify the window coordinates of the lower left corner of the
rectangular region of pixels to be copied.
WIDTH
HEIGHT
Specify the dimensions of the rectangular region of pixels to
be copied. Both must be nonnegative.
TYPE
Specifies whether color values, depth values, or stencil
values are to be copied. Symbolic constants 'GL_COLOR',
'GL_DEPTH', and 'GL_STENCIL' are accepted.
'glCopyPixels' copies a screen-aligned rectangle of pixels from the
specified frame buffer location to a region relative to the current
raster position. Its operation is well defined only if the entire
pixel source region is within the exposed portion of the window.
Results of copies from outside the window, or from regions of the
window that are not exposed, are hardware dependent and undefined.
X and Y specify the window coordinates of the lower left corner of
the rectangular region to be copied. WIDTH and HEIGHT specify the
dimensions of the rectangular region to be copied. Both WIDTH and
HEIGHT must not be negative.
Several parameters control the processing of the pixel data while
it is being copied. These parameters are set with three commands:
'glPixelTransfer', 'glPixelMap', and 'glPixelZoom'. This reference
page describes the effects on 'glCopyPixels' of most, but not all,
of the parameters specified by these three commands.
'glCopyPixels' copies values from each pixel with the lower
left-hand corner at (X+I,Y+J) for 0<=ILOG_2(MAX,), where
MAX is the returned value of 'GL_MAX_TEXTURE_SIZE'.
'GL_INVALID_VALUE' is generated if XOFFSET<-B, or
(XOFFSET+WIDTH,)>(W-B,), where W is the 'GL_TEXTURE_WIDTH' and B is
the 'GL_TEXTURE_BORDER' of the texture image being modified. Note
that W includes twice the border width.
-- Function: void glCopyTexSubImage2D target level xoffset yoffset x y
width height
Copy a two-dimensional texture subimage.
TARGET
Specifies the target texture. Must be 'GL_TEXTURE_2D',
'GL_TEXTURE_CUBE_MAP_POSITIVE_X',
'GL_TEXTURE_CUBE_MAP_NEGATIVE_X',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Y',
'GL_TEXTURE_CUBE_MAP_NEGATIVE_Y',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Z', or
'GL_TEXTURE_CUBE_MAP_NEGATIVE_Z'.
LEVEL
Specifies the level-of-detail number. Level 0 is the base
image level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
array.
YOFFSET
Specifies a texel offset in the y direction within the texture
array.
X
Y
Specify the window coordinates of the lower left corner of the
rectangular region of pixels to be copied.
WIDTH
Specifies the width of the texture subimage.
HEIGHT
Specifies the height of the texture subimage.
'glCopyTexSubImage2D' replaces a rectangular portion of a
two-dimensional texture image or cube-map texture image with pixels
from the current 'GL_READ_BUFFER' (rather than from main memory, as
is the case for 'glTexSubImage2D').
The screen-aligned pixel rectangle with lower left corner at (X,Y)
and with width WIDTH and height HEIGHT replaces the portion of the
texture array with x indices XOFFSET through XOFFSET+WIDTH-1,
inclusive, and y indices YOFFSET through YOFFSET+HEIGHT-1,
inclusive, at the mipmap level specified by LEVEL.
The pixels in the rectangle are processed exactly as if
'glCopyPixels' had been called, but the process stops just before
final conversion. At this point, all pixel component values are
clamped to the range [0,1] and then converted to the texture's
internal format for storage in the texel array.
The destination rectangle in the texture array may not include any
texels outside the texture array as it was originally specified.
It is not an error to specify a subtexture with zero width or
height, but such a specification has no effect.
If any of the pixels within the specified rectangle of the current
'GL_READ_BUFFER' are outside the read window associated with the
current rendering context, then the values obtained for those
pixels are undefined.
No change is made to the INTERNALFORMAT, WIDTH, HEIGHT, or BORDER
parameters of the specified texture array or to texel values
outside the specified subregion.
'GL_INVALID_ENUM' is generated if TARGET is not 'GL_TEXTURE_2D',
'GL_TEXTURE_CUBE_MAP_POSITIVE_X', 'GL_TEXTURE_CUBE_MAP_NEGATIVE_X',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Y', 'GL_TEXTURE_CUBE_MAP_NEGATIVE_Y',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Z', or
'GL_TEXTURE_CUBE_MAP_NEGATIVE_Z'.
'GL_INVALID_OPERATION' is generated if the texture array has not
been defined by a previous 'glTexImage2D' or 'glCopyTexImage2D'
operation.
'GL_INVALID_VALUE' is generated if LEVEL is less than 0.
'GL_INVALID_VALUE' may be generated if LEVEL>LOG_2(MAX,), where
MAX is the returned value of 'GL_MAX_TEXTURE_SIZE'.
'GL_INVALID_VALUE' is generated if XOFFSET<-B,
(XOFFSET+WIDTH,)>(W-B,), YOFFSET<-B, or (YOFFSET+HEIGHT,)>(H-B,),
where W is the 'GL_TEXTURE_WIDTH', H is the 'GL_TEXTURE_HEIGHT',
and B is the 'GL_TEXTURE_BORDER' of the texture image being
modified. Note that W and H include twice the border width.
'GL_INVALID_OPERATION' is generated if 'glCopyTexSubImage2D' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glCopyTexSubImage3D target level xoffset yoffset
zoffset x y width height
Copy a three-dimensional texture subimage.
TARGET
Specifies the target texture. Must be 'GL_TEXTURE_3D'
LEVEL
Specifies the level-of-detail number. Level 0 is the base
image level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
array.
YOFFSET
Specifies a texel offset in the y direction within the texture
array.
ZOFFSET
Specifies a texel offset in the z direction within the texture
array.
X
Y
Specify the window coordinates of the lower left corner of the
rectangular region of pixels to be copied.
WIDTH
Specifies the width of the texture subimage.
HEIGHT
Specifies the height of the texture subimage.
'glCopyTexSubImage3D' replaces a rectangular portion of a
three-dimensional texture image with pixels from the current
'GL_READ_BUFFER' (rather than from main memory, as is the case for
'glTexSubImage3D').
The screen-aligned pixel rectangle with lower left corner at (X,\
Y) and with width WIDTH and height HEIGHT replaces the portion of
the texture array with x indices XOFFSET through XOFFSET+WIDTH-1,
inclusive, and y indices YOFFSET through YOFFSET+HEIGHT-1,
inclusive, at z index ZOFFSET and at the mipmap level specified by
LEVEL.
The pixels in the rectangle are processed exactly as if
'glCopyPixels' had been called, but the process stops just before
final conversion. At this point, all pixel component values are
clamped to the range [0,1] and then converted to the texture's
internal format for storage in the texel array.
The destination rectangle in the texture array may not include any
texels outside the texture array as it was originally specified.
It is not an error to specify a subtexture with zero width or
height, but such a specification has no effect.
If any of the pixels within the specified rectangle of the current
'GL_READ_BUFFER' are outside the read window associated with the
current rendering context, then the values obtained for those
pixels are undefined.
No change is made to the INTERNALFORMAT, WIDTH, HEIGHT, DEPTH, or
BORDER parameters of the specified texture array or to texel values
outside the specified subregion.
'GL_INVALID_ENUM' is generated if /TARGET is not 'GL_TEXTURE_3D'.
'GL_INVALID_OPERATION' is generated if the texture array has not
been defined by a previous 'glTexImage3D' operation.
'GL_INVALID_VALUE' is generated if LEVEL is less than 0.
'GL_INVALID_VALUE' may be generated if LEVEL>LOG_2(MAX,), where
MAX is the returned value of 'GL_MAX_3D_TEXTURE_SIZE'.
'GL_INVALID_VALUE' is generated if XOFFSET<-B,
(XOFFSET+WIDTH,)>(W-B,), YOFFSET<-B, (YOFFSET+HEIGHT,)>(H-B,),
ZOFFSET<-B, or (ZOFFSET+1,)>(D-B,), where W is the
'GL_TEXTURE_WIDTH', H is the 'GL_TEXTURE_HEIGHT', D is the
'GL_TEXTURE_DEPTH', and B is the 'GL_TEXTURE_BORDER' of the texture
image being modified. Note that W, H, and D include twice the
border width.
'GL_INVALID_OPERATION' is generated if 'glCopyTexSubImage3D' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: GLuint glCreateProgram
Creates a program object.
'glCreateProgram' creates an empty program object and returns a
non-zero value by which it can be referenced. A program object is
an object to which shader objects can be attached. This provides a
mechanism to specify the shader objects that will be linked to
create a program. It also provides a means for checking the
compatibility of the shaders that will be used to create a program
(for instance, checking the compatibility between a vertex shader
and a fragment shader). When no longer needed as part of a program
object, shader objects can be detached.
One or more executables are created in a program object by
successfully attaching shader objects to it with 'glAttachShader',
successfully compiling the shader objects with 'glCompileShader',
and successfully linking the program object with 'glLinkProgram'.
These executables are made part of current state when
'glUseProgram' is called. Program objects can be deleted by
calling 'glDeleteProgram'. The memory associated with the program
object will be deleted when it is no longer part of current
rendering state for any context.
This function returns 0 if an error occurs creating the program
object.
'GL_INVALID_OPERATION' is generated if 'glCreateProgram' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: GLuint glCreateShader shaderType
Creates a shader object.
SHADERTYPE
Specifies the type of shader to be created. Must be either
'GL_VERTEX_SHADER' or 'GL_FRAGMENT_SHADER'.
'glCreateShader' creates an empty shader object and returns a
non-zero value by which it can be referenced. A shader object is
used to maintain the source code strings that define a shader.
SHADERTYPE indicates the type of shader to be created. Two types
of shaders are supported. A shader of type 'GL_VERTEX_SHADER' is a
shader that is intended to run on the programmable vertex processor
and replace the fixed functionality vertex processing in OpenGL. A
shader of type 'GL_FRAGMENT_SHADER' is a shader that is intended to
run on the programmable fragment processor and replace the fixed
functionality fragment processing in OpenGL.
When created, a shader object's 'GL_SHADER_TYPE' parameter is set
to either 'GL_VERTEX_SHADER' or 'GL_FRAGMENT_SHADER', depending on
the value of SHADERTYPE.
This function returns 0 if an error occurs creating the shader
object.
'GL_INVALID_ENUM' is generated if SHADERTYPE is not an accepted
value.
'GL_INVALID_OPERATION' is generated if 'glCreateShader' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glCullFace mode
Specify whether front- or back-facing facets can be culled.
MODE
Specifies whether front- or back-facing facets are candidates
for culling. Symbolic constants 'GL_FRONT', 'GL_BACK', and
'GL_FRONT_AND_BACK' are accepted. The initial value is
'GL_BACK'.
'glCullFace' specifies whether front- or back-facing facets are
culled (as specified by MODE) when facet culling is enabled. Facet
culling is initially disabled. To enable and disable facet
culling, call the 'glEnable' and 'glDisable' commands with the
argument 'GL_CULL_FACE'. Facets include triangles, quadrilaterals,
polygons, and rectangles.
'glFrontFace' specifies which of the clockwise and counterclockwise
facets are front-facing and back-facing. See 'glFrontFace'.
'GL_INVALID_ENUM' is generated if MODE is not an accepted value.
'GL_INVALID_OPERATION' is generated if 'glCullFace' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glDeleteBuffers n buffers
Delete named buffer objects.
N
Specifies the number of buffer objects to be deleted.
BUFFERS
Specifies an array of buffer objects to be deleted.
'glDeleteBuffers' deletes N buffer objects named by the elements of
the array BUFFERS. After a buffer object is deleted, it has no
contents, and its name is free for reuse (for example by
'glGenBuffers'). If a buffer object that is currently bound is
deleted, the binding reverts to 0 (the absence of any buffer
object, which reverts to client memory usage).
'glDeleteBuffers' silently ignores 0's and names that do not
correspond to existing buffer objects.
'GL_INVALID_VALUE' is generated if N is negative.
'GL_INVALID_OPERATION' is generated if 'glDeleteBuffers' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glDeleteLists list range
Delete a contiguous group of display lists.
LIST
Specifies the integer name of the first display list to
delete.
RANGE
Specifies the number of display lists to delete.
'glDeleteLists' causes a contiguous group of display lists to be
deleted. LIST is the name of the first display list to be deleted,
and RANGE is the number of display lists to delete. All display
lists D with LIST<=D<=LIST+RANGE-1 are deleted.
All storage locations allocated to the specified display lists are
freed, and the names are available for reuse at a later time.
Names within the range that do not have an associated display list
are ignored. If RANGE is 0, nothing happens.
'GL_INVALID_VALUE' is generated if RANGE is negative.
'GL_INVALID_OPERATION' is generated if 'glDeleteLists' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glDeleteProgram program
Deletes a program object.
PROGRAM
Specifies the program object to be deleted.
'glDeleteProgram' frees the memory and invalidates the name
associated with the program object specified by PROGRAM. This
command effectively undoes the effects of a call to
'glCreateProgram'.
If a program object is in use as part of current rendering state,
it will be flagged for deletion, but it will not be deleted until
it is no longer part of current state for any rendering context.
If a program object to be deleted has shader objects attached to
it, those shader objects will be automatically detached but not
deleted unless they have already been flagged for deletion by a
previous call to 'glDeleteShader'. A value of 0 for PROGRAM will
be silently ignored.
To determine whether a program object has been flagged for
deletion, call 'glGetProgram' with arguments PROGRAM and
'GL_DELETE_STATUS'.
'GL_INVALID_VALUE' is generated if PROGRAM is not a value generated
by OpenGL.
'GL_INVALID_OPERATION' is generated if 'glDeleteProgram' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glDeleteQueries n ids
Delete named query objects.
N
Specifies the number of query objects to be deleted.
IDS
Specifies an array of query objects to be deleted.
'glDeleteQueries' deletes N query objects named by the elements of
the array IDS. After a query object is deleted, it has no
contents, and its name is free for reuse (for example by
'glGenQueries').
'glDeleteQueries' silently ignores 0's and names that do not
correspond to existing query objects.
'GL_INVALID_VALUE' is generated if N is negative.
'GL_INVALID_OPERATION' is generated if 'glDeleteQueries' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glDeleteShader shader
Deletes a shader object.
SHADER
Specifies the shader object to be deleted.
'glDeleteShader' frees the memory and invalidates the name
associated with the shader object specified by SHADER. This
command effectively undoes the effects of a call to
'glCreateShader'.
If a shader object to be deleted is attached to a program object,
it will be flagged for deletion, but it will not be deleted until
it is no longer attached to any program object, for any rendering
context (i.e., it must be detached from wherever it was attached
before it will be deleted). A value of 0 for SHADER will be
silently ignored.
To determine whether an object has been flagged for deletion, call
'glGetShader' with arguments SHADER and 'GL_DELETE_STATUS'.
'GL_INVALID_VALUE' is generated if SHADER is not a value generated
by OpenGL.
'GL_INVALID_OPERATION' is generated if 'glDeleteShader' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glDeleteTextures n textures
Delete named textures.
N
Specifies the number of textures to be deleted.
TEXTURES
Specifies an array of textures to be deleted.
'glDeleteTextures' deletes N textures named by the elements of the
array TEXTURES. After a texture is deleted, it has no contents or
dimensionality, and its name is free for reuse (for example by
'glGenTextures'). If a texture that is currently bound is deleted,
the binding reverts to 0 (the default texture).
'glDeleteTextures' silently ignores 0's and names that do not
correspond to existing textures.
'GL_INVALID_VALUE' is generated if N is negative.
'GL_INVALID_OPERATION' is generated if 'glDeleteTextures' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glDepthFunc func
Specify the value used for depth buffer comparisons.
FUNC
Specifies the depth comparison function. Symbolic constants
'GL_NEVER', 'GL_LESS', 'GL_EQUAL', 'GL_LEQUAL', 'GL_GREATER',
'GL_NOTEQUAL', 'GL_GEQUAL', and 'GL_ALWAYS' are accepted. The
initial value is 'GL_LESS'.
'glDepthFunc' specifies the function used to compare each incoming
pixel depth value with the depth value present in the depth buffer.
The comparison is performed only if depth testing is enabled. (See
'glEnable' and 'glDisable' of 'GL_DEPTH_TEST'.)
FUNC specifies the conditions under which the pixel will be drawn.
The comparison functions are as follows:
'GL_NEVER'
Never passes.
'GL_LESS'
Passes if the incoming depth value is less than the stored
depth value.
'GL_EQUAL'
Passes if the incoming depth value is equal to the stored
depth value.
'GL_LEQUAL'
Passes if the incoming depth value is less than or equal to
the stored depth value.
'GL_GREATER'
Passes if the incoming depth value is greater than the stored
depth value.
'GL_NOTEQUAL'
Passes if the incoming depth value is not equal to the stored
depth value.
'GL_GEQUAL'
Passes if the incoming depth value is greater than or equal to
the stored depth value.
'GL_ALWAYS'
Always passes.
The initial value of FUNC is 'GL_LESS'. Initially, depth testing
is disabled. If depth testing is disabled or if no depth buffer
exists, it is as if the depth test always passes.
'GL_INVALID_ENUM' is generated if FUNC is not an accepted value.
'GL_INVALID_OPERATION' is generated if 'glDepthFunc' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glDepthMask flag
Enable or disable writing into the depth buffer.
FLAG
Specifies whether the depth buffer is enabled for writing. If
FLAG is 'GL_FALSE', depth buffer writing is disabled.
Otherwise, it is enabled. Initially, depth buffer writing is
enabled.
'glDepthMask' specifies whether the depth buffer is enabled for
writing. If FLAG is 'GL_FALSE', depth buffer writing is disabled.
Otherwise, it is enabled. Initially, depth buffer writing is
enabled.
'GL_INVALID_OPERATION' is generated if 'glDepthMask' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glDepthRange nearVal farVal
Specify mapping of depth values from normalized device coordinates
to window coordinates.
NEARVAL
Specifies the mapping of the near clipping plane to window
coordinates. The initial value is 0.
FARVAL
Specifies the mapping of the far clipping plane to window
coordinates. The initial value is 1.
After clipping and division by W, depth coordinates range from -1
to 1, corresponding to the near and far clipping planes.
'glDepthRange' specifies a linear mapping of the normalized depth
coordinates in this range to window depth coordinates. Regardless
of the actual depth buffer implementation, window coordinate depth
values are treated as though they range from 0 through 1 (like
color components). Thus, the values accepted by 'glDepthRange' are
both clamped to this range before they are accepted.
The setting of (0,1) maps the near plane to 0 and the far plane to
1. With this mapping, the depth buffer range is fully utilized.
'GL_INVALID_OPERATION' is generated if 'glDepthRange' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glDetachShader program shader
Detaches a shader object from a program object to which it is
attached.
PROGRAM
Specifies the program object from which to detach the shader
object.
SHADER
Specifies the shader object to be detached.
'glDetachShader' detaches the shader object specified by SHADER
from the program object specified by PROGRAM. This command can be
used to undo the effect of the command 'glAttachShader'.
If SHADER has already been flagged for deletion by a call to
'glDeleteShader' and it is not attached to any other program
object, it will be deleted after it has been detached.
'GL_INVALID_VALUE' is generated if either PROGRAM or SHADER is a
value that was not generated by OpenGL.
'GL_INVALID_OPERATION' is generated if PROGRAM is not a program
object.
'GL_INVALID_OPERATION' is generated if SHADER is not a shader
object.
'GL_INVALID_OPERATION' is generated if SHADER is not attached to
PROGRAM.
'GL_INVALID_OPERATION' is generated if 'glDetachShader' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glDrawArrays mode first count
Render primitives from array data.
MODE
Specifies what kind of primitives to render. Symbolic
constants 'GL_POINTS', 'GL_LINE_STRIP', 'GL_LINE_LOOP',
'GL_LINES', 'GL_TRIANGLE_STRIP', 'GL_TRIANGLE_FAN',
'GL_TRIANGLES', 'GL_QUAD_STRIP', 'GL_QUADS', and 'GL_POLYGON'
are accepted.
FIRST
Specifies the starting index in the enabled arrays.
COUNT
Specifies the number of indices to be rendered.
'glDrawArrays' specifies multiple geometric primitives with very
few subroutine calls. Instead of calling a GL procedure to pass
each individual vertex, normal, texture coordinate, edge flag, or
color, you can prespecify separate arrays of vertices, normals, and
colors and use them to construct a sequence of primitives with a
single call to 'glDrawArrays'.
When 'glDrawArrays' is called, it uses COUNT sequential elements
from each enabled array to construct a sequence of geometric
primitives, beginning with element FIRST. MODE specifies what kind
of primitives are constructed and how the array elements construct
those primitives. If 'GL_VERTEX_ARRAY' is not enabled, no
geometric primitives are generated.
Vertex attributes that are modified by 'glDrawArrays' have an
unspecified value after 'glDrawArrays' returns. For example, if
'GL_COLOR_ARRAY' is enabled, the value of the current color is
undefined after 'glDrawArrays' executes. Attributes that aren't
modified remain well defined.
'GL_INVALID_ENUM' is generated if MODE is not an accepted value.
'GL_INVALID_VALUE' is generated if COUNT is negative.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to an enabled array and the buffer object's data
store is currently mapped.
'GL_INVALID_OPERATION' is generated if 'glDrawArrays' is executed
between the execution of 'glBegin' and the corresponding 'glEnd'.
-- Function: void glDrawBuffers n bufs
Specifies a list of color buffers to be drawn into.
N
Specifies the number of buffers in BUFS.
BUFS
Points to an array of symbolic constants specifying the
buffers into which fragment colors or data values will be
written.
'glDrawBuffers' defines an array of buffers into which fragment
color values or fragment data will be written. If no fragment
shader is active, rendering operations will generate only one
fragment color per fragment and it will be written into each of the
buffers specified by BUFS. If a fragment shader is active and it
writes a value to the output variable 'gl_FragColor', then that
value will be written into each of the buffers specified by BUFS.
If a fragment shader is active and it writes a value to one or more
elements of the output array variable 'gl_FragData[]', then the
value of 'gl_FragData[0] ' will be written into the first buffer
specified by BUFS, the value of 'gl_FragData[1] ' will be written
into the second buffer specified by BUFS, and so on up to
'gl_FragData[n-1]'. The draw buffer used for 'gl_FragData[n]' and
beyond is implicitly set to be 'GL_NONE'.
The symbolic constants contained in BUFS may be any of the
following:
'GL_NONE'
The fragment color/data value is not written into any color
buffer.
'GL_FRONT_LEFT'
The fragment color/data value is written into the front left
color buffer.
'GL_FRONT_RIGHT'
The fragment color/data value is written into the front right
color buffer.
'GL_BACK_LEFT'
The fragment color/data value is written into the back left
color buffer.
'GL_BACK_RIGHT'
The fragment color/data value is written into the back right
color buffer.
'GL_AUXi'
The fragment color/data value is written into auxiliary buffer
'i'.
Except for 'GL_NONE', the preceding symbolic constants may not
appear more than once in BUFS. The maximum number of draw buffers
supported is implementation dependent and can be queried by calling
'glGet' with the argument 'GL_MAX_DRAW_BUFFERS'. The number of
auxiliary buffers can be queried by calling 'glGet' with the
argument 'GL_AUX_BUFFERS'.
'GL_INVALID_ENUM' is generated if one of the values in BUFS is not
an accepted value.
'GL_INVALID_ENUM' is generated if N is less than 0.
'GL_INVALID_OPERATION' is generated if a symbolic constant other
than 'GL_NONE' appears more than once in BUFS.
'GL_INVALID_OPERATION' is generated if any of the entries in BUFS
(other than 'GL_NONE' ) indicates a color buffer that does not
exist in the current GL context.
'GL_INVALID_VALUE' is generated if N is greater than
'GL_MAX_DRAW_BUFFERS'.
'GL_INVALID_OPERATION' is generated if 'glDrawBuffers' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glDrawBuffer mode
Specify which color buffers are to be drawn into.
MODE
Specifies up to four color buffers to be drawn into. Symbolic
constants 'GL_NONE', 'GL_FRONT_LEFT', 'GL_FRONT_RIGHT',
'GL_BACK_LEFT', 'GL_BACK_RIGHT', 'GL_FRONT', 'GL_BACK',
'GL_LEFT', 'GL_RIGHT', 'GL_FRONT_AND_BACK', and 'GL_AUX'I,
where I is between 0 and the value of 'GL_AUX_BUFFERS' minus
1, are accepted. ('GL_AUX_BUFFERS' is not the upper limit;
use 'glGet' to query the number of available aux buffers.)
The initial value is 'GL_FRONT' for single-buffered contexts,
and 'GL_BACK' for double-buffered contexts.
When colors are written to the frame buffer, they are written into
the color buffers specified by 'glDrawBuffer'. The specifications
are as follows:
'GL_NONE'
No color buffers are written.
'GL_FRONT_LEFT'
Only the front left color buffer is written.
'GL_FRONT_RIGHT'
Only the front right color buffer is written.
'GL_BACK_LEFT'
Only the back left color buffer is written.
'GL_BACK_RIGHT'
Only the back right color buffer is written.
'GL_FRONT'
Only the front left and front right color buffers are written.
If there is no front right color buffer, only the front left
color buffer is written.
'GL_BACK'
Only the back left and back right color buffers are written.
If there is no back right color buffer, only the back left
color buffer is written.
'GL_LEFT'
Only the front left and back left color buffers are written.
If there is no back left color buffer, only the front left
color buffer is written.
'GL_RIGHT'
Only the front right and back right color buffers are written.
If there is no back right color buffer, only the front right
color buffer is written.
'GL_FRONT_AND_BACK'
All the front and back color buffers (front left, front right,
back left, back right) are written. If there are no back
color buffers, only the front left and front right color
buffers are written. If there are no right color buffers,
only the front left and back left color buffers are written.
If there are no right or back color buffers, only the front
left color buffer is written.
'GL_AUX'I
Only auxiliary color buffer I is written.
If more than one color buffer is selected for drawing, then
blending or logical operations are computed and applied
independently for each color buffer and can produce different
results in each buffer.
Monoscopic contexts include only LEFT buffers, and stereoscopic
contexts include both LEFT and RIGHT buffers. Likewise,
single-buffered contexts include only FRONT buffers, and
double-buffered contexts include both FRONT and BACK buffers. The
context is selected at GL initialization.
'GL_INVALID_ENUM' is generated if MODE is not an accepted value.
'GL_INVALID_OPERATION' is generated if none of the buffers
indicated by MODE exists.
'GL_INVALID_OPERATION' is generated if 'glDrawBuffer' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glDrawElements mode count type indices
Render primitives from array data.
MODE
Specifies what kind of primitives to render. Symbolic
constants 'GL_POINTS', 'GL_LINE_STRIP', 'GL_LINE_LOOP',
'GL_LINES', 'GL_TRIANGLE_STRIP', 'GL_TRIANGLE_FAN',
'GL_TRIANGLES', 'GL_QUAD_STRIP', 'GL_QUADS', and 'GL_POLYGON'
are accepted.
COUNT
Specifies the number of elements to be rendered.
TYPE
Specifies the type of the values in INDICES. Must be one of
'GL_UNSIGNED_BYTE', 'GL_UNSIGNED_SHORT', or 'GL_UNSIGNED_INT'.
INDICES
Specifies a pointer to the location where the indices are
stored.
'glDrawElements' specifies multiple geometric primitives with very
few subroutine calls. Instead of calling a GL function to pass
each individual vertex, normal, texture coordinate, edge flag, or
color, you can prespecify separate arrays of vertices, normals, and
so on, and use them to construct a sequence of primitives with a
single call to 'glDrawElements'.
When 'glDrawElements' is called, it uses COUNT sequential elements
from an enabled array, starting at INDICES to construct a sequence
of geometric primitives. MODE specifies what kind of primitives
are constructed and how the array elements construct these
primitives. If more than one array is enabled, each is used. If
'GL_VERTEX_ARRAY' is not enabled, no geometric primitives are
constructed.
Vertex attributes that are modified by 'glDrawElements' have an
unspecified value after 'glDrawElements' returns. For example, if
'GL_COLOR_ARRAY' is enabled, the value of the current color is
undefined after 'glDrawElements' executes. Attributes that aren't
modified maintain their previous values.
'GL_INVALID_ENUM' is generated if MODE is not an accepted value.
'GL_INVALID_VALUE' is generated if COUNT is negative.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to an enabled array or the element array and the
buffer object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if 'glDrawElements' is executed
between the execution of 'glBegin' and the corresponding 'glEnd'.
-- Function: void glDrawPixels width height format type data
Write a block of pixels to the frame buffer.
WIDTH
HEIGHT
Specify the dimensions of the pixel rectangle to be written
into the frame buffer.
FORMAT
Specifies the format of the pixel data. Symbolic constants
'GL_COLOR_INDEX', 'GL_STENCIL_INDEX', 'GL_DEPTH_COMPONENT',
'GL_RGB', 'GL_BGR', 'GL_RGBA', 'GL_BGRA', 'GL_RED',
'GL_GREEN', 'GL_BLUE', 'GL_ALPHA', 'GL_LUMINANCE', and
'GL_LUMINANCE_ALPHA' are accepted.
TYPE
Specifies the data type for DATA. Symbolic constants
'GL_UNSIGNED_BYTE', 'GL_BYTE', 'GL_BITMAP',
'GL_UNSIGNED_SHORT', 'GL_SHORT', 'GL_UNSIGNED_INT', 'GL_INT',
'GL_FLOAT', 'GL_UNSIGNED_BYTE_3_3_2',
'GL_UNSIGNED_BYTE_2_3_3_REV', 'GL_UNSIGNED_SHORT_5_6_5',
'GL_UNSIGNED_SHORT_5_6_5_REV', 'GL_UNSIGNED_SHORT_4_4_4_4',
'GL_UNSIGNED_SHORT_4_4_4_4_REV', 'GL_UNSIGNED_SHORT_5_5_5_1',
'GL_UNSIGNED_SHORT_1_5_5_5_REV', 'GL_UNSIGNED_INT_8_8_8_8',
'GL_UNSIGNED_INT_8_8_8_8_REV', 'GL_UNSIGNED_INT_10_10_10_2',
and 'GL_UNSIGNED_INT_2_10_10_10_REV' are accepted.
DATA
Specifies a pointer to the pixel data.
'glDrawPixels' reads pixel data from memory and writes it into the
frame buffer relative to the current raster position, provided that
the raster position is valid. Use 'glRasterPos' or 'glWindowPos'
to set the current raster position; use 'glGet' with argument
'GL_CURRENT_RASTER_POSITION_VALID' to determine if the specified
raster position is valid, and 'glGet' with argument
'GL_CURRENT_RASTER_POSITION' to query the raster position.
Several parameters define the encoding of pixel data in memory and
control the processing of the pixel data before it is placed in the
frame buffer. These parameters are set with four commands:
'glPixelStore', 'glPixelTransfer', 'glPixelMap', and 'glPixelZoom'.
This reference page describes the effects on 'glDrawPixels' of
many, but not all, of the parameters specified by these four
commands.
Data is read from DATA as a sequence of signed or unsigned bytes,
signed or unsigned shorts, signed or unsigned integers, or
single-precision floating-point values, depending on TYPE. When
TYPE is one of 'GL_UNSIGNED_BYTE', 'GL_BYTE', 'GL_UNSIGNED_SHORT',
'GL_SHORT', 'GL_UNSIGNED_INT', 'GL_INT', or 'GL_FLOAT' each of
these bytes, shorts, integers, or floating-point values is
interpreted as one color or depth component, or one index,
depending on FORMAT. When TYPE is one of 'GL_UNSIGNED_BYTE_3_3_2',
'GL_UNSIGNED_SHORT_5_6_5', 'GL_UNSIGNED_SHORT_4_4_4_4',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_INT_8_8_8_8', or
'GL_UNSIGNED_INT_10_10_10_2', each unsigned value is interpreted as
containing all the components for a single pixel, with the color
components arranged according to FORMAT. When TYPE is one of
'GL_UNSIGNED_BYTE_2_3_3_REV', 'GL_UNSIGNED_SHORT_5_6_5_REV',
'GL_UNSIGNED_SHORT_4_4_4_4_REV', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8_REV', or 'GL_UNSIGNED_INT_2_10_10_10_REV',
each unsigned value is interpreted as containing all color
components, specified by FORMAT, for a single pixel in a reversed
order. Indices are always treated individually. Color components
are treated as groups of one, two, three, or four values, again
based on FORMAT. Both individual indices and groups of components
are referred to as pixels. If TYPE is 'GL_BITMAP', the data must
be unsigned bytes, and FORMAT must be either 'GL_COLOR_INDEX' or
'GL_STENCIL_INDEX'. Each unsigned byte is treated as eight 1-bit
pixels, with bit ordering determined by 'GL_UNPACK_LSB_FIRST' (see
'glPixelStore').
WIDTH×HEIGHT pixels are read from memory, starting at location
DATA. By default, these pixels are taken from adjacent memory
locations, except that after all WIDTH pixels are read, the read
pointer is advanced to the next four-byte boundary. The four-byte
row alignment is specified by 'glPixelStore' with argument
'GL_UNPACK_ALIGNMENT', and it can be set to one, two, four, or
eight bytes. Other pixel store parameters specify different read
pointer advancements, both before the first pixel is read and after
all WIDTH pixels are read. See the 'glPixelStore' reference page
for details on these options.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a block
of pixels is specified, DATA is treated as a byte offset into the
buffer object's data store.
The WIDTH×HEIGHT pixels that are read from memory are each
operated on in the same way, based on the values of several
parameters specified by 'glPixelTransfer' and 'glPixelMap'. The
details of these operations, as well as the target buffer into
which the pixels are drawn, are specific to the format of the
pixels, as specified by FORMAT. FORMAT can assume one of 13
symbolic values:
'GL_COLOR_INDEX'
Each pixel is a single value, a color index. It is converted
to fixed-point format, with an unspecified number of bits to
the right of the binary point, regardless of the memory data
type. Floating-point values convert to true fixed-point
values. Signed and unsigned integer data is converted with
all fraction bits set to 0. Bitmap data convert to either 0
or 1.
Each fixed-point index is then shifted left by
'GL_INDEX_SHIFT' bits and added to 'GL_INDEX_OFFSET'. If
'GL_INDEX_SHIFT' is negative, the shift is to the right. In
either case, zero bits fill otherwise unspecified bit
locations in the result.
If the GL is in RGBA mode, the resulting index is converted to
an RGBA pixel with the help of the 'GL_PIXEL_MAP_I_TO_R',
'GL_PIXEL_MAP_I_TO_G', 'GL_PIXEL_MAP_I_TO_B', and
'GL_PIXEL_MAP_I_TO_A' tables. If the GL is in color index
mode, and if 'GL_MAP_COLOR' is true, the index is replaced
with the value that it references in lookup table
'GL_PIXEL_MAP_I_TO_I'. Whether the lookup replacement of the
index is done or not, the integer part of the index is then
ANDed with 2^B-1, where B is the number of bits in a color
index buffer.
The GL then converts the resulting indices or RGBA colors to
fragments by attaching the current raster position Z
coordinate and texture coordinates to each pixel, then
assigning X and Y window coordinates to the Nth fragment such
that X_N=X_R+N%WIDTHY_N=Y_R+⌊N/WIDTH,⌋
where (X_R,Y_R) is the current raster position. These pixel
fragments are then treated just like the fragments generated
by rasterizing points, lines, or polygons. Texture mapping,
fog, and all the fragment operations are applied before the
fragments are written to the frame buffer.
'GL_STENCIL_INDEX'
Each pixel is a single value, a stencil index. It is
converted to fixed-point format, with an unspecified number of
bits to the right of the binary point, regardless of the
memory data type. Floating-point values convert to true
fixed-point values. Signed and unsigned integer data is
converted with all fraction bits set to 0. Bitmap data
convert to either 0 or 1.
Each fixed-point index is then shifted left by
'GL_INDEX_SHIFT' bits, and added to 'GL_INDEX_OFFSET'. If
'GL_INDEX_SHIFT' is negative, the shift is to the right. In
either case, zero bits fill otherwise unspecified bit
locations in the result. If 'GL_MAP_STENCIL' is true, the
index is replaced with the value that it references in lookup
table 'GL_PIXEL_MAP_S_TO_S'. Whether the lookup replacement
of the index is done or not, the integer part of the index is
then ANDed with 2^B-1, where B is the number of bits in the
stencil buffer. The resulting stencil indices are then
written to the stencil buffer such that the Nth index is
written to location
X_N=X_R+N%WIDTHY_N=Y_R+⌊N/WIDTH,⌋
where (X_R,Y_R) is the current raster position. Only the
pixel ownership test, the scissor test, and the stencil
writemask affect these write operations.
'GL_DEPTH_COMPONENT'
Each pixel is a single-depth component. Floating-point data
is converted directly to an internal floating-point format
with unspecified precision. Signed integer data is mapped
linearly to the internal floating-point format such that the
most positive representable integer value maps to 1.0, and the
most negative representable value maps to -1.0. Unsigned
integer data is mapped similarly: the largest integer value
maps to 1.0, and 0 maps to 0.0. The resulting floating-point
depth value is then multiplied by 'GL_DEPTH_SCALE' and added
to 'GL_DEPTH_BIAS'. The result is clamped to the range [0,1].
The GL then converts the resulting depth components to
fragments by attaching the current raster position color or
color index and texture coordinates to each pixel, then
assigning X and Y window coordinates to the Nth fragment such
that
X_N=X_R+N%WIDTHY_N=Y_R+⌊N/WIDTH,⌋
where (X_R,Y_R) is the current raster position. These pixel
fragments are then treated just like the fragments generated
by rasterizing points, lines, or polygons. Texture mapping,
fog, and all the fragment operations are applied before the
fragments are written to the frame buffer.
'GL_RGBA'
'GL_BGRA'
Each pixel is a four-component group: For 'GL_RGBA', the red
component is first, followed by green, followed by blue,
followed by alpha; for 'GL_BGRA' the order is blue, green, red
and then alpha. Floating-point values are converted directly
to an internal floating-point format with unspecified
precision. Signed integer values are mapped linearly to the
internal floating-point format such that the most positive
representable integer value maps to 1.0, and the most negative
representable value maps to -1.0. (Note that this mapping
does not convert 0 precisely to 0.0.) Unsigned integer data
is mapped similarly: The largest integer value maps to 1.0,
and 0 maps to 0.0. The resulting floating-point color values
are then multiplied by 'GL_c_SCALE' and added to 'GL_c_BIAS',
where C is RED, GREEN, BLUE, and ALPHA for the respective
color components. The results are clamped to the range [0,1].
If 'GL_MAP_COLOR' is true, each color component is scaled by
the size of lookup table 'GL_PIXEL_MAP_c_TO_c', then replaced
by the value that it references in that table. C is R, G, B,
or A respectively.
The GL then converts the resulting RGBA colors to fragments by
attaching the current raster position Z coordinate and texture
coordinates to each pixel, then assigning X and Y window
coordinates to the Nth fragment such that
X_N=X_R+N%WIDTHY_N=Y_R+⌊N/WIDTH,⌋
where (X_R,Y_R) is the current raster position. These pixel
fragments are then treated just like the fragments generated
by rasterizing points, lines, or polygons. Texture mapping,
fog, and all the fragment operations are applied before the
fragments are written to the frame buffer.
'GL_RED'
Each pixel is a single red component. This component is
converted to the internal floating-point format in the same
way the red component of an RGBA pixel is. It is then
converted to an RGBA pixel with green and blue set to 0, and
alpha set to 1. After this conversion, the pixel is treated
as if it had been read as an RGBA pixel.
'GL_GREEN'
Each pixel is a single green component. This component is
converted to the internal floating-point format in the same
way the green component of an RGBA pixel is. It is then
converted to an RGBA pixel with red and blue set to 0, and
alpha set to 1. After this conversion, the pixel is treated
as if it had been read as an RGBA pixel.
'GL_BLUE'
Each pixel is a single blue component. This component is
converted to the internal floating-point format in the same
way the blue component of an RGBA pixel is. It is then
converted to an RGBA pixel with red and green set to 0, and
alpha set to 1. After this conversion, the pixel is treated
as if it had been read as an RGBA pixel.
'GL_ALPHA'
Each pixel is a single alpha component. This component is
converted to the internal floating-point format in the same
way the alpha component of an RGBA pixel is. It is then
converted to an RGBA pixel with red, green, and blue set to 0.
After this conversion, the pixel is treated as if it had been
read as an RGBA pixel.
'GL_RGB'
'GL_BGR'
Each pixel is a three-component group: red first, followed by
green, followed by blue; for 'GL_BGR', the first component is
blue, followed by green and then red. Each component is
converted to the internal floating-point format in the same
way the red, green, and blue components of an RGBA pixel are.
The color triple is converted to an RGBA pixel with alpha set
to 1. After this conversion, the pixel is treated as if it
had been read as an RGBA pixel.
'GL_LUMINANCE'
Each pixel is a single luminance component. This component is
converted to the internal floating-point format in the same
way the red component of an RGBA pixel is. It is then
converted to an RGBA pixel with red, green, and blue set to
the converted luminance value, and alpha set to 1. After this
conversion, the pixel is treated as if it had been read as an
RGBA pixel.
'GL_LUMINANCE_ALPHA'
Each pixel is a two-component group: luminance first, followed
by alpha. The two components are converted to the internal
floating-point format in the same way the red component of an
RGBA pixel is. They are then converted to an RGBA pixel with
red, green, and blue set to the converted luminance value, and
alpha set to the converted alpha value. After this
conversion, the pixel is treated as if it had been read as an
RGBA pixel.
The following table summarizes the meaning of the valid constants
for the TYPE parameter:
*Type*
*Corresponding Type*
'GL_UNSIGNED_BYTE'
unsigned 8-bit integer
'GL_BYTE'
signed 8-bit integer
'GL_BITMAP'
single bits in unsigned 8-bit integers
'GL_UNSIGNED_SHORT'
unsigned 16-bit integer
'GL_SHORT'
signed 16-bit integer
'GL_UNSIGNED_INT'
unsigned 32-bit integer
'GL_INT'
32-bit integer
'GL_FLOAT'
single-precision floating-point
'GL_UNSIGNED_BYTE_3_3_2'
unsigned 8-bit integer
'GL_UNSIGNED_BYTE_2_3_3_REV'
unsigned 8-bit integer with reversed component ordering
'GL_UNSIGNED_SHORT_5_6_5'
unsigned 16-bit integer
'GL_UNSIGNED_SHORT_5_6_5_REV'
unsigned 16-bit integer with reversed component ordering
'GL_UNSIGNED_SHORT_4_4_4_4'
unsigned 16-bit integer
'GL_UNSIGNED_SHORT_4_4_4_4_REV'
unsigned 16-bit integer with reversed component ordering
'GL_UNSIGNED_SHORT_5_5_5_1'
unsigned 16-bit integer
'GL_UNSIGNED_SHORT_1_5_5_5_REV'
unsigned 16-bit integer with reversed component ordering
'GL_UNSIGNED_INT_8_8_8_8'
unsigned 32-bit integer
'GL_UNSIGNED_INT_8_8_8_8_REV'
unsigned 32-bit integer with reversed component ordering
'GL_UNSIGNED_INT_10_10_10_2'
unsigned 32-bit integer
'GL_UNSIGNED_INT_2_10_10_10_REV'
unsigned 32-bit integer with reversed component ordering
The rasterization described so far assumes pixel zoom factors of 1.
If 'glPixelZoom' is used to change the X and Y pixel zoom factors,
pixels are converted to fragments as follows. If (X_R,Y_R) is the
current raster position, and a given pixel is in the Nth column and
Mth row of the pixel rectangle, then fragments are generated for
pixels whose centers are in the rectangle with corners at
(X_R+ZOOM_X,N,Y_R+ZOOM_Y,M)(X_R+ZOOM_X,(N+1,),Y_R+ZOOM_Y,(M+1,))
where ZOOM_X is the value of 'GL_ZOOM_X' and ZOOM_Y is the value of
'GL_ZOOM_Y'.
'GL_INVALID_ENUM' is generated if FORMAT or TYPE is not one of the
accepted values.
'GL_INVALID_ENUM' is generated if TYPE is 'GL_BITMAP' and FORMAT is
not either 'GL_COLOR_INDEX' or 'GL_STENCIL_INDEX'.
'GL_INVALID_VALUE' is generated if either WIDTH or HEIGHT is
negative.
'GL_INVALID_OPERATION' is generated if FORMAT is 'GL_STENCIL_INDEX'
and there is no stencil buffer.
'GL_INVALID_OPERATION' is generated if FORMAT is 'GL_RED',
'GL_GREEN', 'GL_BLUE', 'GL_ALPHA', 'GL_RGB', 'GL_RGBA', 'GL_BGR',
'GL_BGRA', 'GL_LUMINANCE', or 'GL_LUMINANCE_ALPHA', and the GL is
in color index mode.
'GL_INVALID_OPERATION' is generated if FORMAT is one of
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', or 'GL_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GL_RGB'.
'GL_INVALID_OPERATION' is generated if FORMAT is one of
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', or 'GL_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GL_RGBA' nor 'GL_BGRA'.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and DATA is
not evenly divisible into the number of bytes needed to store in
memory a datum indicated by TYPE.
'GL_INVALID_OPERATION' is generated if 'glDrawPixels' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glDrawRangeElements mode start end count type indices
Render primitives from array data.
MODE
Specifies what kind of primitives to render. Symbolic
constants 'GL_POINTS', 'GL_LINE_STRIP', 'GL_LINE_LOOP',
'GL_LINES', 'GL_TRIANGLE_STRIP', 'GL_TRIANGLE_FAN',
'GL_TRIANGLES', 'GL_QUAD_STRIP', 'GL_QUADS', and 'GL_POLYGON'
are accepted.
START
Specifies the minimum array index contained in INDICES.
END
Specifies the maximum array index contained in INDICES.
COUNT
Specifies the number of elements to be rendered.
TYPE
Specifies the type of the values in INDICES. Must be one of
'GL_UNSIGNED_BYTE', 'GL_UNSIGNED_SHORT', or 'GL_UNSIGNED_INT'.
INDICES
Specifies a pointer to the location where the indices are
stored.
'glDrawRangeElements' is a restricted form of 'glDrawElements'.
MODE, START, END, and COUNT match the corresponding arguments to
'glDrawElements', with the additional constraint that all values in
the arrays COUNT must lie between START and END, inclusive.
Implementations denote recommended maximum amounts of vertex and
index data, which may be queried by calling 'glGet' with argument
'GL_MAX_ELEMENTS_VERTICES' and 'GL_MAX_ELEMENTS_INDICES'. If
END-START+1 is greater than the value of
'GL_MAX_ELEMENTS_VERTICES', or if COUNT is greater than the value
of 'GL_MAX_ELEMENTS_INDICES', then the call may operate at reduced
performance. There is no requirement that all vertices in the
range [START,END] be referenced. However, the implementation may
partially process unused vertices, reducing performance from what
could be achieved with an optimal index set.
When 'glDrawRangeElements' is called, it uses COUNT sequential
elements from an enabled array, starting at START to construct a
sequence of geometric primitives. MODE specifies what kind of
primitives are constructed, and how the array elements construct
these primitives. If more than one array is enabled, each is used.
If 'GL_VERTEX_ARRAY' is not enabled, no geometric primitives are
constructed.
Vertex attributes that are modified by 'glDrawRangeElements' have
an unspecified value after 'glDrawRangeElements' returns. For
example, if 'GL_COLOR_ARRAY' is enabled, the value of the current
color is undefined after 'glDrawRangeElements' executes.
Attributes that aren't modified maintain their previous values.
It is an error for indices to lie outside the range [START,END],
but implementations may not check for this situation. Such indices
cause implementation-dependent behavior.
'GL_INVALID_ENUM' is generated if MODE is not an accepted value.
'GL_INVALID_VALUE' is generated if COUNT is negative.
'GL_INVALID_VALUE' is generated if END=∣ΔY,∣, I pixels are filled in each column
that is rasterized, where I is the rounded value of WIDTH.
Otherwise, I pixels are filled in each row that is rasterized.
If antialiasing is enabled, line rasterization produces a fragment
for each pixel square that intersects the region lying within the
rectangle having width equal to the current line width, length
equal to the actual length of the line, and centered on the
mathematical line segment. The coverage value for each fragment is
the window coordinate area of the intersection of the rectangular
region with the corresponding pixel square. This value is saved
and used in the final rasterization step.
Not all widths can be supported when line antialiasing is enabled.
If an unsupported width is requested, the nearest supported width
is used. Only width 1 is guaranteed to be supported; others depend
on the implementation. Likewise, there is a range for aliased line
widths as well. To query the range of supported widths and the
size difference between supported widths within the range, call
'glGet' with arguments 'GL_ALIASED_LINE_WIDTH_RANGE',
'GL_SMOOTH_LINE_WIDTH_RANGE', and
'GL_SMOOTH_LINE_WIDTH_GRANULARITY'.
'GL_INVALID_VALUE' is generated if WIDTH is less than or equal to
0.
'GL_INVALID_OPERATION' is generated if 'glLineWidth' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glLinkProgram program
Links a program object.
PROGRAM
Specifies the handle of the program object to be linked.
'glLinkProgram' links the program object specified by PROGRAM. If
any shader objects of type 'GL_VERTEX_SHADER' are attached to
PROGRAM, they will be used to create an executable that will run on
the programmable vertex processor. If any shader objects of type
'GL_FRAGMENT_SHADER' are attached to PROGRAM, they will be used to
create an executable that will run on the programmable fragment
processor.
The status of the link operation will be stored as part of the
program object's state. This value will be set to 'GL_TRUE' if the
program object was linked without errors and is ready for use, and
'GL_FALSE' otherwise. It can be queried by calling 'glGetProgram'
with arguments PROGRAM and 'GL_LINK_STATUS'.
As a result of a successful link operation, all active user-defined
uniform variables belonging to PROGRAM will be initialized to 0,
and each of the program object's active uniform variables will be
assigned a location that can be queried by calling
'glGetUniformLocation'. Also, any active user-defined attribute
variables that have not been bound to a generic vertex attribute
index will be bound to one at this time.
Linking of a program object can fail for a number of reasons as
specified in the OPENGL SHADING LANGUAGE SPECIFICATION. The
following lists some of the conditions that will cause a link
error.
* The number of active attribute variables supported by the
implementation has been exceeded.
* The storage limit for uniform variables has been exceeded.
* The number of active uniform variables supported by the
implementation has been exceeded.
* The 'main' function is missing for the vertex shader or the
fragment shader.
* A varying variable actually used in the fragment shader is not
declared in the same way (or is not declared at all) in the
vertex shader.
* A reference to a function or variable name is unresolved.
* A shared global is declared with two different types or two
different initial values.
* One or more of the attached shader objects has not been
successfully compiled.
* Binding a generic attribute matrix caused some rows of the
matrix to fall outside the allowed maximum of
'GL_MAX_VERTEX_ATTRIBS'.
* Not enough contiguous vertex attribute slots could be found to
bind attribute matrices.
When a program object has been successfully linked, the program
object can be made part of current state by calling 'glUseProgram'.
Whether or not the link operation was successful, the program
object's information log will be overwritten. The information log
can be retrieved by calling 'glGetProgramInfoLog'.
'glLinkProgram' will also install the generated executables as part
of the current rendering state if the link operation was successful
and the specified program object is already currently in use as a
result of a previous call to 'glUseProgram'. If the program object
currently in use is relinked unsuccessfully, its link status will
be set to 'GL_FALSE' , but the executables and associated state
will remain part of the current state until a subsequent call to
'glUseProgram' removes it from use. After it is removed from use,
it cannot be made part of current state until it has been
successfully relinked.
If PROGRAM contains shader objects of type 'GL_VERTEX_SHADER' but
does not contain shader objects of type 'GL_FRAGMENT_SHADER', the
vertex shader will be linked against the implicit interface for
fixed functionality fragment processing. Similarly, if PROGRAM
contains shader objects of type 'GL_FRAGMENT_SHADER' but it does
not contain shader objects of type 'GL_VERTEX_SHADER', the fragment
shader will be linked against the implicit interface for fixed
functionality vertex processing.
The program object's information log is updated and the program is
generated at the time of the link operation. After the link
operation, applications are free to modify attached shader objects,
compile attached shader objects, detach shader objects, delete
shader objects, and attach additional shader objects. None of
these operations affects the information log or the program that is
part of the program object.
'GL_INVALID_VALUE' is generated if PROGRAM is not a value generated
by OpenGL.
'GL_INVALID_OPERATION' is generated if PROGRAM is not a program
object.
'GL_INVALID_OPERATION' is generated if 'glLinkProgram' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glListBase base
Set the display-list base for .
BASE
Specifies an integer offset that will be added to
'glCallLists' offsets to generate display-list names. The
initial value is 0.
'glCallLists' specifies an array of offsets. Display-list names
are generated by adding BASE to each offset. Names that reference
valid display lists are executed; the others are ignored.
'GL_INVALID_OPERATION' is generated if 'glListBase' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glLoadIdentity
Replace the current matrix with the identity matrix.
'glLoadIdentity' replaces the current matrix with the identity
matrix. It is semantically equivalent to calling 'glLoadMatrix'
with the identity matrix
((1 0 0 0), (0 1 0 0), (0 0 1 0), (0 0 0 1),,)
but in some cases it is more efficient.
'GL_INVALID_OPERATION' is generated if 'glLoadIdentity' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glLoadMatrixd m
-- Function: void glLoadMatrixf m
Replace the current matrix with the specified matrix.
M
Specifies a pointer to 16 consecutive values, which are used
as the elements of a 4×4 column-major matrix.
'glLoadMatrix' replaces the current matrix with the one whose
elements are specified by M. The current matrix is the projection
matrix, modelview matrix, or texture matrix, depending on the
current matrix mode (see 'glMatrixMode').
The current matrix, M, defines a transformation of coordinates.
For instance, assume M refers to the modelview matrix. If
V=(V[0,],V[1,]V[2,]V[3,]) is the set of object
coordinates of a vertex, and M points to an array of 16 single- or
double-precision floating-point values
M={M[0,],M[1,]...M[15,]}, then the modelview
transformation M(V,) does the following:
M(V,)=((M[0,] M[4,] M[8,] M[12,]), (M[1,]
M[5,] M[9,] M[13,]), (M[2,] M[6,] M[10,]
M[14,]), (M[3,] M[7,] M[11,] M[15,]),)×((V[0,]),
(V[1,]), (V[2,]), (V[3,]),)
Projection and texture transformations are similarly defined.
'GL_INVALID_OPERATION' is generated if 'glLoadMatrix' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glLoadName name
Load a name onto the name stack.
NAME
Specifies a name that will replace the top value on the name
stack.
The name stack is used during selection mode to allow sets of
rendering commands to be uniquely identified. It consists of an
ordered set of unsigned integers and is initially empty.
'glLoadName' causes NAME to replace the value on the top of the
name stack.
The name stack is always empty while the render mode is not
'GL_SELECT'. Calls to 'glLoadName' while the render mode is not
'GL_SELECT' are ignored.
'GL_INVALID_OPERATION' is generated if 'glLoadName' is called while
the name stack is empty.
'GL_INVALID_OPERATION' is generated if 'glLoadName' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glLoadTransposeMatrixd m
-- Function: void glLoadTransposeMatrixf m
Replace the current matrix with the specified row-major ordered
matrix.
M
Specifies a pointer to 16 consecutive values, which are used
as the elements of a 4×4 row-major matrix.
'glLoadTransposeMatrix' replaces the current matrix with the one
whose elements are specified by M. The current matrix is the
projection matrix, modelview matrix, or texture matrix, depending
on the current matrix mode (see 'glMatrixMode').
The current matrix, M, defines a transformation of coordinates.
For instance, assume M refers to the modelview matrix. If
V=(V[0,],V[1,]V[2,]V[3,]) is the set of object
coordinates of a vertex, and M points to an array of 16 single- or
double-precision floating-point values
M={M[0,],M[1,]...M[15,]}, then the modelview
transformation M(V,) does the following:
M(V,)=((M[0,] M[1,] M[2,] M[3,]), (M[4,] M[5,]
M[6,] M[7,]), (M[8,] M[9,] M[10,] M[11,]),
(M[12,] M[13,] M[14,] M[15,]),)×((V[0,]),
(V[1,]), (V[2,]), (V[3,]),)
Projection and texture transformations are similarly defined.
Calling 'glLoadTransposeMatrix' with matrix M is identical in
operation to 'glLoadMatrix' with M^T, where T represents the
transpose.
'GL_INVALID_OPERATION' is generated if 'glLoadTransposeMatrix' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glLogicOp opcode
Specify a logical pixel operation for color index rendering.
OPCODE
Specifies a symbolic constant that selects a logical
operation. The following symbols are accepted: 'GL_CLEAR',
'GL_SET', 'GL_COPY', 'GL_COPY_INVERTED', 'GL_NOOP',
'GL_INVERT', 'GL_AND', 'GL_NAND', 'GL_OR', 'GL_NOR', 'GL_XOR',
'GL_EQUIV', 'GL_AND_REVERSE', 'GL_AND_INVERTED',
'GL_OR_REVERSE', and 'GL_OR_INVERTED'. The initial value is
'GL_COPY'.
'glLogicOp' specifies a logical operation that, when enabled, is
applied between the incoming color index or RGBA color and the
color index or RGBA color at the corresponding location in the
frame buffer. To enable or disable the logical operation, call
'glEnable' and 'glDisable' using the symbolic constant
'GL_COLOR_LOGIC_OP' for RGBA mode or 'GL_INDEX_LOGIC_OP' for color
index mode. The initial value is disabled for both operations.
*Opcode*
*Resulting Operation*
'GL_CLEAR'
0
'GL_SET'
1
'GL_COPY'
s
'GL_COPY_INVERTED'
~s
'GL_NOOP'
d
'GL_INVERT'
~d
'GL_AND'
s & d
'GL_NAND'
~(s & d)
'GL_OR'
s | d
'GL_NOR'
~(s | d)
'GL_XOR'
s ^ d
'GL_EQUIV'
~(s ^ d)
'GL_AND_REVERSE'
s & ~d
'GL_AND_INVERTED'
~s & d
'GL_OR_REVERSE'
s | ~d
'GL_OR_INVERTED'
~s | d
OPCODE is a symbolic constant chosen from the list above. In the
explanation of the logical operations, S represents the incoming
color index and D represents the index in the frame buffer.
Standard C-language operators are used. As these bitwise operators
suggest, the logical operation is applied independently to each bit
pair of the source and destination indices or colors.
'GL_INVALID_ENUM' is generated if OPCODE is not an accepted value.
'GL_INVALID_OPERATION' is generated if 'glLogicOp' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glMap1f target u1 u2 stride order points
-- Function: void glMap1d target u1 u2 stride order points
Define a one-dimensional evaluator.
TARGET
Specifies the kind of values that are generated by the
evaluator. Symbolic constants 'GL_MAP1_VERTEX_3',
'GL_MAP1_VERTEX_4', 'GL_MAP1_INDEX', 'GL_MAP1_COLOR_4',
'GL_MAP1_NORMAL', 'GL_MAP1_TEXTURE_COORD_1',
'GL_MAP1_TEXTURE_COORD_2', 'GL_MAP1_TEXTURE_COORD_3', and
'GL_MAP1_TEXTURE_COORD_4' are accepted.
U1
U2
Specify a linear mapping of U, as presented to 'glEvalCoord1',
to U^, the variable that is evaluated by the equations
specified by this command.
STRIDE
Specifies the number of floats or doubles between the
beginning of one control point and the beginning of the next
one in the data structure referenced in POINTS. This allows
control points to be embedded in arbitrary data structures.
The only constraint is that the values for a particular
control point must occupy contiguous memory locations.
ORDER
Specifies the number of control points. Must be positive.
POINTS
Specifies a pointer to the array of control points.
Evaluators provide a way to use polynomial or rational polynomial
mapping to produce vertices, normals, texture coordinates, and
colors. The values produced by an evaluator are sent to further
stages of GL processing just as if they had been presented using
'glVertex', 'glNormal', 'glTexCoord', and 'glColor' commands,
except that the generated values do not update the current normal,
texture coordinates, or color.
All polynomial or rational polynomial splines of any degree (up to
the maximum degree supported by the GL implementation) can be
described using evaluators. These include almost all splines used
in computer graphics: B-splines, Bezier curves, Hermite splines,
and so on.
Evaluators define curves based on Bernstein polynomials. Define
P(U^,) as
P(U^,)=ΣI=0NB_I,^N(U^,)R_I
where R_I is a control point and B_I,^N(U^,) is the Ith
Bernstein polynomial of degree N (ORDER = N+1):
B_I,^N(U^,)=((N), (I),,)U^,^I(1-U^,)^N-I,,
Recall that
0^0==1 and ((N), (0),,)==1
'glMap1' is used to define the basis and to specify what kind of
values are produced. Once defined, a map can be enabled and
disabled by calling 'glEnable' and 'glDisable' with the map name,
one of the nine predefined values for TARGET described below.
'glEvalCoord1' evaluates the one-dimensional maps that are enabled.
When 'glEvalCoord1' presents a value U, the Bernstein functions are
evaluated using U^, where U^=U-U1,/U2-U1,
TARGET is a symbolic constant that indicates what kind of control
points are provided in POINTS, and what output is generated when
the map is evaluated. It can assume one of nine predefined values:
'GL_MAP1_VERTEX_3'
Each control point is three floating-point values representing
X, Y, and Z. Internal 'glVertex3' commands are generated when
the map is evaluated.
'GL_MAP1_VERTEX_4'
Each control point is four floating-point values representing
X, Y, Z, and W. Internal 'glVertex4' commands are generated
when the map is evaluated.
'GL_MAP1_INDEX'
Each control point is a single floating-point value
representing a color index. Internal 'glIndex' commands are
generated when the map is evaluated but the current index is
not updated with the value of these 'glIndex' commands.
'GL_MAP1_COLOR_4'
Each control point is four floating-point values representing
red, green, blue, and alpha. Internal 'glColor4' commands are
generated when the map is evaluated but the current color is
not updated with the value of these 'glColor4' commands.
'GL_MAP1_NORMAL'
Each control point is three floating-point values representing
the X, Y, and Z components of a normal vector. Internal
'glNormal' commands are generated when the map is evaluated
but the current normal is not updated with the value of these
'glNormal' commands.
'GL_MAP1_TEXTURE_COORD_1'
Each control point is a single floating-point value
representing the S texture coordinate. Internal 'glTexCoord1'
commands are generated when the map is evaluated but the
current texture coordinates are not updated with the value of
these 'glTexCoord' commands.
'GL_MAP1_TEXTURE_COORD_2'
Each control point is two floating-point values representing
the S and T texture coordinates. Internal 'glTexCoord2'
commands are generated when the map is evaluated but the
current texture coordinates are not updated with the value of
these 'glTexCoord' commands.
'GL_MAP1_TEXTURE_COORD_3'
Each control point is three floating-point values representing
the S, T, and R texture coordinates. Internal 'glTexCoord3'
commands are generated when the map is evaluated but the
current texture coordinates are not updated with the value of
these 'glTexCoord' commands.
'GL_MAP1_TEXTURE_COORD_4'
Each control point is four floating-point values representing
the S, T, R, and Q texture coordinates. Internal
'glTexCoord4' commands are generated when the map is evaluated
but the current texture coordinates are not updated with the
value of these 'glTexCoord' commands.
STRIDE, ORDER, and POINTS define the array addressing for accessing
the control points. POINTS is the location of the first control
point, which occupies one, two, three, or four contiguous memory
locations, depending on which map is being defined. ORDER is the
number of control points in the array. STRIDE specifies how many
float or double locations to advance the internal memory pointer to
reach the next control point.
'GL_INVALID_ENUM' is generated if TARGET is not an accepted value.
'GL_INVALID_VALUE' is generated if U1 is equal to U2.
'GL_INVALID_VALUE' is generated if STRIDE is less than the number
of values in a control point.
'GL_INVALID_VALUE' is generated if ORDER is less than 1 or greater
than the return value of 'GL_MAX_EVAL_ORDER'.
'GL_INVALID_OPERATION' is generated if 'glMap1' is executed between
the execution of 'glBegin' and the corresponding execution of
'glEnd'.
'GL_INVALID_OPERATION' is generated if 'glMap1' is called and the
value of 'GL_ACTIVE_TEXTURE' is not 'GL_TEXTURE0'.
-- Function: void glMap2f target u1 u2 ustride uorder v1 v2 vstride
vorder points
-- Function: void glMap2d target u1 u2 ustride uorder v1 v2 vstride
vorder points
Define a two-dimensional evaluator.
TARGET
Specifies the kind of values that are generated by the
evaluator. Symbolic constants 'GL_MAP2_VERTEX_3',
'GL_MAP2_VERTEX_4', 'GL_MAP2_INDEX', 'GL_MAP2_COLOR_4',
'GL_MAP2_NORMAL', 'GL_MAP2_TEXTURE_COORD_1',
'GL_MAP2_TEXTURE_COORD_2', 'GL_MAP2_TEXTURE_COORD_3', and
'GL_MAP2_TEXTURE_COORD_4' are accepted.
U1
U2
Specify a linear mapping of U, as presented to 'glEvalCoord2',
to U^, one of the two variables that are evaluated by the
equations specified by this command. Initially, U1 is 0 and
U2 is 1.
USTRIDE
Specifies the number of floats or doubles between the
beginning of control point R_IJ and the beginning of control
point R_(I+1,)J,, where I and J are the U and V control
point indices, respectively. This allows control points to be
embedded in arbitrary data structures. The only constraint is
that the values for a particular control point must occupy
contiguous memory locations. The initial value of USTRIDE is
0.
UORDER
Specifies the dimension of the control point array in the U
axis. Must be positive. The initial value is 1.
V1
V2
Specify a linear mapping of V, as presented to 'glEvalCoord2',
to V^, one of the two variables that are evaluated by the
equations specified by this command. Initially, V1 is 0 and
V2 is 1.
VSTRIDE
Specifies the number of floats or doubles between the
beginning of control point R_IJ and the beginning of control
point R_I(J+1,),, where I and J are the U and V control
point indices, respectively. This allows control points to be
embedded in arbitrary data structures. The only constraint is
that the values for a particular control point must occupy
contiguous memory locations. The initial value of VSTRIDE is
0.
VORDER
Specifies the dimension of the control point array in the V
axis. Must be positive. The initial value is 1.
POINTS
Specifies a pointer to the array of control points.
Evaluators provide a way to use polynomial or rational polynomial
mapping to produce vertices, normals, texture coordinates, and
colors. The values produced by an evaluator are sent on to further
stages of GL processing just as if they had been presented using
'glVertex', 'glNormal', 'glTexCoord', and 'glColor' commands,
except that the generated values do not update the current normal,
texture coordinates, or color.
All polynomial or rational polynomial splines of any degree (up to
the maximum degree supported by the GL implementation) can be
described using evaluators. These include almost all surfaces used
in computer graphics, including B-spline surfaces, NURBS surfaces,
Bezier surfaces, and so on.
Evaluators define surfaces based on bivariate Bernstein
polynomials. Define P(U^,V^) as
P(U^,V^)=ΣI=0NΣJ=0MB_I,^N(U^,)B_J,^M(V^,)R_IJ
where R_IJ is a control point, B_I,^N(U^,) is the Ith Bernstein
polynomial of degree N (UORDER = N+1)
B_I,^N(U^,)=((N), (I),,)U^,^I(1-U^,)^N-I,,
and B_J,^M(V^,) is the Jth Bernstein polynomial of degree M
(VORDER = M+1)
B_J,^M(V^,)=((M), (J),,)V^,^J(1-V^,)^M-J,,
Recall that 0^0==1 and ((N), (0),,)==1
'glMap2' is used to define the basis and to specify what kind of
values are produced. Once defined, a map can be enabled and
disabled by calling 'glEnable' and 'glDisable' with the map name,
one of the nine predefined values for TARGET, described below.
When 'glEvalCoord2' presents values U and V, the bivariate
Bernstein polynomials are evaluated using U^ and V^, where
U^=U-U1,/U2-U1,
V^=V-V1,/V2-V1,
TARGET is a symbolic constant that indicates what kind of control
points are provided in POINTS, and what output is generated when
the map is evaluated. It can assume one of nine predefined values:
'GL_MAP2_VERTEX_3'
Each control point is three floating-point values representing
X, Y, and Z. Internal 'glVertex3' commands are generated when
the map is evaluated.
'GL_MAP2_VERTEX_4'
Each control point is four floating-point values representing
X, Y, Z, and W. Internal 'glVertex4' commands are generated
when the map is evaluated.
'GL_MAP2_INDEX'
Each control point is a single floating-point value
representing a color index. Internal 'glIndex' commands are
generated when the map is evaluated but the current index is
not updated with the value of these 'glIndex' commands.
'GL_MAP2_COLOR_4'
Each control point is four floating-point values representing
red, green, blue, and alpha. Internal 'glColor4' commands are
generated when the map is evaluated but the current color is
not updated with the value of these 'glColor4' commands.
'GL_MAP2_NORMAL'
Each control point is three floating-point values representing
the X, Y, and Z components of a normal vector. Internal
'glNormal' commands are generated when the map is evaluated
but the current normal is not updated with the value of these
'glNormal' commands.
'GL_MAP2_TEXTURE_COORD_1'
Each control point is a single floating-point value
representing the S texture coordinate. Internal 'glTexCoord1'
commands are generated when the map is evaluated but the
current texture coordinates are not updated with the value of
these 'glTexCoord' commands.
'GL_MAP2_TEXTURE_COORD_2'
Each control point is two floating-point values representing
the S and T texture coordinates. Internal 'glTexCoord2'
commands are generated when the map is evaluated but the
current texture coordinates are not updated with the value of
these 'glTexCoord' commands.
'GL_MAP2_TEXTURE_COORD_3'
Each control point is three floating-point values representing
the S, T, and R texture coordinates. Internal 'glTexCoord3'
commands are generated when the map is evaluated but the
current texture coordinates are not updated with the value of
these 'glTexCoord' commands.
'GL_MAP2_TEXTURE_COORD_4'
Each control point is four floating-point values representing
the S, T, R, and Q texture coordinates. Internal
'glTexCoord4' commands are generated when the map is evaluated
but the current texture coordinates are not updated with the
value of these 'glTexCoord' commands.
USTRIDE, UORDER, VSTRIDE, VORDER, and POINTS define the array
addressing for accessing the control points. POINTS is the
location of the first control point, which occupies one, two,
three, or four contiguous memory locations, depending on which map
is being defined. There are UORDER×VORDER control points in the
array. USTRIDE specifies how many float or double locations are
skipped to advance the internal memory pointer from control point
R_IJ, to control point R_(I+1,)J,. VSTRIDE specifies how
many float or double locations are skipped to advance the internal
memory pointer from control point R_IJ, to control point
R_I(J+1,),.
'GL_INVALID_ENUM' is generated if TARGET is not an accepted value.
'GL_INVALID_VALUE' is generated if U1 is equal to U2, or if V1 is
equal to V2.
'GL_INVALID_VALUE' is generated if either USTRIDE or VSTRIDE is
less than the number of values in a control point.
'GL_INVALID_VALUE' is generated if either UORDER or VORDER is less
than 1 or greater than the return value of 'GL_MAX_EVAL_ORDER'.
'GL_INVALID_OPERATION' is generated if 'glMap2' is executed between
the execution of 'glBegin' and the corresponding execution of
'glEnd'.
'GL_INVALID_OPERATION' is generated if 'glMap2' is called and the
value of 'GL_ACTIVE_TEXTURE' is not 'GL_TEXTURE0'.
-- Function: void-* glMapBuffer target access
-- Function: GLboolean glUnmapBuffer target
Map a buffer object's data store.
TARGET
Specifies the target buffer object being mapped. The symbolic
constant must be 'GL_ARRAY_BUFFER', 'GL_ELEMENT_ARRAY_BUFFER',
'GL_PIXEL_PACK_BUFFER', or 'GL_PIXEL_UNPACK_BUFFER'.
ACCESS
Specifies the access policy, indicating whether it will be
possible to read from, write to, or both read from and write
to the buffer object's mapped data store. The symbolic
constant must be 'GL_READ_ONLY', 'GL_WRITE_ONLY', or
'GL_READ_WRITE'.
'glMapBuffer' maps to the client's address space the entire data
store of the buffer object currently bound to TARGET. The data can
then be directly read and/or written relative to the returned
pointer, depending on the specified ACCESS policy. If the GL is
unable to map the buffer object's data store, 'glMapBuffer'
generates an error and returns 'NULL'. This may occur for
system-specific reasons, such as low virtual memory availability.
If a mapped data store is accessed in a way inconsistent with the
specified ACCESS policy, no error is generated, but performance may
be negatively impacted and system errors, including program
termination, may result. Unlike the USAGE parameter of
'glBufferData', ACCESS is not a hint, and does in fact constrain
the usage of the mapped data store on some GL implementations. In
order to achieve the highest performance available, a buffer
object's data store should be used in ways consistent with both its
specified USAGE and ACCESS parameters.
A mapped data store must be unmapped with 'glUnmapBuffer' before
its buffer object is used. Otherwise an error will be generated by
any GL command that attempts to dereference the buffer object's
data store. When a data store is unmapped, the pointer to its data
store becomes invalid. 'glUnmapBuffer' returns 'GL_TRUE' unless
the data store contents have become corrupt during the time the
data store was mapped. This can occur for system-specific reasons
that affect the availability of graphics memory, such as screen
mode changes. In such situations, 'GL_FALSE' is returned and the
data store contents are undefined. An application must detect this
rare condition and reinitialize the data store.
A buffer object's mapped data store is automatically unmapped when
the buffer object is deleted or its data store is recreated with
'glBufferData'.
'GL_INVALID_ENUM' is generated if TARGET is not 'GL_ARRAY_BUFFER',
'GL_ELEMENT_ARRAY_BUFFER', 'GL_PIXEL_PACK_BUFFER', or
'GL_PIXEL_UNPACK_BUFFER'.
'GL_INVALID_ENUM' is generated if ACCESS is not 'GL_READ_ONLY',
'GL_WRITE_ONLY', or 'GL_READ_WRITE'.
'GL_OUT_OF_MEMORY' is generated when 'glMapBuffer' is executed if
the GL is unable to map the buffer object's data store. This may
occur for a variety of system-specific reasons, such as the absence
of sufficient remaining virtual memory.
'GL_INVALID_OPERATION' is generated if the reserved buffer object
name 0 is bound to TARGET.
'GL_INVALID_OPERATION' is generated if 'glMapBuffer' is executed
for a buffer object whose data store is already mapped.
'GL_INVALID_OPERATION' is generated if 'glUnmapBuffer' is executed
for a buffer object whose data store is not currently mapped.
'GL_INVALID_OPERATION' is generated if 'glMapBuffer' or
'glUnmapBuffer' is executed between the execution of 'glBegin' and
the corresponding execution of 'glEnd'.
-- Function: void glMapGrid1d un u1 u2
-- Function: void glMapGrid1f un u1 u2
-- Function: void glMapGrid2d un u1 u2 vn v1 v2
-- Function: void glMapGrid2f un u1 u2 vn v1 v2
Define a one- or two-dimensional mesh.
UN
Specifies the number of partitions in the grid range interval
[U1, U2]. Must be positive.
U1
U2
Specify the mappings for integer grid domain values I=0 and
I=UN.
VN
Specifies the number of partitions in the grid range interval
[V1, V2] ('glMapGrid2' only).
V1
V2
Specify the mappings for integer grid domain values J=0 and
J=VN ('glMapGrid2' only).
'glMapGrid' and 'glEvalMesh' are used together to efficiently
generate and evaluate a series of evenly-spaced map domain values.
'glEvalMesh' steps through the integer domain of a one- or
two-dimensional grid, whose range is the domain of the evaluation
maps specified by 'glMap1' and 'glMap2'.
'glMapGrid1' and 'glMapGrid2' specify the linear grid mappings
between the I (or I and J) integer grid coordinates, to the U (or U
and V) floating-point evaluation map coordinates. See 'glMap1' and
'glMap2' for details of how U and V coordinates are evaluated.
'glMapGrid1' specifies a single linear mapping such that integer
grid coordinate 0 maps exactly to U1, and integer grid coordinate
UN maps exactly to U2. All other integer grid coordinates I are
mapped so that
U=I(U2-U1,)/UN+U1
'glMapGrid2' specifies two such linear mappings. One maps integer
grid coordinate I=0 exactly to U1, and integer grid coordinate I=UN
exactly to U2. The other maps integer grid coordinate J=0 exactly
to V1, and integer grid coordinate J=VN exactly to V2. Other
integer grid coordinates I and J are mapped such that
U=I(U2-U1,)/UN+U1
V=J(V2-V1,)/VN+V1
The mappings specified by 'glMapGrid' are used identically by
'glEvalMesh' and 'glEvalPoint'.
'GL_INVALID_VALUE' is generated if either UN or VN is not positive.
'GL_INVALID_OPERATION' is generated if 'glMapGrid' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glMaterialf face pname param
-- Function: void glMateriali face pname param
-- Function: void glMaterialfv face pname params
-- Function: void glMaterialiv face pname params
Specify material parameters for the lighting model.
FACE
Specifies which face or faces are being updated. Must be one
of 'GL_FRONT', 'GL_BACK', or 'GL_FRONT_AND_BACK'.
PNAME
Specifies the single-valued material parameter of the face or
faces that is being updated. Must be 'GL_SHININESS'.
PARAM
Specifies the value that parameter 'GL_SHININESS' will be set
to.
'glMaterial' assigns values to material parameters. There are two
matched sets of material parameters. One, the FRONT-FACING set, is
used to shade points, lines, bitmaps, and all polygons (when
two-sided lighting is disabled), or just front-facing polygons
(when two-sided lighting is enabled). The other set, BACK-FACING,
is used to shade back-facing polygons only when two-sided lighting
is enabled. Refer to the 'glLightModel' reference page for details
concerning one- and two-sided lighting calculations.
'glMaterial' takes three arguments. The first, FACE, specifies
whether the 'GL_FRONT' materials, the 'GL_BACK' materials, or both
'GL_FRONT_AND_BACK' materials will be modified. The second, PNAME,
specifies which of several parameters in one or both sets will be
modified. The third, PARAMS, specifies what value or values will
be assigned to the specified parameter.
Material parameters are used in the lighting equation that is
optionally applied to each vertex. The equation is discussed in
the 'glLightModel' reference page. The parameters that can be
specified using 'glMaterial', and their interpretations by the
lighting equation, are as follows:
'GL_AMBIENT'
PARAMS contains four integer or floating-point values that
specify the ambient RGBA reflectance of the material. Integer
values are mapped linearly such that the most positive
representable value maps to 1.0, and the most negative
representable value maps to -1.0. Floating-point values are
mapped directly. Neither integer nor floating-point values
are clamped. The initial ambient reflectance for both front-
and back-facing materials is (0.2, 0.2, 0.2, 1.0).
'GL_DIFFUSE'
PARAMS contains four integer or floating-point values that
specify the diffuse RGBA reflectance of the material. Integer
values are mapped linearly such that the most positive
representable value maps to 1.0, and the most negative
representable value maps to -1.0. Floating-point values are
mapped directly. Neither integer nor floating-point values
are clamped. The initial diffuse reflectance for both front-
and back-facing materials is (0.8, 0.8, 0.8, 1.0).
'GL_SPECULAR'
PARAMS contains four integer or floating-point values that
specify the specular RGBA reflectance of the material.
Integer values are mapped linearly such that the most positive
representable value maps to 1.0, and the most negative
representable value maps to -1.0. Floating-point values are
mapped directly. Neither integer nor floating-point values
are clamped. The initial specular reflectance for both front-
and back-facing materials is (0, 0, 0, 1).
'GL_EMISSION'
PARAMS contains four integer or floating-point values that
specify the RGBA emitted light intensity of the material.
Integer values are mapped linearly such that the most positive
representable value maps to 1.0, and the most negative
representable value maps to -1.0. Floating-point values are
mapped directly. Neither integer nor floating-point values
are clamped. The initial emission intensity for both front-
and back-facing materials is (0, 0, 0, 1).
'GL_SHININESS'
PARAMS is a single integer or floating-point value that
specifies the RGBA specular exponent of the material. Integer
and floating-point values are mapped directly. Only values in
the range [0,128] are accepted. The initial specular exponent
for both front- and back-facing materials is 0.
'GL_AMBIENT_AND_DIFFUSE'
Equivalent to calling 'glMaterial' twice with the same
parameter values, once with 'GL_AMBIENT' and once with
'GL_DIFFUSE'.
'GL_COLOR_INDEXES'
PARAMS contains three integer or floating-point values
specifying the color indices for ambient, diffuse, and
specular lighting. These three values, and 'GL_SHININESS',
are the only material values used by the color index mode
lighting equation. Refer to the 'glLightModel' reference page
for a discussion of color index lighting.
'GL_INVALID_ENUM' is generated if either FACE or PNAME is not an
accepted value.
'GL_INVALID_VALUE' is generated if a specular exponent outside the
range [0,128] is specified.
-- Function: void glMatrixMode mode
Specify which matrix is the current matrix.
MODE
Specifies which matrix stack is the target for subsequent
matrix operations. Three values are accepted: 'GL_MODELVIEW',
'GL_PROJECTION', and 'GL_TEXTURE'. The initial value is
'GL_MODELVIEW'. Additionally, if the 'ARB_imaging' extension
is supported, 'GL_COLOR' is also accepted.
'glMatrixMode' sets the current matrix mode. MODE can assume one
of four values:
'GL_MODELVIEW'
Applies subsequent matrix operations to the modelview matrix
stack.
'GL_PROJECTION'
Applies subsequent matrix operations to the projection matrix
stack.
'GL_TEXTURE'
Applies subsequent matrix operations to the texture matrix
stack.
'GL_COLOR'
Applies subsequent matrix operations to the color matrix
stack.
To find out which matrix stack is currently the target of all
matrix operations, call 'glGet' with argument 'GL_MATRIX_MODE'.
The initial value is 'GL_MODELVIEW'.
'GL_INVALID_ENUM' is generated if MODE is not an accepted value.
'GL_INVALID_OPERATION' is generated if 'glMatrixMode' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glMinmax target internalformat sink
Define minmax table.
TARGET
The minmax table whose parameters are to be set. Must be
'GL_MINMAX'.
INTERNALFORMAT
The format of entries in the minmax table. Must be one of
'GL_ALPHA', 'GL_ALPHA4', 'GL_ALPHA8', 'GL_ALPHA12',
'GL_ALPHA16', 'GL_LUMINANCE', 'GL_LUMINANCE4',
'GL_LUMINANCE8', 'GL_LUMINANCE12', 'GL_LUMINANCE16',
'GL_LUMINANCE_ALPHA', 'GL_LUMINANCE4_ALPHA4',
'GL_LUMINANCE6_ALPHA2', 'GL_LUMINANCE8_ALPHA8',
'GL_LUMINANCE12_ALPHA4', 'GL_LUMINANCE12_ALPHA12',
'GL_LUMINANCE16_ALPHA16', 'GL_R3_G3_B2', 'GL_RGB', 'GL_RGB4',
'GL_RGB5', 'GL_RGB8', 'GL_RGB10', 'GL_RGB12', 'GL_RGB16',
'GL_RGBA', 'GL_RGBA2', 'GL_RGBA4', 'GL_RGB5_A1', 'GL_RGBA8',
'GL_RGB10_A2', 'GL_RGBA12', or 'GL_RGBA16'.
SINK
If 'GL_TRUE', pixels will be consumed by the minmax process
and no drawing or texture loading will take place. If
'GL_FALSE', pixels will proceed to the final conversion
process after minmax.
When 'GL_MINMAX' is enabled, the RGBA components of incoming pixels
are compared to the minimum and maximum values for each component,
which are stored in the two-element minmax table. (The first
element stores the minima, and the second element stores the
maxima.) If a pixel component is greater than the corresponding
component in the maximum element, then the maximum element is
updated with the pixel component value. If a pixel component is
less than the corresponding component in the minimum element, then
the minimum element is updated with the pixel component value. (In
both cases, if the internal format of the minmax table includes
luminance, then the R color component of incoming pixels is used
for comparison.) The contents of the minmax table may be retrieved
at a later time by calling 'glGetMinmax'. The minmax operation is
enabled or disabled by calling 'glEnable' or 'glDisable',
respectively, with an argument of 'GL_MINMAX'.
'glMinmax' redefines the current minmax table to have entries of
the format specified by INTERNALFORMAT. The maximum element is
initialized with the smallest possible component values, and the
minimum element is initialized with the largest possible component
values. The values in the previous minmax table, if any, are lost.
If SINK is 'GL_TRUE', then pixels are discarded after minmax; no
further processing of the pixels takes place, and no drawing,
texture loading, or pixel readback will result.
'GL_INVALID_ENUM' is generated if TARGET is not one of the
allowable values.
'GL_INVALID_ENUM' is generated if INTERNALFORMAT is not one of the
allowable values.
'GL_INVALID_OPERATION' is generated if 'glMinmax' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glMultiDrawArrays mode first count primcount
Render multiple sets of primitives from array data.
MODE
Specifies what kind of primitives to render. Symbolic
constants 'GL_POINTS', 'GL_LINE_STRIP', 'GL_LINE_LOOP',
'GL_LINES', 'GL_TRIANGLE_STRIP', 'GL_TRIANGLE_FAN',
'GL_TRIANGLES', 'GL_QUAD_STRIP', 'GL_QUADS', and 'GL_POLYGON'
are accepted.
FIRST
Points to an array of starting indices in the enabled arrays.
COUNT
Points to an array of the number of indices to be rendered.
PRIMCOUNT
Specifies the size of the first and count
'glMultiDrawArrays' specifies multiple sets of geometric primitives
with very few subroutine calls. Instead of calling a GL procedure
to pass each individual vertex, normal, texture coordinate, edge
flag, or color, you can prespecify separate arrays of vertices,
normals, and colors and use them to construct a sequence of
primitives with a single call to 'glMultiDrawArrays'.
'glMultiDrawArrays' behaves identically to 'glDrawArrays' except
that PRIMCOUNT separate ranges of elements are specified instead.
When 'glMultiDrawArrays' is called, it uses COUNT sequential
elements from each enabled array to construct a sequence of
geometric primitives, beginning with element FIRST. MODE specifies
what kind of primitives are constructed, and how the array elements
construct those primitives. If 'GL_VERTEX_ARRAY' is not enabled,
no geometric primitives are generated.
Vertex attributes that are modified by 'glMultiDrawArrays' have an
unspecified value after 'glMultiDrawArrays' returns. For example,
if 'GL_COLOR_ARRAY' is enabled, the value of the current color is
undefined after 'glMultiDrawArrays' executes. Attributes that
aren't modified remain well defined.
'GL_INVALID_ENUM' is generated if MODE is not an accepted value.
'GL_INVALID_VALUE' is generated if PRIMCOUNT is negative.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to an enabled array and the buffer object's data
store is currently mapped.
'GL_INVALID_OPERATION' is generated if 'glMultiDrawArrays' is
executed between the execution of 'glBegin' and the corresponding
'glEnd'.
-- Function: void glMultiDrawElements mode count type indices primcount
Render multiple sets of primitives by specifying indices of array
data elements.
MODE
Specifies what kind of primitives to render. Symbolic
constants 'GL_POINTS', 'GL_LINE_STRIP', 'GL_LINE_LOOP',
'GL_LINES', 'GL_TRIANGLE_STRIP', 'GL_TRIANGLE_FAN',
'GL_TRIANGLES', 'GL_QUAD_STRIP', 'GL_QUADS', and 'GL_POLYGON'
are accepted.
COUNT
Points to an array of the elements counts.
TYPE
Specifies the type of the values in INDICES. Must be one of
'GL_UNSIGNED_BYTE', 'GL_UNSIGNED_SHORT', or 'GL_UNSIGNED_INT'.
INDICES
Specifies a pointer to the location where the indices are
stored.
PRIMCOUNT
Specifies the size of the COUNT array.
'glMultiDrawElements' specifies multiple sets of geometric
primitives with very few subroutine calls. Instead of calling a GL
function to pass each individual vertex, normal, texture
coordinate, edge flag, or color, you can prespecify separate arrays
of vertices, normals, and so on, and use them to construct a
sequence of primitives with a single call to 'glMultiDrawElements'.
'glMultiDrawElements' is identical in operation to 'glDrawElements'
except that PRIMCOUNT separate lists of elements are specified.
Vertex attributes that are modified by 'glMultiDrawElements' have
an unspecified value after 'glMultiDrawElements' returns. For
example, if 'GL_COLOR_ARRAY' is enabled, the value of the current
color is undefined after 'glMultiDrawElements' executes.
Attributes that aren't modified maintain their previous values.
'GL_INVALID_ENUM' is generated if MODE is not an accepted value.
'GL_INVALID_VALUE' is generated if PRIMCOUNT is negative.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to an enabled array or the element array and the
buffer object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if 'glMultiDrawElements' is
executed between the execution of 'glBegin' and the corresponding
'glEnd'.
-- Function: void glMultiTexCoord1s target s
-- Function: void glMultiTexCoord1i target s
-- Function: void glMultiTexCoord1f target s
-- Function: void glMultiTexCoord1d target s
-- Function: void glMultiTexCoord2s target s t
-- Function: void glMultiTexCoord2i target s t
-- Function: void glMultiTexCoord2f target s t
-- Function: void glMultiTexCoord2d target s t
-- Function: void glMultiTexCoord3s target s t r
-- Function: void glMultiTexCoord3i target s t r
-- Function: void glMultiTexCoord3f target s t r
-- Function: void glMultiTexCoord3d target s t r
-- Function: void glMultiTexCoord4s target s t r q
-- Function: void glMultiTexCoord4i target s t r q
-- Function: void glMultiTexCoord4f target s t r q
-- Function: void glMultiTexCoord4d target s t r q
-- Function: void glMultiTexCoord1sv target v
-- Function: void glMultiTexCoord1iv target v
-- Function: void glMultiTexCoord1fv target v
-- Function: void glMultiTexCoord1dv target v
-- Function: void glMultiTexCoord2sv target v
-- Function: void glMultiTexCoord2iv target v
-- Function: void glMultiTexCoord2fv target v
-- Function: void glMultiTexCoord2dv target v
-- Function: void glMultiTexCoord3sv target v
-- Function: void glMultiTexCoord3iv target v
-- Function: void glMultiTexCoord3fv target v
-- Function: void glMultiTexCoord3dv target v
-- Function: void glMultiTexCoord4sv target v
-- Function: void glMultiTexCoord4iv target v
-- Function: void glMultiTexCoord4fv target v
-- Function: void glMultiTexCoord4dv target v
Set the current texture coordinates.
TARGET
Specifies the texture unit whose coordinates should be
modified. The number of texture units is implementation
dependent, but must be at least two. Symbolic constant must
be one of 'GL_TEXTURE'I, where i ranges from 0 to
'GL_MAX_TEXTURE_COORDS' - 1, which is an
implementation-dependent value.
S
T
R
Q
Specify S, T, R, and Q texture coordinates for TARGET texture
unit. Not all parameters are present in all forms of the
command.
'glMultiTexCoord' specifies texture coordinates in one, two, three,
or four dimensions. 'glMultiTexCoord1' sets the current texture
coordinates to (S,001); a call to 'glMultiTexCoord2' sets them to
(S,T01). Similarly, 'glMultiTexCoord3' specifies the texture
coordinates as (S,TR1), and 'glMultiTexCoord4' defines all four
components explicitly as (S,TRQ).
The current texture coordinates are part of the data that is
associated with each vertex and with the current raster position.
Initially, the values for (S,TRQ) are (0,001).
-- Function: void glMultMatrixd m
-- Function: void glMultMatrixf m
Multiply the current matrix with the specified matrix.
M
Points to 16 consecutive values that are used as the elements
of a 4×4 column-major matrix.
'glMultMatrix' multiplies the current matrix with the one specified
using M, and replaces the current matrix with the product.
The current matrix is determined by the current matrix mode (see
'glMatrixMode'). It is either the projection matrix, modelview
matrix, or the texture matrix.
'GL_INVALID_OPERATION' is generated if 'glMultMatrix' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glMultTransposeMatrixd m
-- Function: void glMultTransposeMatrixf m
Multiply the current matrix with the specified row-major ordered
matrix.
M
Points to 16 consecutive values that are used as the elements
of a 4×4 row-major matrix.
'glMultTransposeMatrix' multiplies the current matrix with the one
specified using M, and replaces the current matrix with the
product.
The current matrix is determined by the current matrix mode (see
'glMatrixMode'). It is either the projection matrix, modelview
matrix, or the texture matrix.
'GL_INVALID_OPERATION' is generated if 'glMultTransposeMatrix' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glNewList list mode
-- Function: void glEndList
Create or replace a display list.
LIST
Specifies the display-list name.
MODE
Specifies the compilation mode, which can be 'GL_COMPILE' or
'GL_COMPILE_AND_EXECUTE'.
Display lists are groups of GL commands that have been stored for
subsequent execution. Display lists are created with 'glNewList'.
All subsequent commands are placed in the display list, in the
order issued, until 'glEndList' is called.
'glNewList' has two arguments. The first argument, LIST, is a
positive integer that becomes the unique name for the display list.
Names can be created and reserved with 'glGenLists' and tested for
uniqueness with 'glIsList'. The second argument, MODE, is a
symbolic constant that can assume one of two values:
'GL_COMPILE'
Commands are merely compiled.
'GL_COMPILE_AND_EXECUTE'
Commands are executed as they are compiled into the display
list.
Certain commands are not compiled into the display list but are
executed immediately, regardless of the display-list mode. These
commands are 'glAreTexturesResident', 'glColorPointer',
'glDeleteLists', 'glDeleteTextures', 'glDisableClientState',
'glEdgeFlagPointer', 'glEnableClientState', 'glFeedbackBuffer',
'glFinish', 'glFlush', 'glGenLists', 'glGenTextures',
'glIndexPointer', 'glInterleavedArrays', 'glIsEnabled', 'glIsList',
'glIsTexture', 'glNormalPointer', 'glPopClientAttrib',
'glPixelStore', 'glPushClientAttrib', 'glReadPixels',
'glRenderMode', 'glSelectBuffer', 'glTexCoordPointer',
'glVertexPointer', and all of the 'glGet' commands.
Similarly, 'glTexImage1D', 'glTexImage2D', and 'glTexImage3D' are
executed immediately and not compiled into the display list when
their first argument is 'GL_PROXY_TEXTURE_1D',
'GL_PROXY_TEXTURE_1D', or 'GL_PROXY_TEXTURE_3D', respectively.
When the 'ARB_imaging' extension is supported, 'glHistogram'
executes immediately when its argument is 'GL_PROXY_HISTOGRAM'.
Similarly, 'glColorTable' executes immediately when its first
argument is 'GL_PROXY_COLOR_TABLE',
'GL_PROXY_POST_CONVOLUTION_COLOR_TABLE', or
'GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE'.
For OpenGL versions 1.3 and greater, or when the 'ARB_multitexture'
extension is supported, 'glClientActiveTexture' is not compiled
into display lists, but executed immediately.
When 'glEndList' is encountered, the display-list definition is
completed by associating the list with the unique name LIST
(specified in the 'glNewList' command). If a display list with
name LIST already exists, it is replaced only when 'glEndList' is
called.
'GL_INVALID_VALUE' is generated if LIST is 0.
'GL_INVALID_ENUM' is generated if MODE is not an accepted value.
'GL_INVALID_OPERATION' is generated if 'glEndList' is called
without a preceding 'glNewList', or if 'glNewList' is called while
a display list is being defined.
'GL_INVALID_OPERATION' is generated if 'glNewList' or 'glEndList'
is executed between the execution of 'glBegin' and the
corresponding execution of 'glEnd'.
'GL_OUT_OF_MEMORY' is generated if there is insufficient memory to
compile the display list. If the GL version is 1.1 or greater, no
change is made to the previous contents of the display list, if
any, and no other change is made to the GL state. (It is as if no
attempt had been made to create the new display list.)
-- Function: void glNormalPointer type stride pointer
Define an array of normals.
TYPE
Specifies the data type of each coordinate in the array.
Symbolic constants 'GL_BYTE', 'GL_SHORT', 'GL_INT',
'GL_FLOAT', and 'GL_DOUBLE' are accepted. The initial value
is 'GL_FLOAT'.
STRIDE
Specifies the byte offset between consecutive normals. If
STRIDE is 0, the normals are understood to be tightly packed
in the array. The initial value is 0.
POINTER
Specifies a pointer to the first coordinate of the first
normal in the array. The initial value is 0.
'glNormalPointer' specifies the location and data format of an
array of normals to use when rendering. TYPE specifies the data
type of each normal coordinate, and STRIDE specifies the byte
stride from one normal to the next, allowing vertices and
attributes to be packed into a single array or stored in separate
arrays. (Single-array storage may be more efficient on some
implementations; see 'glInterleavedArrays'.)
If a non-zero named buffer object is bound to the 'GL_ARRAY_BUFFER'
target (see 'glBindBuffer') while a normal array is specified,
POINTER is treated as a byte offset into the buffer object's data
store. Also, the buffer object binding ('GL_ARRAY_BUFFER_BINDING')
is saved as normal vertex array client-side state
('GL_NORMAL_ARRAY_BUFFER_BINDING').
When a normal array is specified, TYPE, STRIDE, and POINTER are
saved as client-side state, in addition to the current vertex array
buffer object binding.
To enable and disable the normal array, call 'glEnableClientState'
and 'glDisableClientState' with the argument 'GL_NORMAL_ARRAY'. If
enabled, the normal array is used when 'glDrawArrays',
'glMultiDrawArrays', 'glDrawElements', 'glMultiDrawElements',
'glDrawRangeElements', or 'glArrayElement' is called.
'GL_INVALID_ENUM' is generated if TYPE is not an accepted value.
'GL_INVALID_VALUE' is generated if STRIDE is negative.
-- Function: void glNormal3b nx ny nz
-- Function: void glNormal3d nx ny nz
-- Function: void glNormal3f nx ny nz
-- Function: void glNormal3i nx ny nz
-- Function: void glNormal3s nx ny nz
-- Function: void glNormal3bv v
-- Function: void glNormal3dv v
-- Function: void glNormal3fv v
-- Function: void glNormal3iv v
-- Function: void glNormal3sv v
Set the current normal vector.
NX
NY
NZ
Specify the X, Y, and Z coordinates of the new current normal.
The initial value of the current normal is the unit vector,
(0, 0, 1).
The current normal is set to the given coordinates whenever
'glNormal' is issued. Byte, short, or integer arguments are
converted to floating-point format with a linear mapping that maps
the most positive representable integer value to 1.0 and the most
negative representable integer value to -1.0.
Normals specified with 'glNormal' need not have unit length. If
'GL_NORMALIZE' is enabled, then normals of any length specified
with 'glNormal' are normalized after transformation. If
'GL_RESCALE_NORMAL' is enabled, normals are scaled by a scaling
factor derived from the modelview matrix. 'GL_RESCALE_NORMAL'
requires that the originally specified normals were of unit length,
and that the modelview matrix contain only uniform scales for
proper results. To enable and disable normalization, call
'glEnable' and 'glDisable' with either 'GL_NORMALIZE' or
'GL_RESCALE_NORMAL'. Normalization is initially disabled.
-- Function: void glOrtho left right bottom top nearVal farVal
Multiply the current matrix with an orthographic matrix.
LEFT
RIGHT
Specify the coordinates for the left and right vertical
clipping planes.
BOTTOM
TOP
Specify the coordinates for the bottom and top horizontal
clipping planes.
NEARVAL
FARVAL
Specify the distances to the nearer and farther depth clipping
planes. These values are negative if the plane is to be
behind the viewer.
'glOrtho' describes a transformation that produces a parallel
projection. The current matrix (see 'glMatrixMode') is multiplied
by this matrix and the result replaces the current matrix, as if
'glMultMatrix' were called with the following matrix as its
argument:
((2/RIGHT-LEFT,, 0 0 T_X,), (0 2/TOP-BOTTOM,, 0 T_Y,), (0 0
-2/FARVAL-NEARVAL,, T_Z,), (0 0 0 1),)
where
T_X=-RIGHT+LEFT,/RIGHT-LEFT,,T_Y=-TOP+BOTTOM,/TOP-BOTTOM,,T_Z=-FARVAL+NEARVAL,/FARVAL-NEARVAL,,
Typically, the matrix mode is 'GL_PROJECTION', and
(LEFT,BOTTOM-NEARVAL) and (RIGHT,TOP-NEARVAL) specify the points on
the near clipping plane that are mapped to the lower left and upper
right corners of the window, respectively, assuming that the eye is
located at (0, 0, 0). -FARVAL specifies the location of the far
clipping plane. Both NEARVAL and FARVAL can be either positive or
negative.
Use 'glPushMatrix' and 'glPopMatrix' to save and restore the
current matrix stack.
'GL_INVALID_VALUE' is generated if LEFT = RIGHT, or BOTTOM = TOP,
or NEAR = FAR.
'GL_INVALID_OPERATION' is generated if 'glOrtho' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glPassThrough token
Place a marker in the feedback buffer.
TOKEN
Specifies a marker value to be placed in the feedback buffer
following a 'GL_PASS_THROUGH_TOKEN'.
Feedback is a GL render mode. The mode is selected by calling
'glRenderMode' with 'GL_FEEDBACK'. When the GL is in feedback
mode, no pixels are produced by rasterization. Instead,
information about primitives that would have been rasterized is fed
back to the application using the GL. See the 'glFeedbackBuffer'
reference page for a description of the feedback buffer and the
values in it.
'glPassThrough' inserts a user-defined marker in the feedback
buffer when it is executed in feedback mode. TOKEN is returned as
if it were a primitive; it is indicated with its own unique
identifying value: 'GL_PASS_THROUGH_TOKEN'. The order of
'glPassThrough' commands with respect to the specification of
graphics primitives is maintained.
'GL_INVALID_OPERATION' is generated if 'glPassThrough' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glPixelMapfv map mapsize values
-- Function: void glPixelMapuiv map mapsize values
-- Function: void glPixelMapusv map mapsize values
Set up pixel transfer maps.
MAP
Specifies a symbolic map name. Must be one of the following:
'GL_PIXEL_MAP_I_TO_I', 'GL_PIXEL_MAP_S_TO_S',
'GL_PIXEL_MAP_I_TO_R', 'GL_PIXEL_MAP_I_TO_G',
'GL_PIXEL_MAP_I_TO_B', 'GL_PIXEL_MAP_I_TO_A',
'GL_PIXEL_MAP_R_TO_R', 'GL_PIXEL_MAP_G_TO_G',
'GL_PIXEL_MAP_B_TO_B', or 'GL_PIXEL_MAP_A_TO_A'.
MAPSIZE
Specifies the size of the map being defined.
VALUES
Specifies an array of MAPSIZE values.
'glPixelMap' sets up translation tables, or MAPS, used by
'glCopyPixels', 'glCopyTexImage1D', 'glCopyTexImage2D',
'glCopyTexSubImage1D', 'glCopyTexSubImage2D',
'glCopyTexSubImage3D', 'glDrawPixels', 'glReadPixels',
'glTexImage1D', 'glTexImage2D', 'glTexImage3D', 'glTexSubImage1D',
'glTexSubImage2D', and 'glTexSubImage3D'. Additionally, if the
'ARB_imaging' subset is supported, the routines 'glColorTable',
'glColorSubTable', 'glConvolutionFilter1D',
'glConvolutionFilter2D', 'glHistogram', 'glMinmax', and
'glSeparableFilter2D'. Use of these maps is described completely
in the 'glPixelTransfer' reference page, and partly in the
reference pages for the pixel and texture image commands. Only the
specification of the maps is described in this reference page.
MAP is a symbolic map name, indicating one of ten maps to set.
MAPSIZE specifies the number of entries in the map, and VALUES is a
pointer to an array of MAPSIZE map values.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a pixel
transfer map is specified, VALUES is treated as a byte offset into
the buffer object's data store.
The ten maps are as follows:
'GL_PIXEL_MAP_I_TO_I'
Maps color indices to color indices.
'GL_PIXEL_MAP_S_TO_S'
Maps stencil indices to stencil indices.
'GL_PIXEL_MAP_I_TO_R'
Maps color indices to red components.
'GL_PIXEL_MAP_I_TO_G'
Maps color indices to green components.
'GL_PIXEL_MAP_I_TO_B'
Maps color indices to blue components.
'GL_PIXEL_MAP_I_TO_A'
Maps color indices to alpha components.
'GL_PIXEL_MAP_R_TO_R'
Maps red components to red components.
'GL_PIXEL_MAP_G_TO_G'
Maps green components to green components.
'GL_PIXEL_MAP_B_TO_B'
Maps blue components to blue components.
'GL_PIXEL_MAP_A_TO_A'
Maps alpha components to alpha components.
The entries in a map can be specified as single-precision
floating-point numbers, unsigned short integers, or unsigned int
integers. Maps that store color component values (all but
'GL_PIXEL_MAP_I_TO_I' and 'GL_PIXEL_MAP_S_TO_S') retain their
values in floating-point format, with unspecified mantissa and
exponent sizes. Floating-point values specified by 'glPixelMapfv'
are converted directly to the internal floating-point format of
these maps, then clamped to the range [0,1]. Unsigned integer
values specified by 'glPixelMapusv' and 'glPixelMapuiv' are
converted linearly such that the largest representable integer maps
to 1.0, and 0 maps to 0.0.
Maps that store indices, 'GL_PIXEL_MAP_I_TO_I' and
'GL_PIXEL_MAP_S_TO_S', retain their values in fixed-point format,
with an unspecified number of bits to the right of the binary
point. Floating-point values specified by 'glPixelMapfv' are
converted directly to the internal fixed-point format of these
maps. Unsigned integer values specified by 'glPixelMapusv' and
'glPixelMapuiv' specify integer values, with all 0's to the right
of the binary point.
The following table shows the initial sizes and values for each of
the maps. Maps that are indexed by either color or stencil indices
must have MAPSIZE = 2^N for some N or the results are undefined.
The maximum allowable size for each map depends on the
implementation and can be determined by calling 'glGet' with
argument 'GL_MAX_PIXEL_MAP_TABLE'. The single maximum applies to
all maps; it is at least 32.
*MAP*
*Lookup Index*, *Lookup Value*, *Initial Size*, *Initial
Value*
'GL_PIXEL_MAP_I_TO_I'
color index , color index , 1 , 0
'GL_PIXEL_MAP_S_TO_S'
stencil index , stencil index , 1 , 0
'GL_PIXEL_MAP_I_TO_R'
color index , R , 1 , 0
'GL_PIXEL_MAP_I_TO_G'
color index , G , 1 , 0
'GL_PIXEL_MAP_I_TO_B'
color index , B , 1 , 0
'GL_PIXEL_MAP_I_TO_A'
color index , A , 1 , 0
'GL_PIXEL_MAP_R_TO_R'
R , R , 1 , 0
'GL_PIXEL_MAP_G_TO_G'
G , G , 1 , 0
'GL_PIXEL_MAP_B_TO_B'
B , B , 1 , 0
'GL_PIXEL_MAP_A_TO_A'
A , A , 1 , 0
'GL_INVALID_ENUM' is generated if MAP is not an accepted value.
'GL_INVALID_VALUE' is generated if MAPSIZE is less than one or
larger than 'GL_MAX_PIXEL_MAP_TABLE'.
'GL_INVALID_VALUE' is generated if MAP is 'GL_PIXEL_MAP_I_TO_I',
'GL_PIXEL_MAP_S_TO_S', 'GL_PIXEL_MAP_I_TO_R',
'GL_PIXEL_MAP_I_TO_G', 'GL_PIXEL_MAP_I_TO_B', or
'GL_PIXEL_MAP_I_TO_A', and MAPSIZE is not a power of two.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated by 'glPixelMapfv' if a non-zero
buffer object name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target
and VALUES is not evenly divisible into the number of bytes needed
to store in memory a GLfloat datum.
'GL_INVALID_OPERATION' is generated by 'glPixelMapuiv' if a
non-zero buffer object name is bound to the
'GL_PIXEL_UNPACK_BUFFER' target and VALUES is not evenly divisible
into the number of bytes needed to store in memory a GLuint datum.
'GL_INVALID_OPERATION' is generated by 'glPixelMapusv' if a
non-zero buffer object name is bound to the
'GL_PIXEL_UNPACK_BUFFER' target and VALUES is not evenly divisible
into the number of bytes needed to store in memory a GLushort
datum.
'GL_INVALID_OPERATION' is generated if 'glPixelMap' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glPixelStoref pname param
-- Function: void glPixelStorei pname param
Set pixel storage modes.
PNAME
Specifies the symbolic name of the parameter to be set. Six
values affect the packing of pixel data into memory:
'GL_PACK_SWAP_BYTES', 'GL_PACK_LSB_FIRST',
'GL_PACK_ROW_LENGTH', 'GL_PACK_IMAGE_HEIGHT',
'GL_PACK_SKIP_PIXELS', 'GL_PACK_SKIP_ROWS',
'GL_PACK_SKIP_IMAGES', and 'GL_PACK_ALIGNMENT'. Six more
affect the unpacking of pixel data FROM memory:
'GL_UNPACK_SWAP_BYTES', 'GL_UNPACK_LSB_FIRST',
'GL_UNPACK_ROW_LENGTH', 'GL_UNPACK_IMAGE_HEIGHT',
'GL_UNPACK_SKIP_PIXELS', 'GL_UNPACK_SKIP_ROWS',
'GL_UNPACK_SKIP_IMAGES', and 'GL_UNPACK_ALIGNMENT'.
PARAM
Specifies the value that PNAME is set to.
'glPixelStore' sets pixel storage modes that affect the operation
of subsequent 'glDrawPixels' and 'glReadPixels' as well as the
unpacking of polygon stipple patterns (see 'glPolygonStipple'),
bitmaps (see 'glBitmap'), texture patterns (see 'glTexImage1D',
'glTexImage2D', 'glTexImage3D', 'glTexSubImage1D',
'glTexSubImage2D', 'glTexSubImage3D'). Additionally, if the
'ARB_imaging' extension is supported, pixel storage modes affect
convolution filters (see 'glConvolutionFilter1D',
'glConvolutionFilter2D', and 'glSeparableFilter2D', color table
(see 'glColorTable', and 'glColorSubTable', and unpacking histogram
(See 'glHistogram'), and minmax (See 'glMinmax') data.
PNAME is a symbolic constant indicating the parameter to be set,
and PARAM is the new value. Six of the twelve storage parameters
affect how pixel data is returned to client memory. They are as
follows:
'GL_PACK_SWAP_BYTES'
If true, byte ordering for multibyte color components, depth
components, color indices, or stencil indices is reversed.
That is, if a four-byte component consists of bytes B_0, B_1,
B_2, B_3, it is stored in memory as B_3, B_2, B_1, B_0 if
'GL_PACK_SWAP_BYTES' is true. 'GL_PACK_SWAP_BYTES' has no
effect on the memory order of components within a pixel, only
on the order of bytes within components or indices. For
example, the three components of a 'GL_RGB' format pixel are
always stored with red first, green second, and blue third,
regardless of the value of 'GL_PACK_SWAP_BYTES'.
'GL_PACK_LSB_FIRST'
If true, bits are ordered within a byte from least significant
to most significant; otherwise, the first bit in each byte is
the most significant one. This parameter is significant for
bitmap data only.
'GL_PACK_ROW_LENGTH'
If greater than 0, 'GL_PACK_ROW_LENGTH' defines the number of
pixels in a row. If the first pixel of a row is placed at
location P in memory, then the location of the first pixel of
the next row is obtained by skipping
K={(NL), (A/S,⌈SNL,/A,⌉)(S>=A), (S=A),
(S=A), (S=A),
(S=THRESHOLD),
(OTHERWISE),
The point alpha value is modified by computing:
POINTALPHA={(1),
((POINTSIZE/THRESHOLD,)^2)(POINTSIZE>=THRESHOLD), (OTHERWISE),
If point antialiasing is disabled, the actual size is determined by
rounding the supplied size to the nearest integer. (If the
rounding results in the value 0, it is as if the point size were
1.) If the rounded size is odd, then the center point (X, Y) of
the pixel fragment that represents the point is computed as
(⌊X_W,⌋+.5,⌊Y_W,⌋+.5)
where W subscripts indicate window coordinates. All pixels that
lie within the square grid of the rounded size centered at (X, Y)
make up the fragment. If the size is even, the center point is
(⌊X_W+.5,⌋,⌊Y_W+.5,⌋)
and the rasterized fragment's centers are the half-integer window
coordinates within the square of the rounded size centered at
(X,Y). All pixel fragments produced in rasterizing a
nonantialiased point are assigned the same associated data, that of
the vertex corresponding to the point.
If antialiasing is enabled, then point rasterization produces a
fragment for each pixel square that intersects the region lying
within the circle having diameter equal to the current point size
and centered at the point's (X_W,Y_W). The coverage value for each
fragment is the window coordinate area of the intersection of the
circular region with the corresponding pixel square. This value is
saved and used in the final rasterization step. The data
associated with each fragment is the data associated with the point
being rasterized.
Not all sizes are supported when point antialiasing is enabled. If
an unsupported size is requested, the nearest supported size is
used. Only size 1 is guaranteed to be supported; others depend on
the implementation. To query the range of supported sizes and the
size difference between supported sizes within the range, call
'glGet' with arguments 'GL_SMOOTH_POINT_SIZE_RANGE' and
'GL_SMOOTH_POINT_SIZE_GRANULARITY'. For aliased points, query the
supported ranges and granularity with 'glGet' with arguments
'GL_ALIASED_POINT_SIZE_RANGE'.
'GL_INVALID_VALUE' is generated if SIZE is less than or equal to 0.
'GL_INVALID_OPERATION' is generated if 'glPointSize' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glPolygonMode face mode
Select a polygon rasterization mode.
FACE
Specifies the polygons that MODE applies to. Must be
'GL_FRONT' for front-facing polygons, 'GL_BACK' for
back-facing polygons, or 'GL_FRONT_AND_BACK' for front- and
back-facing polygons.
MODE
Specifies how polygons will be rasterized. Accepted values
are 'GL_POINT', 'GL_LINE', and 'GL_FILL'. The initial value
is 'GL_FILL' for both front- and back-facing polygons.
'glPolygonMode' controls the interpretation of polygons for
rasterization. FACE describes which polygons MODE applies to:
front-facing polygons ('GL_FRONT'), back-facing polygons
('GL_BACK'), or both ('GL_FRONT_AND_BACK'). The polygon mode
affects only the final rasterization of polygons. In particular, a
polygon's vertices are lit and the polygon is clipped and possibly
culled before these modes are applied.
Three modes are defined and can be specified in MODE:
'GL_POINT'
Polygon vertices that are marked as the start of a boundary
edge are drawn as points. Point attributes such as
'GL_POINT_SIZE' and 'GL_POINT_SMOOTH' control the
rasterization of the points. Polygon rasterization attributes
other than 'GL_POLYGON_MODE' have no effect.
'GL_LINE'
Boundary edges of the polygon are drawn as line segments.
They are treated as connected line segments for line
stippling; the line stipple counter and pattern are not reset
between segments (see 'glLineStipple'). Line attributes such
as 'GL_LINE_WIDTH' and 'GL_LINE_SMOOTH' control the
rasterization of the lines. Polygon rasterization attributes
other than 'GL_POLYGON_MODE' have no effect.
'GL_FILL'
The interior of the polygon is filled. Polygon attributes
such as 'GL_POLYGON_STIPPLE' and 'GL_POLYGON_SMOOTH' control
the rasterization of the polygon.
'GL_INVALID_ENUM' is generated if either FACE or MODE is not an
accepted value.
'GL_INVALID_OPERATION' is generated if 'glPolygonMode' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glPolygonOffset factor units
Set the scale and units used to calculate depth values.
FACTOR
Specifies a scale factor that is used to create a variable
depth offset for each polygon. The initial value is 0.
UNITS
Is multiplied by an implementation-specific value to create a
constant depth offset. The initial value is 0.
When 'GL_POLYGON_OFFSET_FILL', 'GL_POLYGON_OFFSET_LINE', or
'GL_POLYGON_OFFSET_POINT' is enabled, each fragment's DEPTH value
will be offset after it is interpolated from the DEPTH values of
the appropriate vertices. The value of the offset is
FACTOR×DZ+R×UNITS, where DZ is a measurement of the change in
depth relative to the screen area of the polygon, and R is the
smallest value that is guaranteed to produce a resolvable offset
for a given implementation. The offset is added before the depth
test is performed and before the value is written into the depth
buffer.
'glPolygonOffset' is useful for rendering hidden-line images, for
applying decals to surfaces, and for rendering solids with
highlighted edges.
'GL_INVALID_OPERATION' is generated if 'glPolygonOffset' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glPolygonStipple pattern
Set the polygon stippling pattern.
PATTERN
Specifies a pointer to a 32×32 stipple pattern that will be
unpacked from memory in the same way that 'glDrawPixels'
unpacks pixels.
Polygon stippling, like line stippling (see 'glLineStipple'), masks
out certain fragments produced by rasterization, creating a
pattern. Stippling is independent of polygon antialiasing.
PATTERN is a pointer to a 32×32 stipple pattern that is stored in
memory just like the pixel data supplied to a 'glDrawPixels' call
with height and WIDTH both equal to 32, a pixel format of
'GL_COLOR_INDEX', and data type of 'GL_BITMAP'. That is, the
stipple pattern is represented as a 32×32 array of 1-bit color
indices packed in unsigned bytes. 'glPixelStore' parameters like
'GL_UNPACK_SWAP_BYTES' and 'GL_UNPACK_LSB_FIRST' affect the
assembling of the bits into a stipple pattern. Pixel transfer
operations (shift, offset, pixel map) are not applied to the
stipple image, however.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
stipple pattern is specified, PATTERN is treated as a byte offset
into the buffer object's data store.
To enable and disable polygon stippling, call 'glEnable' and
'glDisable' with argument 'GL_POLYGON_STIPPLE'. Polygon stippling
is initially disabled. If it's enabled, a rasterized polygon
fragment with window coordinates X_W and Y_W is sent to the next
stage of the GL if and only if the (X_W%32)th bit in the (Y_W%32)th
row of the stipple pattern is 1 (one). When polygon stippling is
disabled, it is as if the stipple pattern consists of all 1's.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if 'glPolygonStipple' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glPrioritizeTextures n textures priorities
Set texture residence priority.
N
Specifies the number of textures to be prioritized.
TEXTURES
Specifies an array containing the names of the textures to be
prioritized.
PRIORITIES
Specifies an array containing the texture priorities. A
priority given in an element of PRIORITIES applies to the
texture named by the corresponding element of TEXTURES.
'glPrioritizeTextures' assigns the N texture priorities given in
PRIORITIES to the N textures named in TEXTURES.
The GL establishes a "working set" of textures that are resident in
texture memory. These textures may be bound to a texture target
much more efficiently than textures that are not resident. By
specifying a priority for each texture, 'glPrioritizeTextures'
allows applications to guide the GL implementation in determining
which textures should be resident.
The priorities given in PRIORITIES are clamped to the range [0,1]
before they are assigned. 0 indicates the lowest priority;
textures with priority 0 are least likely to be resident. 1
indicates the highest priority; textures with priority 1 are most
likely to be resident. However, textures are not guaranteed to be
resident until they are used.
'glPrioritizeTextures' silently ignores attempts to prioritize
texture 0 or any texture name that does not correspond to an
existing texture.
'glPrioritizeTextures' does not require that any of the textures
named by TEXTURES be bound to a texture target. 'glTexParameter'
may also be used to set a texture's priority, but only if the
texture is currently bound. This is the only way to set the
priority of a default texture.
'GL_INVALID_VALUE' is generated if N is negative.
'GL_INVALID_OPERATION' is generated if 'glPrioritizeTextures' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glPushAttrib mask
-- Function: void glPopAttrib
Push and pop the server attribute stack.
MASK
Specifies a mask that indicates which attributes to save.
Values for MASK are listed below.
'glPushAttrib' takes one argument, a mask that indicates which
groups of state variables to save on the attribute stack. Symbolic
constants are used to set bits in the mask. MASK is typically
constructed by specifying the bitwise-or of several of these
constants together. The special mask 'GL_ALL_ATTRIB_BITS' can be
used to save all stackable states.
The symbolic mask constants and their associated GL state are as
follows (the second column lists which attributes are saved):
'GL_ACCUM_BUFFER_BIT'
Accumulation buffer clear value
'GL_COLOR_BUFFER_BIT'
'GL_ALPHA_TEST' enable bit
.
Alpha test function and reference value
.
'GL_BLEND' enable bit
.
Blending source and destination functions
.
Constant blend color
.
Blending equation
.
'GL_DITHER' enable bit
.
'GL_DRAW_BUFFER' setting
.
'GL_COLOR_LOGIC_OP' enable bit
.
'GL_INDEX_LOGIC_OP' enable bit
.
Logic op function
.
Color mode and index mode clear values
.
Color mode and index mode writemasks
'GL_CURRENT_BIT'
Current RGBA color
.
Current color index
.
Current normal vector
.
Current texture coordinates
.
Current raster position
.
'GL_CURRENT_RASTER_POSITION_VALID' flag
.
RGBA color associated with current raster position
.
Color index associated with current raster position
.
Texture coordinates associated with current raster position
.
'GL_EDGE_FLAG' flag
'GL_DEPTH_BUFFER_BIT'
'GL_DEPTH_TEST' enable bit
.
Depth buffer test function
.
Depth buffer clear value
.
'GL_DEPTH_WRITEMASK' enable bit
'GL_ENABLE_BIT'
'GL_ALPHA_TEST' flag
.
'GL_AUTO_NORMAL' flag
.
'GL_BLEND' flag
.
Enable bits for the user-definable clipping planes
.
'GL_COLOR_MATERIAL'
.
'GL_CULL_FACE' flag
.
'GL_DEPTH_TEST' flag
.
'GL_DITHER' flag
.
'GL_FOG' flag
.
'GL_LIGHT'I where '0' <= I < 'GL_MAX_LIGHTS'
.
'GL_LIGHTING' flag
.
'GL_LINE_SMOOTH' flag
.
'GL_LINE_STIPPLE' flag
.
'GL_COLOR_LOGIC_OP' flag
.
'GL_INDEX_LOGIC_OP' flag
.
'GL_MAP1_'X where X is a map type
.
'GL_MAP2_'X where X is a map type
.
'GL_MULTISAMPLE' flag
.
'GL_NORMALIZE' flag
.
'GL_POINT_SMOOTH' flag
.
'GL_POLYGON_OFFSET_LINE' flag
.
'GL_POLYGON_OFFSET_FILL' flag
.
'GL_POLYGON_OFFSET_POINT' flag
.
'GL_POLYGON_SMOOTH' flag
.
'GL_POLYGON_STIPPLE' flag
.
'GL_SAMPLE_ALPHA_TO_COVERAGE' flag
.
'GL_SAMPLE_ALPHA_TO_ONE' flag
.
'GL_SAMPLE_COVERAGE' flag
.
'GL_SCISSOR_TEST' flag
.
'GL_STENCIL_TEST' flag
.
'GL_TEXTURE_1D' flag
.
'GL_TEXTURE_2D' flag
.
'GL_TEXTURE_3D' flag
.
Flags 'GL_TEXTURE_GEN_'X where X is S, T, R, or Q
'GL_EVAL_BIT'
'GL_MAP1_'X enable bits, where X is a map type
.
'GL_MAP2_'X enable bits, where X is a map type
.
1D grid endpoints and divisions
.
2D grid endpoints and divisions
.
'GL_AUTO_NORMAL' enable bit
'GL_FOG_BIT'
'GL_FOG' enable bit
.
Fog color
.
Fog density
.
Linear fog start
.
Linear fog end
.
Fog index
.
'GL_FOG_MODE' value
'GL_HINT_BIT'
'GL_PERSPECTIVE_CORRECTION_HINT' setting
.
'GL_POINT_SMOOTH_HINT' setting
.
'GL_LINE_SMOOTH_HINT' setting
.
'GL_POLYGON_SMOOTH_HINT' setting
.
'GL_FOG_HINT' setting
.
'GL_GENERATE_MIPMAP_HINT' setting
.
'GL_TEXTURE_COMPRESSION_HINT' setting
'GL_LIGHTING_BIT'
'GL_COLOR_MATERIAL' enable bit
.
'GL_COLOR_MATERIAL_FACE' value
.
Color material parameters that are tracking the current color
.
Ambient scene color
.
'GL_LIGHT_MODEL_LOCAL_VIEWER' value
.
'GL_LIGHT_MODEL_TWO_SIDE' setting
.
'GL_LIGHTING' enable bit
.
Enable bit for each light
.
Ambient, diffuse, and specular intensity for each light
.
Direction, position, exponent, and cutoff angle for each light
.
Constant, linear, and quadratic attenuation factors for each
light
.
Ambient, diffuse, specular, and emissive color for each
material
.
Ambient, diffuse, and specular color indices for each material
.
Specular exponent for each material
.
'GL_SHADE_MODEL' setting
'GL_LINE_BIT'
'GL_LINE_SMOOTH' flag
.
'GL_LINE_STIPPLE' enable bit
.
Line stipple pattern and repeat counter
.
Line width
'GL_LIST_BIT'
'GL_LIST_BASE' setting
'GL_MULTISAMPLE_BIT'
'GL_MULTISAMPLE' flag
.
'GL_SAMPLE_ALPHA_TO_COVERAGE' flag
.
'GL_SAMPLE_ALPHA_TO_ONE' flag
.
'GL_SAMPLE_COVERAGE' flag
.
'GL_SAMPLE_COVERAGE_VALUE' value
.
'GL_SAMPLE_COVERAGE_INVERT' value
'GL_PIXEL_MODE_BIT'
'GL_RED_BIAS' and 'GL_RED_SCALE' settings
.
'GL_GREEN_BIAS' and 'GL_GREEN_SCALE' values
.
'GL_BLUE_BIAS' and 'GL_BLUE_SCALE'
.
'GL_ALPHA_BIAS' and 'GL_ALPHA_SCALE'
.
'GL_DEPTH_BIAS' and 'GL_DEPTH_SCALE'
.
'GL_INDEX_OFFSET' and 'GL_INDEX_SHIFT' values
.
'GL_MAP_COLOR' and 'GL_MAP_STENCIL' flags
.
'GL_ZOOM_X' and 'GL_ZOOM_Y' factors
.
'GL_READ_BUFFER' setting
'GL_POINT_BIT'
'GL_POINT_SMOOTH' flag
.
Point size
'GL_POLYGON_BIT'
'GL_CULL_FACE' enable bit
.
'GL_CULL_FACE_MODE' value
.
'GL_FRONT_FACE' indicator
.
'GL_POLYGON_MODE' setting
.
'GL_POLYGON_SMOOTH' flag
.
'GL_POLYGON_STIPPLE' enable bit
.
'GL_POLYGON_OFFSET_FILL' flag
.
'GL_POLYGON_OFFSET_LINE' flag
.
'GL_POLYGON_OFFSET_POINT' flag
.
'GL_POLYGON_OFFSET_FACTOR'
.
'GL_POLYGON_OFFSET_UNITS'
'GL_POLYGON_STIPPLE_BIT'
Polygon stipple image
'GL_SCISSOR_BIT'
'GL_SCISSOR_TEST' flag
.
Scissor box
'GL_STENCIL_BUFFER_BIT'
'GL_STENCIL_TEST' enable bit
.
Stencil function and reference value
.
Stencil value mask
.
Stencil fail, pass, and depth buffer pass actions
.
Stencil buffer clear value
.
Stencil buffer writemask
'GL_TEXTURE_BIT'
Enable bits for the four texture coordinates
.
Border color for each texture image
.
Minification function for each texture image
.
Magnification function for each texture image
.
Texture coordinates and wrap mode for each texture image
.
Color and mode for each texture environment
.
Enable bits 'GL_TEXTURE_GEN_'X, X is S, T, R, and Q
.
'GL_TEXTURE_GEN_MODE' setting for S, T, R, and Q
.
'glTexGen' plane equations for S, T, R, and Q
.
Current texture bindings (for example,
'GL_TEXTURE_BINDING_2D')
'GL_TRANSFORM_BIT'
Coefficients of the six clipping planes
.
Enable bits for the user-definable clipping planes
.
'GL_MATRIX_MODE' value
.
'GL_NORMALIZE' flag
.
'GL_RESCALE_NORMAL' flag
'GL_VIEWPORT_BIT'
Depth range (near and far)
.
Viewport origin and extent
'glPopAttrib' restores the values of the state variables saved with
the last 'glPushAttrib' command. Those not saved are left
unchanged.
It is an error to push attributes onto a full stack or to pop
attributes off an empty stack. In either case, the error flag is
set and no other change is made to GL state.
Initially, the attribute stack is empty.
'GL_STACK_OVERFLOW' is generated if 'glPushAttrib' is called while
the attribute stack is full.
'GL_STACK_UNDERFLOW' is generated if 'glPopAttrib' is called while
the attribute stack is empty.
'GL_INVALID_OPERATION' is generated if 'glPushAttrib' or
'glPopAttrib' is executed between the execution of 'glBegin' and
the corresponding execution of 'glEnd'.
-- Function: void glPushClientAttrib mask
-- Function: void glPopClientAttrib
Push and pop the client attribute stack.
MASK
Specifies a mask that indicates which attributes to save.
Values for MASK are listed below.
'glPushClientAttrib' takes one argument, a mask that indicates
which groups of client-state variables to save on the client
attribute stack. Symbolic constants are used to set bits in the
mask. MASK is typically constructed by specifying the bitwise-or
of several of these constants together. The special mask
'GL_CLIENT_ALL_ATTRIB_BITS' can be used to save all stackable
client state.
The symbolic mask constants and their associated GL client state
are as follows (the second column lists which attributes are
saved):
'GL_CLIENT_PIXEL_STORE_BIT' Pixel storage modes
'GL_CLIENT_VERTEX_ARRAY_BIT' Vertex arrays (and enables)
'glPopClientAttrib' restores the values of the client-state
variables saved with the last 'glPushClientAttrib'. Those not
saved are left unchanged.
It is an error to push attributes onto a full client attribute
stack or to pop attributes off an empty stack. In either case, the
error flag is set, and no other change is made to GL state.
Initially, the client attribute stack is empty.
'GL_STACK_OVERFLOW' is generated if 'glPushClientAttrib' is called
while the attribute stack is full.
'GL_STACK_UNDERFLOW' is generated if 'glPopClientAttrib' is called
while the attribute stack is empty.
-- Function: void glPushMatrix
-- Function: void glPopMatrix
Push and pop the current matrix stack.
There is a stack of matrices for each of the matrix modes. In
'GL_MODELVIEW' mode, the stack depth is at least 32. In the other
modes, 'GL_COLOR', 'GL_PROJECTION', and 'GL_TEXTURE', the depth is
at least 2. The current matrix in any mode is the matrix on the
top of the stack for that mode.
'glPushMatrix' pushes the current matrix stack down by one,
duplicating the current matrix. That is, after a 'glPushMatrix'
call, the matrix on top of the stack is identical to the one below
it.
'glPopMatrix' pops the current matrix stack, replacing the current
matrix with the one below it on the stack.
Initially, each of the stacks contains one matrix, an identity
matrix.
It is an error to push a full matrix stack or to pop a matrix stack
that contains only a single matrix. In either case, the error flag
is set and no other change is made to GL state.
'GL_STACK_OVERFLOW' is generated if 'glPushMatrix' is called while
the current matrix stack is full.
'GL_STACK_UNDERFLOW' is generated if 'glPopMatrix' is called while
the current matrix stack contains only a single matrix.
'GL_INVALID_OPERATION' is generated if 'glPushMatrix' or
'glPopMatrix' is executed between the execution of 'glBegin' and
the corresponding execution of 'glEnd'.
-- Function: void glPushName name
-- Function: void glPopName
Push and pop the name stack.
NAME
Specifies a name that will be pushed onto the name stack.
The name stack is used during selection mode to allow sets of
rendering commands to be uniquely identified. It consists of an
ordered set of unsigned integers and is initially empty.
'glPushName' causes NAME to be pushed onto the name stack.
'glPopName' pops one name off the top of the stack.
The maximum name stack depth is implementation-dependent; call
'GL_MAX_NAME_STACK_DEPTH' to find out the value for a particular
implementation. It is an error to push a name onto a full stack or
to pop a name off an empty stack. It is also an error to
manipulate the name stack between the execution of 'glBegin' and
the corresponding execution of 'glEnd'. In any of these cases, the
error flag is set and no other change is made to GL state.
The name stack is always empty while the render mode is not
'GL_SELECT'. Calls to 'glPushName' or 'glPopName' while the render
mode is not 'GL_SELECT' are ignored.
'GL_STACK_OVERFLOW' is generated if 'glPushName' is called while
the name stack is full.
'GL_STACK_UNDERFLOW' is generated if 'glPopName' is called while
the name stack is empty.
'GL_INVALID_OPERATION' is generated if 'glPushName' or 'glPopName'
is executed between a call to 'glBegin' and the corresponding call
to 'glEnd'.
-- Function: void glRasterPos2s x y
-- Function: void glRasterPos2i x y
-- Function: void glRasterPos2f x y
-- Function: void glRasterPos2d x y
-- Function: void glRasterPos3s x y z
-- Function: void glRasterPos3i x y z
-- Function: void glRasterPos3f x y z
-- Function: void glRasterPos3d x y z
-- Function: void glRasterPos4s x y z w
-- Function: void glRasterPos4i x y z w
-- Function: void glRasterPos4f x y z w
-- Function: void glRasterPos4d x y z w
-- Function: void glRasterPos2sv v
-- Function: void glRasterPos2iv v
-- Function: void glRasterPos2fv v
-- Function: void glRasterPos2dv v
-- Function: void glRasterPos3sv v
-- Function: void glRasterPos3iv v
-- Function: void glRasterPos3fv v
-- Function: void glRasterPos3dv v
-- Function: void glRasterPos4sv v
-- Function: void glRasterPos4iv v
-- Function: void glRasterPos4fv v
-- Function: void glRasterPos4dv v
Specify the raster position for pixel operations.
X
Y
Z
W
Specify the X, Y, Z, and W object coordinates (if present) for
the raster position.
The GL maintains a 3D position in window coordinates. This
position, called the raster position, is used to position pixel and
bitmap write operations. It is maintained with subpixel accuracy.
See 'glBitmap', 'glDrawPixels', and 'glCopyPixels'.
The current raster position consists of three window coordinates
(X, Y, Z), a clip coordinate value (W), an eye coordinate distance,
a valid bit, and associated color data and texture coordinates.
The W coordinate is a clip coordinate, because W is not projected
to window coordinates. 'glRasterPos4' specifies object coordinates
X, Y, Z, and W explicitly. 'glRasterPos3' specifies object
coordinate X, Y, and Z explicitly, while W is implicitly set to 1.
'glRasterPos2' uses the argument values for X and Y while
implicitly setting Z and W to 0 and 1.
The object coordinates presented by 'glRasterPos' are treated just
like those of a 'glVertex' command: They are transformed by the
current modelview and projection matrices and passed to the
clipping stage. If the vertex is not culled, then it is projected
and scaled to window coordinates, which become the new current
raster position, and the 'GL_CURRENT_RASTER_POSITION_VALID' flag is
set. If the vertex IS culled, then the valid bit is cleared and
the current raster position and associated color and texture
coordinates are undefined.
The current raster position also includes some associated color
data and texture coordinates. If lighting is enabled, then
'GL_CURRENT_RASTER_COLOR' (in RGBA mode) or
'GL_CURRENT_RASTER_INDEX' (in color index mode) is set to the color
produced by the lighting calculation (see 'glLight',
'glLightModel', and 'glShadeModel'). If lighting is disabled,
current color (in RGBA mode, state variable 'GL_CURRENT_COLOR') or
color index (in color index mode, state variable
'GL_CURRENT_INDEX') is used to update the current raster color.
'GL_CURRENT_RASTER_SECONDARY_COLOR' (in RGBA mode) is likewise
updated.
Likewise, 'GL_CURRENT_RASTER_TEXTURE_COORDS' is updated as a
function of 'GL_CURRENT_TEXTURE_COORDS', based on the texture
matrix and the texture generation functions (see 'glTexGen').
Finally, the distance from the origin of the eye coordinate system
to the vertex as transformed by only the modelview matrix replaces
'GL_CURRENT_RASTER_DISTANCE'.
Initially, the current raster position is (0, 0, 0, 1), the current
raster distance is 0, the valid bit is set, the associated RGBA
color is (1, 1, 1, 1), the associated color index is 1, and the
associated texture coordinates are (0, 0, 0, 1). In RGBA mode,
'GL_CURRENT_RASTER_INDEX' is always 1; in color index mode, the
current raster RGBA color always maintains its initial value.
'GL_INVALID_OPERATION' is generated if 'glRasterPos' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glReadBuffer mode
Select a color buffer source for pixels.
MODE
Specifies a color buffer. Accepted values are
'GL_FRONT_LEFT', 'GL_FRONT_RIGHT', 'GL_BACK_LEFT',
'GL_BACK_RIGHT', 'GL_FRONT', 'GL_BACK', 'GL_LEFT', 'GL_RIGHT',
and 'GL_AUX'I, where I is between 0 and the value of
'GL_AUX_BUFFERS' minus 1.
'glReadBuffer' specifies a color buffer as the source for
subsequent 'glReadPixels', 'glCopyTexImage1D', 'glCopyTexImage2D',
'glCopyTexSubImage1D', 'glCopyTexSubImage2D',
'glCopyTexSubImage3D', and 'glCopyPixels' commands. MODE accepts
one of twelve or more predefined values. ('GL_AUX0' through
'GL_AUX3' are always defined.) In a fully configured system,
'GL_FRONT', 'GL_LEFT', and 'GL_FRONT_LEFT' all name the front left
buffer, 'GL_FRONT_RIGHT' and 'GL_RIGHT' name the front right
buffer, and 'GL_BACK_LEFT' and 'GL_BACK' name the back left buffer.
Nonstereo double-buffered configurations have only a front left and
a back left buffer. Single-buffered configurations have a front
left and a front right buffer if stereo, and only a front left
buffer if nonstereo. It is an error to specify a nonexistent
buffer to 'glReadBuffer'.
MODE is initially 'GL_FRONT' in single-buffered configurations and
'GL_BACK' in double-buffered configurations.
'GL_INVALID_ENUM' is generated if MODE is not one of the twelve (or
more) accepted values.
'GL_INVALID_OPERATION' is generated if MODE specifies a buffer that
does not exist.
'GL_INVALID_OPERATION' is generated if 'glReadBuffer' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glReadPixels x y width height format type data
Read a block of pixels from the frame buffer.
X
Y
Specify the window coordinates of the first pixel that is read
from the frame buffer. This location is the lower left corner
of a rectangular block of pixels.
WIDTH
HEIGHT
Specify the dimensions of the pixel rectangle. WIDTH and
HEIGHT of one correspond to a single pixel.
FORMAT
Specifies the format of the pixel data. The following
symbolic values are accepted: 'GL_COLOR_INDEX',
'GL_STENCIL_INDEX', 'GL_DEPTH_COMPONENT', 'GL_RED',
'GL_GREEN', 'GL_BLUE', 'GL_ALPHA', 'GL_RGB', 'GL_BGR',
'GL_RGBA', 'GL_BGRA', 'GL_LUMINANCE', and
'GL_LUMINANCE_ALPHA'.
TYPE
Specifies the data type of the pixel data. Must be one of
'GL_UNSIGNED_BYTE', 'GL_BYTE', 'GL_BITMAP',
'GL_UNSIGNED_SHORT', 'GL_SHORT', 'GL_UNSIGNED_INT', 'GL_INT',
'GL_FLOAT', 'GL_UNSIGNED_BYTE_3_3_2',
'GL_UNSIGNED_BYTE_2_3_3_REV', 'GL_UNSIGNED_SHORT_5_6_5',
'GL_UNSIGNED_SHORT_5_6_5_REV', 'GL_UNSIGNED_SHORT_4_4_4_4',
'GL_UNSIGNED_SHORT_4_4_4_4_REV', 'GL_UNSIGNED_SHORT_5_5_5_1',
'GL_UNSIGNED_SHORT_1_5_5_5_REV', 'GL_UNSIGNED_INT_8_8_8_8',
'GL_UNSIGNED_INT_8_8_8_8_REV', 'GL_UNSIGNED_INT_10_10_10_2',
or 'GL_UNSIGNED_INT_2_10_10_10_REV'.
DATA
Returns the pixel data.
'glReadPixels' returns pixel data from the frame buffer, starting
with the pixel whose lower left corner is at location (X, Y), into
client memory starting at location DATA. Several parameters
control the processing of the pixel data before it is placed into
client memory. These parameters are set with three commands:
'glPixelStore', 'glPixelTransfer', and 'glPixelMap'. This
reference page describes the effects on 'glReadPixels' of most, but
not all of the parameters specified by these three commands.
If a non-zero named buffer object is bound to the
'GL_PIXEL_PACK_BUFFER' target (see 'glBindBuffer') while a block of
pixels is requested, DATA is treated as a byte offset into the
buffer object's data store rather than a pointer to client memory.
When the 'ARB_imaging' extension is supported, the pixel data may
be processed by additional operations including color table lookup,
color matrix transformations, convolutions, histograms, and minimum
and maximum pixel value computations.
'glReadPixels' returns values from each pixel with lower left
corner at (X+I,Y+J) for 0<=I ( STENCIL & MASK ).
'GL_GEQUAL'
Passes if ( REF & MASK ) >= ( STENCIL & MASK ).
'GL_EQUAL'
Passes if ( REF & MASK ) = ( STENCIL & MASK ).
'GL_NOTEQUAL'
Passes if ( REF & MASK ) != ( STENCIL & MASK ).
'GL_ALWAYS'
Always passes.
'GL_INVALID_ENUM' is generated if FUNC is not one of the eight
accepted values.
'GL_INVALID_OPERATION' is generated if 'glStencilFuncSeparate' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glStencilFunc func ref mask
Set front and back function and reference value for stencil
testing.
FUNC
Specifies the test function. Eight symbolic constants are
valid: 'GL_NEVER', 'GL_LESS', 'GL_LEQUAL', 'GL_GREATER',
'GL_GEQUAL', 'GL_EQUAL', 'GL_NOTEQUAL', and 'GL_ALWAYS'. The
initial value is 'GL_ALWAYS'.
REF
Specifies the reference value for the stencil test. REF is
clamped to the range [0,2^N-1], where N is the number of
bitplanes in the stencil buffer. The initial value is 0.
MASK
Specifies a mask that is ANDed with both the reference value
and the stored stencil value when the test is done. The
initial value is all 1's.
Stenciling, like depth-buffering, enables and disables drawing on a
per-pixel basis. Stencil planes are first drawn into using GL
drawing primitives, then geometry and images are rendered using the
stencil planes to mask out portions of the screen. Stenciling is
typically used in multipass rendering algorithms to achieve special
effects, such as decals, outlining, and constructive solid geometry
rendering.
The stencil test conditionally eliminates a pixel based on the
outcome of a comparison between the reference value and the value
in the stencil buffer. To enable and disable the test, call
'glEnable' and 'glDisable' with argument 'GL_STENCIL_TEST'. To
specify actions based on the outcome of the stencil test, call
'glStencilOp' or 'glStencilOpSeparate'.
There can be two separate sets of FUNC, REF, and MASK parameters;
one affects back-facing polygons, and the other affects
front-facing polygons as well as other non-polygon primitives.
'glStencilFunc' sets both front and back stencil state to the same
values. Use 'glStencilFuncSeparate' to set front and back stencil
state to different values.
FUNC is a symbolic constant that determines the stencil comparison
function. It accepts one of eight values, shown in the following
list. REF is an integer reference value that is used in the
stencil comparison. It is clamped to the range [0,2^N-1], where N
is the number of bitplanes in the stencil buffer. MASK is bitwise
ANDed with both the reference value and the stored stencil value,
with the ANDed values participating in the comparison.
If STENCIL represents the value stored in the corresponding stencil
buffer location, the following list shows the effect of each
comparison function that can be specified by FUNC. Only if the
comparison succeeds is the pixel passed through to the next stage
in the rasterization process (see 'glStencilOp'). All tests treat
STENCIL values as unsigned integers in the range [0,2^N-1], where N
is the number of bitplanes in the stencil buffer.
The following values are accepted by FUNC:
'GL_NEVER'
Always fails.
'GL_LESS'
Passes if ( REF & MASK ) < ( STENCIL & MASK ).
'GL_LEQUAL'
Passes if ( REF & MASK ) <= ( STENCIL & MASK ).
'GL_GREATER'
Passes if ( REF & MASK ) > ( STENCIL & MASK ).
'GL_GEQUAL'
Passes if ( REF & MASK ) >= ( STENCIL & MASK ).
'GL_EQUAL'
Passes if ( REF & MASK ) = ( STENCIL & MASK ).
'GL_NOTEQUAL'
Passes if ( REF & MASK ) != ( STENCIL & MASK ).
'GL_ALWAYS'
Always passes.
'GL_INVALID_ENUM' is generated if FUNC is not one of the eight
accepted values.
'GL_INVALID_OPERATION' is generated if 'glStencilFunc' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glStencilMaskSeparate face mask
Control the front and/or back writing of individual bits in the
stencil planes.
FACE
Specifies whether the front and/or back stencil writemask is
updated. Three symbolic constants are valid: 'GL_FRONT',
'GL_BACK', and 'GL_FRONT_AND_BACK'.
MASK
Specifies a bit mask to enable and disable writing of
individual bits in the stencil planes. Initially, the mask is
all 1's.
'glStencilMaskSeparate' controls the writing of individual bits in
the stencil planes. The least significant N bits of MASK, where N
is the number of bits in the stencil buffer, specify a mask. Where
a 1 appears in the mask, it's possible to write to the
corresponding bit in the stencil buffer. Where a 0 appears, the
corresponding bit is write-protected. Initially, all bits are
enabled for writing.
There can be two separate MASK writemasks; one affects back-facing
polygons, and the other affects front-facing polygons as well as
other non-polygon primitives. 'glStencilMask' sets both front and
back stencil writemasks to the same values, as if
'glStencilMaskSeparate' were called with FACE set to
'GL_FRONT_AND_BACK'.
'GL_INVALID_OPERATION' is generated if 'glStencilMaskSeparate' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glStencilMask mask
Control the front and back writing of individual bits in the
stencil planes.
MASK
Specifies a bit mask to enable and disable writing of
individual bits in the stencil planes. Initially, the mask is
all 1's.
'glStencilMask' controls the writing of individual bits in the
stencil planes. The least significant N bits of MASK, where N is
the number of bits in the stencil buffer, specify a mask. Where a
1 appears in the mask, it's possible to write to the corresponding
bit in the stencil buffer. Where a 0 appears, the corresponding
bit is write-protected. Initially, all bits are enabled for
writing.
There can be two separate MASK writemasks; one affects back-facing
polygons, and the other affects front-facing polygons as well as
other non-polygon primitives. 'glStencilMask' sets both front and
back stencil writemasks to the same values. Use
'glStencilMaskSeparate' to set front and back stencil writemasks to
different values.
'GL_INVALID_OPERATION' is generated if 'glStencilMask' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glStencilOpSeparate face sfail dpfail dppass
Set front and/or back stencil test actions.
FACE
Specifies whether front and/or back stencil state is updated.
Three symbolic constants are valid: 'GL_FRONT', 'GL_BACK', and
'GL_FRONT_AND_BACK'.
SFAIL
Specifies the action to take when the stencil test fails.
Eight symbolic constants are accepted: 'GL_KEEP', 'GL_ZERO',
'GL_REPLACE', 'GL_INCR', 'GL_INCR_WRAP', 'GL_DECR',
'GL_DECR_WRAP', and 'GL_INVERT'. The initial value is
'GL_KEEP'.
DPFAIL
Specifies the stencil action when the stencil test passes, but
the depth test fails. DPFAIL accepts the same symbolic
constants as SFAIL. The initial value is 'GL_KEEP'.
DPPASS
Specifies the stencil action when both the stencil test and
the depth test pass, or when the stencil test passes and
either there is no depth buffer or depth testing is not
enabled. DPPASS accepts the same symbolic constants as SFAIL.
The initial value is 'GL_KEEP'.
Stenciling, like depth-buffering, enables and disables drawing on a
per-pixel basis. You draw into the stencil planes using GL drawing
primitives, then render geometry and images, using the stencil
planes to mask out portions of the screen. Stenciling is typically
used in multipass rendering algorithms to achieve special effects,
such as decals, outlining, and constructive solid geometry
rendering.
The stencil test conditionally eliminates a pixel based on the
outcome of a comparison between the value in the stencil buffer and
a reference value. To enable and disable the test, call 'glEnable'
and 'glDisable' with argument 'GL_STENCIL_TEST'; to control it,
call 'glStencilFunc' or 'glStencilFuncSeparate'.
There can be two separate sets of SFAIL, DPFAIL, and DPPASS
parameters; one affects back-facing polygons, and the other affects
front-facing polygons as well as other non-polygon primitives.
'glStencilOp' sets both front and back stencil state to the same
values, as if 'glStencilOpSeparate' were called with FACE set to
'GL_FRONT_AND_BACK'.
'glStencilOpSeparate' takes three arguments that indicate what
happens to the stored stencil value while stenciling is enabled.
If the stencil test fails, no change is made to the pixel's color
or depth buffers, and SFAIL specifies what happens to the stencil
buffer contents. The following eight actions are possible.
'GL_KEEP'
Keeps the current value.
'GL_ZERO'
Sets the stencil buffer value to 0.
'GL_REPLACE'
Sets the stencil buffer value to REF, as specified by
'glStencilFunc'.
'GL_INCR'
Increments the current stencil buffer value. Clamps to the
maximum representable unsigned value.
'GL_INCR_WRAP'
Increments the current stencil buffer value. Wraps stencil
buffer value to zero when incrementing the maximum
representable unsigned value.
'GL_DECR'
Decrements the current stencil buffer value. Clamps to 0.
'GL_DECR_WRAP'
Decrements the current stencil buffer value. Wraps stencil
buffer value to the maximum representable unsigned value when
decrementing a stencil buffer value of zero.
'GL_INVERT'
Bitwise inverts the current stencil buffer value.
Stencil buffer values are treated as unsigned integers. When
incremented and decremented, values are clamped to 0 and 2^N-1,
where N is the value returned by querying 'GL_STENCIL_BITS'.
The other two arguments to 'glStencilOpSeparate' specify stencil
buffer actions that depend on whether subsequent depth buffer tests
succeed (DPPASS) or fail (DPFAIL) (see 'glDepthFunc'). The actions
are specified using the same eight symbolic constants as SFAIL.
Note that DPFAIL is ignored when there is no depth buffer, or when
the depth buffer is not enabled. In these cases, SFAIL and DPPASS
specify stencil action when the stencil test fails and passes,
respectively.
'GL_INVALID_ENUM' is generated if FACE is any value other than
'GL_FRONT', 'GL_BACK', or 'GL_FRONT_AND_BACK'.
'GL_INVALID_ENUM' is generated if SFAIL, DPFAIL, or DPPASS is any
value other than the eight defined constant values.
'GL_INVALID_OPERATION' is generated if 'glStencilOpSeparate' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glStencilOp sfail dpfail dppass
Set front and back stencil test actions.
SFAIL
Specifies the action to take when the stencil test fails.
Eight symbolic constants are accepted: 'GL_KEEP', 'GL_ZERO',
'GL_REPLACE', 'GL_INCR', 'GL_INCR_WRAP', 'GL_DECR',
'GL_DECR_WRAP', and 'GL_INVERT'. The initial value is
'GL_KEEP'.
DPFAIL
Specifies the stencil action when the stencil test passes, but
the depth test fails. DPFAIL accepts the same symbolic
constants as SFAIL. The initial value is 'GL_KEEP'.
DPPASS
Specifies the stencil action when both the stencil test and
the depth test pass, or when the stencil test passes and
either there is no depth buffer or depth testing is not
enabled. DPPASS accepts the same symbolic constants as SFAIL.
The initial value is 'GL_KEEP'.
Stenciling, like depth-buffering, enables and disables drawing on a
per-pixel basis. You draw into the stencil planes using GL drawing
primitives, then render geometry and images, using the stencil
planes to mask out portions of the screen. Stenciling is typically
used in multipass rendering algorithms to achieve special effects,
such as decals, outlining, and constructive solid geometry
rendering.
The stencil test conditionally eliminates a pixel based on the
outcome of a comparison between the value in the stencil buffer and
a reference value. To enable and disable the test, call 'glEnable'
and 'glDisable' with argument 'GL_STENCIL_TEST'; to control it,
call 'glStencilFunc' or 'glStencilFuncSeparate'.
There can be two separate sets of SFAIL, DPFAIL, and DPPASS
parameters; one affects back-facing polygons, and the other affects
front-facing polygons as well as other non-polygon primitives.
'glStencilOp' sets both front and back stencil state to the same
values. Use 'glStencilOpSeparate' to set front and back stencil
state to different values.
'glStencilOp' takes three arguments that indicate what happens to
the stored stencil value while stenciling is enabled. If the
stencil test fails, no change is made to the pixel's color or depth
buffers, and SFAIL specifies what happens to the stencil buffer
contents. The following eight actions are possible.
'GL_KEEP'
Keeps the current value.
'GL_ZERO'
Sets the stencil buffer value to 0.
'GL_REPLACE'
Sets the stencil buffer value to REF, as specified by
'glStencilFunc'.
'GL_INCR'
Increments the current stencil buffer value. Clamps to the
maximum representable unsigned value.
'GL_INCR_WRAP'
Increments the current stencil buffer value. Wraps stencil
buffer value to zero when incrementing the maximum
representable unsigned value.
'GL_DECR'
Decrements the current stencil buffer value. Clamps to 0.
'GL_DECR_WRAP'
Decrements the current stencil buffer value. Wraps stencil
buffer value to the maximum representable unsigned value when
decrementing a stencil buffer value of zero.
'GL_INVERT'
Bitwise inverts the current stencil buffer value.
Stencil buffer values are treated as unsigned integers. When
incremented and decremented, values are clamped to 0 and 2^N-1,
where N is the value returned by querying 'GL_STENCIL_BITS'.
The other two arguments to 'glStencilOp' specify stencil buffer
actions that depend on whether subsequent depth buffer tests
succeed (DPPASS) or fail (DPFAIL) (see 'glDepthFunc'). The actions
are specified using the same eight symbolic constants as SFAIL.
Note that DPFAIL is ignored when there is no depth buffer, or when
the depth buffer is not enabled. In these cases, SFAIL and DPPASS
specify stencil action when the stencil test fails and passes,
respectively.
'GL_INVALID_ENUM' is generated if SFAIL, DPFAIL, or DPPASS is any
value other than the eight defined constant values.
'GL_INVALID_OPERATION' is generated if 'glStencilOp' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glTexCoordPointer size type stride pointer
Define an array of texture coordinates.
SIZE
Specifies the number of coordinates per array element. Must
be 1, 2, 3, or 4. The initial value is 4.
TYPE
Specifies the data type of each texture coordinate. Symbolic
constants 'GL_SHORT', 'GL_INT', 'GL_FLOAT', or 'GL_DOUBLE' are
accepted. The initial value is 'GL_FLOAT'.
STRIDE
Specifies the byte offset between consecutive texture
coordinate sets. If STRIDE is 0, the array elements are
understood to be tightly packed. The initial value is 0.
POINTER
Specifies a pointer to the first coordinate of the first
texture coordinate set in the array. The initial value is 0.
'glTexCoordPointer' specifies the location and data format of an
array of texture coordinates to use when rendering. SIZE specifies
the number of coordinates per texture coordinate set, and must be
1, 2, 3, or 4. TYPE specifies the data type of each texture
coordinate, and STRIDE specifies the byte stride from one texture
coordinate set to the next, allowing vertices and attributes to be
packed into a single array or stored in separate arrays.
(Single-array storage may be more efficient on some
implementations; see 'glInterleavedArrays'.)
If a non-zero named buffer object is bound to the 'GL_ARRAY_BUFFER'
target (see 'glBindBuffer') while a texture coordinate array is
specified, POINTER is treated as a byte offset into the buffer
object's data store. Also, the buffer object binding
('GL_ARRAY_BUFFER_BINDING') is saved as texture coordinate vertex
array client-side state ('GL_TEXTURE_COORD_ARRAY_BUFFER_BINDING').
When a texture coordinate array is specified, SIZE, TYPE, STRIDE,
and POINTER are saved as client-side state, in addition to the
current vertex array buffer object binding.
To enable and disable a texture coordinate array, call
'glEnableClientState' and 'glDisableClientState' with the argument
'GL_TEXTURE_COORD_ARRAY'. If enabled, the texture coordinate array
is used when 'glArrayElement', 'glDrawArrays', 'glMultiDrawArrays',
'glDrawElements', 'glMultiDrawElements', or 'glDrawRangeElements'
is called.
'GL_INVALID_VALUE' is generated if SIZE is not 1, 2, 3, or 4.
'GL_INVALID_ENUM' is generated if TYPE is not an accepted value.
'GL_INVALID_VALUE' is generated if STRIDE is negative.
-- Function: void glTexCoord1s s
-- Function: void glTexCoord1i s
-- Function: void glTexCoord1f s
-- Function: void glTexCoord1d s
-- Function: void glTexCoord2s s t
-- Function: void glTexCoord2i s t
-- Function: void glTexCoord2f s t
-- Function: void glTexCoord2d s t
-- Function: void glTexCoord3s s t r
-- Function: void glTexCoord3i s t r
-- Function: void glTexCoord3f s t r
-- Function: void glTexCoord3d s t r
-- Function: void glTexCoord4s s t r q
-- Function: void glTexCoord4i s t r q
-- Function: void glTexCoord4f s t r q
-- Function: void glTexCoord4d s t r q
-- Function: void glTexCoord1sv v
-- Function: void glTexCoord1iv v
-- Function: void glTexCoord1fv v
-- Function: void glTexCoord1dv v
-- Function: void glTexCoord2sv v
-- Function: void glTexCoord2iv v
-- Function: void glTexCoord2fv v
-- Function: void glTexCoord2dv v
-- Function: void glTexCoord3sv v
-- Function: void glTexCoord3iv v
-- Function: void glTexCoord3fv v
-- Function: void glTexCoord3dv v
-- Function: void glTexCoord4sv v
-- Function: void glTexCoord4iv v
-- Function: void glTexCoord4fv v
-- Function: void glTexCoord4dv v
Set the current texture coordinates.
S
T
R
Q
Specify S, T, R, and Q texture coordinates. Not all
parameters are present in all forms of the command.
'glTexCoord' specifies texture coordinates in one, two, three, or
four dimensions. 'glTexCoord1' sets the current texture
coordinates to (S,001); a call to 'glTexCoord2' sets them to
(S,T01). Similarly, 'glTexCoord3' specifies the texture
coordinates as (S,TR1), and 'glTexCoord4' defines all four
components explicitly as (S,TRQ).
The current texture coordinates are part of the data that is
associated with each vertex and with the current raster position.
Initially, the values for S, T, R, and Q are (0, 0, 0, 1).
-- Function: void glTexEnvf target pname param
-- Function: void glTexEnvi target pname param
-- Function: void glTexEnvfv target pname params
-- Function: void glTexEnviv target pname params
Set texture environment parameters.
TARGET
Specifies a texture environment. May be 'GL_TEXTURE_ENV',
'GL_TEXTURE_FILTER_CONTROL' or 'GL_POINT_SPRITE'.
PNAME
Specifies the symbolic name of a single-valued texture
environment parameter. May be either 'GL_TEXTURE_ENV_MODE',
'GL_TEXTURE_LOD_BIAS', 'GL_COMBINE_RGB', 'GL_COMBINE_ALPHA',
'GL_SRC0_RGB', 'GL_SRC1_RGB', 'GL_SRC2_RGB', 'GL_SRC0_ALPHA',
'GL_SRC1_ALPHA', 'GL_SRC2_ALPHA', 'GL_OPERAND0_RGB',
'GL_OPERAND1_RGB', 'GL_OPERAND2_RGB', 'GL_OPERAND0_ALPHA',
'GL_OPERAND1_ALPHA', 'GL_OPERAND2_ALPHA', 'GL_RGB_SCALE',
'GL_ALPHA_SCALE', or 'GL_COORD_REPLACE'.
PARAM
Specifies a single symbolic constant, one of 'GL_ADD',
'GL_ADD_SIGNED', 'GL_INTERPOLATE', 'GL_MODULATE', 'GL_DECAL',
'GL_BLEND', 'GL_REPLACE', 'GL_SUBTRACT', 'GL_COMBINE',
'GL_TEXTURE', 'GL_CONSTANT', 'GL_PRIMARY_COLOR',
'GL_PREVIOUS', 'GL_SRC_COLOR', 'GL_ONE_MINUS_SRC_COLOR',
'GL_SRC_ALPHA', 'GL_ONE_MINUS_SRC_ALPHA', a single boolean
value for the point sprite texture coordinate replacement, a
single floating-point value for the texture level-of-detail
bias, or 1.0, 2.0, or 4.0 when specifying the 'GL_RGB_SCALE'
or 'GL_ALPHA_SCALE'.
A texture environment specifies how texture values are interpreted
when a fragment is textured. When TARGET is
'GL_TEXTURE_FILTER_CONTROL', PNAME must be 'GL_TEXTURE_LOD_BIAS'.
When TARGET is 'GL_TEXTURE_ENV', PNAME can be
'GL_TEXTURE_ENV_MODE', 'GL_TEXTURE_ENV_COLOR', 'GL_COMBINE_RGB',
'GL_COMBINE_ALPHA', 'GL_RGB_SCALE', 'GL_ALPHA_SCALE',
'GL_SRC0_RGB', 'GL_SRC1_RGB', 'GL_SRC2_RGB', 'GL_SRC0_ALPHA',
'GL_SRC1_ALPHA', or 'GL_SRC2_ALPHA'.
If PNAME is 'GL_TEXTURE_ENV_MODE', then PARAMS is (or points to)
the symbolic name of a texture function. Six texture functions may
be specified: 'GL_ADD', 'GL_MODULATE', 'GL_DECAL', 'GL_BLEND',
'GL_REPLACE', or 'GL_COMBINE'.
The following table shows the correspondence of filtered texture
values R_T, G_T, B_T, A_T, L_T, I_T to texture source components.
C_S and A_S are used by the texture functions described below.
Texture Base Internal Format
'C'_S, 'A'_S
'GL_ALPHA'
(0, 0, 0) , A_T
'GL_LUMINANCE'
( L_T, L_T, L_T ) , 1
'GL_LUMINANCE_ALPHA'
( L_T, L_T, L_T ) , A_T
'GL_INTENSITY'
( I_T, I_T, I_T ) , I_T
'GL_RGB'
( R_T, G_T, B_T ) , 1
'GL_RGBA'
( R_T, G_T, B_T ) , A_T
A texture function acts on the fragment to be textured using the
texture image value that applies to the fragment (see
'glTexParameter') and produces an RGBA color for that fragment.
The following table shows how the RGBA color is produced for each
of the first five texture functions that can be chosen. C is a
triple of color values (RGB) and A is the associated alpha value.
RGBA values extracted from a texture image are in the range [0,1].
The subscript P refers to the color computed from the previous
texture stage (or the incoming fragment if processing texture stage
0), the subscript S to the texture source color, the subscript C to
the texture environment color, and the subscript V indicates a
value produced by the texture function.
Texture Base Internal Format
'Value', 'GL_REPLACE' Function , 'GL_MODULATE' Function ,
'GL_DECAL' Function , 'GL_BLEND' Function , 'GL_ADD' Function
'GL_ALPHA'
C_V=, C_P, C_P, undefined , C_P, C_P
.
A_V=, A_S, A_PA_S, , A_V=A_PA_S, A_PA_S
'GL_LUMINANCE'
C_V=, C_S, C_PC_S, undefined , C_P(1-C_S,)+C_CC_S,
C_P+C_S
(or 1)
A_V=, A_P, A_P, , A_P, A_P
'GL_LUMINANCE_ALPHA'
C_V=, C_S, C_PC_S, undefined , C_P(1-C_S,)+C_CC_S,
C_P+C_S
(or 2)
A_V=, A_S, A_PA_S, , A_PA_S, A_PA_S
'GL_INTENSITY'
C_V=, C_S, C_PC_S, undefined , C_P(1-C_S,)+C_CC_S,
C_P+C_S
.
A_V=, A_S, A_PA_S, , A_P(1-A_S,)+A_CA_S, A_P+A_S
'GL_RGB'
C_V=, C_S, C_PC_S, C_S, C_P(1-C_S,)+C_CC_S, C_P+C_S
(or 3)
A_V=, A_P, A_P, A_P, A_P, A_P
'GL_RGBA'
C_V=, C_S, C_PC_S, C_P(1-A_S,)+C_SA_S,
C_P(1-C_S,)+C_CC_S, C_P+C_S
(or 4)
A_V=, A_S, A_PA_S, A_P, A_PA_S, A_PA_S
If PNAME is 'GL_TEXTURE_ENV_MODE', and PARAMS is 'GL_COMBINE', the
form of the texture function depends on the values of
'GL_COMBINE_RGB' and 'GL_COMBINE_ALPHA'.
The following describes how the texture sources, as specified by
'GL_SRC0_RGB', 'GL_SRC1_RGB', 'GL_SRC2_RGB', 'GL_SRC0_ALPHA',
'GL_SRC1_ALPHA', and 'GL_SRC2_ALPHA', are combined to produce a
final texture color. In the following tables, 'GL_SRC0_c' is
represented by ARG0, 'GL_SRC1_c' is represented by ARG1, and
'GL_SRC2_c' is represented by ARG2.
'GL_COMBINE_RGB' accepts any of 'GL_REPLACE', 'GL_MODULATE',
'GL_ADD', 'GL_ADD_SIGNED', 'GL_INTERPOLATE', 'GL_SUBTRACT',
'GL_DOT3_RGB', or 'GL_DOT3_RGBA'.
*'GL_COMBINE_RGB'*
*Texture Function*
'GL_REPLACE'
ARG0
'GL_MODULATE'
ARG0×ARG1
'GL_ADD'
ARG0+ARG1
'GL_ADD_SIGNED'
ARG0+ARG1-0.5
'GL_INTERPOLATE'
ARG0×ARG2+ARG1×(1-ARG2,)
'GL_SUBTRACT'
ARG0-ARG1
'GL_DOT3_RGB' or 'GL_DOT3_RGBA'
4×(((ARG0_R,-0.5,)×(ARG1_R,-0.5,),)+((ARG0_G,-0.5,)×(ARG1_G,-0.5,),)+((ARG0_B,-0.5,)×(ARG1_B,-0.5,),),)
The scalar results for 'GL_DOT3_RGB' and 'GL_DOT3_RGBA' are placed
into each of the 3 (RGB) or 4 (RGBA) components on output.
Likewise, 'GL_COMBINE_ALPHA' accepts any of 'GL_REPLACE',
'GL_MODULATE', 'GL_ADD', 'GL_ADD_SIGNED', 'GL_INTERPOLATE', or
'GL_SUBTRACT'. The following table describes how alpha values are
combined:
*'GL_COMBINE_ALPHA'*
*Texture Function*
'GL_REPLACE'
ARG0
'GL_MODULATE'
ARG0×ARG1
'GL_ADD'
ARG0+ARG1
'GL_ADD_SIGNED'
ARG0+ARG1-0.5
'GL_INTERPOLATE'
ARG0×ARG2+ARG1×(1-ARG2,)
'GL_SUBTRACT'
ARG0-ARG1
In the following tables, the value C_S represents the color sampled
from the currently bound texture, C_C represents the constant
texture-environment color, C_F represents the primary color of the
incoming fragment, and C_P represents the color computed from the
previous texture stage or C_F if processing texture stage 0.
Likewise, A_S, A_C, A_F, and A_P represent the respective alpha
values.
The following table describes the values assigned to ARG0, ARG1,
and ARG2 based upon the RGB sources and operands:
*'GL_SRCn_RGB'*
*'GL_OPERANDn_RGB'*, *Argument Value*
'GL_TEXTURE'
'GL_SRC_COLOR', C_S,
.
'GL_ONE_MINUS_SRC_COLOR', 1-C_S,
.
'GL_SRC_ALPHA', A_S,
.
'GL_ONE_MINUS_SRC_ALPHA', 1-A_S,
'GL_TEXTUREn'
'GL_SRC_COLOR', C_S,
.
'GL_ONE_MINUS_SRC_COLOR', 1-C_S,
.
'GL_SRC_ALPHA', A_S,
.
'GL_ONE_MINUS_SRC_ALPHA', 1-A_S,
'GL_CONSTANT'
'GL_SRC_COLOR', C_C,
.
'GL_ONE_MINUS_SRC_COLOR', 1-C_C,
.
'GL_SRC_ALPHA', A_C,
.
'GL_ONE_MINUS_SRC_ALPHA', 1-A_C,
'GL_PRIMARY_COLOR'
'GL_SRC_COLOR', C_F,
.
'GL_ONE_MINUS_SRC_COLOR', 1-C_F,
.
'GL_SRC_ALPHA', A_F,
.
'GL_ONE_MINUS_SRC_ALPHA', 1-A_F,
'GL_PREVIOUS'
'GL_SRC_COLOR', C_P,
.
'GL_ONE_MINUS_SRC_COLOR', 1-C_P,
.
'GL_SRC_ALPHA', A_P,
.
'GL_ONE_MINUS_SRC_ALPHA', 1-A_P,
For 'GL_TEXTUREn' sources, C_S and A_S represent the color and
alpha, respectively, produced from texture stage N.
The follow table describes the values assigned to ARG0, ARG1, and
ARG2 based upon the alpha sources and operands:
*'GL_SRCn_ALPHA'*
*'GL_OPERANDn_ALPHA'*, *Argument Value*
'GL_TEXTURE'
'GL_SRC_ALPHA', A_S,
.
'GL_ONE_MINUS_SRC_ALPHA', 1-A_S,
'GL_TEXTUREn'
'GL_SRC_ALPHA', A_S,
.
'GL_ONE_MINUS_SRC_ALPHA', 1-A_S,
'GL_CONSTANT'
'GL_SRC_ALPHA', A_C,
.
'GL_ONE_MINUS_SRC_ALPHA', 1-A_C,
'GL_PRIMARY_COLOR'
'GL_SRC_ALPHA', A_F,
.
'GL_ONE_MINUS_SRC_ALPHA', 1-A_F,
'GL_PREVIOUS'
'GL_SRC_ALPHA', A_P,
.
'GL_ONE_MINUS_SRC_ALPHA', 1-A_P,
The RGB and alpha results of the texture function are multipled by
the values of 'GL_RGB_SCALE' and 'GL_ALPHA_SCALE', respectively,
and clamped to the range [0,1].
If PNAME is 'GL_TEXTURE_ENV_COLOR', PARAMS is a pointer to an array
that holds an RGBA color consisting of four values. Integer color
components are interpreted linearly such that the most positive
integer maps to 1.0, and the most negative integer maps to -1.0.
The values are clamped to the range [0,1] when they are specified.
C_C takes these four values.
If PNAME is 'GL_TEXTURE_LOD_BIAS', the value specified is added to
the texture level-of-detail parameter, that selects which mipmap,
or mipmaps depending upon the selected 'GL_TEXTURE_MIN_FILTER',
will be sampled.
'GL_TEXTURE_ENV_MODE' defaults to 'GL_MODULATE' and
'GL_TEXTURE_ENV_COLOR' defaults to (0, 0, 0, 0).
If TARGET is 'GL_POINT_SPRITE' and PNAME is 'GL_COORD_REPLACE', the
boolean value specified is used to either enable or disable point
sprite texture coordinate replacement. The default value is
'GL_FALSE'.
'GL_INVALID_ENUM' is generated when TARGET or PNAME is not one of
the accepted defined values, or when PARAMS should have a defined
constant value (based on the value of PNAME) and does not.
'GL_INVALID_VALUE' is generated if the PARAMS value for
'GL_RGB_SCALE' or 'GL_ALPHA_SCALE' are not one of 1.0, 2.0, or 4.0.
'GL_INVALID_OPERATION' is generated if 'glTexEnv' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glTexGeni coord pname param
-- Function: void glTexGenf coord pname param
-- Function: void glTexGend coord pname param
-- Function: void glTexGeniv coord pname params
-- Function: void glTexGenfv coord pname params
-- Function: void glTexGendv coord pname params
Control the generation of texture coordinates.
COORD
Specifies a texture coordinate. Must be one of 'GL_S',
'GL_T', 'GL_R', or 'GL_Q'.
PNAME
Specifies the symbolic name of the texture-coordinate
generation function. Must be 'GL_TEXTURE_GEN_MODE'.
PARAM
Specifies a single-valued texture generation parameter, one of
'GL_OBJECT_LINEAR', 'GL_EYE_LINEAR', 'GL_SPHERE_MAP',
'GL_NORMAL_MAP', or 'GL_REFLECTION_MAP'.
'glTexGen' selects a texture-coordinate generation function or
supplies coefficients for one of the functions. COORD names one of
the (S, T, R, Q) texture coordinates; it must be one of the symbols
'GL_S', 'GL_T', 'GL_R', or 'GL_Q'. PNAME must be one of three
symbolic constants: 'GL_TEXTURE_GEN_MODE', 'GL_OBJECT_PLANE', or
'GL_EYE_PLANE'. If PNAME is 'GL_TEXTURE_GEN_MODE', then PARAMS
chooses a mode, one of 'GL_OBJECT_LINEAR', 'GL_EYE_LINEAR',
'GL_SPHERE_MAP', 'GL_NORMAL_MAP', or 'GL_REFLECTION_MAP'. If PNAME
is either 'GL_OBJECT_PLANE' or 'GL_EYE_PLANE', PARAMS contains
coefficients for the corresponding texture generation function.
If the texture generation function is 'GL_OBJECT_LINEAR', the
function
G=P_1×X_O+P_2×Y_O+P_3×Z_O+P_4×W_O
is used, where G is the value computed for the coordinate named in
COORD, P_1, P_2, P_3, and P_4 are the four values supplied in
PARAMS, and X_O, Y_O, Z_O, and W_O are the object coordinates of
the vertex. This function can be used, for example, to texture-map
terrain using sea level as a reference plane (defined by P_1, P_2,
P_3, and P_4). The altitude of a terrain vertex is computed by the
'GL_OBJECT_LINEAR' coordinate generation function as its distance
from sea level; that altitude can then be used to index the texture
image to map white snow onto peaks and green grass onto foothills.
If the texture generation function is 'GL_EYE_LINEAR', the function
G=P_1,^″×X_E+P_2,^″×Y_E+P_3,^″×Z_E+P_4,^″×W_E
is used, where
(P_1,^″P_2,^″P_3,^″P_4,^″,)=(P_1P_2P_3P_4,)M^-1
and X_E, Y_E, Z_E, and W_E are the eye coordinates of the vertex,
P_1, P_2, P_3, and P_4 are the values supplied in PARAMS, and M is
the modelview matrix when 'glTexGen' is invoked. If M is poorly
conditioned or singular, texture coordinates generated by the
resulting function may be inaccurate or undefined.
Note that the values in PARAMS define a reference plane in eye
coordinates. The modelview matrix that is applied to them may not
be the same one in effect when the polygon vertices are
transformed. This function establishes a field of texture
coordinates that can produce dynamic contour lines on moving
objects.
If the texture generation function is 'GL_SPHERE_MAP' and COORD is
either 'GL_S' or 'GL_T', S and T texture coordinates are generated
as follows. Let U be the unit vector pointing from the origin to
the polygon vertex (in eye coordinates). Let N sup prime be the
current normal, after transformation to eye coordinates. Let
F=(F_XF_YF_Z,)^T be the reflection vector such that
F=U-2N^″N^″,^TU
Finally, let M=2√(F_X,^2+F_Y,^2+(F_Z+1,)^2,). Then the values
assigned to the S and T texture coordinates are
S=F_X/M+1/2
T=F_Y/M+1/2
To enable or disable a texture-coordinate generation function, call
'glEnable' or 'glDisable' with one of the symbolic
texture-coordinate names ('GL_TEXTURE_GEN_S', 'GL_TEXTURE_GEN_T',
'GL_TEXTURE_GEN_R', or 'GL_TEXTURE_GEN_Q') as the argument. When
enabled, the specified texture coordinate is computed according to
the generating function associated with that coordinate. When
disabled, subsequent vertices take the specified texture coordinate
from the current set of texture coordinates. Initially, all
texture generation functions are set to 'GL_EYE_LINEAR' and are
disabled. Both S plane equations are (1, 0, 0, 0), both T plane
equations are (0, 1, 0, 0), and all R and Q plane equations are (0,
0, 0, 0).
When the 'ARB_multitexture' extension is supported, 'glTexGen' sets
the texture generation parameters for the currently active texture
unit, selected with 'glActiveTexture'.
'GL_INVALID_ENUM' is generated when COORD or PNAME is not an
accepted defined value, or when PNAME is 'GL_TEXTURE_GEN_MODE' and
PARAMS is not an accepted defined value.
'GL_INVALID_ENUM' is generated when PNAME is 'GL_TEXTURE_GEN_MODE',
PARAMS is 'GL_SPHERE_MAP', and COORD is either 'GL_R' or 'GL_Q'.
'GL_INVALID_OPERATION' is generated if 'glTexGen' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glTexImage1D target level internalFormat width border
format type data
Specify a one-dimensional texture image.
TARGET
Specifies the target texture. Must be 'GL_TEXTURE_1D' or
'GL_PROXY_TEXTURE_1D'.
LEVEL
Specifies the level-of-detail number. Level 0 is the base
image level. Level N is the Nth mipmap reduction image.
INTERNALFORMAT
Specifies the number of color components in the texture. Must
be 1, 2, 3, or 4, or one of the following symbolic constants:
'GL_ALPHA', 'GL_ALPHA4', 'GL_ALPHA8', 'GL_ALPHA12',
'GL_ALPHA16', 'GL_COMPRESSED_ALPHA',
'GL_COMPRESSED_LUMINANCE', 'GL_COMPRESSED_LUMINANCE_ALPHA',
'GL_COMPRESSED_INTENSITY', 'GL_COMPRESSED_RGB',
'GL_COMPRESSED_RGBA', 'GL_DEPTH_COMPONENT',
'GL_DEPTH_COMPONENT16', 'GL_DEPTH_COMPONENT24',
'GL_DEPTH_COMPONENT32', 'GL_LUMINANCE', 'GL_LUMINANCE4',
'GL_LUMINANCE8', 'GL_LUMINANCE12', 'GL_LUMINANCE16',
'GL_LUMINANCE_ALPHA', 'GL_LUMINANCE4_ALPHA4',
'GL_LUMINANCE6_ALPHA2', 'GL_LUMINANCE8_ALPHA8',
'GL_LUMINANCE12_ALPHA4', 'GL_LUMINANCE12_ALPHA12',
'GL_LUMINANCE16_ALPHA16', 'GL_INTENSITY', 'GL_INTENSITY4',
'GL_INTENSITY8', 'GL_INTENSITY12', 'GL_INTENSITY16',
'GL_R3_G3_B2', 'GL_RGB', 'GL_RGB4', 'GL_RGB5', 'GL_RGB8',
'GL_RGB10', 'GL_RGB12', 'GL_RGB16', 'GL_RGBA', 'GL_RGBA2',
'GL_RGBA4', 'GL_RGB5_A1', 'GL_RGBA8', 'GL_RGB10_A2',
'GL_RGBA12', 'GL_RGBA16', 'GL_SLUMINANCE', 'GL_SLUMINANCE8',
'GL_SLUMINANCE_ALPHA', 'GL_SLUMINANCE8_ALPHA8', 'GL_SRGB',
'GL_SRGB8', 'GL_SRGB_ALPHA', or 'GL_SRGB8_ALPHA8'.
WIDTH
Specifies the width of the texture image including the border
if any. If the GL version does not support non-power-of-two
sizes, this value must be 2^N+2(BORDER,) for some integer
N. All implementations support texture images that are at
least 64 texels wide. The height of the 1D texture image is
1.
BORDER
Specifies the width of the border. Must be either 0 or 1.
FORMAT
Specifies the format of the pixel data. The following
symbolic values are accepted: 'GL_COLOR_INDEX', 'GL_RED',
'GL_GREEN', 'GL_BLUE', 'GL_ALPHA', 'GL_RGB', 'GL_BGR',
'GL_RGBA', 'GL_BGRA', 'GL_LUMINANCE', and
'GL_LUMINANCE_ALPHA'.
TYPE
Specifies the data type of the pixel data. The following
symbolic values are accepted: 'GL_UNSIGNED_BYTE', 'GL_BYTE',
'GL_BITMAP', 'GL_UNSIGNED_SHORT', 'GL_SHORT',
'GL_UNSIGNED_INT', 'GL_INT', 'GL_FLOAT',
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', 'GL_UNSIGNED_SHORT_5_6_5_REV',
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', and
'GL_UNSIGNED_INT_2_10_10_10_REV'.
DATA
Specifies a pointer to the image data in memory.
Texturing maps a portion of a specified texture image onto each
graphical primitive for which texturing is enabled. To enable and
disable one-dimensional texturing, call 'glEnable' and 'glDisable'
with argument 'GL_TEXTURE_1D'.
Texture images are defined with 'glTexImage1D'. The arguments
describe the parameters of the texture image, such as width, width
of the border, level-of-detail number (see 'glTexParameter'), and
the internal resolution and format used to store the image. The
last three arguments describe how the image is represented in
memory; they are identical to the pixel formats used for
'glDrawPixels'.
If TARGET is 'GL_PROXY_TEXTURE_1D', no data is read from DATA, but
all of the texture image state is recalculated, checked for
consistency, and checked against the implementation's capabilities.
If the implementation cannot handle a texture of the requested
texture size, it sets all of the image state to 0, but does not
generate an error (see 'glGetError'). To query for an entire
mipmap array, use an image array level greater than or equal to 1.
If TARGET is 'GL_TEXTURE_1D', data is read from DATA as a sequence
of signed or unsigned bytes, shorts, or longs, or single-precision
floating-point values, depending on TYPE. These values are grouped
into sets of one, two, three, or four values, depending on FORMAT,
to form elements. If TYPE is 'GL_BITMAP', the data is considered
as a string of unsigned bytes (and FORMAT must be
'GL_COLOR_INDEX'). Each data byte is treated as eight 1-bit
elements, with bit ordering determined by 'GL_UNPACK_LSB_FIRST'
(see 'glPixelStore').
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
texture image is specified, DATA is treated as a byte offset into
the buffer object's data store.
The first element corresponds to the left end of the texture array.
Subsequent elements progress left-to-right through the remaining
texels in the texture array. The final element corresponds to the
right end of the texture array.
FORMAT determines the composition of each element in DATA. It can
assume one of these symbolic values:
'GL_COLOR_INDEX'
Each element is a single value, a color index. The GL
converts it to fixed point (with an unspecified number of zero
bits to the right of the binary point), shifted left or right
depending on the value and sign of 'GL_INDEX_SHIFT', and added
to 'GL_INDEX_OFFSET' (see 'glPixelTransfer'). The resulting
index is converted to a set of color components using the
'GL_PIXEL_MAP_I_TO_R', 'GL_PIXEL_MAP_I_TO_G',
'GL_PIXEL_MAP_I_TO_B', and 'GL_PIXEL_MAP_I_TO_A' tables, and
clamped to the range [0,1].
'GL_RED'
Each element is a single red component. The GL converts it to
floating point and assembles it into an RGBA element by
attaching 0 for green and blue, and 1 for alpha. Each
component is then multiplied by the signed scale factor
'GL_c_SCALE', added to the signed bias 'GL_c_BIAS', and
clamped to the range [0,1] (see 'glPixelTransfer').
'GL_GREEN'
Each element is a single green component. The GL converts it
to floating point and assembles it into an RGBA element by
attaching 0 for red and blue, and 1 for alpha. Each component
is then multiplied by the signed scale factor 'GL_c_SCALE',
added to the signed bias 'GL_c_BIAS', and clamped to the range
[0,1] (see 'glPixelTransfer').
'GL_BLUE'
Each element is a single blue component. The GL converts it
to floating point and assembles it into an RGBA element by
attaching 0 for red and green, and 1 for alpha. Each
component is then multiplied by the signed scale factor
'GL_c_SCALE', added to the signed bias 'GL_c_BIAS', and
clamped to the range [0,1] (see 'glPixelTransfer').
'GL_ALPHA'
Each element is a single alpha component. The GL converts it
to floating point and assembles it into an RGBA element by
attaching 0 for red, green, and blue. Each component is then
multiplied by the signed scale factor 'GL_c_SCALE', added to
the signed bias 'GL_c_BIAS', and clamped to the range [0,1]
(see 'glPixelTransfer').
'GL_INTENSITY'
Each element is a single intensity value. The GL converts it
to floating point, then assembles it into an RGBA element by
replicating the intensity value three times for red, green,
blue, and alpha. Each component is then multiplied by the
signed scale factor 'GL_c_SCALE', added to the signed bias
'GL_c_BIAS', and clamped to the range [0,1] (see
'glPixelTransfer').
'GL_RGB'
'GL_BGR'
Each element is an RGB triple. The GL converts it to floating
point and assembles it into an RGBA element by attaching 1 for
alpha. Each component is then multiplied by the signed scale
factor 'GL_c_SCALE', added to the signed bias 'GL_c_BIAS', and
clamped to the range [0,1] (see 'glPixelTransfer').
'GL_RGBA'
'GL_BGRA'
Each element contains all four components. Each component is
multiplied by the signed scale factor 'GL_c_SCALE', added to
the signed bias 'GL_c_BIAS', and clamped to the range [0,1]
(see 'glPixelTransfer').
'GL_LUMINANCE'
Each element is a single luminance value. The GL converts it
to floating point, then assembles it into an RGBA element by
replicating the luminance value three times for red, green,
and blue and attaching 1 for alpha. Each component is then
multiplied by the signed scale factor 'GL_c_SCALE', added to
the signed bias 'GL_c_BIAS', and clamped to the range [0,1]
(see 'glPixelTransfer').
'GL_LUMINANCE_ALPHA'
Each element is a luminance/alpha pair. The GL converts it to
floating point, then assembles it into an RGBA element by
replicating the luminance value three times for red, green,
and blue. Each component is then multiplied by the signed
scale factor 'GL_c_SCALE', added to the signed bias
'GL_c_BIAS', and clamped to the range [0,1] (see
'glPixelTransfer').
'GL_DEPTH_COMPONENT'
Each element is a single depth value. The GL converts it to
floating point, multiplies by the signed scale factor
'GL_DEPTH_SCALE', adds the signed bias 'GL_DEPTH_BIAS', and
clamps to the range [0,1] (see 'glPixelTransfer').
Refer to the 'glDrawPixels' reference page for a description of the
acceptable values for the TYPE parameter.
If an application wants to store the texture at a certain
resolution or in a certain format, it can request the resolution
and format with INTERNALFORMAT. The GL will choose an internal
representation that closely approximates that requested by
INTERNALFORMAT, but it may not match exactly. (The representations
specified by 'GL_LUMINANCE', 'GL_LUMINANCE_ALPHA', 'GL_RGB', and
'GL_RGBA' must match exactly. The numeric values 1, 2, 3, and 4
may also be used to specify the above representations.)
If the INTERNALFORMAT parameter is one of the generic compressed
formats, 'GL_COMPRESSED_ALPHA', 'GL_COMPRESSED_INTENSITY',
'GL_COMPRESSED_LUMINANCE', 'GL_COMPRESSED_LUMINANCE_ALPHA',
'GL_COMPRESSED_RGB', or 'GL_COMPRESSED_RGBA', the GL will replace
the internal format with the symbolic constant for a specific
internal format and compress the texture before storage. If no
corresponding internal format is available, or the GL can not
compress that image for any reason, the internal format is instead
replaced with a corresponding base internal format.
If the INTERNALFORMAT parameter is 'GL_SRGB', 'GL_SRGB8',
'GL_SRGB_ALPHA', 'GL_SRGB8_ALPHA8', 'GL_SLUMINANCE',
'GL_SLUMINANCE8', 'GL_SLUMINANCE_ALPHA', or
'GL_SLUMINANCE8_ALPHA8', the texture is treated as if the red,
green, blue, or luminance components are encoded in the sRGB color
space. Any alpha component is left unchanged. The conversion from
the sRGB encoded component C_S to a linear component C_L is:
C_L={(C_S/12.92 if C_S≤0.04045), (('c'_'s'+0.055/1.055)^2.4 if
C_S>0.04045)
Assume C_S is the sRGB component in the range [0,1].
Use the 'GL_PROXY_TEXTURE_1D' target to try out a resolution and
format. The implementation will update and recompute its best
match for the requested storage resolution and format. To then
query this state, call 'glGetTexLevelParameter'. If the texture
cannot be accommodated, texture state is set to 0.
A one-component texture image uses only the red component of the
RGBA color from DATA. A two-component image uses the R and A
values. A three-component image uses the R, G, and B values. A
four-component image uses all of the RGBA components.
Depth textures can be treated as LUMINANCE, INTENSITY or ALPHA
textures during texture filtering and application. Image-based
shadowing can be enabled by comparing texture r coordinates
to depth texture values to generate a boolean result. See
'glTexParameter' for details on texture comparison.
'GL_INVALID_ENUM' is generated if TARGET is not 'GL_TEXTURE_1D' or
'GL_PROXY_TEXTURE_1D'.
'GL_INVALID_ENUM' is generated if FORMAT is not an accepted format
constant. Format constants other than 'GL_STENCIL_INDEX' are
accepted.
'GL_INVALID_ENUM' is generated if TYPE is not a type constant.
'GL_INVALID_ENUM' is generated if TYPE is 'GL_BITMAP' and FORMAT is
not 'GL_COLOR_INDEX'.
'GL_INVALID_VALUE' is generated if LEVEL is less than 0.
'GL_INVALID_VALUE' may be generated if LEVEL is greater than
LOG_2(MAX,), where MAX is the returned value of
'GL_MAX_TEXTURE_SIZE'.
'GL_INVALID_VALUE' is generated if INTERNALFORMAT is not 1, 2, 3,
4, or one of the accepted resolution and format symbolic constants.
'GL_INVALID_VALUE' is generated if WIDTH is less than 0 or greater
than 2 + 'GL_MAX_TEXTURE_SIZE'.
'GL_INVALID_VALUE' is generated if non-power-of-two textures are
not supported and the WIDTH cannot be represented as
2^N+2(BORDER,) for some integer value of N.
'GL_INVALID_VALUE' is generated if BORDER is not 0 or 1.
'GL_INVALID_OPERATION' is generated if TYPE is one of
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', or 'GL_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GL_RGB'.
'GL_INVALID_OPERATION' is generated if TYPE is one of
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', or 'GL_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GL_RGBA' nor 'GL_BGRA'.
'GL_INVALID_OPERATION' is generated if FORMAT is
'GL_DEPTH_COMPONENT' and INTERNALFORMAT is not
'GL_DEPTH_COMPONENT', 'GL_DEPTH_COMPONENT16',
'GL_DEPTH_COMPONENT24', or 'GL_DEPTH_COMPONENT32'.
'GL_INVALID_OPERATION' is generated if INTERNALFORMAT is
'GL_DEPTH_COMPONENT', 'GL_DEPTH_COMPONENT16',
'GL_DEPTH_COMPONENT24', or 'GL_DEPTH_COMPONENT32', and FORMAT is
not 'GL_DEPTH_COMPONENT'.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and DATA is
not evenly divisible into the number of bytes needed to store in
memory a datum indicated by TYPE.
'GL_INVALID_OPERATION' is generated if 'glTexImage1D' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glTexImage2D target level internalFormat width height
border format type data
Specify a two-dimensional texture image.
TARGET
Specifies the target texture. Must be 'GL_TEXTURE_2D',
'GL_PROXY_TEXTURE_2D', 'GL_TEXTURE_CUBE_MAP_POSITIVE_X',
'GL_TEXTURE_CUBE_MAP_NEGATIVE_X',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Y',
'GL_TEXTURE_CUBE_MAP_NEGATIVE_Y',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Z',
'GL_TEXTURE_CUBE_MAP_NEGATIVE_Z', or
'GL_PROXY_TEXTURE_CUBE_MAP'.
LEVEL
Specifies the level-of-detail number. Level 0 is the base
image level. Level N is the Nth mipmap reduction image.
INTERNALFORMAT
Specifies the number of color components in the texture. Must
be 1, 2, 3, or 4, or one of the following symbolic constants:
'GL_ALPHA', 'GL_ALPHA4', 'GL_ALPHA8', 'GL_ALPHA12',
'GL_ALPHA16', 'GL_COMPRESSED_ALPHA',
'GL_COMPRESSED_LUMINANCE', 'GL_COMPRESSED_LUMINANCE_ALPHA',
'GL_COMPRESSED_INTENSITY', 'GL_COMPRESSED_RGB',
'GL_COMPRESSED_RGBA', 'GL_DEPTH_COMPONENT',
'GL_DEPTH_COMPONENT16', 'GL_DEPTH_COMPONENT24',
'GL_DEPTH_COMPONENT32', 'GL_LUMINANCE', 'GL_LUMINANCE4',
'GL_LUMINANCE8', 'GL_LUMINANCE12', 'GL_LUMINANCE16',
'GL_LUMINANCE_ALPHA', 'GL_LUMINANCE4_ALPHA4',
'GL_LUMINANCE6_ALPHA2', 'GL_LUMINANCE8_ALPHA8',
'GL_LUMINANCE12_ALPHA4', 'GL_LUMINANCE12_ALPHA12',
'GL_LUMINANCE16_ALPHA16', 'GL_INTENSITY', 'GL_INTENSITY4',
'GL_INTENSITY8', 'GL_INTENSITY12', 'GL_INTENSITY16',
'GL_R3_G3_B2', 'GL_RGB', 'GL_RGB4', 'GL_RGB5', 'GL_RGB8',
'GL_RGB10', 'GL_RGB12', 'GL_RGB16', 'GL_RGBA', 'GL_RGBA2',
'GL_RGBA4', 'GL_RGB5_A1', 'GL_RGBA8', 'GL_RGB10_A2',
'GL_RGBA12', 'GL_RGBA16', 'GL_SLUMINANCE', 'GL_SLUMINANCE8',
'GL_SLUMINANCE_ALPHA', 'GL_SLUMINANCE8_ALPHA8', 'GL_SRGB',
'GL_SRGB8', 'GL_SRGB_ALPHA', or 'GL_SRGB8_ALPHA8'.
WIDTH
Specifies the width of the texture image including the border
if any. If the GL version does not support non-power-of-two
sizes, this value must be 2^N+2(BORDER,) for some integer
N. All implementations support texture images that are at
least 64 texels wide.
HEIGHT
Specifies the height of the texture image including the border
if any. If the GL version does not support non-power-of-two
sizes, this value must be 2^M+2(BORDER,) for some integer
M. All implementations support texture images that are at
least 64 texels high.
BORDER
Specifies the width of the border. Must be either 0 or 1.
FORMAT
Specifies the format of the pixel data. The following
symbolic values are accepted: 'GL_COLOR_INDEX', 'GL_RED',
'GL_GREEN', 'GL_BLUE', 'GL_ALPHA', 'GL_RGB', 'GL_BGR',
'GL_RGBA', 'GL_BGRA', 'GL_LUMINANCE', and
'GL_LUMINANCE_ALPHA'.
TYPE
Specifies the data type of the pixel data. The following
symbolic values are accepted: 'GL_UNSIGNED_BYTE', 'GL_BYTE',
'GL_BITMAP', 'GL_UNSIGNED_SHORT', 'GL_SHORT',
'GL_UNSIGNED_INT', 'GL_INT', 'GL_FLOAT',
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', 'GL_UNSIGNED_SHORT_5_6_5_REV',
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', and
'GL_UNSIGNED_INT_2_10_10_10_REV'.
DATA
Specifies a pointer to the image data in memory.
Texturing maps a portion of a specified texture image onto each
graphical primitive for which texturing is enabled. To enable and
disable two-dimensional texturing, call 'glEnable' and 'glDisable'
with argument 'GL_TEXTURE_2D'. To enable and disable texturing
using cube-mapped texture, call 'glEnable' and 'glDisable' with
argument 'GL_TEXTURE_CUBE_MAP'.
To define texture images, call 'glTexImage2D'. The arguments
describe the parameters of the texture image, such as height,
width, width of the border, level-of-detail number (see
'glTexParameter'), and number of color components provided. The
last three arguments describe how the image is represented in
memory; they are identical to the pixel formats used for
'glDrawPixels'.
If TARGET is 'GL_PROXY_TEXTURE_2D' or 'GL_PROXY_TEXTURE_CUBE_MAP',
no data is read from DATA, but all of the texture image state is
recalculated, checked for consistency, and checked against the
implementation's capabilities. If the implementation cannot handle
a texture of the requested texture size, it sets all of the image
state to 0, but does not generate an error (see 'glGetError'). To
query for an entire mipmap array, use an image array level greater
than or equal to 1.
If TARGET is 'GL_TEXTURE_2D', or one of the 'GL_TEXTURE_CUBE_MAP'
targets, data is read from DATA as a sequence of signed or unsigned
bytes, shorts, or longs, or single-precision floating-point values,
depending on TYPE. These values are grouped into sets of one, two,
three, or four values, depending on FORMAT, to form elements. If
TYPE is 'GL_BITMAP', the data is considered as a string of unsigned
bytes (and FORMAT must be 'GL_COLOR_INDEX'). Each data byte is
treated as eight 1-bit elements, with bit ordering determined by
'GL_UNPACK_LSB_FIRST' (see 'glPixelStore').
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
texture image is specified, DATA is treated as a byte offset into
the buffer object's data store.
The first element corresponds to the lower left corner of the
texture image. Subsequent elements progress left-to-right through
the remaining texels in the lowest row of the texture image, and
then in successively higher rows of the texture image. The final
element corresponds to the upper right corner of the texture image.
FORMAT determines the composition of each element in DATA. It can
assume one of these symbolic values:
'GL_COLOR_INDEX'
Each element is a single value, a color index. The GL
converts it to fixed point (with an unspecified number of zero
bits to the right of the binary point), shifted left or right
depending on the value and sign of 'GL_INDEX_SHIFT', and added
to 'GL_INDEX_OFFSET' (see 'glPixelTransfer'). The resulting
index is converted to a set of color components using the
'GL_PIXEL_MAP_I_TO_R', 'GL_PIXEL_MAP_I_TO_G',
'GL_PIXEL_MAP_I_TO_B', and 'GL_PIXEL_MAP_I_TO_A' tables, and
clamped to the range [0,1].
'GL_RED'
Each element is a single red component. The GL converts it to
floating point and assembles it into an RGBA element by
attaching 0 for green and blue, and 1 for alpha. Each
component is then multiplied by the signed scale factor
'GL_c_SCALE', added to the signed bias 'GL_c_BIAS', and
clamped to the range [0,1] (see 'glPixelTransfer').
'GL_GREEN'
Each element is a single green component. The GL converts it
to floating point and assembles it into an RGBA element by
attaching 0 for red and blue, and 1 for alpha. Each component
is then multiplied by the signed scale factor 'GL_c_SCALE',
added to the signed bias 'GL_c_BIAS', and clamped to the range
[0,1] (see 'glPixelTransfer').
'GL_BLUE'
Each element is a single blue component. The GL converts it
to floating point and assembles it into an RGBA element by
attaching 0 for red and green, and 1 for alpha. Each
component is then multiplied by the signed scale factor
'GL_c_SCALE', added to the signed bias 'GL_c_BIAS', and
clamped to the range [0,1] (see 'glPixelTransfer').
'GL_ALPHA'
Each element is a single alpha component. The GL converts it
to floating point and assembles it into an RGBA element by
attaching 0 for red, green, and blue. Each component is then
multiplied by the signed scale factor 'GL_c_SCALE', added to
the signed bias 'GL_c_BIAS', and clamped to the range [0,1]
(see 'glPixelTransfer').
'GL_INTENSITY'
Each element is a single intensity value. The GL converts it
to floating point, then assembles it into an RGBA element by
replicating the intensity value three times for red, green,
blue, and alpha. Each component is then multiplied by the
signed scale factor 'GL_c_SCALE', added to the signed bias
'GL_c_BIAS', and clamped to the range [0,1] (see
'glPixelTransfer').
'GL_RGB'
'GL_BGR'
Each element is an RGB triple. The GL converts it to floating
point and assembles it into an RGBA element by attaching 1 for
alpha. Each component is then multiplied by the signed scale
factor 'GL_c_SCALE', added to the signed bias 'GL_c_BIAS', and
clamped to the range [0,1] (see 'glPixelTransfer').
'GL_RGBA'
'GL_BGRA'
Each element contains all four components. Each component is
multiplied by the signed scale factor 'GL_c_SCALE', added to
the signed bias 'GL_c_BIAS', and clamped to the range [0,1]
(see 'glPixelTransfer').
'GL_LUMINANCE'
Each element is a single luminance value. The GL converts it
to floating point, then assembles it into an RGBA element by
replicating the luminance value three times for red, green,
and blue and attaching 1 for alpha. Each component is then
multiplied by the signed scale factor 'GL_c_SCALE', added to
the signed bias 'GL_c_BIAS', and clamped to the range [0,1]
(see 'glPixelTransfer').
'GL_LUMINANCE_ALPHA'
Each element is a luminance/alpha pair. The GL converts it to
floating point, then assembles it into an RGBA element by
replicating the luminance value three times for red, green,
and blue. Each component is then multiplied by the signed
scale factor 'GL_c_SCALE', added to the signed bias
'GL_c_BIAS', and clamped to the range [0,1] (see
'glPixelTransfer').
'GL_DEPTH_COMPONENT'
Each element is a single depth value. The GL converts it to
floating point, multiplies by the signed scale factor
'GL_DEPTH_SCALE', adds the signed bias 'GL_DEPTH_BIAS', and
clamps to the range [0,1] (see 'glPixelTransfer').
Refer to the 'glDrawPixels' reference page for a description of the
acceptable values for the TYPE parameter.
If an application wants to store the texture at a certain
resolution or in a certain format, it can request the resolution
and format with INTERNALFORMAT. The GL will choose an internal
representation that closely approximates that requested by
INTERNALFORMAT, but it may not match exactly. (The representations
specified by 'GL_LUMINANCE', 'GL_LUMINANCE_ALPHA', 'GL_RGB', and
'GL_RGBA' must match exactly. The numeric values 1, 2, 3, and 4
may also be used to specify the above representations.)
If the INTERNALFORMAT parameter is one of the generic compressed
formats, 'GL_COMPRESSED_ALPHA', 'GL_COMPRESSED_INTENSITY',
'GL_COMPRESSED_LUMINANCE', 'GL_COMPRESSED_LUMINANCE_ALPHA',
'GL_COMPRESSED_RGB', or 'GL_COMPRESSED_RGBA', the GL will replace
the internal format with the symbolic constant for a specific
internal format and compress the texture before storage. If no
corresponding internal format is available, or the GL can not
compress that image for any reason, the internal format is instead
replaced with a corresponding base internal format.
If the INTERNALFORMAT parameter is 'GL_SRGB', 'GL_SRGB8',
'GL_SRGB_ALPHA', 'GL_SRGB8_ALPHA8', 'GL_SLUMINANCE',
'GL_SLUMINANCE8', 'GL_SLUMINANCE_ALPHA', or
'GL_SLUMINANCE8_ALPHA8', the texture is treated as if the red,
green, blue, or luminance components are encoded in the sRGB color
space. Any alpha component is left unchanged. The conversion from
the sRGB encoded component C_S to a linear component C_L is:
C_L={(C_S/12.92 if C_S≤0.04045), (('c'_'s'+0.055/1.055)^2.4 if
C_S>0.04045)
Assume C_S is the sRGB component in the range [0,1].
Use the 'GL_PROXY_TEXTURE_2D' or 'GL_PROXY_TEXTURE_CUBE_MAP' target
to try out a resolution and format. The implementation will update
and recompute its best match for the requested storage resolution
and format. To then query this state, call
'glGetTexLevelParameter'. If the texture cannot be accommodated,
texture state is set to 0.
A one-component texture image uses only the red component of the
RGBA color extracted from DATA. A two-component image uses the R
and A values. A three-component image uses the R, G, and B values.
A four-component image uses all of the RGBA components.
Depth textures can be treated as LUMINANCE, INTENSITY or ALPHA
textures during texture filtering and application. Image-based
shadowing can be enabled by comparing texture r coordinates
to depth texture values to generate a boolean result. See
'glTexParameter' for details on texture comparison.
'GL_INVALID_ENUM' is generated if TARGET is not 'GL_TEXTURE_2D',
'GL_PROXY_TEXTURE_2D', 'GL_PROXY_TEXTURE_CUBE_MAP',
'GL_TEXTURE_CUBE_MAP_POSITIVE_X', 'GL_TEXTURE_CUBE_MAP_NEGATIVE_X',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Y', 'GL_TEXTURE_CUBE_MAP_NEGATIVE_Y',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Z', or
'GL_TEXTURE_CUBE_MAP_NEGATIVE_Z'.
'GL_INVALID_ENUM' is generated if TARGET is one of the six cube map
2D image targets and the width and height parameters are not equal.
'GL_INVALID_ENUM' is generated if TYPE is not a type constant.
'GL_INVALID_ENUM' is generated if TYPE is 'GL_BITMAP' and FORMAT is
not 'GL_COLOR_INDEX'.
'GL_INVALID_VALUE' is generated if WIDTH or HEIGHT is less than 0
or greater than 2 + 'GL_MAX_TEXTURE_SIZE'.
'GL_INVALID_VALUE' is generated if LEVEL is less than 0.
'GL_INVALID_VALUE' may be generated if LEVEL is greater than
LOG_2(MAX,), where MAX is the returned value of
'GL_MAX_TEXTURE_SIZE'.
'GL_INVALID_VALUE' is generated if INTERNALFORMAT is not 1, 2, 3,
4, or one of the accepted resolution and format symbolic constants.
'GL_INVALID_VALUE' is generated if WIDTH or HEIGHT is less than 0
or greater than 2 + 'GL_MAX_TEXTURE_SIZE'.
'GL_INVALID_VALUE' is generated if non-power-of-two textures are
not supported and the WIDTH or HEIGHT cannot be represented as
2^K+2(BORDER,) for some integer value of K.
'GL_INVALID_VALUE' is generated if BORDER is not 0 or 1.
'GL_INVALID_OPERATION' is generated if TYPE is one of
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', or 'GL_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GL_RGB'.
'GL_INVALID_OPERATION' is generated if TYPE is one of
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', or 'GL_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GL_RGBA' nor 'GL_BGRA'.
'GL_INVALID_OPERATION' is generated if TARGET is not
'GL_TEXTURE_2D' or 'GL_PROXY_TEXTURE_2D' and INTERNALFORMAT is
'GL_DEPTH_COMPONENT', 'GL_DEPTH_COMPONENT16',
'GL_DEPTH_COMPONENT24', or 'GL_DEPTH_COMPONENT32'.
'GL_INVALID_OPERATION' is generated if FORMAT is
'GL_DEPTH_COMPONENT' and INTERNALFORMAT is not
'GL_DEPTH_COMPONENT', 'GL_DEPTH_COMPONENT16',
'GL_DEPTH_COMPONENT24', or 'GL_DEPTH_COMPONENT32'.
'GL_INVALID_OPERATION' is generated if INTERNALFORMAT is
'GL_DEPTH_COMPONENT', 'GL_DEPTH_COMPONENT16',
'GL_DEPTH_COMPONENT24', or 'GL_DEPTH_COMPONENT32', and FORMAT is
not 'GL_DEPTH_COMPONENT'.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and DATA is
not evenly divisible into the number of bytes needed to store in
memory a datum indicated by TYPE.
'GL_INVALID_OPERATION' is generated if 'glTexImage2D' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glTexImage3D target level internalFormat width height
depth border format type data
Specify a three-dimensional texture image.
TARGET
Specifies the target texture. Must be 'GL_TEXTURE_3D' or
'GL_PROXY_TEXTURE_3D'.
LEVEL
Specifies the level-of-detail number. Level 0 is the base
image level. Level N is the N^TH mipmap reduction image.
INTERNALFORMAT
Specifies the number of color components in the texture. Must
be 1, 2, 3, or 4, or one of the following symbolic constants:
'GL_ALPHA', 'GL_ALPHA4', 'GL_ALPHA8', 'GL_ALPHA12',
'GL_ALPHA16', 'GL_COMPRESSED_ALPHA',
'GL_COMPRESSED_LUMINANCE', 'GL_COMPRESSED_LUMINANCE_ALPHA',
'GL_COMPRESSED_INTENSITY', 'GL_COMPRESSED_RGB',
'GL_COMPRESSED_RGBA', 'GL_LUMINANCE', 'GL_LUMINANCE4',
'GL_LUMINANCE8', 'GL_LUMINANCE12', 'GL_LUMINANCE16',
'GL_LUMINANCE_ALPHA', 'GL_LUMINANCE4_ALPHA4',
'GL_LUMINANCE6_ALPHA2', 'GL_LUMINANCE8_ALPHA8',
'GL_LUMINANCE12_ALPHA4', 'GL_LUMINANCE12_ALPHA12',
'GL_LUMINANCE16_ALPHA16', 'GL_INTENSITY', 'GL_INTENSITY4',
'GL_INTENSITY8', 'GL_INTENSITY12', 'GL_INTENSITY16',
'GL_R3_G3_B2', 'GL_RGB', 'GL_RGB4', 'GL_RGB5', 'GL_RGB8',
'GL_RGB10', 'GL_RGB12', 'GL_RGB16', 'GL_RGBA', 'GL_RGBA2',
'GL_RGBA4', 'GL_RGB5_A1', 'GL_RGBA8', 'GL_RGB10_A2',
'GL_RGBA12', 'GL_RGBA16', 'GL_SLUMINANCE', 'GL_SLUMINANCE8',
'GL_SLUMINANCE_ALPHA', 'GL_SLUMINANCE8_ALPHA8', 'GL_SRGB',
'GL_SRGB8', 'GL_SRGB_ALPHA', or 'GL_SRGB8_ALPHA8'.
WIDTH
Specifies the width of the texture image including the border
if any. If the GL version does not support non-power-of-two
sizes, this value must be 2^N+2(BORDER,) for some integer
N. All implementations support 3D texture images that are at
least 16 texels wide.
HEIGHT
Specifies the height of the texture image including the border
if any. If the GL version does not support non-power-of-two
sizes, this value must be 2^M+2(BORDER,) for some integer
M. All implementations support 3D texture images that are at
least 16 texels high.
DEPTH
Specifies the depth of the texture image including the border
if any. If the GL version does not support non-power-of-two
sizes, this value must be 2^K+2(BORDER,) for some integer
K. All implementations support 3D texture images that are at
least 16 texels deep.
BORDER
Specifies the width of the border. Must be either 0 or 1.
FORMAT
Specifies the format of the pixel data. The following
symbolic values are accepted: 'GL_COLOR_INDEX', 'GL_RED',
'GL_GREEN', 'GL_BLUE', 'GL_ALPHA', 'GL_RGB', 'GL_BGR',
'GL_RGBA', 'GL_BGRA', 'GL_LUMINANCE', and
'GL_LUMINANCE_ALPHA'.
TYPE
Specifies the data type of the pixel data. The following
symbolic values are accepted: 'GL_UNSIGNED_BYTE', 'GL_BYTE',
'GL_BITMAP', 'GL_UNSIGNED_SHORT', 'GL_SHORT',
'GL_UNSIGNED_INT', 'GL_INT', 'GL_FLOAT',
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', 'GL_UNSIGNED_SHORT_5_6_5_REV',
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', and
'GL_UNSIGNED_INT_2_10_10_10_REV'.
DATA
Specifies a pointer to the image data in memory.
Texturing maps a portion of a specified texture image onto each
graphical primitive for which texturing is enabled. To enable and
disable three-dimensional texturing, call 'glEnable' and
'glDisable' with argument 'GL_TEXTURE_3D'.
To define texture images, call 'glTexImage3D'. The arguments
describe the parameters of the texture image, such as height,
width, depth, width of the border, level-of-detail number (see
'glTexParameter'), and number of color components provided. The
last three arguments describe how the image is represented in
memory; they are identical to the pixel formats used for
'glDrawPixels'.
If TARGET is 'GL_PROXY_TEXTURE_3D', no data is read from DATA, but
all of the texture image state is recalculated, checked for
consistency, and checked against the implementation's capabilities.
If the implementation cannot handle a texture of the requested
texture size, it sets all of the image state to 0, but does not
generate an error (see 'glGetError'). To query for an entire
mipmap array, use an image array level greater than or equal to 1.
If TARGET is 'GL_TEXTURE_3D', data is read from DATA as a sequence
of signed or unsigned bytes, shorts, or longs, or single-precision
floating-point values, depending on TYPE. These values are grouped
into sets of one, two, three, or four values, depending on FORMAT,
to form elements. If TYPE is 'GL_BITMAP', the data is considered
as a string of unsigned bytes (and FORMAT must be
'GL_COLOR_INDEX'). Each data byte is treated as eight 1-bit
elements, with bit ordering determined by 'GL_UNPACK_LSB_FIRST'
(see 'glPixelStore').
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
texture image is specified, DATA is treated as a byte offset into
the buffer object's data store.
The first element corresponds to the lower left corner of the
texture image. Subsequent elements progress left-to-right through
the remaining texels in the lowest row of the texture image, and
then in successively higher rows of the texture image. The final
element corresponds to the upper right corner of the texture image.
FORMAT determines the composition of each element in DATA. It can
assume one of these symbolic values:
'GL_COLOR_INDEX'
Each element is a single value, a color index. The GL
converts it to fixed point (with an unspecified number of zero
bits to the right of the binary point), shifted left or right
depending on the value and sign of 'GL_INDEX_SHIFT', and added
to 'GL_INDEX_OFFSET' (see 'glPixelTransfer'). The resulting
index is converted to a set of color components using the
'GL_PIXEL_MAP_I_TO_R', 'GL_PIXEL_MAP_I_TO_G',
'GL_PIXEL_MAP_I_TO_B', and 'GL_PIXEL_MAP_I_TO_A' tables, and
clamped to the range [0,1].
'GL_RED'
Each element is a single red component. The GL converts it to
floating point and assembles it into an RGBA element by
attaching 0 for green and blue, and 1 for alpha. Each
component is then multiplied by the signed scale factor
'GL_c_SCALE', added to the signed bias 'GL_c_BIAS', and
clamped to the range [0,1] (see 'glPixelTransfer').
'GL_GREEN'
Each element is a single green component. The GL converts it
to floating point and assembles it into an RGBA element by
attaching 0 for red and blue, and 1 for alpha. Each component
is then multiplied by the signed scale factor 'GL_c_SCALE',
added to the signed bias 'GL_c_BIAS', and clamped to the range
[0,1] (see 'glPixelTransfer').
'GL_BLUE'
Each element is a single blue component. The GL converts it
to floating point and assembles it into an RGBA element by
attaching 0 for red and green, and 1 for alpha. Each
component is then multiplied by the signed scale factor
'GL_c_SCALE', added to the signed bias 'GL_c_BIAS', and
clamped to the range [0,1] (see 'glPixelTransfer').
'GL_ALPHA'
Each element is a single alpha component. The GL converts it
to floating point and assembles it into an RGBA element by
attaching 0 for red, green, and blue. Each component is then
multiplied by the signed scale factor 'GL_c_SCALE', added to
the signed bias 'GL_c_BIAS', and clamped to the range [0,1]
(see 'glPixelTransfer').
'GL_INTENSITY'
Each element is a single intensity value. The GL converts it
to floating point, then assembles it into an RGBA element by
replicating the intensity value three times for red, green,
blue, and alpha. Each component is then multiplied by the
signed scale factor 'GL_c_SCALE', added to the signed bias
'GL_c_BIAS', and clamped to the range [0,1] (see
'glPixelTransfer').
'GL_RGB'
'GL_BGR'
Each element is an RGB triple. The GL converts it to floating
point and assembles it into an RGBA element by attaching 1 for
alpha. Each component is then multiplied by the signed scale
factor 'GL_c_SCALE', added to the signed bias 'GL_c_BIAS', and
clamped to the range [0,1] (see 'glPixelTransfer').
'GL_RGBA'
'GL_BGRA'
Each element contains all four components. Each component is
multiplied by the signed scale factor 'GL_c_SCALE', added to
the signed bias 'GL_c_BIAS', and clamped to the range [0,1]
(see 'glPixelTransfer').
'GL_LUMINANCE'
Each element is a single luminance value. The GL converts it
to floating point, then assembles it into an RGBA element by
replicating the luminance value three times for red, green,
and blue and attaching 1 for alpha. Each component is then
multiplied by the signed scale factor 'GL_c_SCALE', added to
the signed bias 'GL_c_BIAS', and clamped to the range [0,1]
(see 'glPixelTransfer').
'GL_LUMINANCE_ALPHA'
Each element is a luminance/alpha pair. The GL converts it to
floating point, then assembles it into an RGBA element by
replicating the luminance value three times for red, green,
and blue. Each component is then multiplied by the signed
scale factor 'GL_c_SCALE', added to the signed bias
'GL_c_BIAS', and clamped to the range [0,1] (see
'glPixelTransfer').
Refer to the 'glDrawPixels' reference page for a description of the
acceptable values for the TYPE parameter.
If an application wants to store the texture at a certain
resolution or in a certain format, it can request the resolution
and format with INTERNALFORMAT. The GL will choose an internal
representation that closely approximates that requested by
INTERNALFORMAT, but it may not match exactly. (The representations
specified by 'GL_LUMINANCE', 'GL_LUMINANCE_ALPHA', 'GL_RGB', and
'GL_RGBA' must match exactly. The numeric values 1, 2, 3, and 4
may also be used to specify the above representations.)
If the INTERNALFORMAT parameter is one of the generic compressed
formats, 'GL_COMPRESSED_ALPHA', 'GL_COMPRESSED_INTENSITY',
'GL_COMPRESSED_LUMINANCE', 'GL_COMPRESSED_LUMINANCE_ALPHA',
'GL_COMPRESSED_RGB', or 'GL_COMPRESSED_RGBA', the GL will replace
the internal format with the symbolic constant for a specific
internal format and compress the texture before storage. If no
corresponding internal format is available, or the GL can not
compress that image for any reason, the internal format is instead
replaced with a corresponding base internal format.
If the INTERNALFORMAT parameter is 'GL_SRGB', 'GL_SRGB8',
'GL_SRGB_ALPHA', 'GL_SRGB8_ALPHA8', 'GL_SLUMINANCE',
'GL_SLUMINANCE8', 'GL_SLUMINANCE_ALPHA', or
'GL_SLUMINANCE8_ALPHA8', the texture is treated as if the red,
green, blue, or luminance components are encoded in the sRGB color
space. Any alpha component is left unchanged. The conversion from
the sRGB encoded component C_S to a linear component C_L is:
C_L={(C_S/12.92 if C_S≤0.04045), (('c'_'s'+0.055/1.055)^2.4 if
C_S>0.04045)
Assume C_S is the sRGB component in the range [0,1].
Use the 'GL_PROXY_TEXTURE_3D' target to try out a resolution and
format. The implementation will update and recompute its best
match for the requested storage resolution and format. To then
query this state, call 'glGetTexLevelParameter'. If the texture
cannot be accommodated, texture state is set to 0.
A one-component texture image uses only the red component of the
RGBA color extracted from DATA. A two-component image uses the R
and A values. A three-component image uses the R, G, and B values.
A four-component image uses all of the RGBA components.
'GL_INVALID_ENUM' is generated if TARGET is not 'GL_TEXTURE_3D' or
'GL_PROXY_TEXTURE_3D'.
'GL_INVALID_ENUM' is generated if FORMAT is not an accepted format
constant. Format constants other than 'GL_STENCIL_INDEX' and
'GL_DEPTH_COMPONENT' are accepted.
'GL_INVALID_ENUM' is generated if TYPE is not a type constant.
'GL_INVALID_ENUM' is generated if TYPE is 'GL_BITMAP' and FORMAT is
not 'GL_COLOR_INDEX'.
'GL_INVALID_VALUE' is generated if LEVEL is less than 0.
'GL_INVALID_VALUE' may be generated if LEVEL is greater than
LOG_2(MAX,), where MAX is the returned value of
'GL_MAX_TEXTURE_SIZE'.
'GL_INVALID_VALUE' is generated if INTERNALFORMAT is not 1, 2, 3,
4, or one of the accepted resolution and format symbolic constants.
'GL_INVALID_VALUE' is generated if WIDTH, HEIGHT, or DEPTH is less
than 0 or greater than 2 + 'GL_MAX_TEXTURE_SIZE'.
'GL_INVALID_VALUE' is generated if non-power-of-two textures are
not supported and the WIDTH, HEIGHT, or DEPTH cannot be represented
as 2^K+2(BORDER,) for some integer value of K.
'GL_INVALID_VALUE' is generated if BORDER is not 0 or 1.
'GL_INVALID_OPERATION' is generated if TYPE is one of
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', or 'GL_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GL_RGB'.
'GL_INVALID_OPERATION' is generated if TYPE is one of
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', or 'GL_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GL_RGBA' nor 'GL_BGRA'.
'GL_INVALID_OPERATION' is generated if FORMAT or INTERNALFORMAT is
'GL_DEPTH_COMPONENT', 'GL_DEPTH_COMPONENT16',
'GL_DEPTH_COMPONENT24', or 'GL_DEPTH_COMPONENT32'.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and DATA is
not evenly divisible into the number of bytes needed to store in
memory a datum indicated by TYPE.
'GL_INVALID_OPERATION' is generated if 'glTexImage3D' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glTexParameterf target pname param
-- Function: void glTexParameteri target pname param
-- Function: void glTexParameterfv target pname params
-- Function: void glTexParameteriv target pname params
Set texture parameters.
TARGET
Specifies the target texture, which must be either
'GL_TEXTURE_1D', 'GL_TEXTURE_2D', 'GL_TEXTURE_3D', or
'GL_TEXTURE_CUBE_MAP'.
PNAME
Specifies the symbolic name of a single-valued texture
parameter. PNAME can be one of the following:
'GL_TEXTURE_MIN_FILTER', 'GL_TEXTURE_MAG_FILTER',
'GL_TEXTURE_MIN_LOD', 'GL_TEXTURE_MAX_LOD',
'GL_TEXTURE_BASE_LEVEL', 'GL_TEXTURE_MAX_LEVEL',
'GL_TEXTURE_WRAP_S', 'GL_TEXTURE_WRAP_T', 'GL_TEXTURE_WRAP_R',
'GL_TEXTURE_PRIORITY', 'GL_TEXTURE_COMPARE_MODE',
'GL_TEXTURE_COMPARE_FUNC', 'GL_DEPTH_TEXTURE_MODE', or
'GL_GENERATE_MIPMAP'.
PARAM
Specifies the value of PNAME.
Texture mapping is a technique that applies an image onto an
object's surface as if the image were a decal or cellophane
shrink-wrap. The image is created in texture space, with an (S, T)
coordinate system. A texture is a one- or two-dimensional image
and a set of parameters that determine how samples are derived from
the image.
'glTexParameter' assigns the value or values in PARAMS to the
texture parameter specified as PNAME. TARGET defines the target
texture, either 'GL_TEXTURE_1D', 'GL_TEXTURE_2D', or
'GL_TEXTURE_3D'. The following symbols are accepted in PNAME:
'GL_TEXTURE_MIN_FILTER'
The texture minifying function is used whenever the pixel
being textured maps to an area greater than one texture
element. There are six defined minifying functions. Two of
them use the nearest one or nearest four texture elements to
compute the texture value. The other four use mipmaps.
A mipmap is an ordered set of arrays representing the same
image at progressively lower resolutions. If the texture has
dimensions 2^N×2^M, there are MAX(N,M)+1 mipmaps. The
first mipmap is the original texture, with dimensions
2^N×2^M. Each subsequent mipmap has dimensions
2^K-1,×2^L-1,, where 2^K×2^L are the dimensions of the
previous mipmap, until either K=0 or L=0. At that point,
subsequent mipmaps have dimension 1×2^L-1, or 2^K-1,×1 until
the final mipmap, which has dimension 1×1. To define the
mipmaps, call 'glTexImage1D', 'glTexImage2D', 'glTexImage3D',
'glCopyTexImage1D', or 'glCopyTexImage2D' with the LEVEL
argument indicating the order of the mipmaps. Level 0 is the
original texture; level MAX(N,M) is the final 1×1 mipmap.
PARAMS supplies a function for minifying the texture as one of
the following:
As more texture elements are sampled in the minification
process, fewer aliasing artifacts will be apparent. While the
'GL_NEAREST' and 'GL_LINEAR' minification functions can be
faster than the other four, they sample only one or four
texture elements to determine the texture value of the pixel
being rendered and can produce moire patterns or ragged
transitions. The initial value of 'GL_TEXTURE_MIN_FILTER' is
'GL_NEAREST_MIPMAP_LINEAR'.
'GL_TEXTURE_MAG_FILTER'
The texture magnification function is used when the pixel
being textured maps to an area less than or equal to one
texture element. It sets the texture magnification function
to either 'GL_NEAREST' or 'GL_LINEAR' (see below).
'GL_NEAREST' is generally faster than 'GL_LINEAR', but it can
produce textured images with sharper edges because the
transition between texture elements is not as smooth. The
initial value of 'GL_TEXTURE_MAG_FILTER' is 'GL_LINEAR'.
'GL_NEAREST'
Returns the value of the texture element that is nearest (in
Manhattan distance) to the center of the pixel being textured.
'GL_LINEAR'
Returns the weighted average of the four texture elements that
are closest to the center of the pixel being textured. These
can include border texture elements, depending on the values
of 'GL_TEXTURE_WRAP_S' and 'GL_TEXTURE_WRAP_T', and on the
exact mapping.
'GL_NEAREST_MIPMAP_NEAREST'
Chooses the mipmap that most closely matches the size of the
pixel being textured and uses the 'GL_NEAREST' criterion (the
texture element nearest to the center of the pixel) to produce
a texture value.
'GL_LINEAR_MIPMAP_NEAREST'
Chooses the mipmap that most closely matches the size of the
pixel being textured and uses the 'GL_LINEAR' criterion (a
weighted average of the four texture elements that are closest
to the center of the pixel) to produce a texture value.
'GL_NEAREST_MIPMAP_LINEAR'
Chooses the two mipmaps that most closely match the size of
the pixel being textured and uses the 'GL_NEAREST' criterion
(the texture element nearest to the center of the pixel) to
produce a texture value from each mipmap. The final texture
value is a weighted average of those two values.
'GL_LINEAR_MIPMAP_LINEAR'
Chooses the two mipmaps that most closely match the size of
the pixel being textured and uses the 'GL_LINEAR' criterion (a
weighted average of the four texture elements that are closest
to the center of the pixel) to produce a texture value from
each mipmap. The final texture value is a weighted average of
those two values.
'GL_NEAREST'
Returns the value of the texture element that is nearest (in
Manhattan distance) to the center of the pixel being textured.
'GL_LINEAR'
Returns the weighted average of the four texture elements that
are closest to the center of the pixel being textured. These
can include border texture elements, depending on the values
of 'GL_TEXTURE_WRAP_S' and 'GL_TEXTURE_WRAP_T', and on the
exact mapping.
'GL_TEXTURE_MIN_LOD'
Sets the minimum level-of-detail parameter. This
floating-point value limits the selection of highest
resolution mipmap (lowest mipmap level). The initial value is
-1000.
'GL_TEXTURE_MAX_LOD'
Sets the maximum level-of-detail parameter. This
floating-point value limits the selection of the lowest
resolution mipmap (highest mipmap level). The initial value
is 1000.
'GL_TEXTURE_BASE_LEVEL'
Specifies the index of the lowest defined mipmap level. This
is an integer value. The initial value is 0.
'GL_TEXTURE_MAX_LEVEL'
Sets the index of the highest defined mipmap level. This is
an integer value. The initial value is 1000.
'GL_TEXTURE_WRAP_S'
Sets the wrap parameter for texture coordinate S to either
'GL_CLAMP', 'GL_CLAMP_TO_BORDER', 'GL_CLAMP_TO_EDGE',
'GL_MIRRORED_REPEAT', or 'GL_REPEAT'. 'GL_CLAMP' causes S
coordinates to be clamped to the range [0,1] and is useful for
preventing wrapping artifacts when mapping a single image onto
an object. 'GL_CLAMP_TO_BORDER' causes the S coordinate to be
clamped to the range [-1/2N,,1+1/2N,], where N is the size of
the texture in the direction of clamping.'GL_CLAMP_TO_EDGE'
causes S coordinates to be clamped to the range
[1/2N,,1-1/2N,], where N is the size of the texture in the
direction of clamping. 'GL_REPEAT' causes the integer part of
the S coordinate to be ignored; the GL uses only the
fractional part, thereby creating a repeating pattern.
'GL_MIRRORED_REPEAT' causes the S coordinate to be set to the
fractional part of the texture coordinate if the integer part
of S is even; if the integer part of S is odd, then the S
texture coordinate is set to 1-FRAC(S,), where FRAC(S,)
represents the fractional part of S. Border texture elements
are accessed only if wrapping is set to 'GL_CLAMP' or
'GL_CLAMP_TO_BORDER'. Initially, 'GL_TEXTURE_WRAP_S' is set
to 'GL_REPEAT'.
'GL_TEXTURE_WRAP_T'
Sets the wrap parameter for texture coordinate T to either
'GL_CLAMP', 'GL_CLAMP_TO_BORDER', 'GL_CLAMP_TO_EDGE',
'GL_MIRRORED_REPEAT', or 'GL_REPEAT'. See the discussion
under 'GL_TEXTURE_WRAP_S'. Initially, 'GL_TEXTURE_WRAP_T' is
set to 'GL_REPEAT'.
'GL_TEXTURE_WRAP_R'
Sets the wrap parameter for texture coordinate R to either
'GL_CLAMP', 'GL_CLAMP_TO_BORDER', 'GL_CLAMP_TO_EDGE',
'GL_MIRRORED_REPEAT', or 'GL_REPEAT'. See the discussion
under 'GL_TEXTURE_WRAP_S'. Initially, 'GL_TEXTURE_WRAP_R' is
set to 'GL_REPEAT'.
'GL_TEXTURE_BORDER_COLOR'
Sets a border color. PARAMS contains four values that
comprise the RGBA color of the texture border. Integer color
components are interpreted linearly such that the most
positive integer maps to 1.0, and the most negative integer
maps to -1.0. The values are clamped to the range [0,1] when
they are specified. Initially, the border color is (0, 0, 0,
0).
'GL_TEXTURE_PRIORITY'
Specifies the texture residence priority of the currently
bound texture. Permissible values are in the range [0,1].
See 'glPrioritizeTextures' and 'glBindTexture' for more
information.
'GL_TEXTURE_COMPARE_MODE'
Specifies the texture comparison mode for currently bound
depth textures. That is, a texture whose internal format is
'GL_DEPTH_COMPONENT_*'; see 'glTexImage2D') Permissible values
are:
'GL_TEXTURE_COMPARE_FUNC'
Specifies the comparison operator used when
'GL_TEXTURE_COMPARE_MODE' is set to 'GL_COMPARE_R_TO_TEXTURE'.
Permissible values are: where R is the current interpolated
texture coordinate, and D_T is the depth texture value sampled
from the currently bound depth texture. RESULT is assigned to
the either the luminance, intensity, or alpha (as specified by
'GL_DEPTH_TEXTURE_MODE'.)
'GL_DEPTH_TEXTURE_MODE'
Specifies a single symbolic constant indicating how depth
values should be treated during filtering and texture
application. Accepted values are 'GL_LUMINANCE',
'GL_INTENSITY', and 'GL_ALPHA'. The initial value is
'GL_LUMINANCE'.
'GL_GENERATE_MIPMAP'
Specifies a boolean value that indicates if all levels of a
mipmap array should be automatically updated when any
modification to the base level mipmap is done. The initial
value is 'GL_FALSE'.
'GL_COMPARE_R_TO_TEXTURE'
Specifies that the interpolated and clamped R texture
coordinate should be compared to the value in the currently
bound depth texture. See the discussion of
'GL_TEXTURE_COMPARE_FUNC' for details of how the comparison is
evaluated. The result of the comparison is assigned to
luminance, intensity, or alpha (as specified by
'GL_DEPTH_TEXTURE_MODE').
'GL_NONE'
Specifies that the luminance, intensity, or alpha (as
specified by 'GL_DEPTH_TEXTURE_MODE') should be assigned the
appropriate value from the currently bound depth texture.
*Texture Comparison Function*
*Computed result*
'GL_LEQUAL'
RESULT={(1.0), (0.0) (R<=D_T,), (R>D_T,),
'GL_GEQUAL'
RESULT={(1.0), (0.0) (R>=D_T,), (R=D_T,),
'GL_GREATER'
RESULT={(1.0), (0.0) (R>D_T,), (R<=D_T,),
'GL_EQUAL'
RESULT={(1.0), (0.0) (R=D_T,), (R≠D_T,),
'GL_NOTEQUAL'
RESULT={(1.0), (0.0) (R≠D_T,), (R=D_T,),
'GL_ALWAYS'
RESULT='1.0'
'GL_NEVER'
RESULT='0.0'
'GL_INVALID_ENUM' is generated if TARGET or PNAME is not one of the
accepted defined values.
'GL_INVALID_ENUM' is generated if PARAMS should have a defined
constant value (based on the value of PNAME) and does not.
'GL_INVALID_OPERATION' is generated if 'glTexParameter' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glTexSubImage1D target level xoffset width format
type data
Specify a one-dimensional texture subimage.
TARGET
Specifies the target texture. Must be 'GL_TEXTURE_1D'.
LEVEL
Specifies the level-of-detail number. Level 0 is the base
image level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
array.
WIDTH
Specifies the width of the texture subimage.
FORMAT
Specifies the format of the pixel data. The following
symbolic values are accepted: 'GL_COLOR_INDEX', 'GL_RED',
'GL_GREEN', 'GL_BLUE', 'GL_ALPHA', 'GL_RGB', 'GL_BGR',
'GL_RGBA', 'GL_BGRA', 'GL_LUMINANCE', and
'GL_LUMINANCE_ALPHA'.
TYPE
Specifies the data type of the pixel data. The following
symbolic values are accepted: 'GL_UNSIGNED_BYTE', 'GL_BYTE',
'GL_BITMAP', 'GL_UNSIGNED_SHORT', 'GL_SHORT',
'GL_UNSIGNED_INT', 'GL_INT', 'GL_FLOAT',
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', 'GL_UNSIGNED_SHORT_5_6_5_REV',
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', and
'GL_UNSIGNED_INT_2_10_10_10_REV'.
DATA
Specifies a pointer to the image data in memory.
Texturing maps a portion of a specified texture image onto each
graphical primitive for which texturing is enabled. To enable or
disable one-dimensional texturing, call 'glEnable' and 'glDisable'
with argument 'GL_TEXTURE_1D'.
'glTexSubImage1D' redefines a contiguous subregion of an existing
one-dimensional texture image. The texels referenced by DATA
replace the portion of the existing texture array with x indices
XOFFSET and XOFFSET+WIDTH-1, inclusive. This region may not
include any texels outside the range of the texture array as it was
originally specified. It is not an error to specify a subtexture
with width of 0, but such a specification has no effect.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
texture image is specified, DATA is treated as a byte offset into
the buffer object's data store.
'GL_INVALID_ENUM' is generated if TARGET is not one of the
allowable values.
'GL_INVALID_ENUM' is generated if FORMAT is not an accepted format
constant.
'GL_INVALID_ENUM' is generated if TYPE is not a type constant.
'GL_INVALID_ENUM' is generated if TYPE is 'GL_BITMAP' and FORMAT is
not 'GL_COLOR_INDEX'.
'GL_INVALID_VALUE' is generated if LEVEL is less than 0.
'GL_INVALID_VALUE' may be generated if LEVEL is greater than
LOG_2MAX, where MAX is the returned value of 'GL_MAX_TEXTURE_SIZE'.
'GL_INVALID_VALUE' is generated if XOFFSET<-B, or if
(XOFFSET+WIDTH,)>(W-B,), where W is the 'GL_TEXTURE_WIDTH', and B
is the width of the 'GL_TEXTURE_BORDER' of the texture image being
modified. Note that W includes twice the border width.
'GL_INVALID_VALUE' is generated if WIDTH is less than 0.
'GL_INVALID_OPERATION' is generated if the texture array has not
been defined by a previous 'glTexImage1D' operation.
'GL_INVALID_OPERATION' is generated if TYPE is one of
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', or 'GL_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GL_RGB'.
'GL_INVALID_OPERATION' is generated if TYPE is one of
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', or 'GL_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GL_RGBA' nor 'GL_BGRA'.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and DATA is
not evenly divisible into the number of bytes needed to store in
memory a datum indicated by TYPE.
'GL_INVALID_OPERATION' is generated if 'glTexSubImage1D' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glTexSubImage2D target level xoffset yoffset width
height format type data
Specify a two-dimensional texture subimage.
TARGET
Specifies the target texture. Must be 'GL_TEXTURE_2D',
'GL_TEXTURE_CUBE_MAP_POSITIVE_X',
'GL_TEXTURE_CUBE_MAP_NEGATIVE_X',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Y',
'GL_TEXTURE_CUBE_MAP_NEGATIVE_Y',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Z', or
'GL_TEXTURE_CUBE_MAP_NEGATIVE_Z'.
LEVEL
Specifies the level-of-detail number. Level 0 is the base
image level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
array.
YOFFSET
Specifies a texel offset in the y direction within the texture
array.
WIDTH
Specifies the width of the texture subimage.
HEIGHT
Specifies the height of the texture subimage.
FORMAT
Specifies the format of the pixel data. The following
symbolic values are accepted: 'GL_COLOR_INDEX', 'GL_RED',
'GL_GREEN', 'GL_BLUE', 'GL_ALPHA', 'GL_RGB', 'GL_BGR',
'GL_RGBA', 'GL_BGRA', 'GL_LUMINANCE', and
'GL_LUMINANCE_ALPHA'.
TYPE
Specifies the data type of the pixel data. The following
symbolic values are accepted: 'GL_UNSIGNED_BYTE', 'GL_BYTE',
'GL_BITMAP', 'GL_UNSIGNED_SHORT', 'GL_SHORT',
'GL_UNSIGNED_INT', 'GL_INT', 'GL_FLOAT',
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', 'GL_UNSIGNED_SHORT_5_6_5_REV',
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', and
'GL_UNSIGNED_INT_2_10_10_10_REV'.
DATA
Specifies a pointer to the image data in memory.
Texturing maps a portion of a specified texture image onto each
graphical primitive for which texturing is enabled. To enable and
disable two-dimensional texturing, call 'glEnable' and 'glDisable'
with argument 'GL_TEXTURE_2D'.
'glTexSubImage2D' redefines a contiguous subregion of an existing
two-dimensional texture image. The texels referenced by DATA
replace the portion of the existing texture array with x indices
XOFFSET and XOFFSET+WIDTH-1, inclusive, and y indices YOFFSET and
YOFFSET+HEIGHT-1, inclusive. This region may not include any
texels outside the range of the texture array as it was originally
specified. It is not an error to specify a subtexture with zero
width or height, but such a specification has no effect.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
texture image is specified, DATA is treated as a byte offset into
the buffer object's data store.
'GL_INVALID_ENUM' is generated if TARGET is not 'GL_TEXTURE_2D',
'GL_TEXTURE_CUBE_MAP_POSITIVE_X', 'GL_TEXTURE_CUBE_MAP_NEGATIVE_X',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Y', 'GL_TEXTURE_CUBE_MAP_NEGATIVE_Y',
'GL_TEXTURE_CUBE_MAP_POSITIVE_Z', or
'GL_TEXTURE_CUBE_MAP_NEGATIVE_Z'.
'GL_INVALID_ENUM' is generated if FORMAT is not an accepted format
constant.
'GL_INVALID_ENUM' is generated if TYPE is not a type constant.
'GL_INVALID_ENUM' is generated if TYPE is 'GL_BITMAP' and FORMAT is
not 'GL_COLOR_INDEX'.
'GL_INVALID_VALUE' is generated if LEVEL is less than 0.
'GL_INVALID_VALUE' may be generated if LEVEL is greater than
LOG_2MAX, where MAX is the returned value of 'GL_MAX_TEXTURE_SIZE'.
'GL_INVALID_VALUE' is generated if XOFFSET<-B,
(XOFFSET+WIDTH,)>(W-B,), YOFFSET<-B, or (YOFFSET+HEIGHT,)>(H-B,),
where W is the 'GL_TEXTURE_WIDTH', H is the 'GL_TEXTURE_HEIGHT',
and B is the border width of the texture image being modified.
Note that W and H include twice the border width.
'GL_INVALID_VALUE' is generated if WIDTH or HEIGHT is less than 0.
'GL_INVALID_OPERATION' is generated if the texture array has not
been defined by a previous 'glTexImage2D' operation.
'GL_INVALID_OPERATION' is generated if TYPE is one of
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', or 'GL_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GL_RGB'.
'GL_INVALID_OPERATION' is generated if TYPE is one of
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', or 'GL_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GL_RGBA' nor 'GL_BGRA'.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and DATA is
not evenly divisible into the number of bytes needed to store in
memory a datum indicated by TYPE.
'GL_INVALID_OPERATION' is generated if 'glTexSubImage2D' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glTexSubImage3D target level xoffset yoffset zoffset
width height depth format type data
Specify a three-dimensional texture subimage.
TARGET
Specifies the target texture. Must be 'GL_TEXTURE_3D'.
LEVEL
Specifies the level-of-detail number. Level 0 is the base
image level. Level N is the Nth mipmap reduction image.
XOFFSET
Specifies a texel offset in the x direction within the texture
array.
YOFFSET
Specifies a texel offset in the y direction within the texture
array.
ZOFFSET
Specifies a texel offset in the z direction within the texture
array.
WIDTH
Specifies the width of the texture subimage.
HEIGHT
Specifies the height of the texture subimage.
DEPTH
Specifies the depth of the texture subimage.
FORMAT
Specifies the format of the pixel data. The following
symbolic values are accepted: 'GL_COLOR_INDEX', 'GL_RED',
'GL_GREEN', 'GL_BLUE', 'GL_ALPHA', 'GL_RGB', 'GL_BGR',
'GL_RGBA', 'GL_BGRA', 'GL_LUMINANCE', and
'GL_LUMINANCE_ALPHA'.
TYPE
Specifies the data type of the pixel data. The following
symbolic values are accepted: 'GL_UNSIGNED_BYTE', 'GL_BYTE',
'GL_BITMAP', 'GL_UNSIGNED_SHORT', 'GL_SHORT',
'GL_UNSIGNED_INT', 'GL_INT', 'GL_FLOAT',
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', 'GL_UNSIGNED_SHORT_5_6_5_REV',
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', and
'GL_UNSIGNED_INT_2_10_10_10_REV'.
DATA
Specifies a pointer to the image data in memory.
Texturing maps a portion of a specified texture image onto each
graphical primitive for which texturing is enabled. To enable and
disable three-dimensional texturing, call 'glEnable' and
'glDisable' with argument 'GL_TEXTURE_3D'.
'glTexSubImage3D' redefines a contiguous subregion of an existing
three-dimensional texture image. The texels referenced by DATA
replace the portion of the existing texture array with x indices
XOFFSET and XOFFSET+WIDTH-1, inclusive, y indices YOFFSET and
YOFFSET+HEIGHT-1, inclusive, and z indices ZOFFSET and
ZOFFSET+DEPTH-1, inclusive. This region may not include any texels
outside the range of the texture array as it was originally
specified. It is not an error to specify a subtexture with zero
width, height, or depth but such a specification has no effect.
If a non-zero named buffer object is bound to the
'GL_PIXEL_UNPACK_BUFFER' target (see 'glBindBuffer') while a
texture image is specified, DATA is treated as a byte offset into
the buffer object's data store.
'GL_INVALID_ENUM' is generated if /TARGET is not 'GL_TEXTURE_3D'.
'GL_INVALID_ENUM' is generated if FORMAT is not an accepted format
constant.
'GL_INVALID_ENUM' is generated if TYPE is not a type constant.
'GL_INVALID_ENUM' is generated if TYPE is 'GL_BITMAP' and FORMAT is
not 'GL_COLOR_INDEX'.
'GL_INVALID_VALUE' is generated if LEVEL is less than 0.
'GL_INVALID_VALUE' may be generated if LEVEL is greater than
LOG_2MAX, where MAX is the returned value of 'GL_MAX_TEXTURE_SIZE'.
'GL_INVALID_VALUE' is generated if XOFFSET<-B,
(XOFFSET+WIDTH,)>(W-B,), YOFFSET<-B, or (YOFFSET+HEIGHT,)>(H-B,),
or ZOFFSET<-B, or (ZOFFSET+DEPTH,)>(D-B,), where W is the
'GL_TEXTURE_WIDTH', H is the 'GL_TEXTURE_HEIGHT', D is the
'GL_TEXTURE_DEPTH' and B is the border width of the texture image
being modified. Note that W, H, and D include twice the border
width.
'GL_INVALID_VALUE' is generated if WIDTH, HEIGHT, or DEPTH is less
than 0.
'GL_INVALID_OPERATION' is generated if the texture array has not
been defined by a previous 'glTexImage3D' operation.
'GL_INVALID_OPERATION' is generated if TYPE is one of
'GL_UNSIGNED_BYTE_3_3_2', 'GL_UNSIGNED_BYTE_2_3_3_REV',
'GL_UNSIGNED_SHORT_5_6_5', or 'GL_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GL_RGB'.
'GL_INVALID_OPERATION' is generated if TYPE is one of
'GL_UNSIGNED_SHORT_4_4_4_4', 'GL_UNSIGNED_SHORT_4_4_4_4_REV',
'GL_UNSIGNED_SHORT_5_5_5_1', 'GL_UNSIGNED_SHORT_1_5_5_5_REV',
'GL_UNSIGNED_INT_8_8_8_8', 'GL_UNSIGNED_INT_8_8_8_8_REV',
'GL_UNSIGNED_INT_10_10_10_2', or 'GL_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GL_RGBA' nor 'GL_BGRA'.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the buffer
object's data store is currently mapped.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and the data
would be unpacked from the buffer object such that the memory reads
required would exceed the data store size.
'GL_INVALID_OPERATION' is generated if a non-zero buffer object
name is bound to the 'GL_PIXEL_UNPACK_BUFFER' target and DATA is
not evenly divisible into the number of bytes needed to store in
memory a datum indicated by TYPE.
'GL_INVALID_OPERATION' is generated if 'glTexSubImage3D' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glTranslated x y z
-- Function: void glTranslatef x y z
Multiply the current matrix by a translation matrix.
X
Y
Z
Specify the X, Y, and Z coordinates of a translation vector.
'glTranslate' produces a translation by (X,YZ). The current matrix
(see 'glMatrixMode') is multiplied by this translation matrix, with
the product replacing the current matrix, as if 'glMultMatrix' were
called with the following matrix for its argument:
((1 0 0 X), (0 1 0 Y), (0 0 1 Z), (0 0 0 1),)
If the matrix mode is either 'GL_MODELVIEW' or 'GL_PROJECTION', all
objects drawn after a call to 'glTranslate' are translated.
Use 'glPushMatrix' and 'glPopMatrix' to save and restore the
untranslated coordinate system.
'GL_INVALID_OPERATION' is generated if 'glTranslate' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glUniform1f location v0
-- Function: void glUniform2f location v0 v1
-- Function: void glUniform3f location v0 v1 v2
-- Function: void glUniform4f location v0 v1 v2 v3
-- Function: void glUniform1i location v0
-- Function: void glUniform2i location v0 v1
-- Function: void glUniform3i location v0 v1 v2
-- Function: void glUniform4i location v0 v1 v2 v3
-- Function: void glUniform1fv location count value
-- Function: void glUniform2fv location count value
-- Function: void glUniform3fv location count value
-- Function: void glUniform4fv location count value
-- Function: void glUniform1iv location count value
-- Function: void glUniform2iv location count value
-- Function: void glUniform3iv location count value
-- Function: void glUniform4iv location count value
-- Function: void glUniformMatrix2fv location count transpose value
-- Function: void glUniformMatrix3fv location count transpose value
-- Function: void glUniformMatrix4fv location count transpose value
-- Function: void glUniformMatrix2x3fv location count transpose value
-- Function: void glUniformMatrix3x2fv location count transpose value
-- Function: void glUniformMatrix2x4fv location count transpose value
-- Function: void glUniformMatrix4x2fv location count transpose value
-- Function: void glUniformMatrix3x4fv location count transpose value
-- Function: void glUniformMatrix4x3fv location count transpose value
Specify the value of a uniform variable for the current program
object.
LOCATION
Specifies the location of the uniform variable to be modified.
V0, V1, V2, V3
Specifies the new values to be used for the specified uniform
variable.
'glUniform' modifies the value of a uniform variable or a uniform
variable array. The location of the uniform variable to be
modified is specified by LOCATION, which should be a value returned
by 'glGetUniformLocation'. 'glUniform' operates on the program
object that was made part of current state by calling
'glUseProgram'.
The commands 'glUniform{1|2|3|4}{f|i}' are used to change the value
of the uniform variable specified by LOCATION using the values
passed as arguments. The number specified in the command should
match the number of components in the data type of the specified
uniform variable (e.g., '1' for float, int, bool; '2' for vec2,
ivec2, bvec2, etc.). The suffix 'f' indicates that floating-point
values are being passed; the suffix 'i' indicates that integer
values are being passed, and this type should also match the data
type of the specified uniform variable. The 'i' variants of this
function should be used to provide values for uniform variables
defined as int, ivec2, ivec3, ivec4, or arrays of these. The 'f'
variants should be used to provide values for uniform variables of
type float, vec2, vec3, vec4, or arrays of these. Either the 'i'
or the 'f' variants may be used to provide values for uniform
variables of type bool, bvec2, bvec3, bvec4, or arrays of these.
The uniform variable will be set to false if the input value is 0
or 0.0f, and it will be set to true otherwise.
All active uniform variables defined in a program object are
initialized to 0 when the program object is linked successfully.
They retain the values assigned to them by a call to 'glUniform '
until the next successful link operation occurs on the program
object, when they are once again initialized to 0.
The commands 'glUniform{1|2|3|4}{f|i}v' can be used to modify a
single uniform variable or a uniform variable array. These
commands pass a count and a pointer to the values to be loaded into
a uniform variable or a uniform variable array. A count of 1
should be used if modifying the value of a single uniform variable,
and a count of 1 or greater can be used to modify an entire array
or part of an array. When loading N elements starting at an
arbitrary position M in a uniform variable array, elements M + N -
1 in the array will be replaced with the new values. If M + N - 1
is larger than the size of the uniform variable array, values for
all array elements beyond the end of the array will be ignored.
The number specified in the name of the command indicates the
number of components for each element in VALUE, and it should match
the number of components in the data type of the specified uniform
variable (e.g., '1' for float, int, bool; '2' for vec2, ivec2,
bvec2, etc.). The data type specified in the name of the command
must match the data type for the specified uniform variable as
described previously for 'glUniform{1|2|3|4}{f|i}'.
For uniform variable arrays, each element of the array is
considered to be of the type indicated in the name of the command
(e.g., 'glUniform3f' or 'glUniform3fv' can be used to load a
uniform variable array of type vec3). The number of elements of
the uniform variable array to be modified is specified by COUNT
The commands 'glUniformMatrix{2|3|4|2x3|3x2|2x4|4x2|3x4|4x3}fv' are
used to modify a matrix or an array of matrices. The numbers in
the command name are interpreted as the dimensionality of the
matrix. The number '2' indicates a 2 × 2 matrix (i.e., 4 values),
the number '3' indicates a 3 × 3 matrix (i.e., 9 values), and the
number '4' indicates a 4 × 4 matrix (i.e., 16 values). Non-square
matrix dimensionality is explicit, with the first number
representing the number of columns and the second number
representing the number of rows. For example, '2x4' indicates a 2
× 4 matrix with 2 columns and 4 rows (i.e., 8 values). If
TRANSPOSE is 'GL_FALSE', each matrix is assumed to be supplied in
column major order. If TRANSPOSE is 'GL_TRUE', each matrix is
assumed to be supplied in row major order. The COUNT argument
indicates the number of matrices to be passed. A count of 1 should
be used if modifying the value of a single matrix, and a count
greater than 1 can be used to modify an array of matrices.
'GL_INVALID_OPERATION' is generated if there is no current program
object.
'GL_INVALID_OPERATION' is generated if the size of the uniform
variable declared in the shader does not match the size indicated
by the 'glUniform' command.
'GL_INVALID_OPERATION' is generated if one of the integer variants
of this function is used to load a uniform variable of type float,
vec2, vec3, vec4, or an array of these, or if one of the
floating-point variants of this function is used to load a uniform
variable of type int, ivec2, ivec3, or ivec4, or an array of these.
'GL_INVALID_OPERATION' is generated if LOCATION is an invalid
uniform location for the current program object and LOCATION is not
equal to -1.
'GL_INVALID_VALUE' is generated if COUNT is less than 0.
'GL_INVALID_OPERATION' is generated if COUNT is greater than 1 and
the indicated uniform variable is not an array variable.
'GL_INVALID_OPERATION' is generated if a sampler is loaded using a
command other than 'glUniform1i' and 'glUniform1iv'.
'GL_INVALID_OPERATION' is generated if 'glUniform' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glUseProgram program
Installs a program object as part of current rendering state.
PROGRAM
Specifies the handle of the program object whose executables
are to be used as part of current rendering state.
'glUseProgram' installs the program object specified by PROGRAM as
part of current rendering state. One or more executables are
created in a program object by successfully attaching shader
objects to it with 'glAttachShader', successfully compiling the
shader objects with 'glCompileShader', and successfully linking the
program object with 'glLinkProgram'.
A program object will contain an executable that will run on the
vertex processor if it contains one or more shader objects of type
'GL_VERTEX_SHADER' that have been successfully compiled and linked.
Similarly, a program object will contain an executable that will
run on the fragment processor if it contains one or more shader
objects of type 'GL_FRAGMENT_SHADER' that have been successfully
compiled and linked.
Successfully installing an executable on a programmable processor
will cause the corresponding fixed functionality of OpenGL to be
disabled. Specifically, if an executable is installed on the
vertex processor, the OpenGL fixed functionality will be disabled
as follows.
* The modelview matrix is not applied to vertex coordinates.
* The projection matrix is not applied to vertex coordinates.
* The texture matrices are not applied to texture coordinates.
* Normals are not transformed to eye coordinates.
* Normals are not rescaled or normalized.
* Normalization of 'GL_AUTO_NORMAL' evaluated normals is not
performed.
* Texture coordinates are not generated automatically.
* Per-vertex lighting is not performed.
* Color material computations are not performed.
* Color index lighting is not performed.
* This list also applies when setting the current raster
position.
The executable that is installed on the vertex processor is
expected to implement any or all of the desired functionality from
the preceding list. Similarly, if an executable is installed on
the fragment processor, the OpenGL fixed functionality will be
disabled as follows.
* Texture environment and texture functions are not applied.
* Texture application is not applied.
* Color sum is not applied.
* Fog is not applied.
Again, the fragment shader that is installed is expected to
implement any or all of the desired functionality from the
preceding list.
While a program object is in use, applications are free to modify
attached shader objects, compile attached shader objects, attach
additional shader objects, and detach or delete shader objects.
None of these operations will affect the executables that are part
of the current state. However, relinking the program object that
is currently in use will install the program object as part of the
current rendering state if the link operation was successful (see
'glLinkProgram' ). If the program object currently in use is
relinked unsuccessfully, its link status will be set to 'GL_FALSE',
but the executables and associated state will remain part of the
current state until a subsequent call to 'glUseProgram' removes it
from use. After it is removed from use, it cannot be made part of
current state until it has been successfully relinked.
If PROGRAM contains shader objects of type 'GL_VERTEX_SHADER' but
it does not contain shader objects of type 'GL_FRAGMENT_SHADER', an
executable will be installed on the vertex processor, but fixed
functionality will be used for fragment processing. Similarly, if
PROGRAM contains shader objects of type 'GL_FRAGMENT_SHADER' but it
does not contain shader objects of type 'GL_VERTEX_SHADER', an
executable will be installed on the fragment processor, but fixed
functionality will be used for vertex processing. If PROGRAM is 0,
the programmable processors will be disabled, and fixed
functionality will be used for both vertex and fragment processing.
'GL_INVALID_VALUE' is generated if PROGRAM is neither 0 nor a value
generated by OpenGL.
'GL_INVALID_OPERATION' is generated if PROGRAM is not a program
object.
'GL_INVALID_OPERATION' is generated if PROGRAM could not be made
part of current state.
'GL_INVALID_OPERATION' is generated if 'glUseProgram' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glValidateProgram program
Validates a program object.
PROGRAM
Specifies the handle of the program object to be validated.
'glValidateProgram' checks to see whether the executables contained
in PROGRAM can execute given the current OpenGL state. The
information generated by the validation process will be stored in
PROGRAM's information log. The validation information may consist
of an empty string, or it may be a string containing information
about how the current program object interacts with the rest of
current OpenGL state. This provides a way for OpenGL implementers
to convey more information about why the current program is
inefficient, suboptimal, failing to execute, and so on.
The status of the validation operation will be stored as part of
the program object's state. This value will be set to 'GL_TRUE' if
the validation succeeded, and 'GL_FALSE' otherwise. It can be
queried by calling 'glGetProgram' with arguments PROGRAM and
'GL_VALIDATE_STATUS'. If validation is successful, PROGRAM is
guaranteed to execute given the current state. Otherwise, PROGRAM
is guaranteed to not execute.
This function is typically useful only during application
development. The informational string stored in the information
log is completely implementation dependent; therefore, an
application should not expect different OpenGL implementations to
produce identical information strings.
'GL_INVALID_VALUE' is generated if PROGRAM is not a value generated
by OpenGL.
'GL_INVALID_OPERATION' is generated if PROGRAM is not a program
object.
'GL_INVALID_OPERATION' is generated if 'glValidateProgram' is
executed between the execution of 'glBegin' and the corresponding
execution of 'glEnd'.
-- Function: void glVertexAttribPointer index size type normalized
stride pointer
Define an array of generic vertex attribute data.
INDEX
Specifies the index of the generic vertex attribute to be
modified.
SIZE
Specifies the number of components per generic vertex
attribute. Must be 1, 2, 3, or 4. The initial value is 4.
TYPE
Specifies the data type of each component in the array.
Symbolic constants 'GL_BYTE', 'GL_UNSIGNED_BYTE', 'GL_SHORT',
'GL_UNSIGNED_SHORT', 'GL_INT', 'GL_UNSIGNED_INT', 'GL_FLOAT',
or 'GL_DOUBLE' are accepted. The initial value is 'GL_FLOAT'.
NORMALIZED
Specifies whether fixed-point data values should be normalized
('GL_TRUE') or converted directly as fixed-point values
('GL_FALSE') when they are accessed.
STRIDE
Specifies the byte offset between consecutive generic vertex
attributes. If STRIDE is 0, the generic vertex attributes are
understood to be tightly packed in the array. The initial
value is 0.
POINTER
Specifies a pointer to the first component of the first
generic vertex attribute in the array. The initial value is
0.
'glVertexAttribPointer' specifies the location and data format of
the array of generic vertex attributes at index INDEX to use when
rendering. SIZE specifies the number of components per attribute
and must be 1, 2, 3, or 4. TYPE specifies the data type of each
component, and STRIDE specifies the byte stride from one attribute
to the next, allowing vertices and attributes to be packed into a
single array or stored in separate arrays. If set to 'GL_TRUE',
NORMALIZED indicates that values stored in an integer format are to
be mapped to the range [-1,1] (for signed values) or [0,1] (for
unsigned values) when they are accessed and converted to floating
point. Otherwise, values will be converted to floats directly
without normalization.
If a non-zero named buffer object is bound to the 'GL_ARRAY_BUFFER'
target (see 'glBindBuffer') while a generic vertex attribute array
is specified, POINTER is treated as a byte offset into the buffer
object's data store. Also, the buffer object binding
('GL_ARRAY_BUFFER_BINDING') is saved as generic vertex attribute
array client-side state ('GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING')
for index INDEX.
When a generic vertex attribute array is specified, SIZE, TYPE,
NORMALIZED, STRIDE, and POINTER are saved as client-side state, in
addition to the current vertex array buffer object binding.
To enable and disable a generic vertex attribute array, call
'glEnableVertexAttribArray' and 'glDisableVertexAttribArray' with
INDEX. If enabled, the generic vertex attribute array is used when
'glArrayElement', 'glDrawArrays', 'glMultiDrawArrays',
'glDrawElements', 'glMultiDrawElements', or 'glDrawRangeElements'
is called.
'GL_INVALID_VALUE' is generated if INDEX is greater than or equal
to 'GL_MAX_VERTEX_ATTRIBS'.
'GL_INVALID_VALUE' is generated if SIZE is not 1, 2, 3, or 4.
'GL_INVALID_ENUM' is generated if TYPE is not an accepted value.
'GL_INVALID_VALUE' is generated if STRIDE is negative.
-- Function: void glVertexAttrib1f index v0
-- Function: void glVertexAttrib1s index v0
-- Function: void glVertexAttrib1d index v0
-- Function: void glVertexAttrib2f index v0 v1
-- Function: void glVertexAttrib2s index v0 v1
-- Function: void glVertexAttrib2d index v0 v1
-- Function: void glVertexAttrib3f index v0 v1 v2
-- Function: void glVertexAttrib3s index v0 v1 v2
-- Function: void glVertexAttrib3d index v0 v1 v2
-- Function: void glVertexAttrib4f index v0 v1 v2 v3
-- Function: void glVertexAttrib4s index v0 v1 v2 v3
-- Function: void glVertexAttrib4d index v0 v1 v2 v3
-- Function: void glVertexAttrib4Nub index v0 v1 v2 v3
-- Function: void glVertexAttrib1fv index v
-- Function: void glVertexAttrib1sv index v
-- Function: void glVertexAttrib1dv index v
-- Function: void glVertexAttrib2fv index v
-- Function: void glVertexAttrib2sv index v
-- Function: void glVertexAttrib2dv index v
-- Function: void glVertexAttrib3fv index v
-- Function: void glVertexAttrib3sv index v
-- Function: void glVertexAttrib3dv index v
-- Function: void glVertexAttrib4fv index v
-- Function: void glVertexAttrib4sv index v
-- Function: void glVertexAttrib4dv index v
-- Function: void glVertexAttrib4iv index v
-- Function: void glVertexAttrib4bv index v
-- Function: void glVertexAttrib4ubv index v
-- Function: void glVertexAttrib4usv index v
-- Function: void glVertexAttrib4uiv index v
-- Function: void glVertexAttrib4Nbv index v
-- Function: void glVertexAttrib4Nsv index v
-- Function: void glVertexAttrib4Niv index v
-- Function: void glVertexAttrib4Nubv index v
-- Function: void glVertexAttrib4Nusv index v
-- Function: void glVertexAttrib4Nuiv index v
Specifies the value of a generic vertex attribute.
INDEX
Specifies the index of the generic vertex attribute to be
modified.
V0, V1, V2, V3
Specifies the new values to be used for the specified vertex
attribute.
OpenGL defines a number of standard vertex attributes that
applications can modify with standard API entry points (color,
normal, texture coordinates, etc.). The 'glVertexAttrib' family of
entry points allows an application to pass generic vertex
attributes in numbered locations.
Generic attributes are defined as four-component values that are
organized into an array. The first entry of this array is numbered
0, and the size of the array is specified by the
implementation-dependent constant 'GL_MAX_VERTEX_ATTRIBS'.
Individual elements of this array can be modified with a
'glVertexAttrib' call that specifies the index of the element to be
modified and a value for that element.
These commands can be used to specify one, two, three, or all four
components of the generic vertex attribute specified by INDEX. A
'1' in the name of the command indicates that only one value is
passed, and it will be used to modify the first component of the
generic vertex attribute. The second and third components will be
set to 0, and the fourth component will be set to 1. Similarly, a
'2' in the name of the command indicates that values are provided
for the first two components, the third component will be set to 0,
and the fourth component will be set to 1. A '3' in the name of
the command indicates that values are provided for the first three
components and the fourth component will be set to 1, whereas a '4'
in the name indicates that values are provided for all four
components.
The letters 's', 'f', 'i', 'd', 'ub', 'us', and 'ui' indicate
whether the arguments are of type short, float, int, double,
unsigned byte, unsigned short, or unsigned int. When 'v' is
appended to the name, the commands can take a pointer to an array
of such values. The commands containing 'N' indicate that the
arguments will be passed as fixed-point values that are scaled to a
normalized range according to the component conversion rules
defined by the OpenGL specification. Signed values are understood
to represent fixed-point values in the range [-1,1], and unsigned
values are understood to represent fixed-point values in the range
[0,1].
OpenGL Shading Language attribute variables are allowed to be of
type mat2, mat3, or mat4. Attributes of these types may be loaded
using the 'glVertexAttrib' entry points. Matrices must be loaded
into successive generic attribute slots in column major order, with
one column of the matrix in each generic attribute slot.
A user-defined attribute variable declared in a vertex shader can
be bound to a generic attribute index by calling
'glBindAttribLocation'. This allows an application to use more
descriptive variable names in a vertex shader. A subsequent change
to the specified generic vertex attribute will be immediately
reflected as a change to the corresponding attribute variable in
the vertex shader.
The binding between a generic vertex attribute index and a
user-defined attribute variable in a vertex shader is part of the
state of a program object, but the current value of the generic
vertex attribute is not. The value of each generic vertex
attribute is part of current state, just like standard vertex
attributes, and it is maintained even if a different program object
is used.
An application may freely modify generic vertex attributes that are
not bound to a named vertex shader attribute variable. These
values are simply maintained as part of current state and will not
be accessed by the vertex shader. If a generic vertex attribute
bound to an attribute variable in a vertex shader is not updated
while the vertex shader is executing, the vertex shader will
repeatedly use the current value for the generic vertex attribute.
The generic vertex attribute with index 0 is the same as the vertex
position attribute previously defined by OpenGL. A 'glVertex2',
'glVertex3', or 'glVertex4' command is completely equivalent to the
corresponding 'glVertexAttrib' command with an index argument of 0.
A vertex shader can access generic vertex attribute 0 by using the
built-in attribute variable GL_VERTEX. There are no current values
for generic vertex attribute 0. This is the only generic vertex
attribute with this property; calls to set other standard vertex
attributes can be freely mixed with calls to set any of the other
generic vertex attributes.
'GL_INVALID_VALUE' is generated if INDEX is greater than or equal
to 'GL_MAX_VERTEX_ATTRIBS'.
-- Function: void glVertexPointer size type stride pointer
Define an array of vertex data.
SIZE
Specifies the number of coordinates per vertex. Must be 2, 3,
or 4. The initial value is 4.
TYPE
Specifies the data type of each coordinate in the array.
Symbolic constants 'GL_SHORT', 'GL_INT', 'GL_FLOAT', or
'GL_DOUBLE' are accepted. The initial value is 'GL_FLOAT'.
STRIDE
Specifies the byte offset between consecutive vertices. If
STRIDE is 0, the vertices are understood to be tightly packed
in the array. The initial value is 0.
POINTER
Specifies a pointer to the first coordinate of the first
vertex in the array. The initial value is 0.
'glVertexPointer' specifies the location and data format of an
array of vertex coordinates to use when rendering. SIZE specifies
the number of coordinates per vertex, and must be 2, 3, or 4. TYPE
specifies the data type of each coordinate, and STRIDE specifies
the byte stride from one vertex to the next, allowing vertices and
attributes to be packed into a single array or stored in separate
arrays. (Single-array storage may be more efficient on some
implementations; see 'glInterleavedArrays'.)
If a non-zero named buffer object is bound to the 'GL_ARRAY_BUFFER'
target (see 'glBindBuffer') while a vertex array is specified,
POINTER is treated as a byte offset into the buffer object's data
store. Also, the buffer object binding ('GL_ARRAY_BUFFER_BINDING')
is saved as vertex array client-side state
('GL_VERTEX_ARRAY_BUFFER_BINDING').
When a vertex array is specified, SIZE, TYPE, STRIDE, and POINTER
are saved as client-side state, in addition to the current vertex
array buffer object binding.
To enable and disable the vertex array, call 'glEnableClientState'
and 'glDisableClientState' with the argument 'GL_VERTEX_ARRAY'. If
enabled, the vertex array is used when 'glArrayElement',
'glDrawArrays', 'glMultiDrawArrays', 'glDrawElements',
'glMultiDrawElements', or 'glDrawRangeElements' is called.
'GL_INVALID_VALUE' is generated if SIZE is not 2, 3, or 4.
'GL_INVALID_ENUM' is generated if TYPE is not an accepted value.
'GL_INVALID_VALUE' is generated if STRIDE is negative.
-- Function: void glVertex2s x y
-- Function: void glVertex2i x y
-- Function: void glVertex2f x y
-- Function: void glVertex2d x y
-- Function: void glVertex3s x y z
-- Function: void glVertex3i x y z
-- Function: void glVertex3f x y z
-- Function: void glVertex3d x y z
-- Function: void glVertex4s x y z w
-- Function: void glVertex4i x y z w
-- Function: void glVertex4f x y z w
-- Function: void glVertex4d x y z w
-- Function: void glVertex2sv v
-- Function: void glVertex2iv v
-- Function: void glVertex2fv v
-- Function: void glVertex2dv v
-- Function: void glVertex3sv v
-- Function: void glVertex3iv v
-- Function: void glVertex3fv v
-- Function: void glVertex3dv v
-- Function: void glVertex4sv v
-- Function: void glVertex4iv v
-- Function: void glVertex4fv v
-- Function: void glVertex4dv v
Specify a vertex.
X
Y
Z
W
Specify X, Y, Z, and W coordinates of a vertex. Not all
parameters are present in all forms of the command.
'glVertex' commands are used within 'glBegin'/'glEnd' pairs to
specify point, line, and polygon vertices. The current color,
normal, texture coordinates, and fog coordinate are associated with
the vertex when 'glVertex' is called.
When only X and Y are specified, Z defaults to 0 and W defaults to
1. When X, Y, and Z are specified, W defaults to 1.
-- Function: void glViewport x y width height
Set the viewport.
X
Y
Specify the lower left corner of the viewport rectangle, in
pixels. The initial value is (0,0).
WIDTH
HEIGHT
Specify the width and height of the viewport. When a GL
context is first attached to a window, WIDTH and HEIGHT are
set to the dimensions of that window.
'glViewport' specifies the affine transformation of X and Y from
normalized device coordinates to window coordinates. Let
(X_ND,Y_ND) be normalized device coordinates. Then the window
coordinates (X_W,Y_W) are computed as follows:
X_W=(X_ND+1,)(WIDTH/2,)+X
Y_W=(Y_ND+1,)(HEIGHT/2,)+Y
Viewport width and height are silently clamped to a range that
depends on the implementation. To query this range, call 'glGet'
with argument 'GL_MAX_VIEWPORT_DIMS'.
'GL_INVALID_VALUE' is generated if either WIDTH or HEIGHT is
negative.
'GL_INVALID_OPERATION' is generated if 'glViewport' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
-- Function: void glWindowPos2s x y
-- Function: void glWindowPos2i x y
-- Function: void glWindowPos2f x y
-- Function: void glWindowPos2d x y
-- Function: void glWindowPos3s x y z
-- Function: void glWindowPos3i x y z
-- Function: void glWindowPos3f x y z
-- Function: void glWindowPos3d x y z
-- Function: void glWindowPos2sv v
-- Function: void glWindowPos2iv v
-- Function: void glWindowPos2fv v
-- Function: void glWindowPos2dv v
-- Function: void glWindowPos3sv v
-- Function: void glWindowPos3iv v
-- Function: void glWindowPos3fv v
-- Function: void glWindowPos3dv v
Specify the raster position in window coordinates for pixel
operations.
X
Y
Z
Specify the X, Y, Z coordinates for the raster position.
The GL maintains a 3D position in window coordinates. This
position, called the raster position, is used to position pixel and
bitmap write operations. It is maintained with subpixel accuracy.
See 'glBitmap', 'glDrawPixels', and 'glCopyPixels'.
'glWindowPos2' specifies the X and Y coordinates, while Z is
implicitly set to 0. 'glWindowPos3' specifies all three
coordinates. The W coordinate of the current raster position is
always set to 1.0.
'glWindowPos' directly updates the X and Y coordinates of the
current raster position with the values specified. That is, the
values are neither transformed by the current modelview and
projection matrices, nor by the viewport-to-window transform. The
Z coordinate of the current raster position is updated in the
following manner:
Z={(N), (F), (N+Z×(F-N,),)(IFZ<=0), (IFZ>=1),
('otherwise',),
where N is 'GL_DEPTH_RANGE''s near value, and F is
'GL_DEPTH_RANGE''s far value. See 'glDepthRange'.
The specified coordinates are not clip-tested, causing the raster
position to always be valid.
The current raster position also includes some associated color
data and texture coordinates. If lighting is enabled, then
'GL_CURRENT_RASTER_COLOR' (in RGBA mode) or
'GL_CURRENT_RASTER_INDEX' (in color index mode) is set to the color
produced by the lighting calculation (see 'glLight',
'glLightModel', and 'glShadeModel'). If lighting is disabled,
current color (in RGBA mode, state variable 'GL_CURRENT_COLOR') or
color index (in color index mode, state variable
'GL_CURRENT_INDEX') is used to update the current raster color.
'GL_CURRENT_RASTER_SECONDARY_COLOR' (in RGBA mode) is likewise
updated.
Likewise, 'GL_CURRENT_RASTER_TEXTURE_COORDS' is updated as a
function of 'GL_CURRENT_TEXTURE_COORDS', based on the texture
matrix and the texture generation functions (see 'glTexGen'). The
'GL_CURRENT_RASTER_DISTANCE' is set to the 'GL_CURRENT_FOG_COORD'.
'GL_INVALID_OPERATION' is generated if 'glWindowPos' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
3.7 GL Extensions
=================
The future is already here - it's just not very evenly distributed.
- William Gibson
Before interfaces end up in the core OpenGL API, the are usually
present as vendor-specific or candidate extensions. Indeed, the making
of an OpenGL standard these days seems to be a matter of simply
collecting a set of mature extensions and making them coherent.
Guile doesn't currently provide specific interfaces for GL
extensions. Perhaps it should, but that's a lot of work that we haven't
had time to do. Contributions are welcome.
In the meantime, if you know enough about GL to know that you need an
extension, you can define one yourself - after all, this library is all
a bunch of Scheme code anyway.
For example, let's say you decide that you need to render to a
framebuffer object. You go to and
pick out an extension, say
.
This extension defines a procedure, 'GLboolean
glIsRenderBuffer(GLuint)'. So you define it:
(use-modules (gl runtime) (gl types))
(define-gl-procedure (glIsRenderBuffer (buf GLuint) -> GLboolean)
"Render buffer predicate. Other docs here.")
And that's that. It's a low-level binding, but what did you expect?
Note that you'll still need to check for the availability of this
extension at runtime with '(glGetString GL_EXTENSIONS)'.
4 GLU
*****
4.1 GLU API
===========
Import the GLU module to have access to these procedures:
(use-modules (glu))
The GLU specification is available at
.
4.1.1 Initialization
--------------------
4.1.2 Mipmapping
----------------
4.1.3 Matrix Manipulation
-------------------------
-- Function: glu-perspective fov-y aspect z-near z-far
Set up a perspective projection matrix.
FOV-Y is the field of view angle, in degrees, in the Y direction.
ASPECT is the ratio of width to height. Z-NEAR and Z-FAR are the
distances from the viewer to the near and far clipping planes,
respectively.
The resulting matrix is multiplied against the current matrix.
4.1.4 Polygon Tesselation
-------------------------
4.1.5 Quadrics
--------------
4.1.6 NURBS
-----------
4.1.7 Errors
------------
4.2 Low-Level GLU
=================
The functions from this section may be had by loading the module:
(use-modules (glu low-level)
This section of the manual was derived from the upstream OpenGL
documentation. Each function's documentation has its own copyright
statement; for full details, see the upstream documentation. The
copyright notices and licenses present in this section are as follows.
Copyright (C) 1991-2006 Silicon Graphics, Inc. This document is
licensed under the SGI Free Software B License. For details, see
http://oss.sgi.com/projects/FreeB/ (http://oss.sgi.com/projects/FreeB/).
-- Function: void gluBeginCurve nurb
-- Function: void gluEndCurve nurb
Delimit a NURBS curve definition.
NURB
Specifies the NURBS object (created with
'gluNewNurbsRenderer').
Use 'gluBeginCurve' to mark the beginning of a NURBS curve
definition. After calling 'gluBeginCurve', make one or more calls
to 'gluNurbsCurve' to define the attributes of the curve. Exactly
one of the calls to 'gluNurbsCurve' must have a curve type of
'GLU_MAP1_VERTEX_3' or 'GLU_MAP1_VERTEX_4'. To mark the end of the
NURBS curve definition, call 'gluEndCurve'.
GL evaluators are used to render the NURBS curve as a series of
line segments. Evaluator state is preserved during rendering with
'glPushAttrib'('GLU_EVAL_BIT') and 'glPopAttrib'(). See the
'glPushAttrib' reference page for details on exactly what state
these calls preserve.
-- Function: void gluBeginPolygon tess
-- Function: void gluEndPolygon tess
Delimit a polygon description.
TESS
Specifies the tessellation object (created with 'gluNewTess').
'gluBeginPolygon' and 'gluEndPolygon' delimit the definition of a
nonconvex polygon. To define such a polygon, first call
'gluBeginPolygon'. Then define the contours of the polygon by
calling 'gluTessVertex' for each vertex and 'gluNextContour' to
start each new contour. Finally, call 'gluEndPolygon' to signal
the end of the definition. See the 'gluTessVertex' and
'gluNextContour' reference pages for more details.
Once 'gluEndPolygon' is called, the polygon is tessellated, and the
resulting triangles are described through callbacks. See
'gluTessCallback' for descriptions of the callback functions.
-- Function: void gluBeginSurface nurb
-- Function: void gluEndSurface nurb
Delimit a NURBS surface definition.
NURB
Specifies the NURBS object (created with
'gluNewNurbsRenderer').
Use 'gluBeginSurface' to mark the beginning of a NURBS surface
definition. After calling 'gluBeginSurface', make one or more
calls to 'gluNurbsSurface' to define the attributes of the surface.
Exactly one of these calls to 'gluNurbsSurface' must have a surface
type of 'GLU_MAP2_VERTEX_3' or 'GLU_MAP2_VERTEX_4'. To mark the
end of the NURBS surface definition, call 'gluEndSurface'.
Trimming of NURBS surfaces is supported with 'gluBeginTrim',
'gluPwlCurve', 'gluNurbsCurve', and 'gluEndTrim'. See the
'gluBeginTrim' reference page for details.
GL evaluators are used to render the NURBS surface as a set of
polygons. Evaluator state is preserved during rendering with
'glPushAttrib'('GLU_EVAL_BIT') and 'glPopAttrib'. See the
'glPushAttrib' reference page for details on exactly what state
these calls preserve.
-- Function: void gluBeginTrim nurb
-- Function: void gluEndTrim nurb
Delimit a NURBS trimming loop definition.
NURB
Specifies the NURBS object (created with
'gluNewNurbsRenderer').
Use 'gluBeginTrim' to mark the beginning of a trimming loop and
'gluEndTrim' to mark the end of a trimming loop. A trimming loop
is a set of oriented curve segments (forming a closed curve) that
define boundaries of a NURBS surface. You include these trimming
loops in the definition of a NURBS surface, between calls to
'gluBeginSurface' and 'gluEndSurface'.
The definition for a NURBS surface can contain many trimming loops.
For example, if you wrote a definition for a NURBS surface that
resembled a rectangle with a hole punched out, the definition would
contain two trimming loops. One loop would define the outer edge
of the rectangle; the other would define the hole punched out of
the rectangle. The definitions of each of these trimming loops
would be bracketed by a 'gluBeginTrim'/'gluEndTrim' pair.
The definition of a single closed trimming loop can consist of
multiple curve segments, each described as a piecewise linear curve
(see 'gluPwlCurve') or as a single NURBS curve (see
'gluNurbsCurve'), or as a combination of both in any order. The
only library calls that can appear in a trimming loop definition
(between the calls to 'gluBeginTrim' and 'gluEndTrim') are
'gluPwlCurve' and 'gluNurbsCurve'.
The area of the NURBS surface that is displayed is the region in
the domain to the left of the trimming curve as the curve parameter
increases. Thus, the retained region of the NURBS surface is
inside a counterclockwise trimming loop and outside a clockwise
trimming loop. For the rectangle mentioned earlier, the trimming
loop for the outer edge of the rectangle runs counterclockwise,
while the trimming loop for the punched-out hole runs clockwise.
If you use more than one curve to define a single trimming loop,
the curve segments must form a closed loop (that is, the endpoint
of each curve must be the starting point of the next curve, and the
endpoint of the final curve must be the starting point of the first
curve). If the endpoints of the curve are sufficiently close
together but not exactly coincident, they will be coerced to match.
If the endpoints are not sufficiently close, an error results (see
'gluNurbsCallback').
If a trimming loop definition contains multiple curves, the
direction of the curves must be consistent (that is, the inside
must be to the left of all of the curves). Nested trimming loops
are legal as long as the curve orientations alternate correctly.
If trimming curves are self-intersecting, or intersect one another,
an error results.
If no trimming information is given for a NURBS surface, the entire
surface is drawn.
-- Function: GLint gluBuild1DMipmapLevels target internalFormat width
format type level base max data
Builds a subset of one-dimensional mipmap levels.
TARGET
Specifies the target texture. Must be 'GLU_TEXTURE_1D'.
INTERNALFORMAT
Requests the internal storage format of the texture image.
The most current version of the SGI implementation of GLU does
not check this value for validity before passing it on to the
underlying OpenGL implementation. A value that is not
accepted by the OpenGL implementation will lead to an OpenGL
error. The benefit of not checking this value at the GLU
level is that OpenGL extensions can add new internal texture
formats without requiring a revision of the GLU
implementation. Older implementations of GLU check this value
and raise a GLU error if it is not 1, 2, 3, or 4 or one of the
following symbolic constants: 'GLU_ALPHA', 'GLU_ALPHA4',
'GLU_ALPHA8', 'GLU_ALPHA12', 'GLU_ALPHA16', 'GLU_LUMINANCE',
'GLU_LUMINANCE4', 'GLU_LUMINANCE8', 'GLU_LUMINANCE12',
'GLU_LUMINANCE16', 'GLU_LUMINANCE_ALPHA',
'GLU_LUMINANCE4_ALPHA4', 'GLU_LUMINANCE6_ALPHA2',
'GLU_LUMINANCE8_ALPHA8', 'GLU_LUMINANCE12_ALPHA4',
'GLU_LUMINANCE12_ALPHA12', 'GLU_LUMINANCE16_ALPHA16',
'GLU_INTENSITY', 'GLU_INTENSITY4', 'GLU_INTENSITY8',
'GLU_INTENSITY12', 'GLU_INTENSITY16', 'GLU_RGB',
'GLU_R3_G3_B2', 'GLU_RGB4', 'GLU_RGB5', 'GLU_RGB8',
'GLU_RGB10', 'GLU_RGB12', 'GLU_RGB16', 'GLU_RGBA',
'GLU_RGBA2', 'GLU_RGBA4', 'GLU_RGB5_A1', 'GLU_RGBA8',
'GLU_RGB10_A2', 'GLU_RGBA12', or 'GLU_RGBA16'.
WIDTH
Specifies the width in pixels of the texture image. This
should be a power of 2.
FORMAT
Specifies the format of the pixel data. Must be one of:
'GLU_COLOR_INDEX', 'GLU_DEPTH_COMPONENT', 'GLU_RED',
'GLU_GREEN', 'GLU_BLUE', 'GLU_ALPHA', 'GLU_RGB', 'GLU_RGBA',
'GLU_BGR', 'GLU_BGRA', 'GLU_LUMINANCE', or
'GLU_LUMINANCE_ALPHA'.
TYPE
Specifies the data type for DATA. Must be one of:
'GLU_UNSIGNED_BYTE', 'GLU_BYTE', 'GLU_BITMAP',
'GLU_UNSIGNED_SHORT', 'GLU_SHORT', 'GLU_UNSIGNED_INT',
'GLU_INT', 'GLU_FLOAT', 'GLU_UNSIGNED_BYTE_3_3_2',
'GLU_UNSIGNED_BYTE_2_3_3_REV', 'GLU_UNSIGNED_SHORT_5_6_5',
'GLU_UNSIGNED_SHORT_5_6_5_REV', 'GLU_UNSIGNED_SHORT_4_4_4_4',
'GLU_UNSIGNED_SHORT_4_4_4_4_REV',
'GLU_UNSIGNED_SHORT_5_5_5_1',
'GLU_UNSIGNED_SHORT_1_5_5_5_REV', 'GLU_UNSIGNED_INT_8_8_8_8',
'GLU_UNSIGNED_INT_8_8_8_8_REV', 'GLU_UNSIGNED_INT_10_10_10_2',
or 'GLU_UNSIGNED_INT_2_10_10_10_REV'.
LEVEL
Specifies the mipmap level of the image data.
BASE
Specifies the minimum mipmap level to pass to 'glTexImage1D'.
MAX
Specifies the maximum mipmap level to pass to 'glTexImage1D'.
DATA
Specifies a pointer to the image data in memory.
'gluBuild1DMipmapLevels' builds a subset of prefiltered
one-dimensional texture maps of decreasing resolutions called a
mipmap. This is used for the antialiasing of texture mapped
primitives.
A return value of zero indicates success, otherwise a GLU error
code is returned (see 'gluErrorString').
A series of mipmap levels from BASE to MAX is built by decimating
DATA in half until size 1×1 is reached. At each level, each texel
in the halved mipmap level is an average of the corresponding two
texels in the larger mipmap level. 'glTexImage1D' is called to
load these mipmap levels from BASE to MAX. If MAX is larger than
the highest mipmap level for the texture of the specified size,
then a GLU error code is returned (see 'gluErrorString') and
nothing is loaded.
For example, if LEVEL is 2 and WIDTH is 16, the following levels
are possible: 16×1, 8×1, 4×1, 2×1, 1×1. These correspond to
levels 2 through 6 respectively. If BASE is 3 and MAX is 5, then
only mipmap levels 8×1, 4×1 and 2×1 are loaded. However, if MAX
is 7, then an error is returned and nothing is loaded since MAX is
larger than the highest mipmap level which is, in this case, 6.
The highest mipmap level can be derived from the formula
LOG_2(WIDTH×2^LEVEL,).
See the 'glTexImage1D' reference page for a description of the
acceptable values for TYPE parameter. See the 'glDrawPixels'
reference page for a description of the acceptable values for LEVEL
parameter.
'GLU_INVALID_VALUE' is returned if LEVEL > BASE, BASE < 0, MAX <
BASE or MAX is > the highest mipmap level for DATA.
'GLU_INVALID_VALUE' is returned if WIDTH is < 1.
'GLU_INVALID_ENUM' is returned if INTERNALFORMAT, FORMAT, or TYPE
are not legal.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_BYTE_3_3_2' or 'GLU_UNSIGNED_BYTE_2_3_3_REV' and
FORMAT is not 'GLU_RGB'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_5_6_5' or 'GLU_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GLU_RGB'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_4_4_4_4' or 'GLU_UNSIGNED_SHORT_4_4_4_4_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_5_5_5_1' or 'GLU_UNSIGNED_SHORT_1_5_5_5_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_INT_8_8_8_8' or 'GLU_UNSIGNED_INT_8_8_8_8_REV' and
FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_INT_10_10_10_2' or 'GLU_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
-- Function: GLint gluBuild1DMipmaps target internalFormat width format
type data
Builds a one-dimensional mipmap.
TARGET
Specifies the target texture. Must be 'GLU_TEXTURE_1D'.
INTERNALFORMAT
Requests the internal storage format of the texture image.
The most current version of the SGI implementation of GLU does
not check this value for validity before passing it on to the
underlying OpenGL implementation. A value that is not
accepted by the OpenGL implementation will lead to an OpenGL
error. The benefit of not checking this value at the GLU
level is that OpenGL extensions can add new internal texture
formats without requiring a revision of the GLU
implementation. Older implementations of GLU check this value
and raise a GLU error if it is not 1, 2, 3, or 4 or one of the
following symbolic constants: 'GLU_ALPHA', 'GLU_ALPHA4',
'GLU_ALPHA8', 'GLU_ALPHA12', 'GLU_ALPHA16', 'GLU_LUMINANCE',
'GLU_LUMINANCE4', 'GLU_LUMINANCE8', 'GLU_LUMINANCE12',
'GLU_LUMINANCE16', 'GLU_LUMINANCE_ALPHA',
'GLU_LUMINANCE4_ALPHA4', 'GLU_LUMINANCE6_ALPHA2',
'GLU_LUMINANCE8_ALPHA8', 'GLU_LUMINANCE12_ALPHA4',
'GLU_LUMINANCE12_ALPHA12', 'GLU_LUMINANCE16_ALPHA16',
'GLU_INTENSITY', 'GLU_INTENSITY4', 'GLU_INTENSITY8',
'GLU_INTENSITY12', 'GLU_INTENSITY16', 'GLU_RGB',
'GLU_R3_G3_B2', 'GLU_RGB4', 'GLU_RGB5', 'GLU_RGB8',
'GLU_RGB10', 'GLU_RGB12', 'GLU_RGB16', 'GLU_RGBA',
'GLU_RGBA2', 'GLU_RGBA4', 'GLU_RGB5_A1', 'GLU_RGBA8',
'GLU_RGB10_A2', 'GLU_RGBA12', or 'GLU_RGBA16'.
WIDTH
Specifies the width, in pixels, of the texture image.
FORMAT
Specifies the format of the pixel data. Must be one of
'GLU_COLOR_INDEX', 'GLU_DEPTH_COMPONENT', 'GLU_RED',
'GLU_GREEN', 'GLU_BLUE', 'GLU_ALPHA', 'GLU_RGB', 'GLU_RGBA',
'GLU_BGR', 'GLU_BGRA', 'GLU_LUMINANCE', or
'GLU_LUMINANCE_ALPHA'.
TYPE
Specifies the data type for DATA. Must be one of
'GLU_UNSIGNED_BYTE', 'GLU_BYTE', 'GLU_BITMAP',
'GLU_UNSIGNED_SHORT', 'GLU_SHORT', 'GLU_UNSIGNED_INT',
'GLU_INT', 'GLU_FLOAT', 'GLU_UNSIGNED_BYTE_3_3_2',
'GLU_UNSIGNED_BYTE_2_3_3_REV', 'GLU_UNSIGNED_SHORT_5_6_5',
'GLU_UNSIGNED_SHORT_5_6_5_REV', 'GLU_UNSIGNED_SHORT_4_4_4_4',
'GLU_UNSIGNED_SHORT_4_4_4_4_REV',
'GLU_UNSIGNED_SHORT_5_5_5_1',
'GLU_UNSIGNED_SHORT_1_5_5_5_REV', 'GLU_UNSIGNED_INT_8_8_8_8',
'GLU_UNSIGNED_INT_8_8_8_8_REV', 'GLU_UNSIGNED_INT_10_10_10_2',
or 'GLU_UNSIGNED_INT_2_10_10_10_REV'.
DATA
Specifies a pointer to the image data in memory.
'gluBuild1DMipmaps' builds a series of prefiltered one-dimensional
texture maps of decreasing resolutions called a mipmap. This is
used for the antialiasing of texture mapped primitives.
A return value of zero indicates success, otherwise a GLU error
code is returned (see 'gluErrorString').
Initially, the WIDTH of DATA is checked to see if it is a power of
2. If not, a copy of DATA is scaled up or down to the nearest
power of 2. (If WIDTH is exactly between powers of 2, then the
copy of DATA will scale upwards.) This copy will be used for
subsequent mipmapping operations described below. For example, if
WIDTH is 57, then a copy of DATA will scale up to 64 before
mipmapping takes place.
Then, proxy textures (see 'glTexImage1D') are used to determine if
the implementation can fit the requested texture. If not, WIDTH is
continually halved until it fits.
Next, a series of mipmap levels is built by decimating a copy of
DATA in half until size 1×1 is reached. At each level, each texel
in the halved mipmap level is an average of the corresponding two
texels in the larger mipmap level.
'glTexImage1D' is called to load each of these mipmap levels.
Level 0 is a copy of DATA. The highest level is LOG_2,(WIDTH,).
For example, if WIDTH is 64 and the implementation can store a
texture of this size, the following mipmap levels are built: 64×1,
32×1, 16×1, 8×1, 4×1, 2×1, and 1×1. These correspond to
levels 0 through 6, respectively.
See the 'glTexImage1D' reference page for a description of the
acceptable values for the TYPE parameter. See the 'glDrawPixels'
reference page for a description of the acceptable values for the
DATA parameter.
'GLU_INVALID_VALUE' is returned if WIDTH is < 1.
'GLU_INVALID_ENUM' is returned if FORMAT or TYPE are not legal.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_BYTE_3_3_2' or 'GLU_UNSIGNED_BYTE_2_3_3_REV' and
FORMAT is not 'GLU_RGB'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_5_6_5' or 'GLU_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GLU_RGB'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_4_4_4_4' or 'GLU_UNSIGNED_SHORT_4_4_4_4_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_5_5_5_1' or 'GLU_UNSIGNED_SHORT_1_5_5_5_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_INT_8_8_8_8' or 'GLU_UNSIGNED_INT_8_8_8_8_REV' and
FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_INT_10_10_10_2' or 'GLU_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
-- Function: GLint gluBuild2DMipmapLevels target internalFormat width
height format type level base max data
Builds a subset of two-dimensional mipmap levels.
TARGET
Specifies the target texture. Must be 'GLU_TEXTURE_2D'.
INTERNALFORMAT
Requests the internal storage format of the texture image.
The most current version of the SGI implementation of GLU does
not check this value for validity before passing it on to the
underlying OpenGL implementation. A value that is not
accepted by the OpenGL implementation will lead to an OpenGL
error. The benefit of not checking this value at the GLU
level is that OpenGL extensions can add new internal texture
formats without requiring a revision of the GLU
implementation. Older implementations of GLU check this value
and raise a GLU error if it is not 1, 2, 3, or 4 or one of the
following symbolic constants: 'GLU_ALPHA', 'GLU_ALPHA4',
'GLU_ALPHA8', 'GLU_ALPHA12', 'GLU_ALPHA16', 'GLU_LUMINANCE',
'GLU_LUMINANCE4', 'GLU_LUMINANCE8', 'GLU_LUMINANCE12',
'GLU_LUMINANCE16', 'GLU_LUMINANCE_ALPHA',
'GLU_LUMINANCE4_ALPHA4', 'GLU_LUMINANCE6_ALPHA2',
'GLU_LUMINANCE8_ALPHA8', 'GLU_LUMINANCE12_ALPHA4',
'GLU_LUMINANCE12_ALPHA12', 'GLU_LUMINANCE16_ALPHA16',
'GLU_INTENSITY', 'GLU_INTENSITY4', 'GLU_INTENSITY8',
'GLU_INTENSITY12', 'GLU_INTENSITY16', 'GLU_RGB',
'GLU_R3_G3_B2', 'GLU_RGB4', 'GLU_RGB5', 'GLU_RGB8',
'GLU_RGB10', 'GLU_RGB12', 'GLU_RGB16', 'GLU_RGBA',
'GLU_RGBA2', 'GLU_RGBA4', 'GLU_RGB5_A1', 'GLU_RGBA8',
'GLU_RGB10_A2', 'GLU_RGBA12', or 'GLU_RGBA16'.
WIDTH
HEIGHT
Specifies the width and height, respectively, in pixels of the
texture image. These should be a power of 2.
FORMAT
Specifies the format of the pixel data. Must be one of
'GLU_COLOR_INDEX', 'GLU_DEPTH_COMPONENT', 'GLU_RED',
'GLU_GREEN', 'GLU_BLUE', 'GLU_ALPHA', 'GLU_RGB', 'GLU_RGBA',
'GLU_BGR', 'GLU_BGRA', 'GLU_LUMINANCE', or
'GLU_LUMINANCE_ALPHA'.
TYPE
Specifies the data type for DATA. Must be one of
'GLU_UNSIGNED_BYTE', 'GLU_BYTE', 'GLU_BITMAP',
'GLU_UNSIGNED_SHORT', 'GLU_SHORT', 'GLU_UNSIGNED_INT',
'GLU_INT', 'GLU_FLOAT', 'GLU_UNSIGNED_BYTE_3_3_2',
'GLU_UNSIGNED_BYTE_2_3_3_REV', 'GLU_UNSIGNED_SHORT_5_6_5',
'GLU_UNSIGNED_SHORT_5_6_5_REV', 'GLU_UNSIGNED_SHORT_4_4_4_4',
'GLU_UNSIGNED_SHORT_4_4_4_4_REV',
'GLU_UNSIGNED_SHORT_5_5_5_1',
'GLU_UNSIGNED_SHORT_1_5_5_5_REV', 'GLU_UNSIGNED_INT_8_8_8_8',
'GLU_UNSIGNED_INT_8_8_8_8_REV', 'GLU_UNSIGNED_INT_10_10_10_2',
or 'GLU_UNSIGNED_INT_2_10_10_10_REV'.
LEVEL
Specifies the mipmap level of the image data.
BASE
Specifies the minimum mipmap level to pass to 'glTexImage2D'.
MAX
Specifies the maximum mipmap level to pass to 'glTexImage2D'.
DATA
Specifies a pointer to the image data in memory.
'gluBuild2DMipmapLevels' builds a subset of prefiltered
two-dimensional texture maps of decreasing resolutions called a
mipmap. This is used for the antialiasing of texture mapped
primitives.
A return value of zero indicates success, otherwise a GLU error
code is returned (see 'gluErrorString').
A series of mipmap levels from BASE to MAX is built by decimating
DATA in half along both dimensions until size 1×1 is reached. At
each level, each texel in the halved mipmap level is an average of
the corresponding four texels in the larger mipmap level. (In the
case of rectangular images, the decimation will ultimately reach an
N×1 or 1×N configuration. Here, two texels are averaged
instead.) 'glTexImage2D' is called to load these mipmap levels
from BASE to MAX. If MAX is larger than the highest mipmap level
for the texture of the specified size, then a GLU error code is
returned (see 'gluErrorString') and nothing is loaded.
For example, if LEVEL is 2 and WIDTH is 16 and HEIGHT is 8, the
following levels are possible: 16×8, 8×4, 4×2, 2×1, 1×1.
These correspond to levels 2 through 6 respectively. If BASE is 3
and MAX is 5, then only mipmap levels 8×4, 4×2, and 2×1 are
loaded. However, if MAX is 7, then an error is returned and
nothing is loaded since MAX is larger than the highest mipmap level
which is, in this case, 6.
The highest mipmap level can be derived from the formula
LOG_2(MAX(WIDTH,HEIGHT)×2^LEVEL,).
See the 'glTexImage1D' reference page for a description of the
acceptable values for FORMAT parameter. See the 'glDrawPixels'
reference page for a description of the acceptable values for TYPE
parameter.
'GLU_INVALID_VALUE' is returned if LEVEL > BASE, BASE < 0, MAX <
BASE, or MAX is > the highest mipmap level for DATA.
'GLU_INVALID_VALUE' is returned if WIDTH or HEIGHT is < 1.
'GLU_INVALID_ENUM' is returned if INTERNALFORMAT, FORMAT, or TYPE
is not legal.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_BYTE_3_3_2' or 'GLU_UNSIGNED_BYTE_2_3_3_REV' and
FORMAT is not 'GLU_RGB'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_5_6_5' or 'GLU_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GLU_RGB'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_4_4_4_4' or 'GLU_UNSIGNED_SHORT_4_4_4_4_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_5_5_5_1' or 'GLU_UNSIGNED_SHORT_1_5_5_5_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_INT_8_8_8_8' or 'GLU_UNSIGNED_INT_8_8_8_8_REV' and
FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_INT_10_10_10_2' or 'GLU_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
-- Function: GLint gluBuild2DMipmaps target internalFormat width height
format type data
Builds a two-dimensional mipmap.
TARGET
Specifies the target texture. Must be 'GLU_TEXTURE_2D'.
INTERNALFORMAT
Requests the internal storage format of the texture image.
The most current version of the SGI implementation of GLU does
not check this value for validity before passing it on to the
underlying OpenGL implementation. A value that is not
accepted by the OpenGL implementation will lead to an OpenGL
error. The benefit of not checking this value at the GLU
level is that OpenGL extensions can add new internal texture
formats without requiring a revision of the GLU
implementation. Older implementations of GLU check this value
and raise a GLU error if it is not 1, 2, 3, or 4 or one of the
following symbolic constants: 'GLU_ALPHA', 'GLU_ALPHA4',
'GLU_ALPHA8', 'GLU_ALPHA12', 'GLU_ALPHA16', 'GLU_LUMINANCE',
'GLU_LUMINANCE4', 'GLU_LUMINANCE8', 'GLU_LUMINANCE12',
'GLU_LUMINANCE16', 'GLU_LUMINANCE_ALPHA',
'GLU_LUMINANCE4_ALPHA4', 'GLU_LUMINANCE6_ALPHA2',
'GLU_LUMINANCE8_ALPHA8', 'GLU_LUMINANCE12_ALPHA4',
'GLU_LUMINANCE12_ALPHA12', 'GLU_LUMINANCE16_ALPHA16',
'GLU_INTENSITY', 'GLU_INTENSITY4', 'GLU_INTENSITY8',
'GLU_INTENSITY12', 'GLU_INTENSITY16', 'GLU_RGB',
'GLU_R3_G3_B2', 'GLU_RGB4', 'GLU_RGB5', 'GLU_RGB8',
'GLU_RGB10', 'GLU_RGB12', 'GLU_RGB16', 'GLU_RGBA',
'GLU_RGBA2', 'GLU_RGBA4', 'GLU_RGB5_A1', 'GLU_RGBA8',
'GLU_RGB10_A2', 'GLU_RGBA12', or 'GLU_RGBA16'.
WIDTH
HEIGHT
Specifies in pixels the width and height, respectively, of the
texture image.
FORMAT
Specifies the format of the pixel data. Must be one of
'GLU_COLOR_INDEX', 'GLU_DEPTH_COMPONENT', 'GLU_RED',
'GLU_GREEN', 'GLU_BLUE', 'GLU_ALPHA', 'GLU_RGB', 'GLU_RGBA',
'GLU_BGR', 'GLU_BGRA', 'GLU_LUMINANCE', or
'GLU_LUMINANCE_ALPHA'.
TYPE
Specifies the data type for DATA. Must be one of
'GLU_UNSIGNED_BYTE', 'GLU_BYTE', 'GLU_BITMAP',
'GLU_UNSIGNED_SHORT', 'GLU_SHORT', 'GLU_UNSIGNED_INT',
'GLU_INT', 'GLU_FLOAT', 'GLU_UNSIGNED_BYTE_3_3_2',
'GLU_UNSIGNED_BYTE_2_3_3_REV', 'GLU_UNSIGNED_SHORT_5_6_5',
'GLU_UNSIGNED_SHORT_5_6_5_REV', 'GLU_UNSIGNED_SHORT_4_4_4_4',
'GLU_UNSIGNED_SHORT_4_4_4_4_REV',
'GLU_UNSIGNED_SHORT_5_5_5_1',
'GLU_UNSIGNED_SHORT_1_5_5_5_REV', 'GLU_UNSIGNED_INT_8_8_8_8',
'GLU_UNSIGNED_INT_8_8_8_8_REV', 'GLU_UNSIGNED_INT_10_10_10_2',
or 'GLU_UNSIGNED_INT_2_10_10_10_REV'.
DATA
Specifies a pointer to the image data in memory.
'gluBuild2DMipmaps' builds a series of prefiltered two-dimensional
texture maps of decreasing resolutions called a mipmap. This is
used for the antialiasing of texture-mapped primitives.
A return value of zero indicates success, otherwise a GLU error
code is returned (see 'gluErrorString').
Initially, the WIDTH and HEIGHT of DATA are checked to see if they
are a power of 2. If not, a copy of DATA (not DATA), is scaled up
or down to the nearest power of 2. This copy will be used for
subsequent mipmapping operations described below. (If WIDTH or
HEIGHT is exactly between powers of 2, then the copy of DATA will
scale upwards.) For example, if WIDTH is 57 and HEIGHT is 23, then
a copy of DATA will scale up to 64 in WIDTH and down to 16 in
depth, before mipmapping takes place.
Then, proxy textures (see 'glTexImage2D') are used to determine if
the implementation can fit the requested texture. If not, both
dimensions are continually halved until it fits. (If the OpenGL
version is \(<= 1.0, both maximum texture dimensions are clamped to
the value returned by 'glGetIntegerv' with the argument
'GLU_MAX_TEXTURE_SIZE'.)
Next, a series of mipmap levels is built by decimating a copy of
DATA in half along both dimensions until size 1×1 is reached. At
each level, each texel in the halved mipmap level is an average of
the corresponding four texels in the larger mipmap level. (In the
case of rectangular images, the decimation will ultimately reach an
N×1 or 1×N configuration. Here, two texels are averaged
instead.)
'glTexImage2D' is called to load each of these mipmap levels.
Level 0 is a copy of DATA. The highest level is
LOG_2,(MAX(WIDTH,HEIGHT),). For example, if WIDTH is 64 and
HEIGHT is 16 and the implementation can store a texture of this
size, the following mipmap levels are built: 64×16, 32×8, 16×4,
8×2, 4×1, 2×1, and 1×1 These correspond to levels 0 through 6,
respectively.
See the 'glTexImage1D' reference page for a description of the
acceptable values for FORMAT parameter. See the 'glDrawPixels'
reference page for a description of the acceptable values for TYPE
parameter.
'GLU_INVALID_VALUE' is returned if WIDTH or HEIGHT is < 1.
'GLU_INVALID_ENUM' is returned if INTERNALFORMAT, FORMAT, or TYPE
is not legal.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_BYTE_3_3_2' or 'GLU_UNSIGNED_BYTE_2_3_3_REV' and
FORMAT is not 'GLU_RGB'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_5_6_5' or 'GLU_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GLU_RGB'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_4_4_4_4' or 'GLU_UNSIGNED_SHORT_4_4_4_4_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_5_5_5_1' or 'GLU_UNSIGNED_SHORT_1_5_5_5_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_INT_8_8_8_8' or 'GLU_UNSIGNED_INT_8_8_8_8_REV' and
FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_INT_10_10_10_2' or 'GLU_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
-- Function: GLint gluBuild3DMipmapLevels target internalFormat width
height depth format type level base max data
Builds a subset of three-dimensional mipmap levels.
TARGET
Specifies the target texture. Must be 'GLU_TEXTURE_3D'.
INTERNALFORMAT
Requests the internal storage format of the texture image.
The most current version of the SGI implementation of GLU does
not check this value for validity before passing it on to the
underlying OpenGL implementation. A value that is not
accepted by the OpenGL implementation will lead to an OpenGL
error. The benefit of not checking this value at the GLU
level is that OpenGL extensions can add new internal texture
formats without requiring a revision of the GLU
implementation. Older implementations of GLU check this value
and raise a GLU error if it is not 1, 2, 3, or 4 or one of the
following symbolic constants: 'GLU_ALPHA', 'GLU_ALPHA4',
'GLU_ALPHA8', 'GLU_ALPHA12', 'GLU_ALPHA16', 'GLU_LUMINANCE',
'GLU_LUMINANCE4', 'GLU_LUMINANCE8', 'GLU_LUMINANCE12',
'GLU_LUMINANCE16', 'GLU_LUMINANCE_ALPHA',
'GLU_LUMINANCE4_ALPHA4', 'GLU_LUMINANCE6_ALPHA2',
'GLU_LUMINANCE8_ALPHA8', 'GLU_LUMINANCE12_ALPHA4',
'GLU_LUMINANCE12_ALPHA12', 'GLU_LUMINANCE16_ALPHA16',
'GLU_INTENSITY', 'GLU_INTENSITY4', 'GLU_INTENSITY8',
'GLU_INTENSITY12', 'GLU_INTENSITY16', 'GLU_RGB',
'GLU_R3_G3_B2', 'GLU_RGB4', 'GLU_RGB5', 'GLU_RGB8',
'GLU_RGB10', 'GLU_RGB12', 'GLU_RGB16', 'GLU_RGBA',
'GLU_RGBA2', 'GLU_RGBA4', 'GLU_RGB5_A1', 'GLU_RGBA8',
'GLU_RGB10_A2', 'GLU_RGBA12', or 'GLU_RGBA16'.
WIDTH
HEIGHT
DEPTH
Specifies in pixels the width, height and depth respectively,
of the texture image. These should be a power of 2.
FORMAT
Specifies the format of the pixel data. Must be one of
'GLU_COLOR_INDEX', 'GLU_DEPTH_COMPONENT', 'GLU_RED',
'GLU_GREEN', 'GLU_BLUE', 'GLU_ALPHA', 'GLU_RGB', 'GLU_RGBA',
'GLU_BGR', 'GLU_BGRA', 'GLU_LUMINANCE', or
'GLU_LUMINANCE_ALPHA'.
TYPE
Specifies the data type for DATA. Must be one of
'GLU_UNSIGNED_BYTE', 'GLU_BYTE', 'GLU_BITMAP',
'GLU_UNSIGNED_SHORT', 'GLU_SHORT', 'GLU_UNSIGNED_INT',
'GLU_INT', 'GLU_FLOAT', 'GLU_UNSIGNED_BYTE_3_3_2',
'GLU_UNSIGNED_BYTE_2_3_3_REV', 'GLU_UNSIGNED_SHORT_5_6_5',
'GLU_UNSIGNED_SHORT_5_6_5_REV', 'GLU_UNSIGNED_SHORT_4_4_4_4',
'GLU_UNSIGNED_SHORT_4_4_4_4_REV',
'GLU_UNSIGNED_SHORT_5_5_5_1',
'GLU_UNSIGNED_SHORT_1_5_5_5_REV', 'GLU_UNSIGNED_INT_8_8_8_8',
'GLU_UNSIGNED_INT_8_8_8_8_REV', 'GLU_UNSIGNED_INT_10_10_10_2',
or 'GLU_UNSIGNED_INT_2_10_10_10_REV'.
LEVEL
Specifies the mipmap level of the image data.
BASE
Specifies the minimum mipmap level to pass to 'glTexImage3D'.
MAX
Specifies the maximum mipmap level to pass to 'glTexImage3D'.
DATA
Specifies a pointer to the image data in memory.
'gluBuild3DMipmapLevels' builds a subset of prefiltered
three-dimensional texture maps of decreasing resolutions called a
mipmap. This is used for the antialiasing of texture mapped
primitives.
A return value of zero indicates success, otherwise a GLU error
code is returned (see 'gluErrorString').
A series of mipmap levels from BASE to MAX is built by decimating
DATA in half along both dimensions until size 1×1×1 is reached.
At each level, each texel in the halved mipmap level is an average
of the corresponding eight texels in the larger mipmap level. (If
exactly one of the dimensions is 1, four texels are averaged. If
exactly two of the dimensions are 1, two texels are averaged.)
'glTexImage3D' is called to load these mipmap levels from BASE to
MAX. If MAX is larger than the highest mipmap level for the
texture of the specified size, then a GLU error code is returned
(see 'gluErrorString') and nothing is loaded.
For example, if LEVEL is 2 and WIDTH is 16, HEIGHT is 8 and DEPTH
is 4, the following levels are possible: 16×8×4, 8×4×2,
4×2×1, 2×1×1, 1×1×1. These correspond to levels 2 through 6
respectively. If BASE is 3 and MAX is 5, then only mipmap levels
8×4×2, 4×2×1, and 2×1×1 are loaded. However, if MAX is 7,
then an error is returned and nothing is loaded, since MAX is
larger than the highest mipmap level which is, in this case, 6.
The highest mipmap level can be derived from the formula
LOG_2(MAX(WIDTH,HEIGHTDEPTH)×2^LEVEL,).
See the 'glTexImage1D' reference page for a description of the
acceptable values for FORMAT parameter. See the 'glDrawPixels'
reference page for a description of the acceptable values for TYPE
parameter.
'GLU_INVALID_VALUE' is returned if LEVEL > BASE, BASE < 0, MAX <
BASE, or MAX is > the highest mipmap level for DATA.
'GLU_INVALID_VALUE' is returned if WIDTH, HEIGHT, or DEPTH is < 1.
'GLU_INVALID_ENUM' is returned if INTERNALFORMAT, FORMAT, or TYPE
is not legal.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_BYTE_3_3_2' or 'GLU_UNSIGNED_BYTE_2_3_3_REV' and
FORMAT is not 'GLU_RGB'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_5_6_5' or 'GLU_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GLU_RGB'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_4_4_4_4' or 'GLU_UNSIGNED_SHORT_4_4_4_4_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_5_5_5_1' or 'GLU_UNSIGNED_SHORT_1_5_5_5_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_INT_8_8_8_8' or 'GLU_UNSIGNED_INT_8_8_8_8_REV' and
FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_INT_10_10_10_2' or 'GLU_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
-- Function: GLint gluBuild3DMipmaps target internalFormat width height
depth format type data
Builds a three-dimensional mipmap.
TARGET
Specifies the target texture. Must be 'GLU_TEXTURE_3D'.
INTERNALFORMAT
Requests the internal storage format of the texture image.
The most current version of the SGI implementation of GLU does
not check this value for validity before passing it on to the
underlying OpenGL implementation. A value that is not
accepted by the OpenGL implementation will lead to an OpenGL
error. The benefit of not checking this value at the GLU
level is that OpenGL extensions can add new internal texture
formats without requiring a revision of the GLU
implementation. Older implementations of GLU check this value
and raise a GLU error if it is not 1, 2, 3, or 4 or one of the
following symbolic constants: 'GLU_ALPHA', 'GLU_ALPHA4',
'GLU_ALPHA8', 'GLU_ALPHA12', 'GLU_ALPHA16', 'GLU_LUMINANCE',
'GLU_LUMINANCE4', 'GLU_LUMINANCE8', 'GLU_LUMINANCE12',
'GLU_LUMINANCE16', 'GLU_LUMINANCE_ALPHA',
'GLU_LUMINANCE4_ALPHA4', 'GLU_LUMINANCE6_ALPHA2',
'GLU_LUMINANCE8_ALPHA8', 'GLU_LUMINANCE12_ALPHA4',
'GLU_LUMINANCE12_ALPHA12', 'GLU_LUMINANCE16_ALPHA16',
'GLU_INTENSITY', 'GLU_INTENSITY4', 'GLU_INTENSITY8',
'GLU_INTENSITY12', 'GLU_INTENSITY16', 'GLU_RGB',
'GLU_R3_G3_B2', 'GLU_RGB4', 'GLU_RGB5', 'GLU_RGB8',
'GLU_RGB10', 'GLU_RGB12', 'GLU_RGB16', 'GLU_RGBA',
'GLU_RGBA2', 'GLU_RGBA4', 'GLU_RGB5_A1', 'GLU_RGBA8',
'GLU_RGB10_A2', 'GLU_RGBA12', or 'GLU_RGBA16'.
WIDTH
HEIGHT
DEPTH
Specifies in pixels the width, height and depth respectively,
in pixels of the texture image.
FORMAT
Specifies the format of the pixel data. Must be one of
'GLU_COLOR_INDEX', 'GLU_DEPTH_COMPONENT', 'GLU_RED',
'GLU_GREEN', 'GLU_BLUE', 'GLU_ALPHA', 'GLU_RGB', 'GLU_RGBA',
'GLU_BGR', 'GLU_BGRA', 'GLU_LUMINANCE', or
'GLU_LUMINANCE_ALPHA'.
TYPE
Specifies the data type for DATA. Must be one of:
'GLU_UNSIGNED_BYTE', 'GLU_BYTE', 'GLU_BITMAP',
'GLU_UNSIGNED_SHORT', 'GLU_SHORT', 'GLU_UNSIGNED_INT',
'GLU_INT', 'GLU_FLOAT', 'GLU_UNSIGNED_BYTE_3_3_2',
'GLU_UNSIGNED_BYTE_2_3_3_REV', 'GLU_UNSIGNED_SHORT_5_6_5',
'GLU_UNSIGNED_SHORT_5_6_5_REV', 'GLU_UNSIGNED_SHORT_4_4_4_4',
'GLU_UNSIGNED_SHORT_4_4_4_4_REV',
'GLU_UNSIGNED_SHORT_5_5_5_1',
'GLU_UNSIGNED_SHORT_1_5_5_5_REV', 'GLU_UNSIGNED_INT_8_8_8_8',
'GLU_UNSIGNED_INT_8_8_8_8_REV', 'GLU_UNSIGNED_INT_10_10_10_2',
or 'GLU_UNSIGNED_INT_2_10_10_10_REV'.
DATA
Specifies a pointer to the image data in memory.
'gluBuild3DMipmaps' builds a series of prefiltered
three-dimensional texture maps of decreasing resolutions called a
mipmap. This is used for the antialiasing of texture-mapped
primitives.
A return value of zero indicates success, otherwise a GLU error
code is returned (see 'gluErrorString').
Initially, the WIDTH, HEIGHT and DEPTH of DATA are checked to see
if they are a power of 2. If not, a copy of DATA is made and
scaled up or down to the nearest power of 2. (If WIDTH, HEIGHT, or
DEPTH is exactly between powers of 2, then the copy of DATA will
scale upwards.) This copy will be used for subsequent mipmapping
operations described below. For example, if WIDTH is 57, HEIGHT is
23, and DEPTH is 24, then a copy of DATA will scale up to 64 in
width, down to 16 in height, and up to 32 in depth before
mipmapping takes place.
Then, proxy textures (see 'glTexImage3D') are used to determine if
the implementation can fit the requested texture. If not, all
three dimensions are continually halved until it fits.
Next, a series of mipmap levels is built by decimating a copy of
DATA in half along all three dimensions until size 1×1×1 is
reached. At each level, each texel in the halved mipmap level is
an average of the corresponding eight texels in the larger mipmap
level. (If exactly one of the dimensions is 1, four texels are
averaged. If exactly two of the dimensions are 1, two texels are
averaged.)
'glTexImage3D' is called to load each of these mipmap levels.
Level 0 is a copy of DATA. The highest level is
LOG_2,(MAX(WIDTH,HEIGHTDEPTH),). For example, if WIDTH is
64, HEIGHT is 16, and DEPTH is 32, and the implementation can store
a texture of this size, the following mipmap levels are built:
64×16×32, 32×8×16, 16×4×8, 8×2×4, 4×1×2, 2×1×1, and
1×1×1. These correspond to levels 0 through 6, respectively.
See the 'glTexImage1D' reference page for a description of the
acceptable values for FORMAT parameter. See the 'glDrawPixels'
reference page for a description of the acceptable values for TYPE
parameter.
'GLU_INVALID_VALUE' is returned if WIDTH, HEIGHT, or DEPTH is < 1.
'GLU_INVALID_ENUM' is returned if INTERNALFORMAT, FORMAT, or TYPE
is not legal.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_BYTE_3_3_2' or 'GLU_UNSIGNED_BYTE_2_3_3_REV' and
FORMAT is not 'GLU_RGB'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_5_6_5' or 'GLU_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GLU_RGB'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_4_4_4_4' or 'GLU_UNSIGNED_SHORT_4_4_4_4_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_SHORT_5_5_5_1' or 'GLU_UNSIGNED_SHORT_1_5_5_5_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_INT_8_8_8_8' or 'GLU_UNSIGNED_INT_8_8_8_8_REV' and
FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPE is
'GLU_UNSIGNED_INT_10_10_10_2' or 'GLU_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
-- Function: GLboolean gluCheckExtension extName extString
Determines if an extension name is supported.
EXTNAME
Specifies an extension name.
EXTSTRING
Specifies a space-separated list of extension names supported.
'gluCheckExtension' returns 'GLU_TRUE' if EXTNAME is supported
otherwise 'GLU_FALSE' is returned.
This is used to check for the presence for OpenGL, GLU, or GLX
extension names by passing the extension strings returned by
'glGetString', 'gluGetString', 'glXGetClientString',
'glXQueryExtensionsString', or 'glXQueryServerString',
respectively, as EXTSTRING.
-- Function: void gluCylinder quad base top height slices stacks
Draw a cylinder.
QUAD
Specifies the quadrics object (created with 'gluNewQuadric').
BASE
Specifies the radius of the cylinder at Z = 0.
TOP
Specifies the radius of the cylinder at Z = HEIGHT.
HEIGHT
Specifies the height of the cylinder.
SLICES
Specifies the number of subdivisions around the Z axis.
STACKS
Specifies the number of subdivisions along the Z axis.
'gluCylinder' draws a cylinder oriented along the Z axis. The base
of the cylinder is placed at Z = 0 and the top at Z=HEIGHT. Like a
sphere, a cylinder is subdivided around the Z axis into slices and
along the Z axis into stacks.
Note that if TOP is set to 0.0, this routine generates a cone.
If the orientation is set to 'GLU_OUTSIDE' (with
'gluQuadricOrientation'), then any generated normals point away
from the Z axis. Otherwise, they point toward the Z axis.
If texturing is turned on (with 'gluQuadricTexture'), then texture
coordinates are generated so that T ranges linearly from 0.0 at Z =
0 to 1.0 at Z = HEIGHT, and S ranges from 0.0 at the +Y axis, to
0.25 at the +X axis, to 0.5 at the -Y axis, to 0.75 at the \-X
axis, and back to 1.0 at the +Y axis.
-- Function: void gluDeleteNurbsRenderer nurb
Destroy a NURBS object.
NURB
Specifies the NURBS object to be destroyed.
'gluDeleteNurbsRenderer' destroys the NURBS object (which was
created with 'gluNewNurbsRenderer') and frees any memory it uses.
Once 'gluDeleteNurbsRenderer' has been called, NURB cannot be used
again.
-- Function: void gluDeleteQuadric quad
Destroy a quadrics object.
QUAD
Specifies the quadrics object to be destroyed.
'gluDeleteQuadric' destroys the quadrics object (created with
'gluNewQuadric') and frees any memory it uses. Once
'gluDeleteQuadric' has been called, QUAD cannot be used again.
-- Function: void gluDeleteTess tess
Destroy a tessellation object.
TESS
Specifies the tessellation object to destroy.
'gluDeleteTess' destroys the indicated tessellation object (which
was created with 'gluNewTess') and frees any memory that it used.
-- Function: void gluDisk quad inner outer slices loops
Draw a disk.
QUAD
Specifies the quadrics object (created with 'gluNewQuadric').
INNER
Specifies the inner radius of the disk (may be 0).
OUTER
Specifies the outer radius of the disk.
SLICES
Specifies the number of subdivisions around the Z axis.
LOOPS
Specifies the number of concentric rings about the origin into
which the disk is subdivided.
'gluDisk' renders a disk on the Z = 0 plane. The disk has a radius
of OUTER and contains a concentric circular hole with a radius of
INNER. If INNER is 0, then no hole is generated. The disk is
subdivided around the Z axis into slices (like pizza slices) and
also about the Z axis into rings (as specified by SLICES and LOOPS,
respectively).
With respect to orientation, the +Z side of the disk is considered
to be "outside" (see 'gluQuadricOrientation'). This means that if
the orientation is set to 'GLU_OUTSIDE', then any normals generated
point along the +Z axis. Otherwise, they point along the \-Z axis.
If texturing has been turned on (with 'gluQuadricTexture'), texture
coordinates are generated linearly such that where R=OUTER, the
value at (R, 0, 0) is (1, 0.5), at (0, R, 0) it is (0.5, 1), at
(\-R, 0, 0) it is (0, 0.5), and at (0, \-R, 0) it is (0.5, 0).
-- Function: const-GLubyte-* gluErrorString error
Produce an error string from a GL or GLU error code.
ERROR
Specifies a GL or GLU error code.
'gluErrorString' produces an error string from a GL or GLU error
code. The string is in ISO Latin 1 format. For example,
'gluErrorString'('GLU_OUT_OF_MEMORY') returns the string OUT OF
MEMORY.
The standard GLU error codes are 'GLU_INVALID_ENUM',
'GLU_INVALID_VALUE', and 'GLU_OUT_OF_MEMORY'. Certain other GLU
functions can return specialized error codes through callbacks.
See the 'glGetError' reference page for the list of GL error codes.
'NULL' is returned if ERROR is not a valid GL or GLU error code.
-- Function: void gluGetNurbsProperty nurb property data
Get a NURBS property.
NURB
Specifies the NURBS object (created with
'gluNewNurbsRenderer').
PROPERTY
Specifies the property whose value is to be fetched. Valid
values are 'GLU_CULLING', 'GLU_SAMPLING_TOLERANCE',
'GLU_DISPLAY_MODE', 'GLU_AUTO_LOAD_MATRIX',
'GLU_PARAMETRIC_TOLERANCE', 'GLU_SAMPLING_METHOD',
'GLU_U_STEP', 'GLU_V_STEP', and 'GLU_NURBS_MODE'.
DATA
Specifies a pointer to the location into which the value of
the named property is written.
'gluGetNurbsProperty' retrieves properties stored in a NURBS
object. These properties affect the way that NURBS curves and
surfaces are rendered. See the 'gluNurbsProperty' reference page
for information about what the properties are and what they do.
-- Function: const-GLubyte-* gluGetString name
Return a string describing the GLU version or GLU extensions .
NAME
Specifies a symbolic constant, one of 'GLU_VERSION', or
'GLU_EXTENSIONS'.
'gluGetString' returns a pointer to a static string describing the
GLU version or the GLU extensions that are supported.
The version number is one of the following forms:
MAJOR_NUMBER.MINOR_NUMBERMAJOR_NUMBER.MINOR_NUMBER.RELEASE_NUMBER.
The version string is of the following form:
VERSION NUMBERVENDOR-SPECIFIC INFORMATION
Vendor-specific information is optional. Its format and contents
depend on the implementation.
The standard GLU contains a basic set of features and capabilities.
If a company or group of companies wish to support other features,
these may be included as extensions to the GLU. If NAME is
'GLU_EXTENSIONS', then 'gluGetString' returns a space-separated
list of names of supported GLU extensions. (Extension names never
contain spaces.)
All strings are null-terminated.
NULL is returned if NAME is not 'GLU_VERSION' or 'GLU_EXTENSIONS'.
-- Function: void gluGetTessProperty tess which data
Get a tessellation object property.
TESS
Specifies the tessellation object (created with 'gluNewTess').
WHICH
Specifies the property whose value is to be fetched. Valid
values are 'GLU_TESS_WINDING_RULE', 'GLU_TESS_BOUNDARY_ONLY',
and 'GLU_TESS_TOLERANCE'.
DATA
Specifies a pointer to the location into which the value of
the named property is written.
'gluGetTessProperty' retrieves properties stored in a tessellation
object. These properties affect the way that tessellation objects
are interpreted and rendered. See the 'gluTessProperty' reference
page for information about the properties and what they do.
-- Function: void gluLoadSamplingMatrices nurb model perspective view
Load NURBS sampling and culling matrices.
NURB
Specifies the NURBS object (created with
'gluNewNurbsRenderer').
MODEL
Specifies a modelview matrix (as from a 'glGetFloatv' call).
PERSPECTIVE
Specifies a projection matrix (as from a 'glGetFloatv' call).
VIEW
Specifies a viewport (as from a 'glGetIntegerv' call).
'gluLoadSamplingMatrices' uses MODEL, PERSPECTIVE, and VIEW to
recompute the sampling and culling matrices stored in NURB. The
sampling matrix determines how finely a NURBS curve or surface must
be tessellated to satisfy the sampling tolerance (as determined by
the 'GLU_SAMPLING_TOLERANCE' property). The culling matrix is used
in deciding if a NURBS curve or surface should be culled before
rendering (when the 'GLU_CULLING' property is turned on).
'gluLoadSamplingMatrices' is necessary only if the
'GLU_AUTO_LOAD_MATRIX' property is turned off (see
'gluNurbsProperty'). Although it can be convenient to leave the
'GLU_AUTO_LOAD_MATRIX' property turned on, there can be a
performance penalty for doing so. (A round trip to the GL server
is needed to fetch the current values of the modelview matrix,
projection matrix, and viewport.)
-- Function: void gluLookAt eyeX eyeY eyeZ centerX centerY centerZ upX
upY upZ
Define a viewing transformation.
EYEX
EYEY
EYEZ
Specifies the position of the eye point.
CENTERX
CENTERY
CENTERZ
Specifies the position of the reference point.
UPX
UPY
UPZ
Specifies the direction of the UP vector.
'gluLookAt' creates a viewing matrix derived from an eye point, a
reference point indicating the center of the scene, and an UP
vector.
The matrix maps the reference point to the negative Z axis and the
eye point to the origin. When a typical projection matrix is used,
the center of the scene therefore maps to the center of the
viewport. Similarly, the direction described by the UP vector
projected onto the viewing plane is mapped to the positive Y axis
so that it points upward in the viewport. The UP vector must not
be parallel to the line of sight from the eye point to the
reference point.
Let
F=((CENTERX-EYEX), (CENTERY-EYEY), (CENTERZ-EYEZ),)
Let UP be the vector (UPX,UPYUPZ).
Then normalize as follows: F=F/∥F,∥,
UP^″=UP/∥UP,∥,
Finally, let S=F×UP^″, and U=S×F.
M is then constructed as follows: M=((S[0,] S[1,] S[2,]
0), (U[0,] U[1,] U[2,] 0), (-F[0,] -F[1,] -F[2,]
0), (0 0 0 1),)
and 'gluLookAt' is equivalent to
glMultMatrixf(M);
glTranslated(-eyex, -eyey, -eyez);
-- Function: GLUnurbs* gluNewNurbsRenderer
Create a NURBS object.
'gluNewNurbsRenderer' creates and returns a pointer to a new NURBS
object. This object must be referred to when calling NURBS
rendering and control functions. A return value of 0 means that
there is not enough memory to allocate the object.
-- Function: GLUquadric* gluNewQuadric
Create a quadrics object.
'gluNewQuadric' creates and returns a pointer to a new quadrics
object. This object must be referred to when calling quadrics
rendering and control functions. A return value of 0 means that
there is not enough memory to allocate the object.
-- Function: GLUtesselator* gluNewTess
Create a tessellation object.
'gluNewTess' creates and returns a pointer to a new tessellation
object. This object must be referred to when calling tessellation
functions. A return value of 0 means that there is not enough
memory to allocate the object.
-- Function: void gluNextContour tess type
Mark the beginning of another contour.
TESS
Specifies the tessellation object (created with 'gluNewTess').
TYPE
Specifies the type of the contour being defined. Valid values
are 'GLU_EXTERIOR', 'GLU_INTERIOR', 'GLU_UNKNOWN', 'GLU_CCW',
and 'GLU_CW'.
'gluNextContour' is used in describing polygons with multiple
contours. After the first contour has been described through a
series of 'gluTessVertex' calls, a 'gluNextContour' call indicates
that the previous contour is complete and that the next contour is
about to begin. Another series of 'gluTessVertex' calls is then
used to describe the new contour. This process can be repeated
until all contours have been described.
TYPE defines what type of contour follows. The legal contour types
are as follows:
'GLU_EXTERIOR'
An exterior contour defines an exterior boundary of the
polygon.
'GLU_INTERIOR'
An interior contour defines an interior boundary of the
polygon (such as a hole).
'GLU_UNKNOWN'
An unknown contour is analyzed by the library to determine if
it is interior or exterior.
'GLU_CCW',
'GLU_CW'
The first 'GLU_CCW' or 'GLU_CW' contour defined is considered
to be exterior. All other contours are considered to be
exterior if they are oriented in the same direction (clockwise
or counterclockwise) as the first contour, and interior if
they are not.
If one contour is of type 'GLU_CCW' or 'GLU_CW', then all contours
must be of the same type (if they are not, then all 'GLU_CCW' and
'GLU_CW' contours will be changed to 'GLU_UNKNOWN').
Note that there is no real difference between the 'GLU_CCW' and
'GLU_CW' contour types.
Before the first contour is described, 'gluNextContour' can be
called to define the type of the first contour. If
'gluNextContour' is not called before the first contour, then the
first contour is marked 'GLU_EXTERIOR'.
This command is obsolete and is provided for backward compatibility
only. Calls to 'gluNextContour' are mapped to 'gluTessEndContour'
followed by 'gluTessBeginContour'.
-- Function: void gluNurbsCallbackDataEXT nurb userData
Set a user data pointer.
NURB
Specifies the NURBS object (created with
'gluNewNurbsRenderer').
USERDATA
Specifies a pointer to the user's data.
'gluNurbsCallbackDataEXT' is used to pass a pointer to the
application's data to NURBS tessellator. A copy of this pointer
will be passed by the tessellator in the NURBS callback functions
(set by 'gluNurbsCallback').
-- Function: void gluNurbsCallbackData nurb userData
Set a user data pointer.
NURB
Specifies the NURBS object (created with
'gluNewNurbsRenderer').
USERDATA
Specifies a pointer to the user's data.
'gluNurbsCallbackData' is used to pass a pointer to the
application's data to NURBS tessellator. A copy of this pointer
will be passed by the tessellator in the NURBS callback functions
(set by 'gluNurbsCallback').
-- Function: void gluNurbsCallback nurb which CallBackFunc
Define a callback for a NURBS object.
NURB
Specifies the NURBS object (created with
'gluNewNurbsRenderer').
WHICH
Specifies the callback being defined. Valid values are
'GLU_NURBS_BEGIN', 'GLU_NURBS_VERTEX', 'GLU_NURBS_NORMAL',
'GLU_NURBS_COLOR', 'GLU_NURBS_TEXTURE_COORD', 'GLU_NURBS_END',
'GLU_NURBS_BEGIN_DATA', 'GLU_NURBS_VERTEX_DATA',
'GLU_NURBS_NORMAL_DATA', 'GLU_NURBS_COLOR_DATA',
'GLU_NURBS_TEXTURE_COORD_DATA', 'GLU_NURBS_END_DATA', and
'GLU_NURBS_ERROR'.
CALLBACKFUNC
Specifies the function that the callback calls.
'gluNurbsCallback' is used to define a callback to be used by a
NURBS object. If the specified callback is already defined, then
it is replaced. If CALLBACKFUNC is NULL, then this callback will
not get invoked and the related data, if any, will be lost.
Except the error callback, these callbacks are used by NURBS
tessellator (when 'GLU_NURBS_MODE' is set to be
'GLU_NURBS_TESSELLATOR') to return back the OpenGL polygon
primitives resulting from the tessellation. Note that there are
two versions of each callback: one with a user data pointer and one
without. If both versions for a particular callback are specified
then the callback with the user data pointer will be used. Note
that "userData" is a copy of the pointer that was specified at the
last call to 'gluNurbsCallbackData'.
The error callback function is effective no matter which value that
'GLU_NURBS_MODE' is set to. All other callback functions are
effective only when 'GLU_NURBS_MODE' is set to
'GLU_NURBS_TESSELLATOR'.
The legal callbacks are as follows:
'GLU_NURBS_BEGIN'
The begin callback indicates the start of a primitive. The
function takes a single argument of type GLenum, which can be
one of 'GLU_LINES', 'GLU_LINE_STRIP', 'GLU_TRIANGLE_FAN',
'GLU_TRIANGLE_STRIP', 'GLU_TRIANGLES', or 'GLU_QUAD_STRIP'.
The default begin callback function is NULL. The function
prototype for this callback looks like:
'GLU_NURBS_BEGIN_DATA'
The same as the 'GLU_NURBS_BEGIN' callback except that it
takes an additional pointer argument. This pointer is a copy
of the pointer that was specified at the last call to
'gluNurbsCallbackData'. The default callback function is
NULL. The function prototype for this callback function looks
like:
'GLU_NURBS_VERTEX'
The vertex callback indicates a vertex of the primitive. The
coordinates of the vertex are stored in the parameter
"vertex". All the generated vertices have dimension 3; that
is, homogeneous coordinates have been transformed into affine
coordinates. The default vertex callback function is NULL.
The function prototype for this callback function looks like:
'GLU_NURBS_VERTEX_DATA'
This is the same as the 'GLU_NURBS_VERTEX' callback, except
that it takes an additional pointer argument. This pointer is
a copy of the pointer that was specified at the last call to
'gluNurbsCallbackData'. The default callback function is
NULL. The function prototype for this callback function looks
like:
'GLU_NURBS_NORMAL'
The normal callback is invoked as the vertex normal is
generated. The components of the normal are stored in the
parameter "normal." In the case of a NURBS curve, the
callback function is effective only when the user provides a
normal map ('GLU_MAP1_NORMAL'). In the case of a NURBS
surface, if a normal map ('GLU_MAP2_NORMAL') is provided, then
the generated normal is computed from the normal map. If a
normal map is not provided, then a surface normal is computed
in a manner similar to that described for evaluators when
'GLU_AUTO_NORMAL' is enabled. The default normal callback
function is NULL. The function prototype for this callback
function looks like:
'GLU_NURBS_NORMAL_DATA'
The same as the 'GLU_NURBS_NORMAL' callback except that it
takes an additional pointer argument. This pointer is a copy
of the pointer that was specified at the last call to
'gluNurbsCallbackData'. The default callback function is
NULL. The function prototype for this callback function looks
like:
'GLU_NURBS_COLOR'
The color callback is invoked as the color of a vertex is
generated. The components of the color are stored in the
parameter "color." This callback is effective only when the
user provides a color map ('GLU_MAP1_COLOR_4' or
'GLU_MAP2_COLOR_4'). "color" contains four components: R, G,
B, A. The default color callback function is NULL. The
prototype for this callback function looks like:
'GLU_NURBS_COLOR_DATA'
The same as the 'GLU_NURBS_COLOR' callback except that it
takes an additional pointer argument. This pointer is a copy
of the pointer that was specified at the last call to
'gluNurbsCallbackData'. The default callback function is
NULL. The function prototype for this callback function looks
like:
'GLU_NURBS_TEXTURE_COORD'
The texture callback is invoked as the texture coordinates of
a vertex are generated. These coordinates are stored in the
parameter "texCoord." The number of texture coordinates can
be 1, 2, 3, or 4 depending on which type of texture map is
specified ('GLU_MAP1_TEXTURE_COORD_1',
'GLU_MAP1_TEXTURE_COORD_2', 'GLU_MAP1_TEXTURE_COORD_3',
'GLU_MAP1_TEXTURE_COORD_4', 'GLU_MAP2_TEXTURE_COORD_1',
'GLU_MAP2_TEXTURE_COORD_2', 'GLU_MAP2_TEXTURE_COORD_3',
'GLU_MAP2_TEXTURE_COORD_4'). If no texture map is specified,
this callback function will not be called. The default
texture callback function is NULL. The function prototype for
this callback function looks like:
'GLU_NURBS_TEXTURE_COORD_DATA'
This is the same as the 'GLU_NURBS_TEXTURE_COORD' callback,
except that it takes an additional pointer argument. This
pointer is a copy of the pointer that was specified at the
last call to 'gluNurbsCallbackData'. The default callback
function is NULL. The function prototype for this callback
function looks like:
'GLU_NURBS_END'
The end callback is invoked at the end of a primitive. The
default end callback function is NULL. The function prototype
for this callback function looks like:
'GLU_NURBS_END_DATA'
This is the same as the 'GLU_NURBS_END' callback, except that
it takes an additional pointer argument. This pointer is a
copy of the pointer that was specified at the last call to
'gluNurbsCallbackData'. The default callback function is
NULL. The function prototype for this callback function looks
like:
'GLU_NURBS_ERROR'
The error function is called when an error is encountered.
Its single argument is of type GLenum, and it indicates the
specific error that occurred. There are 37 errors unique to
NURBS, named 'GLU_NURBS_ERROR1' through 'GLU_NURBS_ERROR37'.
Character strings describing these errors can be retrieved
with 'gluErrorString'.
void begin( GLenum type );
void beginData(GLenum type, void *userData);
void vertex( GLfloat *vertex );
void vertexData( GLfloat *vertex, void *userData );
void normal( GLfloat *normal );
void normalData( GLfloat *normal, void *userData );
void color( GLfloat *color );
void colorData( GLfloat *color, void *userData );
void texCoord( GLfloat *texCoord );
void texCoordData( GLfloat *texCoord, void *userData );
void end( void );
void endData( void *userData );
-- Function: void gluNurbsCurve nurb knotCount knots stride control
order type
Define the shape of a NURBS curve.
NURB
Specifies the NURBS object (created with
'gluNewNurbsRenderer').
KNOTCOUNT
Specifies the number of knots in KNOTS. KNOTCOUNT equals the
number of control points plus the order.
KNOTS
Specifies an array of KNOTCOUNT nondecreasing knot values.
STRIDE
Specifies the offset (as a number of single-precision
floating-point values) between successive curve control
points.
CONTROL
Specifies a pointer to an array of control points. The
coordinates must agree with TYPE, specified below.
ORDER
Specifies the order of the NURBS curve. ORDER equals degree +
1, hence a cubic curve has an order of 4.
TYPE
Specifies the type of the curve. If this curve is defined
within a 'gluBeginCurve'/'gluEndCurve' pair, then the type can
be any of the valid one-dimensional evaluator types (such as
'GLU_MAP1_VERTEX_3' or 'GLU_MAP1_COLOR_4'). Between a
'gluBeginTrim'/'gluEndTrim' pair, the only valid types are
'GLU_MAP1_TRIM_2' and 'GLU_MAP1_TRIM_3'.
Use 'gluNurbsCurve' to describe a NURBS curve.
When 'gluNurbsCurve' appears between a
'gluBeginCurve'/'gluEndCurve' pair, it is used to describe a curve
to be rendered. Positional, texture, and color coordinates are
associated by presenting each as a separate 'gluNurbsCurve' between
a 'gluBeginCurve'/'gluEndCurve' pair. No more than one call to
'gluNurbsCurve' for each of color, position, and texture data can
be made within a single 'gluBeginCurve'/'gluEndCurve' pair.
Exactly one call must be made to describe the position of the curve
(a TYPE of 'GLU_MAP1_VERTEX_3' or 'GLU_MAP1_VERTEX_4').
When 'gluNurbsCurve' appears between a 'gluBeginTrim'/'gluEndTrim'
pair, it is used to describe a trimming curve on a NURBS surface.
If TYPE is 'GLU_MAP1_TRIM_2', then it describes a curve in
two-dimensional (U and V) parameter space. If it is
'GLU_MAP1_TRIM_3', then it describes a curve in two-dimensional
homogeneous (U, V, and W) parameter space. See the 'gluBeginTrim'
reference page for more discussion about trimming curves.
-- Function: void gluNurbsProperty nurb property value
Set a NURBS property.
NURB
Specifies the NURBS object (created with
'gluNewNurbsRenderer').
PROPERTY
Specifies the property to be set. Valid values are
'GLU_SAMPLING_TOLERANCE', 'GLU_DISPLAY_MODE', 'GLU_CULLING',
'GLU_AUTO_LOAD_MATRIX', 'GLU_PARAMETRIC_TOLERANCE',
'GLU_SAMPLING_METHOD', 'GLU_U_STEP', 'GLU_V_STEP', or
'GLU_NURBS_MODE'.
VALUE
Specifies the value of the indicated property. It may be a
numeric value or one of 'GLU_OUTLINE_POLYGON', 'GLU_FILL',
'GLU_OUTLINE_PATCH', 'GLU_TRUE', 'GLU_FALSE',
'GLU_PATH_LENGTH', 'GLU_PARAMETRIC_ERROR',
'GLU_DOMAIN_DISTANCE', 'GLU_NURBS_RENDERER', or
'GLU_NURBS_TESSELLATOR'.
'gluNurbsProperty' is used to control properties stored in a NURBS
object. These properties affect the way that a NURBS curve is
rendered. The accepted values for PROPERTY are as follows:
'GLU_NURBS_MODE'
VALUE should be set to be either 'GLU_NURBS_RENDERER' or
'GLU_NURBS_TESSELLATOR'. When set to 'GLU_NURBS_RENDERER',
NURBS objects are tessellated into OpenGL primitives and sent
to the pipeline for rendering. When set to
'GLU_NURBS_TESSELLATOR', NURBS objects are tessellated into
OpenGL primitives but the vertices, normals, colors, and/or
textures are retrieved back through a callback interface (see
'gluNurbsCallback'). This allows the user to cache the
tessellated results for further processing. The initial value
is 'GLU_NURBS_RENDERER'.
'GLU_SAMPLING_METHOD'
Specifies how a NURBS surface should be tessellated. VALUE
may be one of 'GLU_PATH_LENGTH', 'GLU_PARAMETRIC_ERROR',
'GLU_DOMAIN_DISTANCE', 'GLU_OBJECT_PATH_LENGTH', or
'GLU_OBJECT_PARAMETRIC_ERROR'. When set to 'GLU_PATH_LENGTH',
the surface is rendered so that the maximum length, in pixels,
of the edges of the tessellation polygons is no greater than
what is specified by 'GLU_SAMPLING_TOLERANCE'.
'GLU_PARAMETRIC_ERROR' specifies that the surface is rendered
in such a way that the value specified by
'GLU_PARAMETRIC_TOLERANCE' describes the maximum distance, in
pixels, between the tessellation polygons and the surfaces
they approximate.
'GLU_DOMAIN_DISTANCE' allows users to specify, in parametric
coordinates, how many sample points per unit length are taken
in U, V direction.
'GLU_OBJECT_PATH_LENGTH' is similar to 'GLU_PATH_LENGTH'
except that it is view independent; that is, the surface is
rendered so that the maximum length, in object space, of edges
of the tessellation polygons is no greater than what is
specified by 'GLU_SAMPLING_TOLERANCE'.
'GLU_OBJECT_PARAMETRIC_ERROR' is similar to
'GLU_PARAMETRIC_ERROR' except that it is view independent;
that is, the surface is rendered in such a way that the value
specified by 'GLU_PARAMETRIC_TOLERANCE' describes the maximum
distance, in object space, between the tessellation polygons
and the surfaces they approximate.
The initial value of 'GLU_SAMPLING_METHOD' is
'GLU_PATH_LENGTH'.
'GLU_SAMPLING_TOLERANCE'
Specifies the maximum length, in pixels or in object space
length unit, to use when the sampling method is set to
'GLU_PATH_LENGTH' or 'GLU_OBJECT_PATH_LENGTH'. The NURBS code
is conservative when rendering a curve or surface, so the
actual length can be somewhat shorter. The initial value is
50.0 pixels.
'GLU_PARAMETRIC_TOLERANCE'
Specifies the maximum distance, in pixels or in object space
length unit, to use when the sampling method is
'GLU_PARAMETRIC_ERROR' or 'GLU_OBJECT_PARAMETRIC_ERROR'. The
initial value is 0.5.
'GLU_U_STEP'
Specifies the number of sample points per unit length taken
along the U axis in parametric coordinates. It is needed when
'GLU_SAMPLING_METHOD' is set to 'GLU_DOMAIN_DISTANCE'. The
initial value is 100.
'GLU_V_STEP'
Specifies the number of sample points per unit length taken
along the V axis in parametric coordinate. It is needed when
'GLU_SAMPLING_METHOD' is set to 'GLU_DOMAIN_DISTANCE'. The
initial value is 100.
'GLU_DISPLAY_MODE'
VALUE can be set to 'GLU_OUTLINE_POLYGON', 'GLU_FILL', or
'GLU_OUTLINE_PATCH'. When 'GLU_NURBS_MODE' is set to be
'GLU_NURBS_RENDERER', VALUE defines how a NURBS surface should
be rendered. When VALUE is set to 'GLU_FILL', the surface is
rendered as a set of polygons. When VALUE is set to
'GLU_OUTLINE_POLYGON', the NURBS library draws only the
outlines of the polygons created by tessellation. When VALUE
is set to 'GLU_OUTLINE_PATCH' just the outlines of patches and
trim curves defined by the user are drawn.
When 'GLU_NURBS_MODE' is set to be 'GLU_NURBS_TESSELLATOR',
VALUE defines how a NURBS surface should be tessellated. When
'GLU_DISPLAY_MODE' is set to 'GLU_FILL' or
'GLU_OUTLINE_POLYGON', the NURBS surface is tessellated into
OpenGL triangle primitives that can be retrieved back through
callback functions. If 'GLU_DISPLAY_MODE' is set to
'GLU_OUTLINE_PATCH', only the outlines of the patches and trim
curves are generated as a sequence of line strips that can be
retrieved back through callback functions.
The initial value is 'GLU_FILL'.
'GLU_CULLING'
VALUE is a boolean value that, when set to 'GLU_TRUE',
indicates that a NURBS curve should be discarded prior to
tessellation if its control points lie outside the current
viewport. The initial value is 'GLU_FALSE'.
'GLU_AUTO_LOAD_MATRIX'
VALUE is a boolean value. When set to 'GLU_TRUE', the NURBS
code downloads the projection matrix, the modelview matrix,
and the viewport from the GL server to compute sampling and
culling matrices for each NURBS curve that is rendered.
Sampling and culling matrices are required to determine the
tessellation of a NURBS surface into line segments or polygons
and to cull a NURBS surface if it lies outside the viewport.
If this mode is set to 'GLU_FALSE', then the program needs to
provide a projection matrix, a modelview matrix, and a
viewport for the NURBS renderer to use to construct sampling
and culling matrices. This can be done with the
'gluLoadSamplingMatrices' function. This mode is initially
set to 'GLU_TRUE'. Changing it from 'GLU_TRUE' to 'GLU_FALSE'
does not affect the sampling and culling matrices until
'gluLoadSamplingMatrices' is called.
-- Function: void gluNurbsSurface nurb sKnotCount sKnots tKnotCount
tKnots sStride tStride control sOrder tOrder type
Define the shape of a NURBS surface.
NURB
Specifies the NURBS object (created with
'gluNewNurbsRenderer').
SKNOTCOUNT
Specifies the number of knots in the parametric U direction.
SKNOTS
Specifies an array of SKNOTCOUNT nondecreasing knot values in
the parametric U direction.
TKNOTCOUNT
Specifies the number of knots in the parametric V direction.
TKNOTS
Specifies an array of TKNOTCOUNT nondecreasing knot values in
the parametric V direction.
SSTRIDE
Specifies the offset (as a number of single-precision
floating-point values) between successive control points in
the parametric U direction in CONTROL.
TSTRIDE
Specifies the offset (in single-precision floating-point
values) between successive control points in the parametric V
direction in CONTROL.
CONTROL
Specifies an array containing control points for the NURBS
surface. The offsets between successive control points in the
parametric U and V directions are given by SSTRIDE and
TSTRIDE.
SORDER
Specifies the order of the NURBS surface in the parametric U
direction. The order is one more than the degree, hence a
surface that is cubic in U has a U order of 4.
TORDER
Specifies the order of the NURBS surface in the parametric V
direction. The order is one more than the degree, hence a
surface that is cubic in V has a V order of 4.
TYPE
Specifies type of the surface. TYPE can be any of the valid
two-dimensional evaluator types (such as 'GLU_MAP2_VERTEX_3'
or 'GLU_MAP2_COLOR_4').
Use 'gluNurbsSurface' within a NURBS (Non-Uniform Rational
B-Spline) surface definition to describe the shape of a NURBS
surface (before any trimming). To mark the beginning of a NURBS
surface definition, use the 'gluBeginSurface' command. To mark the
end of a NURBS surface definition, use the 'gluEndSurface' command.
Call 'gluNurbsSurface' within a NURBS surface definition only.
Positional, texture, and color coordinates are associated with a
surface by presenting each as a separate 'gluNurbsSurface' between
a 'gluBeginSurface'/'gluEndSurface' pair. No more than one call to
'gluNurbsSurface' for each of color, position, and texture data can
be made within a single 'gluBeginSurface'/'gluEndSurface' pair.
Exactly one call must be made to describe the position of the
surface (a TYPE of 'GLU_MAP2_VERTEX_3' or 'GLU_MAP2_VERTEX_4').
A NURBS surface can be trimmed by using the commands
'gluNurbsCurve' and 'gluPwlCurve' between calls to 'gluBeginTrim'
and 'gluEndTrim'.
Note that a 'gluNurbsSurface' with SKNOTCOUNT knots in the U
direction and TKNOTCOUNT knots in the V direction with orders
SORDER and TORDER must have (SKNOTCOUNT - SORDER) TIMES (TKNOTCOUNT
- TORDER) control points.
-- Function: void gluOrtho2D left right bottom top
Define a 2D orthographic projection matrix.
LEFT
RIGHT
Specify the coordinates for the left and right vertical
clipping planes.
BOTTOM
TOP
Specify the coordinates for the bottom and top horizontal
clipping planes.
'gluOrtho2D' sets up a two-dimensional orthographic viewing region.
This is equivalent to calling 'glOrtho' with NEAR=-1 and FAR=1.
-- Function: void gluPartialDisk quad inner outer slices loops start
sweep
Draw an arc of a disk.
QUAD
Specifies a quadrics object (created with 'gluNewQuadric').
INNER
Specifies the inner radius of the partial disk (can be 0).
OUTER
Specifies the outer radius of the partial disk.
SLICES
Specifies the number of subdivisions around the Z axis.
LOOPS
Specifies the number of concentric rings about the origin into
which the partial disk is subdivided.
START
Specifies the starting angle, in degrees, of the disk portion.
SWEEP
Specifies the sweep angle, in degrees, of the disk portion.
'gluPartialDisk' renders a partial disk on the Z=0 plane. A
partial disk is similar to a full disk, except that only the subset
of the disk from START through START + SWEEP is included (where 0
degrees is along the +\f2y\f axis, 90 degrees along the +X axis,
180 degrees along the \-Y axis, and 270 degrees along the \-X
axis).
The partial disk has a radius of OUTER and contains a concentric
circular hole with a radius of INNER. If INNER is 0, then no hole
is generated. The partial disk is subdivided around the Z axis
into slices (like pizza slices) and also about the Z axis into
rings (as specified by SLICES and LOOPS, respectively).
With respect to orientation, the +Z side of the partial disk is
considered to be outside (see 'gluQuadricOrientation'). This means
that if the orientation is set to 'GLU_OUTSIDE', then any normals
generated point along the +Z axis. Otherwise, they point along the
\-Z axis.
If texturing is turned on (with 'gluQuadricTexture'), texture
coordinates are generated linearly such that where R=OUTER, the
value at (R, 0, 0) is (1.0, 0.5), at (0, R, 0) it is (0.5, 1.0), at
(\-R, 0, 0) it is (0.0, 0.5), and at (0, \-R, 0) it is (0.5, 0.0).
-- Function: void gluPerspective fovy aspect zNear zFar
Set up a perspective projection matrix.
FOVY
Specifies the field of view angle, in degrees, in the Y
direction.
ASPECT
Specifies the aspect ratio that determines the field of view
in the X direction. The aspect ratio is the ratio of X
(width) to Y (height).
ZNEAR
Specifies the distance from the viewer to the near clipping
plane (always positive).
ZFAR
Specifies the distance from the viewer to the far clipping
plane (always positive).
'gluPerspective' specifies a viewing frustum into the world
coordinate system. In general, the aspect ratio in
'gluPerspective' should match the aspect ratio of the associated
viewport. For example, ASPECT=2.0 means the viewer's angle of view
is twice as wide in X as it is in Y. If the viewport is twice as
wide as it is tall, it displays the image without distortion.
The matrix generated by 'gluPerspective' is multipled by the
current matrix, just as if 'glMultMatrix' were called with the
generated matrix. To load the perspective matrix onto the current
matrix stack instead, precede the call to 'gluPerspective' with a
call to 'glLoadIdentity'.
Given F defined as follows:
F=COTANGENT(FOVY/2,) The generated matrix is
((F/ASPECT 0 0 0), (0 F 0 0), (0 0 ZFAR+ZNEAR,/ZNEAR-ZFAR,
2×ZFAR×ZNEAR,/ZNEAR-ZFAR,), (0 0 -1 0),)
-- Function: void gluPickMatrix x y delX delY viewport
Define a picking region.
X
Y
Specify the center of a picking region in window coordinates.
DELX
DELY
Specify the width and height, respectively, of the picking
region in window coordinates.
VIEWPORT
Specifies the current viewport (as from a 'glGetIntegerv'
call).
'gluPickMatrix' creates a projection matrix that can be used to
restrict drawing to a small region of the viewport. This is
typically useful to determine what objects are being drawn near the
cursor. Use 'gluPickMatrix' to restrict drawing to a small region
around the cursor. Then, enter selection mode (with
'glRenderMode') and rerender the scene. All primitives that would
have been drawn near the cursor are identified and stored in the
selection buffer.
The matrix created by 'gluPickMatrix' is multiplied by the current
matrix just as if 'glMultMatrix' is called with the generated
matrix. To effectively use the generated pick matrix for picking,
first call 'glLoadIdentity' to load an identity matrix onto the
perspective matrix stack. Then call 'gluPickMatrix', and, finally,
call a command (such as 'gluPerspective') to multiply the
perspective matrix by the pick matrix.
When using 'gluPickMatrix' to pick NURBS, be careful to turn off
the NURBS property 'GLU_AUTO_LOAD_MATRIX'. If
'GLU_AUTO_LOAD_MATRIX' is not turned off, then any NURBS surface
rendered is subdivided differently with the pick matrix than the
way it was subdivided without the pick matrix.
-- Function: GLint gluProject objX objY objZ model proj view winX winY
winZ
Map object coordinates to window coordinates.
OBJX
OBJY
OBJZ
Specify the object coordinates.
MODEL
Specifies the current modelview matrix (as from a
'glGetDoublev' call).
PROJ
Specifies the current projection matrix (as from a
'glGetDoublev' call).
VIEW
Specifies the current viewport (as from a 'glGetIntegerv'
call).
WINX
WINY
WINZ
Return the computed window coordinates.
'gluProject' transforms the specified object coordinates into
window coordinates using MODEL, PROJ, and VIEW. The result is
stored in WINX, WINY, and WINZ. A return value of 'GLU_TRUE'
indicates success, a return value of 'GLU_FALSE' indicates failure.
To compute the coordinates, let V=(OBJX,OBJYOBJZ1.0) represented as
a matrix with 4 rows and 1 column. Then 'gluProject' computes
V^″ as follows:
V^″=P×M×V
where P is the current projection matrix PROJ and M is the current
modelview matrix MODEL (both represented as 4×4 matrices in
column-major order).
The window coordinates are then computed as follows:
WINX=VIEW(0,)+VIEW(2,)×(V^″(0,)+1,)/2WINY=VIEW(1,)+VIEW(3,)×(V^″(1,)+1,)/2
WINZ=(V^″(2,)+1,)/2
-- Function: void gluPwlCurve nurb count data stride type
Describe a piecewise linear NURBS trimming curve.
NURB
Specifies the NURBS object (created with
'gluNewNurbsRenderer').
COUNT
Specifies the number of points on the curve.
DATA
Specifies an array containing the curve points.
STRIDE
Specifies the offset (a number of single-precision
floating-point values) between points on the curve.
TYPE
Specifies the type of curve. Must be either 'GLU_MAP1_TRIM_2'
or 'GLU_MAP1_TRIM_3'.
'gluPwlCurve' describes a piecewise linear trimming curve for a
NURBS surface. A piecewise linear curve consists of a list of
coordinates of points in the parameter space for the NURBS surface
to be trimmed. These points are connected with line segments to
form a curve. If the curve is an approximation to a curve that is
not piecewise linear, the points should be close enough in
parameter space that the resulting path appears curved at the
resolution used in the application.
If TYPE is 'GLU_MAP1_TRIM_2', then it describes a curve in
two-dimensional (U and V) parameter space. If it is
'GLU_MAP1_TRIM_3', then it describes a curve in two-dimensional
homogeneous (U, V, and W) parameter space. See the 'gluBeginTrim'
reference page for more information about trimming curves.
-- Function: void gluQuadricCallback quad which CallBackFunc
Define a callback for a quadrics object.
QUAD
Specifies the quadrics object (created with 'gluNewQuadric').
WHICH
Specifies the callback being defined. The only valid value is
'GLU_ERROR'.
CALLBACKFUNC
Specifies the function to be called.
'gluQuadricCallback' is used to define a new callback to be used by
a quadrics object. If the specified callback is already defined,
then it is replaced. If CALLBACKFUNC is NULL, then any existing
callback is erased.
The one legal callback is 'GLU_ERROR':
'GLU_ERROR'
The function is called when an error is encountered. Its
single argument is of type GLenum, and it indicates the
specific error that occurred. Character strings describing
these errors can be retrieved with the 'gluErrorString' call.
-- Function: void gluQuadricDrawStyle quad draw
Specify the draw style desired for quadrics.
QUAD
Specifies the quadrics object (created with 'gluNewQuadric').
DRAW
Specifies the desired draw style. Valid values are
'GLU_FILL', 'GLU_LINE', 'GLU_SILHOUETTE', and 'GLU_POINT'.
'gluQuadricDrawStyle' specifies the draw style for quadrics
rendered with QUAD. The legal values are as follows:
'GLU_FILL'
Quadrics are rendered with polygon primitives. The polygons
are drawn in a counterclockwise fashion with respect to their
normals (as defined with 'gluQuadricOrientation').
'GLU_LINE'
Quadrics are rendered as a set of lines.
'GLU_SILHOUETTE'
Quadrics are rendered as a set of lines, except that edges
separating coplanar faces will not be drawn.
'GLU_POINT'
Quadrics are rendered as a set of points.
-- Function: void gluQuadricNormals quad normal
Specify what kind of normals are desired for quadrics.
QUAD
Specifies the quadrics object (created with 'gluNewQuadric').
NORMAL
Specifies the desired type of normals. Valid values are
'GLU_NONE', 'GLU_FLAT', and 'GLU_SMOOTH'.
'gluQuadricNormals' specifies what kind of normals are desired for
quadrics rendered with QUAD. The legal values are as follows:
'GLU_NONE'
No normals are generated.
'GLU_FLAT'
One normal is generated for every facet of a quadric.
'GLU_SMOOTH'
One normal is generated for every vertex of a quadric. This
is the initial value.
-- Function: void gluQuadricOrientation quad orientation
Specify inside/outside orientation for quadrics.
QUAD
Specifies the quadrics object (created with 'gluNewQuadric').
ORIENTATION
Specifies the desired orientation. Valid values are
'GLU_OUTSIDE' and 'GLU_INSIDE'.
'gluQuadricOrientation' specifies what kind of orientation is
desired for quadrics rendered with QUAD. The ORIENTATION values
are as follows:
'GLU_OUTSIDE'
Quadrics are drawn with normals pointing outward (the initial
value).
'GLU_INSIDE'
Quadrics are drawn with normals pointing inward.
Note that the interpretation of OUTWARD and INWARD depends on the
quadric being drawn.
-- Function: void gluQuadricTexture quad texture
Specify if texturing is desired for quadrics.
QUAD
Specifies the quadrics object (created with 'gluNewQuadric').
TEXTURE
Specifies a flag indicating if texture coordinates should be
generated.
'gluQuadricTexture' specifies if texture coordinates should be
generated for quadrics rendered with QUAD. If the value of TEXTURE
is 'GLU_TRUE', then texture coordinates are generated, and if
TEXTURE is 'GLU_FALSE', they are not. The initial value is
'GLU_FALSE'.
The manner in which texture coordinates are generated depends upon
the specific quadric rendered.
-- Function: GLint gluScaleImage format wIn hIn typeIn dataIn wOut hOut
typeOut dataOut
Scale an image to an arbitrary size.
FORMAT
Specifies the format of the pixel data. The following
symbolic values are valid: 'GLU_COLOR_INDEX',
'GLU_STENCIL_INDEX', 'GLU_DEPTH_COMPONENT', 'GLU_RED',
'GLU_GREEN', 'GLU_BLUE', 'GLU_ALPHA', 'GLU_RGB', 'GLU_RGBA',
'GLU_BGR', 'GLU_BGRA', 'GLU_LUMINANCE', and
'GLU_LUMINANCE_ALPHA'.
WIN
HIN
Specify in pixels the width and height, respectively, of the
source image.
TYPEIN
Specifies the data type for DATAIN. Must be one of
'GLU_UNSIGNED_BYTE', 'GLU_BYTE', 'GLU_BITMAP',
'GLU_UNSIGNED_SHORT', 'GLU_SHORT', 'GLU_UNSIGNED_INT',
'GLU_INT', 'GLU_FLOAT', 'GLU_UNSIGNED_BYTE_3_3_2',
'GLU_UNSIGNED_BYTE_2_3_3_REV', 'GLU_UNSIGNED_SHORT_5_6_5',
'GLU_UNSIGNED_SHORT_5_6_5_REV', 'GLU_UNSIGNED_SHORT_4_4_4_4',
'GLU_UNSIGNED_SHORT_4_4_4_4_REV',
'GLU_UNSIGNED_SHORT_5_5_5_1',
'GLU_UNSIGNED_SHORT_1_5_5_5_REV', 'GLU_UNSIGNED_INT_8_8_8_8',
'GLU_UNSIGNED_INT_8_8_8_8_REV', 'GLU_UNSIGNED_INT_10_10_10_2',
or 'GLU_UNSIGNED_INT_2_10_10_10_REV'.
DATAIN
Specifies a pointer to the source image.
WOUT
HOUT
Specify the width and height, respectively, in pixels of the
destination image.
TYPEOUT
Specifies the data type for DATAOUT. Must be one of
'GLU_UNSIGNED_BYTE', 'GLU_BYTE', 'GLU_BITMAP',
'GLU_UNSIGNED_SHORT', 'GLU_SHORT', 'GLU_UNSIGNED_INT',
'GLU_INT', 'GLU_FLOAT', 'GLU_UNSIGNED_BYTE_3_3_2',
'GLU_UNSIGNED_BYTE_2_3_3_REV', 'GLU_UNSIGNED_SHORT_5_6_5',
'GLU_UNSIGNED_SHORT_5_6_5_REV', 'GLU_UNSIGNED_SHORT_4_4_4_4',
'GLU_UNSIGNED_SHORT_4_4_4_4_REV',
'GLU_UNSIGNED_SHORT_5_5_5_1',
'GLU_UNSIGNED_SHORT_1_5_5_5_REV', 'GLU_UNSIGNED_INT_8_8_8_8',
'GLU_UNSIGNED_INT_8_8_8_8_REV', 'GLU_UNSIGNED_INT_10_10_10_2',
or 'GLU_UNSIGNED_INT_2_10_10_10_REV'.
DATAOUT
Specifies a pointer to the destination image.
'gluScaleImage' scales a pixel image using the appropriate pixel
store modes to unpack data from the source image and pack data into
the destination image.
When shrinking an image, 'gluScaleImage' uses a box filter to
sample the source image and create pixels for the destination
image. When magnifying an image, the pixels from the source image
are linearly interpolated to create the destination image.
A return value of zero indicates success, otherwise a GLU error
code is returned (see 'gluErrorString').
See the 'glReadPixels' reference page for a description of the
acceptable values for the FORMAT, TYPEIN, and TYPEOUT parameters.
'GLU_INVALID_VALUE' is returned if WIN, HIN, WOUT, or HOUT is
negative.
'GLU_INVALID_ENUM' is returned if FORMAT, TYPEIN, or TYPEOUT is not
legal.
'GLU_INVALID_OPERATION' is returned if TYPEIN or TYPEOUT is
'GLU_UNSIGNED_BYTE_3_3_2' or 'GLU_UNSIGNED_BYTE_2_3_3_REV' and
FORMAT is not 'GLU_RGB'.
'GLU_INVALID_OPERATION' is returned if TYPEIN or TYPEOUT is
'GLU_UNSIGNED_SHORT_5_6_5' or 'GLU_UNSIGNED_SHORT_5_6_5_REV' and
FORMAT is not 'GLU_RGB'.
'GLU_INVALID_OPERATION' is returned if TYPEIN or TYPEOUT is
'GLU_UNSIGNED_SHORT_4_4_4_4' or 'GLU_UNSIGNED_SHORT_4_4_4_4_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPEIN or TYPEOUT is
'GLU_UNSIGNED_SHORT_5_5_5_1' or 'GLU_UNSIGNED_SHORT_1_5_5_5_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPEIN or TYPEOUT is
'GLU_UNSIGNED_INT_8_8_8_8' or 'GLU_UNSIGNED_INT_8_8_8_8_REV' and
FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
'GLU_INVALID_OPERATION' is returned if TYPEIN or TYPEOUT is
'GLU_UNSIGNED_INT_10_10_10_2' or 'GLU_UNSIGNED_INT_2_10_10_10_REV'
and FORMAT is neither 'GLU_RGBA' nor 'GLU_BGRA'.
-- Function: void gluSphere quad radius slices stacks
Draw a sphere.
QUAD
Specifies the quadrics object (created with 'gluNewQuadric').
RADIUS
Specifies the radius of the sphere.
SLICES
Specifies the number of subdivisions around the Z axis
(similar to lines of longitude).
STACKS
Specifies the number of subdivisions along the Z axis (similar
to lines of latitude).
'gluSphere' draws a sphere of the given radius centered around the
origin. The sphere is subdivided around the Z axis into slices and
along the Z axis into stacks (similar to lines of longitude and
latitude).
If the orientation is set to 'GLU_OUTSIDE' (with
'gluQuadricOrientation'), then any normals generated point away
from the center of the sphere. Otherwise, they point toward the
center of the sphere.
If texturing is turned on (with 'gluQuadricTexture'), then texture
coordinates are generated so that T ranges from 0.0 at Z=-RADIUS to
1.0 at Z=RADIUS (T increases linearly along longitudinal lines),
and S ranges from 0.0 at the +Y axis, to 0.25 at the +X axis, to
0.5 at the \-Y axis, to 0.75 at the \-X axis, and back to 1.0 at
the +Y axis.
-- Function: void gluTessBeginContour tess
-- Function: void gluTessEndContour tess
Delimit a contour description.
TESS
Specifies the tessellation object (created with 'gluNewTess').
'gluTessBeginContour' and 'gluTessEndContour' delimit the
definition of a polygon contour. Within each
'gluTessBeginContour'/'gluTessEndContour' pair, there can be zero
or more calls to 'gluTessVertex'. The vertices specify a closed
contour (the last vertex of each contour is automatically linked to
the first). See the 'gluTessVertex' reference page for more
details. 'gluTessBeginContour' can only be called between
'gluTessBeginPolygon' and 'gluTessEndPolygon'.
-- Function: void gluTessBeginPolygon tess data
Delimit a polygon description.
TESS
Specifies the tessellation object (created with 'gluNewTess').
DATA
Specifies a pointer to user polygon data.
'gluTessBeginPolygon' and 'gluTessEndPolygon' delimit the
definition of a convex, concave or self-intersecting polygon.
Within each 'gluTessBeginPolygon'/'gluTessEndPolygon' pair, there
must be one or more calls to
'gluTessBeginContour'/'gluTessEndContour'. Within each contour,
there are zero or more calls to 'gluTessVertex'. The vertices
specify a closed contour (the last vertex of each contour is
automatically linked to the first). See the 'gluTessVertex',
'gluTessBeginContour', and 'gluTessEndContour' reference pages for
more details.
DATA is a pointer to a user-defined data structure. If the
appropriate callback(s) are specified (see 'gluTessCallback'), then
this pointer is returned to the callback function(s). Thus, it is
a convenient way to store per-polygon information.
Once 'gluTessEndPolygon' is called, the polygon is tessellated, and
the resulting triangles are described through callbacks. See
'gluTessCallback' for descriptions of the callback functions.
-- Function: void gluTessCallback tess which CallBackFunc
Define a callback for a tessellation object.
TESS
Specifies the tessellation object (created with 'gluNewTess').
WHICH
Specifies the callback being defined. The following values
are valid: 'GLU_TESS_BEGIN', 'GLU_TESS_BEGIN_DATA',
'GLU_TESS_EDGE_FLAG', 'GLU_TESS_EDGE_FLAG_DATA',
'GLU_TESS_VERTEX', 'GLU_TESS_VERTEX_DATA', 'GLU_TESS_END',
'GLU_TESS_END_DATA', 'GLU_TESS_COMBINE',
'GLU_TESS_COMBINE_DATA', 'GLU_TESS_ERROR', and
'GLU_TESS_ERROR_DATA'.
CALLBACKFUNC
Specifies the function to be called.
'gluTessCallback' is used to indicate a callback to be used by a
tessellation object. If the specified callback is already defined,
then it is replaced. If CALLBACKFUNC is NULL, then the existing
callback becomes undefined.
These callbacks are used by the tessellation object to describe how
a polygon specified by the user is broken into triangles. Note
that there are two versions of each callback: one with
user-specified polygon data and one without. If both versions of a
particular callback are specified, then the callback with
user-specified polygon data will be used. Note that the
POLYGON_DATA parameter used by some of the functions is a copy of
the pointer that was specified when 'gluTessBeginPolygon' was
called. The legal callbacks are as follows:
'GLU_TESS_BEGIN'
The begin callback is invoked like 'glBegin' to indicate the
start of a (triangle) primitive. The function takes a single
argument of type GLenum. If the 'GLU_TESS_BOUNDARY_ONLY'
property is set to 'GLU_FALSE', then the argument is set to
either 'GLU_TRIANGLE_FAN', 'GLU_TRIANGLE_STRIP', or
'GLU_TRIANGLES'. If the 'GLU_TESS_BOUNDARY_ONLY' property is
set to 'GLU_TRUE', then the argument will be set to
'GLU_LINE_LOOP'. The function prototype for this callback is:
'GLU_TESS_BEGIN_DATA'
The same as the 'GLU_TESS_BEGIN' callback except that it takes
an additional pointer argument. This pointer is identical to
the opaque pointer provided when 'gluTessBeginPolygon' was
called. The function prototype for this callback is:
'GLU_TESS_EDGE_FLAG'
The edge flag callback is similar to 'glEdgeFlag'. The
function takes a single boolean flag that indicates which
edges lie on the polygon boundary. If the flag is 'GLU_TRUE',
then each vertex that follows begins an edge that lies on the
polygon boundary, that is, an edge that separates an interior
region from an exterior one. If the flag is 'GLU_FALSE', then
each vertex that follows begins an edge that lies in the
polygon interior. The edge flag callback (if defined) is
invoked before the first vertex callback.
Since triangle fans and triangle strips do not support edge
flags, the begin callback is not called with
'GLU_TRIANGLE_FAN' or 'GLU_TRIANGLE_STRIP' if a non-NULL edge
flag callback is provided. (If the callback is initialized to
NULL, there is no impact on performance). Instead, the fans
and strips are converted to independent triangles. The
function prototype for this callback is:
'GLU_TESS_EDGE_FLAG_DATA'
The same as the 'GLU_TESS_EDGE_FLAG' callback except that it
takes an additional pointer argument. This pointer is
identical to the opaque pointer provided when
'gluTessBeginPolygon' was called. The function prototype for
this callback is:
'GLU_TESS_VERTEX'
The vertex callback is invoked between the begin and end
callbacks. It is similar to 'glVertex', and it defines the
vertices of the triangles created by the tessellation process.
The function takes a pointer as its only argument. This
pointer is identical to the opaque pointer provided by the
user when the vertex was described (see 'gluTessVertex'). The
function prototype for this callback is:
'GLU_TESS_VERTEX_DATA'
The same as the 'GLU_TESS_VERTEX' callback except that it
takes an additional pointer argument. This pointer is
identical to the opaque pointer provided when
'gluTessBeginPolygon' was called. The function prototype for
this callback is:
'GLU_TESS_END'
The end callback serves the same purpose as 'glEnd'. It
indicates the end of a primitive and it takes no arguments.
The function prototype for this callback is:
'GLU_TESS_END_DATA'
The same as the 'GLU_TESS_END' callback except that it takes
an additional pointer argument. This pointer is identical to
the opaque pointer provided when 'gluTessBeginPolygon' was
called. The function prototype for this callback is:
'GLU_TESS_COMBINE'
The combine callback is called to create a new vertex when the
tessellation detects an intersection or wishes to merge
features. The function takes four arguments: an array of
three elements each of type GLdouble, an array of four
pointers, an array of four elements each of type GLfloat, and
a pointer to a pointer. The prototype is:
The vertex is defined as a linear combination of up to four
existing vertices, stored in VERTEX_DATA. The coefficients of
the linear combination are given by WEIGHT; these weights
always add up to 1. All vertex pointers are valid even when
some of the weights are 0. COORDS gives the location of the
new vertex.
The user must allocate another vertex, interpolate parameters
using VERTEX_DATA and WEIGHT, and return the new vertex
pointer in OUTDATA. This handle is supplied during rendering
callbacks. The user is responsible for freeing the memory
some time after 'gluTessEndPolygon' is called.
For example, if the polygon lies in an arbitrary plane in
3-space, and a color is associated with each vertex, the
'GLU_TESS_COMBINE' callback might look like this:
If the tessellation detects an intersection, then the
'GLU_TESS_COMBINE' or 'GLU_TESS_COMBINE_DATA' callback (see
below) must be defined, and it must write a non-NULL pointer
into DATAOUT. Otherwise the 'GLU_TESS_NEED_COMBINE_CALLBACK'
error occurs, and no output is generated.
'GLU_TESS_COMBINE_DATA'
The same as the 'GLU_TESS_COMBINE' callback except that it
takes an additional pointer argument. This pointer is
identical to the opaque pointer provided when
'gluTessBeginPolygon' was called. The function prototype for
this callback is:
'GLU_TESS_ERROR'
The error callback is called when an error is encountered.
The one argument is of type GLenum; it indicates the specific
error that occurred and will be set to one of
'GLU_TESS_MISSING_BEGIN_POLYGON',
'GLU_TESS_MISSING_END_POLYGON',
'GLU_TESS_MISSING_BEGIN_CONTOUR',
'GLU_TESS_MISSING_END_CONTOUR', 'GLU_TESS_COORD_TOO_LARGE',
'GLU_TESS_NEED_COMBINE_CALLBACK', or 'GLU_OUT_OF_MEMORY'.
Character strings describing these errors can be retrieved
with the 'gluErrorString' call. The function prototype for
this callback is:
The GLU library will recover from the first four errors by
inserting the missing call(s). 'GLU_TESS_COORD_TOO_LARGE'
indicates that some vertex coordinate exceeded the predefined
constant 'GLU_TESS_MAX_COORD' in absolute value, and that the
value has been clamped. (Coordinate values must be small
enough so that two can be multiplied together without
overflow.) 'GLU_TESS_NEED_COMBINE_CALLBACK' indicates that
the tessellation detected an intersection between two edges in
the input data, and the 'GLU_TESS_COMBINE' or
'GLU_TESS_COMBINE_DATA' callback was not provided. No output
is generated. 'GLU_OUT_OF_MEMORY' indicates that there is not
enough memory so no output is generated.
'GLU_TESS_ERROR_DATA'
The same as the 'GLU_TESS_ERROR' callback except that it takes
an additional pointer argument. This pointer is identical to
the opaque pointer provided when 'gluTessBeginPolygon' was
called. The function prototype for this callback is:
void begin( GLenum type );
void beginData( GLenum type, void *polygon_data );
void edgeFlag( GLboolean flag );
void edgeFlagData( GLboolean flag, void *polygon_data );
void vertex( void *vertex_data );
void vertexData( void *vertex_data, void *polygon_data );
void end( void );
void endData( void *polygon_data );
void combine( GLdouble coords[3], void *vertex_data[4],
GLfloat weight[4], void **outData );
void myCombine( GLdouble coords[3], VERTEX *d[4],
GLfloat w[4], VERTEX **dataOut )
{
VERTEX *new = new_vertex();
new->x = coords[0];
new->y = coords[1];
new->z = coords[2];
new->r = w[0]*d[0]->r + w[1]*d[1]->r + w[2]*d[2]->r + w[3]*d[3]->r;
new->g = w[0]*d[0]->g + w[1]*d[1]->g + w[2]*d[2]->g + w[3]*d[3]->g;
new->b = w[0]*d[0]->b + w[1]*d[1]->b + w[2]*d[2]->b + w[3]*d[3]->b;
new->a = w[0]*d[0]->a + w[1]*d[1]->a + w[2]*d[2]->a + w[3]*d[3]->a;
*dataOut = new;
}
void combineData( GLdouble coords[3], void *vertex_data[4],
GLfloat weight[4], void **outData,
void *polygon_data );
void error( GLenum errno );
void errorData( GLenum errno, void *polygon_data );
-- Function: void gluTessEndPolygon tess
Delimit a polygon description.
TESS
Specifies the tessellation object (created with 'gluNewTess').
'gluTessBeginPolygon' and 'gluTessEndPolygon' delimit the
definition of a convex, concave, or self-intersecting polygon.
Within each 'gluTessBeginPolygon'/'gluTessEndPolygon' pair, there
must be one or more calls to
'gluTessBeginContour'/'gluTessEndContour'. Within each contour,
there are zero or more calls to 'gluTessVertex'. The vertices
specify a closed contour (the last vertex of each contour is
automatically linked to the first). See the 'gluTessVertex',
'gluTessBeginContour', and 'gluTessEndContour' reference pages for
more details.
Once 'gluTessEndPolygon' is called, the polygon is tessellated, and
the resulting triangles are described through callbacks. See
'gluTessCallback' for descriptions of the callback functions.
-- Function: void gluTessNormal tess valueX valueY valueZ
Specify a normal for a polygon.
TESS
Specifies the tessellation object (created with 'gluNewTess').
VALUEX
Specifies the first component of the normal.
VALUEY
Specifies the second component of the normal.
VALUEZ
Specifies the third component of the normal.
'gluTessNormal' describes a normal for a polygon that the program
is defining. All input data will be projected onto a plane
perpendicular to one of the three coordinate axes before
tessellation and all output triangles will be oriented CCW with
respect to the normal (CW orientation can be obtained by reversing
the sign of the supplied normal). For example, if you know that
all polygons lie in the x-y plane, call 'gluTessNormal'(tess, 0.0,
0.0, 1.0) before rendering any polygons.
If the supplied normal is (0.0, 0.0, 0.0) (the initial value), the
normal is determined as follows. The direction of the normal, up
to its sign, is found by fitting a plane to the vertices, without
regard to how the vertices are connected. It is expected that the
input data lies approximately in the plane; otherwise, projection
perpendicular to one of the three coordinate axes may substantially
change the geometry. The sign of the normal is chosen so that the
sum of the signed areas of all input contours is nonnegative (where
a CCW contour has positive area).
The supplied normal persists until it is changed by another call to
'gluTessNormal'.
-- Function: void gluTessProperty tess which data
Set a tessellation object property.
TESS
Specifies the tessellation object (created with 'gluNewTess').
WHICH
Specifies the property to be set. Valid values are
'GLU_TESS_WINDING_RULE', 'GLU_TESS_BOUNDARY_ONLY', and
'GLU_TESS_TOLERANCE'.
DATA
Specifies the value of the indicated property.
'gluTessProperty' is used to control properties stored in a
tessellation object. These properties affect the way that the
polygons are interpreted and rendered. The legal values for WHICH
are as follows:
'GLU_TESS_WINDING_RULE'
Determines which parts of the polygon are on the "interior".
DATA may be set to one of 'GLU_TESS_WINDING_ODD',
'GLU_TESS_WINDING_NONZERO', 'GLU_TESS_WINDING_POSITIVE',
'GLU_TESS_WINDING_NEGATIVE', or
'GLU_TESS_WINDING_ABS_GEQ_TWO'.
To understand how the winding rule works, consider that the
input contours partition the plane into regions. The winding
rule determines which of these regions are inside the polygon.
For a single contour C, the winding number of a point x is
simply the signed number of revolutions we make around x as we
travel once around C (where CCW is positive). When there are
several contours, the individual winding numbers are summed.
This procedure associates a signed integer value with each
point x in the plane. Note that the winding number is the
same for all points in a single region.
The winding rule classifies a region as "inside" if its
winding number belongs to the chosen category (odd, nonzero,
positive, negative, or absolute value of at least two). The
previous GLU tessellator (prior to GLU 1.2) used the "odd"
rule. The "nonzero" rule is another common way to define the
interior. The other three rules are useful for polygon CSG
operations.
'GLU_TESS_BOUNDARY_ONLY'
Is a boolean value ("value" should be set to GL_TRUE or
GL_FALSE). When set to GL_TRUE, a set of closed contours
separating the polygon interior and exterior are returned
instead of a tessellation. Exterior contours are oriented CCW
with respect to the normal; interior contours are oriented CW.
The 'GLU_TESS_BEGIN' and 'GLU_TESS_BEGIN_DATA' callbacks use
the type GL_LINE_LOOP for each contour.
'GLU_TESS_TOLERANCE'
Specifies a tolerance for merging features to reduce the size
of the output. For example, two vertices that are very close
to each other might be replaced by a single vertex. The
tolerance is multiplied by the largest coordinate magnitude of
any input vertex; this specifies the maximum distance that any
feature can move as the result of a single merge operation.
If a single feature takes part in several merge operations,
the total distance moved could be larger.
Feature merging is completely optional; the tolerance is only
a hint. The implementation is free to merge in some cases and
not in others, or to never merge features at all. The initial
tolerance is 0.
The current implementation merges vertices only if they are
exactly coincident, regardless of the current tolerance. A
vertex is spliced into an edge only if the implementation is
unable to distinguish which side of the edge the vertex lies
on. Two edges are merged only when both endpoints are
identical.
-- Function: void gluTessVertex tess location data
Specify a vertex on a polygon.
TESS
Specifies the tessellation object (created with 'gluNewTess').
LOCATION
Specifies the location of the vertex.
DATA
Specifies an opaque pointer passed back to the program with
the vertex callback (as specified by 'gluTessCallback').
'gluTessVertex' describes a vertex on a polygon that the program
defines. Successive 'gluTessVertex' calls describe a closed
contour. For example, to describe a quadrilateral, 'gluTessVertex'
should be called four times. 'gluTessVertex' can only be called
between 'gluTessBeginContour' and 'gluTessEndContour'.
DATA normally points to a structure containing the vertex location,
as well as other per-vertex attributes such as color and normal.
This pointer is passed back to the user through the
'GLU_TESS_VERTEX' or 'GLU_TESS_VERTEX_DATA' callback after
tessellation (see the 'gluTessCallback' reference page).
-- Function: GLint gluUnProject4 winX winY winZ clipW model proj view
nearVal farVal objX objY objZ objW
Map window and clip coordinates to object coordinates.
WINX
WINY
WINZ
Specify the window coordinates to be mapped.
CLIPW
Specify the clip w coordinate to be mapped.
MODEL
Specifies the modelview matrix (as from a 'glGetDoublev'
call).
PROJ
Specifies the projection matrix (as from a 'glGetDoublev'
call).
VIEW
Specifies the viewport (as from a 'glGetIntegerv' call).
NEARVAL
FARVAL
Specifies the near and far planes (as from a 'glGetDoublev'
call).
OBJX
OBJY
OBJZ
OBJW
Returns the computed object coordinates.
'gluUnProject4' maps the specified window coordinatesi: WINX, WINY,
and WINZ and its clip w coordinate CLIPW into object coordinates
(OBJX,OBJYOBJZOBJW) using MODEL, PROJ, and VIEW. CLIPW can be
other than 1 as for vertices in 'glFeedbackBuffer' when data type
'GLU_4D_COLOR_TEXTURE' is returned. This also handles the case
where the NEARVAL and FARVAL planes are different from the default,
0 and 1, respectively. A return value of 'GLU_TRUE' indicates
success; a return value of 'GLU_FALSE' indicates failure.
To compute the coordinates (OBJX,OBJYOBJZOBJW), 'gluUnProject4'
multiplies the normalized device coordinates by the inverse of
MODEL * PROJ as follows:
((OBJX), (OBJY), (OBJZ),
(OBJW),)=INV(PM,)((2(WINX-VIEW[0,],),/VIEW[2,],-1),
(2(WINY-VIEW[1,],),/VIEW[3,],-1),
(2(WINZ-NEARVAL,),/(FARVAL-NEARVAL,),-1), (CLIPW),)
INV denotes matrix inversion.
'gluUnProject4' is equivalent to 'gluUnProject' when CLIPW is 1,
NEARVAL is 0, and FARVAL is 1.
-- Function: GLint gluUnProject winX winY winZ model proj view objX
objY objZ
Map window coordinates to object coordinates.
WINX
WINY
WINZ
Specify the window coordinates to be mapped.
MODEL
Specifies the modelview matrix (as from a 'glGetDoublev'
call).
PROJ
Specifies the projection matrix (as from a 'glGetDoublev'
call).
VIEW
Specifies the viewport (as from a 'glGetIntegerv' call).
OBJX
OBJY
OBJZ
Returns the computed object coordinates.
'gluUnProject' maps the specified window coordinates into object
coordinates using MODEL, PROJ, and VIEW. The result is stored in
OBJX, OBJY, and OBJZ. A return value of 'GLU_TRUE' indicates
success; a return value of 'GLU_FALSE' indicates failure.
To compute the coordinates (OBJX,OBJYOBJZ), 'gluUnProject'
multiplies the normalized device coordinates by the inverse of
MODEL * PROJ as follows:
((OBJX), (OBJY), (OBJZ),
(W),)=INV(PM,)((2(WINX-VIEW[0,],),/VIEW[2,],-1),
(2(WINY-VIEW[1,],),/VIEW[3,],-1), (2(WINZ,)-1),
(1),)INV denotes matrix inversion. W is an unused variable,
included for consistent matrix notation.
5 GLX
*****
5.1 GLX API
===========
Import the GLX module to have access to these procedures:
(use-modules (glx))
The GLX specification is available at
.
5.2 GLX Enumerations
====================
The functions from this section may be had by loading the module:
(use-modules (glx enums)
-- Macro: glx-string-name enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'vendor', 'version', 'extensions'.
-- Macro: glx-error-code enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'bad-screen', 'bad-attribute', 'no-extension', 'bad-visual',
'bad-context', 'bad-value', 'bad-enum',
'bad-hyperpipe-config-sgix', 'bad-hyperpipe-sgix'.
-- Macro: glx-drawable-type-mask enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'window-bit', 'pixmap-bit', 'pbuffer-bit', 'window-bit-sgix',
'pixmap-bit-sgix', 'pbuffer-bit-sgix'.
-- Macro: glx-render-type-mask enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'rgba-bit', 'color-index-bit', 'rgba-bit-sgix',
'color-index-bit-sgix', 'rgba-float-bit-arb',
'rgba-unsigned-float-bit-ext'.
-- Macro: glx-sync-type enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'sync-frame-sgix', 'sync-swap-sgix'.
-- Macro: glx-event-mask enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pbuffer-clobber-mask', 'buffer-clobber-mask-sgix',
'buffer-swap-complete-intel-mask'.
-- Macro: glx-pbuffer-clobber-mask enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'front-left-buffer-bit', 'front-right-buffer-bit',
'back-left-buffer-bit', 'back-right-buffer-bit', 'aux-buffers-bit',
'depth-buffer-bit', 'stencil-buffer-bit', 'accum-buffer-bit',
'front-left-buffer-bit-sgix', 'front-right-buffer-bit-sgix',
'back-left-buffer-bit-sgix', 'back-right-buffer-bit-sgix',
'aux-buffers-bit-sgix', 'depth-buffer-bit-sgix',
'stencil-buffer-bit-sgix', 'accum-buffer-bit-sgix',
'sample-buffers-bit-sgix'.
-- Macro: glx-hyperpipe-type-mask enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'hyperpipe-display-pipe-sgix', 'hyperpipe-render-pipe-sgix'.
-- Macro: glx-hyperpipe-attrib enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'pipe-rect-sgix', 'pipe-rect-limits-sgix', 'hyperpipe-stereo-sgix',
'hyperpipe-pixel-average-sgix'.
-- Macro: glx-hyperpipe-misc enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'hyperpipe-pipe-name-length-sgix'.
-- Macro: glx-bind-to-texture-target-mask enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'texture-1d-bit-ext', 'texture-2d-bit-ext',
'texture-rectangle-bit-ext'.
-- Macro: glx-context-flags enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'context-debug-bit-arb', 'context-forward-compatible-bit-arb',
'context-robust-access-bit-arb', 'context-reset-isolation-bit-arb'.
-- Macro: glx-context-profile-mask enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'context-core-profile-bit-arb',
'context-compatibility-profile-bit-arb',
'context-es-profile-bit-ext', 'context-es2-profile-bit-ext'.
-- Macro: glx-attribute enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'use-gl', 'buffer-size', 'level', 'rgba', 'doublebuffer', 'stereo',
'aux-buffers', 'red-size', 'green-size', 'blue-size', 'alpha-size',
'depth-size', 'stencil-size', 'accum-red-size', 'accum-green-size',
'accum-blue-size', 'accum-alpha-size', 'config-caveat',
'x-visual-type', 'transparent-type', 'transparent-index-value',
'transparent-red-value', 'transparent-green-value',
'transparent-blue-value', 'transparent-alpha-value', 'dont-care',
'none', 'slow-config', 'true-color', 'direct-color',
'pseudo-color', 'static-color', 'gray-scale', 'static-gray',
'transparent-rgb', 'transparent-index', 'visual-id', 'screen',
'non-conformant-config', 'drawable-type', 'render-type',
'x-renderable', 'fbconfig-id', 'rgba-type', 'color-index-type',
'max-pbuffer-width', 'max-pbuffer-height', 'max-pbuffer-pixels',
'preserved-contents', 'largest-pbuffer', 'width', 'height',
'event-mask', 'damaged', 'saved', 'window', 'pbuffer',
'pbuffer-height', 'pbuffer-width', 'visual-caveat-ext',
'x-visual-type-ext', 'transparent-type-ext',
'transparent-index-value-ext', 'transparent-red-value-ext',
'transparent-green-value-ext', 'transparent-blue-value-ext',
'transparent-alpha-value-ext', 'none-ext', 'slow-visual-ext',
'true-color-ext', 'direct-color-ext', 'pseudo-color-ext',
'static-color-ext', 'gray-scale-ext', 'static-gray-ext',
'transparent-rgb-ext', 'transparent-index-ext',
'share-context-ext', 'visual-id-ext', 'screen-ext',
'non-conformant-visual-ext', 'drawable-type-sgix',
'render-type-sgix', 'x-renderable-sgix', 'fbconfig-id-sgix',
'rgba-type-sgix', 'color-index-type-sgix',
'max-pbuffer-width-sgix', 'max-pbuffer-height-sgix',
'max-pbuffer-pixels-sgix', 'optimal-pbuffer-width-sgix',
'optimal-pbuffer-height-sgix', 'preserved-contents-sgix',
'largest-pbuffer-sgix', 'width-sgix', 'height-sgix',
'event-mask-sgix', 'damaged-sgix', 'saved-sgix', 'window-sgix',
'pbuffer-sgix', 'digital-media-pbuffer-sgix', 'blended-rgba-sgis',
'multisample-sub-rect-width-sgis',
'multisample-sub-rect-height-sgis', 'visual-select-group-sgix',
'hyperpipe-id-sgix', 'sample-buffers-sgis', 'samples-sgis',
'sample-buffers-arb', 'samples-arb', 'sample-buffers', 'samples',
'coverage-samples-nv', 'context-major-version-arb',
'context-minor-version-arb', 'context-flags-arb',
'context-allow-buffer-byte-order-mismatch-arb',
'float-components-nv', 'rgba-unsigned-float-type-ext',
'framebuffer-srgb-capable-arb', 'framebuffer-srgb-capable-ext',
'color-samples-nv', 'rgba-float-type-arb', 'video-out-color-nv',
'video-out-alpha-nv', 'video-out-depth-nv',
'video-out-color-and-alpha-nv', 'video-out-color-and-depth-nv',
'video-out-frame-nv', 'video-out-field-1-nv',
'video-out-field-2-nv', 'video-out-stacked-fields-1-2-nv',
'video-out-stacked-fields-2-1-nv', 'device-id-nv', 'unique-id-nv',
'num-video-capture-slots-nv', 'bind-to-texture-rgb-ext',
'bind-to-texture-rgba-ext', 'bind-to-mipmap-texture-ext',
'bind-to-texture-targets-ext', 'y-inverted-ext',
'texture-format-ext', 'texture-target-ext', 'mipmap-texture-ext',
'texture-format-none-ext', 'texture-format-rgb-ext',
'texture-format-rgba-ext', 'texture-1d-ext', 'texture-2d-ext',
'texture-rectangle-ext', 'front-left-ext', 'front-right-ext',
'back-left-ext', 'back-right-ext', 'front-ext', 'back-ext',
'aux0-ext', 'aux1-ext', 'aux2-ext', 'aux3-ext', 'aux4-ext',
'aux5-ext', 'aux6-ext', 'aux7-ext', 'aux8-ext', 'aux9-ext'.
-- Macro: nv-present-video enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'num-video-slots-nv'.
-- Macro: ext-swap-control enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'swap-interval-ext', 'max-swap-interval-ext'.
-- Macro: ext-swap-control-tear enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'late-swaps-tear-ext'.
-- Macro: ext-buffer-age enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'back-buffer-age-ext'.
-- Macro: glx-amd-gpu-association enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'gpu-vendor-amd', 'gpu-renderer-string-amd',
'gpu-opengl-version-string-amd', 'gpu-fastest-target-gpus-amd',
'gpu-ram-amd', 'gpu-clock-amd', 'gpu-num-pipes-amd',
'gpu-num-simd-amd', 'gpu-num-rb-amd', 'gpu-num-spi-amd'.
-- Macro: glx-arb-create-context-robustness enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'lose-context-on-reset-arb',
'context-reset-notification-strategy-arb',
'no-reset-notification-arb'.
-- Macro: arb-create-context-profile enum
Enumerated value. The symbolic ENUM argument is replaced with its
corresponding numeric value at compile-time. The symbolic
arguments known to this enumerated value form are:
'context-profile-mask-arb'.
5.3 Low-Level GLX
=================
The functions from this section may be had by loading the module:
(use-modules (glx low-level)
This section of the manual was derived from the upstream OpenGL
documentation. Each function's documentation has its own copyright
statement; for full details, see the upstream documentation. The
copyright notices and licenses present in this section are as follows.
Copyright (C) 1991-2006 Silicon Graphics, Inc. This document is
licensed under the SGI Free Software B License. For details, see
http://oss.sgi.com/projects/FreeB/ (http://oss.sgi.com/projects/FreeB/).
-- Function: GLXFBConfig-* glXChooseFBConfig dpy screen attrib_list
nelements
Return a list of GLX frame buffer configurations that match the
specified attributes.
DPY
Specifies the connection to the X server.
SCREEN
Specifies the screen number.
ATTRIB_LIST
Specifies a list of attribute/value pairs. The last attribute
must be 'None'.
NELEMENTS
Returns the number of elements in the list returned by
'glXChooseFBConfig'.
'glXChooseFBConfig' returns GLX frame buffer configurations that
match the attributes specified in ATTRIB_LIST, or 'NULL' if no
matches are found. If ATTRIB_LIST is 'NULL', then
'glXChooseFBConfig' returns an array of GLX frame buffer
configurations that are available on the specified screen. If an
error occurs, no frame buffer configurations exist on the specified
screen, or if no frame buffer configurations match the specified
attributes, then 'NULL' is returned. Use 'XFree' to free the
memory returned by 'glXChooseFBConfig'.
All attributes in ATTRIB_LIST, including boolean attributes, are
immediately followed by the corresponding desired value. The list
is terminated with 'None'. If an attribute is not specified in
ATTRIB_LIST, then the default value (see below) is used (and the
attribute is said to be specified implicitly). For example, if
'GLX_STEREO' is not specified, then it is assumed to be 'False'.
For some attributes, the default is 'GLX_DONT_CARE', meaning that
any value is OK for this attribute, so the attribute will not be
checked.
Attributes are matched in an attribute-specific manner. Some of
the attributes, such as 'GLX_LEVEL', must match the specified value
exactly; others, such as, 'GLX_RED_SIZE' must meet or exceed the
specified minimum values. If more than one GLX frame buffer
configuration is found, then a list of configurations, sorted
according to the "best" match criteria, is returned. The match
criteria for each attribute and the exact sorting order is defined
below.
The interpretations of the various GLX visual attributes are as
follows:
'GLX_FBCONFIG_ID'
Must be followed by a valid XID that indicates the desired GLX
frame buffer configuration. When a 'GLX_FBCONFIG_ID' is
specified, all attributes are ignored. The default value is
'GLX_DONT_CARE'.
'GLX_BUFFER_SIZE'
Must be followed by a nonnegative integer that indicates the
desired color index buffer size. The smallest index buffer of
at least the specified size is preferred. This attribute is
ignored if 'GLX_COLOR_INDEX_BIT' is not set in
'GLX_RENDER_TYPE'. The default value is 0.
'GLX_LEVEL'
Must be followed by an integer buffer-level specification.
This specification is honored exactly. Buffer level 0
corresponds to the default frame buffer of the display.
Buffer level 1 is the first overlay frame buffer, level two
the second overlay frame buffer, and so on. Negative buffer
levels correspond to underlay frame buffers. The default
value is 0.
'GLX_DOUBLEBUFFER'
Must be followed by 'True' or 'False'. If 'True' is
specified, then only double-buffered frame buffer
configurations are considered; if 'False' is specified, then
only single-buffered frame buffer configurations are
considered. The default value is 'GLX_DONT_CARE'.
'GLX_STEREO'
Must be followed by 'True' or 'False'. If 'True' is
specified, then only stereo frame buffer configurations are
considered; if 'False' is specified, then only monoscopic
frame buffer configurations are considered. The default value
is 'False'.
'GLX_AUX_BUFFERS'
Must be followed by a nonnegative integer that indicates the
desired number of auxiliary buffers. Configurations with the
smallest number of auxiliary buffers that meet or exceed the
specified number are preferred. The default value is 0.
'GLX_RED_SIZE', 'GLX_GREEN_SIZE', 'GLX_BLUE_SIZE', 'GLX_ALPHA_SIZE'
Each attribute, if present, must be followed by a nonnegative
minimum size specification or 'GLX_DONT_CARE'. The largest
available total RGBA color buffer size (sum of 'GLX_RED_SIZE',
'GLX_GREEN_SIZE', 'GLX_BLUE_SIZE', and 'GLX_ALPHA_SIZE') of at
least the minimum size specified for each color component is
preferred. If the requested number of bits for a color
component is 0 or 'GLX_DONT_CARE', it is not considered. The
default value for each color component is 0.
'GLX_DEPTH_SIZE'
Must be followed by a nonnegative minimum size specification.
If this value is zero, frame buffer configurations with no
depth buffer are preferred. Otherwise, the largest available
depth buffer of at least the minimum size is preferred. The
default value is 0.
'GLX_STENCIL_SIZE'
Must be followed by a nonnegative integer that indicates the
desired number of stencil bitplanes. The smallest stencil
buffer of at least the specified size is preferred. If the
desired value is zero, frame buffer configurations with no
stencil buffer are preferred. The default value is 0.
'GLX_ACCUM_RED_SIZE'
Must be followed by a nonnegative minimum size specification.
If this value is zero, frame buffer configurations with no red
accumulation buffer are preferred. Otherwise, the largest
possible red accumulation buffer of at least the minimum size
is preferred. The default value is 0.
'GLX_ACCUM_GREEN_SIZE'
Must be followed by a nonnegative minimum size specification.
If this value is zero, frame buffer configurations with no
green accumulation buffer are preferred. Otherwise, the
largest possible green accumulation buffer of at least the
minimum size is preferred. The default value is 0.
'GLX_ACCUM_BLUE_SIZE'
Must be followed by a nonnegative minimum size specification.
If this value is zero, frame buffer configurations with no
blue accumulation buffer are preferred. Otherwise, the
largest possible blue accumulation buffer of at least the
minimum size is preferred. The default value is 0.
'GLX_ACCUM_ALPHA_SIZE'
Must be followed by a nonnegative minimum size specification.
If this value is zero, frame buffer configurations with no
alpha accumulation buffer are preferred. Otherwise, the
largest possible alpha accumulation buffer of at least the
minimum size is preferred. The default value is 0.
'GLX_RENDER_TYPE'
Must be followed by a mask indicating which OpenGL rendering
modes the frame buffer configuration must support. Valid bits
are 'GLX_RGBA_BIT' and 'GLX_COLOR_INDEX_BIT'. If the mask is
set to 'GLX_RGBA_BIT' | 'GLX_COLOR_INDEX_BIT', then only frame
buffer configurations that can be bound to both RGBA contexts
and color index contexts will be considered. The default
value is 'GLX_RGBA_BIT'.
'GLX_DRAWABLE_TYPE'
Must be followed by a mask indicating which GLX drawable types
the frame buffer configuration must support. Valid bits are
'GLX_WINDOW_BIT', 'GLX_PIXMAP_BIT', and 'GLX_PBUFFER_BIT'.
For example, if mask is set to 'GLX_WINDOW_BIT' |
'GLX_PIXMAP_BIT', only frame buffer configurations that
support both windows and GLX pixmaps will be considered. The
default value is 'GLX_WINDOW_BIT'.
'GLX_X_RENDERABLE'
Must be followed by 'True' or 'False'. If 'True' is
specified, then only frame buffer configurations that have
associated X visuals (and can be used to render to Windows
and/or GLX pixmaps) will be considered. The default value is
'GLX_DONT_CARE'.
'GLX_X_VISUAL_TYPE'
Must be followed by one of 'GLX_TRUE_COLOR',
'GLX_DIRECT_COLOR', 'GLX_PSEUDO_COLOR', 'GLX_STATIC_COLOR',
'GLX_GRAY_SCALE', or 'GLX_STATIC_GRAY', indicating the desired
X visual type. Not all frame buffer configurations have an
associated X visual. If 'GLX_DRAWABLE_TYPE' is specified in
ATTRIB_LIST and the mask that follows does not have
'GLX_WINDOW_BIT' set, then this value is ignored. It is also
ignored if 'GLX_X_RENDERABLE' is specified as 'False'. RGBA
rendering may be supported for visuals of type
'GLX_TRUE_COLOR', 'GLX_DIRECT_COLOR', 'GLX_PSEUDO_COLOR', or
'GLX_STATIC_COLOR', but color index rendering is only
supported for visuals of type 'GLX_PSEUDO_COLOR' or
'GLX_STATIC_COLOR' (i.e., single-channel visuals). The tokens
'GLX_GRAY_SCALE' and 'GLX_STATIC_GRAY' will not match current
OpenGL enabled visuals, but are included for future use. The
default value for 'GLX_X_VISUAL_TYPE' is 'GLX_DONT_CARE'.
'GLX_CONFIG_CAVEAT'
Must be followed by one of 'GLX_NONE', 'GLX_SLOW_CONFIG',
'GLX_NON_CONFORMANT_CONFIG'. If 'GLX_NONE' is specified, then
only frame buffer configurations with no caveats will be
considered; if 'GLX_SLOW_CONFIG' is specified, then only slow
frame buffer configurations will be considered; if
'GLX_NON_CONFORMANT_CONFIG' is specified, then only
nonconformant frame buffer configurations will be considered.
The default value is 'GLX_DONT_CARE'.
'GLX_TRANSPARENT_TYPE'
Must be followed by one of 'GLX_NONE', 'GLX_TRANSPARENT_RGB',
'GLX_TRANSPARENT_INDEX'. If 'GLX_NONE' is specified, then
only opaque frame buffer configurations will be considered; if
'GLX_TRANSPARENT_RGB' is specified, then only transparent
frame buffer configurations that support RGBA rendering will
be considered; if 'GLX_TRANSPARENT_INDEX' is specified, then
only transparent frame buffer configurations that support
color index rendering will be considered. The default value
is 'GLX_NONE'.
'GLX_TRANSPARENT_INDEX_VALUE'
Must be followed by an integer value indicating the
transparent index value; the value must be between 0 and the
maximum frame buffer value for indices. Only frame buffer
configurations that use the specified transparent index value
will be considered. The default value is 'GLX_DONT_CARE'.
This attribute is ignored unless 'GLX_TRANSPARENT_TYPE' is
included in ATTRIB_LIST and specified as
'GLX_TRANSPARENT_INDEX'.
'GLX_TRANSPARENT_RED_VALUE'
Must be followed by an integer value indicating the
transparent red value; the value must be between 0 and the
maximum frame buffer value for red. Only frame buffer
configurations that use the specified transparent red value
will be considered. The default value is 'GLX_DONT_CARE'.
This attribute is ignored unless 'GLX_TRANSPARENT_TYPE' is
included in ATTRIB_LIST and specified as
'GLX_TRANSPARENT_RGB'.
'GLX_TRANSPARENT_GREEN_VALUE'
Must be followed by an integer value indicating the
transparent green value; the value must be between 0 and the
maximum frame buffer value for green. Only frame buffer
configurations that use the specified transparent green value
will be considered. The default value is 'GLX_DONT_CARE'.
This attribute is ignored unless 'GLX_TRANSPARENT_TYPE' is
included in ATTRIB_LIST and specified as
'GLX_TRANSPARENT_RGB'.
'GLX_TRANSPARENT_BLUE_VALUE'
Must be followed by an integer value indicating the
transparent blue value; the value must be between 0 and the
maximum frame buffer value for blue. Only frame buffer
configurations that use the specified transparent blue value
will be considered. The default value is 'GLX_DONT_CARE'.
This attribute is ignored unless 'GLX_TRANSPARENT_TYPE' is
included in ATTRIB_LIST and specified as
'GLX_TRANSPARENT_RGB'.
'GLX_TRANSPARENT_ALPHA_VALUE'
Must be followed by an integer value indicating the
transparent alpha value; the value must be between 0 and the
maximum frame buffer value for alpha. Only frame buffer
configurations that use the specified transparent alpha value
will be considered. The default value is 'GLX_DONT_CARE'.
When more than one GLX frame buffer configuration matches the
specified attributes, a list of matching configurations is
returned. The list is sorted according to the following precedence
rules, which are applied in ascending order (i.e., configurations
that are considered equal by a lower numbered rule are sorted by
the higher numbered rule):
1.
By 'GLX_CONFIG_CAVEAT' where the precedence is 'GLX_NONE',
'GLX_SLOW_CONFIG', and 'GLX_NON_CONFORMANT_CONFIG'.
2.
Larger total number of RGBA color components ('GLX_RED_SIZE',
'GLX_GREEN_SIZE', 'GLX_BLUE_SIZE', plus 'GLX_ALPHA_SIZE') that
have higher number of bits. If the requested number of bits
in ATTRIB_LIST is zero or 'GLX_DONT_CARE' for a particular
color component, then the number of bits for that component is
not considered.
3.
Smaller 'GLX_BUFFER_SIZE'.
4.
Single buffered configuration ('GLX_DOUBLEBUFFER' being
'False' precedes a double buffered one.
5.
Smaller 'GLX_AUX_BUFFERS'.
6.
Larger 'GLX_DEPTH_SIZE'.
7.
Smaller 'GLX_STENCIL_SIZE'.
8.
Larger total number of accumulation buffer color components
('GLX_ACCUM_RED_SIZE', 'GLX_ACCUM_GREEN_SIZE',
'GLX_ACCUM_BLUE_SIZE', plus 'GLX_ACCUM_ALPHA_SIZE') that have
higher number of bits. If the requested number of bits in
ATTRIB_LIST is zero or 'GLX_DONT_CARE' for a particular color
component, then the number of bits for that component is not
considered.
9.
By 'GLX_X_VISUAL_TYPE' where the precedence order is
'GLX_TRUE_COLOR', 'GLX_DIRECT_COLOR', 'GLX_PSEUDO_COLOR',
'GLX_STATIC_COLOR', 'GLX_GRAY_SCALE', 'GLX_STATIC_GRAY'.
'NULL' is returned if an undefined GLX attribute is encountered in
ATTRIB_LIST, if SCREEN is invalid, or if DPY does not support the
GLX extension.
-- Function: XVisualInfo* glXChooseVisual dpy screen attribList
Return a visual that matches specified attributes.
DPY
Specifies the connection to the X server.
SCREEN
Specifies the screen number.
ATTRIBLIST
Specifies a list of boolean attributes and integer
attribute/value pairs. The last attribute must be 'None'.
'glXChooseVisual' returns a pointer to an XVisualInfo structure
describing the visual that best meets a minimum specification. The
boolean GLX attributes of the visual that is returned will match
the specified values, and the integer GLX attributes will meet or
exceed the specified minimum values. If all other attributes are
equivalent, then TrueColor and PseudoColor visuals have priority
over DirectColor and StaticColor visuals, respectively. If no
conforming visual exists, 'NULL' is returned. To free the data
returned by this function, use 'XFree'.
All boolean GLX attributes default to 'False' except 'GLX_USE_GL',
which defaults to 'True'. All integer GLX attributes default to
zero. Default specifications are superseded by attributes included
in ATTRIBLIST. Boolean attributes included in ATTRIBLIST are
understood to be 'True'. Integer attributes and enumerated type
attributes are followed immediately by the corresponding desired or
minimum value. The list must be terminated with 'None'.
The interpretations of the various GLX visual attributes are as
follows:
'GLX_USE_GL'
Ignored. Only visuals that can be rendered with GLX are
considered.
'GLX_BUFFER_SIZE'
Must be followed by a nonnegative integer that indicates the
desired color index buffer size. The smallest index buffer of
at least the specified size is preferred. Ignored if
'GLX_RGBA' is asserted.
'GLX_LEVEL'
Must be followed by an integer buffer-level specification.
This specification is honored exactly. Buffer level zero
corresponds to the main frame buffer of the display. Buffer
level one is the first overlay frame buffer, level two the
second overlay frame buffer, and so on. Negative buffer
levels correspond to underlay frame buffers.
'GLX_RGBA'
If present, only TrueColor and DirectColor visuals are
considered. Otherwise, only PseudoColor and StaticColor
visuals are considered.
'GLX_DOUBLEBUFFER'
If present, only double-buffered visuals are considered.
Otherwise, only single-buffered visuals are considered.
'GLX_STEREO'
If present, only stereo visuals are considered. Otherwise,
only monoscopic visuals are considered.
'GLX_AUX_BUFFERS'
Must be followed by a nonnegative integer that indicates the
desired number of auxiliary buffers. Visuals with the
smallest number of auxiliary buffers that meets or exceeds the
specified number are preferred.
'GLX_RED_SIZE'
Must be followed by a nonnegative minimum size specification.
If this value is zero, the smallest available red buffer is
preferred. Otherwise, the largest available red buffer of at
least the minimum size is preferred.
'GLX_GREEN_SIZE'
Must be followed by a nonnegative minimum size specification.
If this value is zero, the smallest available green buffer is
preferred. Otherwise, the largest available green buffer of
at least the minimum size is preferred.
'GLX_BLUE_SIZE'
Must be followed by a nonnegative minimum size specification.
If this value is zero, the smallest available blue buffer is
preferred. Otherwise, the largest available blue buffer of at
least the minimum size is preferred.
'GLX_ALPHA_SIZE'
Must be followed by a nonnegative minimum size specification.
If this value is zero, the smallest available alpha buffer is
preferred. Otherwise, the largest available alpha buffer of
at least the minimum size is preferred.
'GLX_DEPTH_SIZE'
Must be followed by a nonnegative minimum size specification.
If this value is zero, visuals with no depth buffer are
preferred. Otherwise, the largest available depth buffer of
at least the minimum size is preferred.
'GLX_STENCIL_SIZE'
Must be followed by a nonnegative integer that indicates the
desired number of stencil bitplanes. The smallest stencil
buffer of at least the specified size is preferred. If the
desired value is zero, visuals with no stencil buffer are
preferred.
'GLX_ACCUM_RED_SIZE'
Must be followed by a nonnegative minimum size specification.
If this value is zero, visuals with no red accumulation buffer
are preferred. Otherwise, the largest possible red
accumulation buffer of at least the minimum size is preferred.
'GLX_ACCUM_GREEN_SIZE'
Must be followed by a nonnegative minimum size specification.
If this value is zero, visuals with no green accumulation
buffer are preferred. Otherwise, the largest possible green
accumulation buffer of at least the minimum size is preferred.
'GLX_ACCUM_BLUE_SIZE'
Must be followed by a nonnegative minimum size specification.
If this value is zero, visuals with no blue accumulation
buffer are preferred. Otherwise, the largest possible blue
accumulation buffer of at least the minimum size is preferred.
'GLX_ACCUM_ALPHA_SIZE'
Must be followed by a nonnegative minimum size specification.
If this value is zero, visuals with no alpha accumulation
buffer are preferred. Otherwise, the largest possible alpha
accumulation buffer of at least the minimum size is preferred.
'NULL' is returned if an undefined GLX attribute is encountered in
ATTRIBLIST.
-- Function: void glXCopyContext dpy src dst mask
Copy state from one rendering context to another.
DPY
Specifies the connection to the X server.
SRC
Specifies the source context.
DST
Specifies the destination context.
MASK
Specifies which portions of SRC state are to be copied to DST.
'glXCopyContext' copies selected groups of state variables from SRC
to DST. MASK indicates which groups of state variables are to be
copied. MASK contains the bitwise OR of the same symbolic names
that are passed to the GL command 'glPushAttrib'. The single
symbolic constant 'GLX_ALL_ATTRIB_BITS' can be used to copy the
maximum possible portion of rendering state.
The copy can be done only if the renderers named by SRC and DST
share an address space. Two rendering contexts share an address
space if both are nondirect using the same server, or if both are
direct and owned by a single process. Note that in the nondirect
case it is not necessary for the calling threads to share an
address space, only for their related rendering contexts to share
an address space.
Not all values for GL state can be copied. For example, pixel pack
and unpack state, render mode state, and select and feedback state
are not copied. The state that can be copied is exactly the state
that is manipulated by the GL command 'glPushAttrib'.
An implicit 'glFlush' is done by 'glXCopyContext' if SRC is the
current context for the calling thread.
'BadMatch' is generated if rendering contexts SRC and DST do not
share an address space or were not created with respect to the same
screen.
'BadAccess' is generated if DST is current to any thread (including
the calling thread) at the time 'glXCopyContext' is called.
'GLXBadCurrentWindow' is generated if SRC is the current context
and the current drawable is a window that is no longer valid.
'GLXBadContext' is generated if either SRC or DST is not a valid
GLX context.
-- Function: GLXContext glXCreateContext dpy vis shareList direct
Create a new GLX rendering context.
DPY
Specifies the connection to the X server.
VIS
Specifies the visual that defines the frame buffer resources
available to the rendering context. It is a pointer to an
'XVisualInfo' structure, not a visual ID or a pointer to a
'Visual'.
SHARELIST
Specifies the context with which to share display lists.
'NULL' indicates that no sharing is to take place.
DIRECT
Specifies whether rendering is to be done with a direct
connection to the graphics system if possible ('True') or
through the X server ('False').
'glXCreateContext' creates a GLX rendering context and returns its
handle. This context can be used to render into both windows and
GLX pixmaps. If 'glXCreateContext' fails to create a rendering
context, 'NULL' is returned.
If DIRECT is 'True', then a direct rendering context is created if
the implementation supports direct rendering, if the connection is
to an X server that is local, and if a direct rendering context is
available. (An implementation may return an indirect context when
DIRECT is 'True'.) If DIRECT is 'False', then a rendering context
that renders through the X server is always created. Direct
rendering provides a performance advantage in some implementations.
However, direct rendering contexts cannot be shared outside a
single process, and they may be unable to render to GLX pixmaps.
If SHARELIST is not 'NULL', then all display-list indexes and
definitions are shared by context SHARELIST and by the newly
created context. An arbitrary number of contexts can share a
single display-list space. However, all rendering contexts that
share a single display-list space must themselves exist in the same
address space. Two rendering contexts share an address space if
both are nondirect using the same server, or if both are direct and
owned by a single process. Note that in the nondirect case, it is
not necessary for the calling threads to share an address space,
only for their related rendering contexts to share an address
space.
If the GL version is 1.1 or greater, then all texture objects
except object 0 are shared by any contexts that share display
lists.
'NULL' is returned if execution fails on the client side.
'BadMatch' is generated if the context to be created would not
share the address space or the screen of the context specified by
SHARELIST.
'BadValue' is generated if VIS is not a valid visual (for example,
if a particular GLX implementation does not support it).
'GLXBadContext' is generated if SHARELIST is not a GLX context and
is not 'NULL'.
'BadAlloc' is generated if the server does not have enough
resources to allocate the new context.
-- Function: GLXPixmap glXCreateGLXPixmap dpy vis pixmap
Create an off-screen GLX rendering area.
DPY
Specifies the connection to the X server.
VIS
Specifies the visual that defines the structure of the
rendering area. It is a pointer to an 'XVisualInfo'
structure, not a visual ID or a pointer to a 'Visual'.
PIXMAP
Specifies the X pixmap that will be used as the front left
color buffer of the off-screen rendering area.
'glXCreateGLXPixmap' creates an off-screen rendering area and
returns its XID. Any GLX rendering context that was created with
respect to VIS can be used to render into this off-screen area.
Use 'glXMakeCurrent' to associate the rendering area with a GLX
rendering context.
The X pixmap identified by PIXMAP is used as the front left buffer
of the resulting off-screen rendering area. All other buffers
specified by VIS, including color buffers other than the front left
buffer, are created without externally visible names. GLX pixmaps
with double-buffering are supported. However, 'glXSwapBuffers' is
ignored by these pixmaps.
Some implementations may not support GLX pixmaps with direct
rendering contexts.
'BadMatch' is generated if the depth of PIXMAP does not match the
depth value reported by core X11 for VIS, or if PIXMAP was not
created with respect to the same screen as VIS.
'BadValue' is generated if VIS is not a valid XVisualInfo pointer
(for example, if a particular GLX implementation does not support
this visual).
'BadPixmap' is generated if PIXMAP is not a valid pixmap.
'BadAlloc' is generated if the server cannot allocate the GLX
pixmap.
-- Function: GLXContext glXCreateNewContext dpy config render_type
share_list direct
Create a new GLX rendering context.
DPY
Specifies the connection to the X server.
CONFIG
Specifies the GLXFBConfig structure with the desired
attributes for the context.
RENDER_TYPE
Specifies the type of the context to be created. Must be one
of 'GLX_RGBA_TYPE' or 'GLX_COLOR_INDEX_TYPE'.
SHARE_LIST
Specifies the context with which to share display lists.
'NULL' indicates that no sharing is to take place.
SHARE_LIST
Specifies whether rendering is to be done with a direct
connection to the graphics system if possible ('True') or
through the X server ('False').
'glXCreateNewContext' creates a GLX rendering context and returns
its handle. This context can be used to render into GLX windows,
pixmaps, or pixel buffers. If 'glXCreateNewContext' fails to
create a rendering context, 'NULL' is returned.
If RENDER_TYPE is 'GLX_RGBA_TYPE', then a context that supports
RGBA rendering is created. If CONFIG is 'GLX_COLOR_INDEX_TYPE',
then context supporting color-index rendering is created.
If RENDER_TYPE is not 'NULL', then all display-list indexes and
definitions are shared by context RENDER_TYPE and by the newly
created context. An arbitrary number of contexts can share a
single display-list space. However, all rendering contexts that
share a single display-list space must themselves exist in the same
address space. Two rendering contexts share an address space if
both are nondirect using the same server, or if both are direct and
owned by a single process. Note that in the nondirect case, it is
not necessary for the calling threads to share an address space,
only for their related rendering contexts to share an address
space.
If SHARE_LIST is 'True', then a direct-rendering context is created
if the implementation supports direct rendering, if the connection
is to an X server that is local, and if a direct-rendering context
is available. (An implementation may return an indirect context
when SHARE_LIST is 'True'.) If SHARE_LIST is 'False', then a
rendering context that renders through the X server is always
created. Direct rendering provides a performance advantage in some
implementations. However, direct-rendering contexts cannot be
shared outside a single process, and they may be unable to render
to GLX pixmaps.
'NULL' is returned if execution fails on the client side.
'GLXBadContext' is generated if RENDER_TYPE is not a GLX context
and is not 'NULL'.
'GLXBadFBConfig' is generated if CONFIG is not a valid GLXFBConfig.
'BadMatch' is generated if the context to be created would not
share the address space or the screen of the context specified by
RENDER_TYPE.
'BadAlloc' is generated if the server does not have enough
resources to allocate the new context.
'BadValue' is generated if CONFIG is not a valid visual (for
example, if a particular GLX implementation does not support it).
-- Function: GLXPbuffer glXCreatePbuffer dpy config attrib_list
Create an off-screen rendering area.
DPY
Specifies the connection to the X server.
CONFIG
Specifies a GLXFBConfig structure with the desired attributes
for the window.
ATTRIB_LIST
Specifies a list of attribute value pairs, which must be
terminated with 'None' or 'NULL'. Accepted attributes are
'GLX_PBUFFER_WIDTH', 'GLX_PBUFFER_HEIGHT',
'GLX_PRESERVED_CONTENTS', and 'GLX_LARGEST_PBUFFER'.
'glXCreatePbuffer' creates an off-screen rendering area and returns
its XID. Any GLX rendering context that was created with respect to
CONFIG can be used to render into this window. Use
'glXMakeContextCurrent' to associate the rendering area with a GLX
rendering context.
The accepted attributes for a GLXPbuffer are:
'GLX_PBUFFER_WIDTH'
Specify the pixel width of the requested GLXPbuffer. The
default value is 0.
'GLX_PBUFFER_HEIGHT'
Specify the pixel height of the requested GLXPbuffer. The
default value is 0.
'GLX_LARGEST_PBUFFER'
Specify to obtain the largest available pixel buffer, if the
requested allocation would have failed. The width and height
of the allocated pixel buffer will never exceed the specified
'GLX_PBUFFER_WIDTH' or 'GLX_PBUFFER_HEIGHT', respectively.
Use 'glXQueryDrawable' to retrieve the dimensions of the
allocated pixel buffer. The default value is 'False'.
'GLX_PRESERVED_CONTENTS'
Specify if the contents of the pixel buffer should be
preserved when a resource conflict occurs. If set to 'False',
the contents of the pixel buffer may be lost at any time. If
set to 'True', or not specified in ATTRIB_LIST, then the
contents of the pixel buffer will be preserved (most likely by
copying the contents into main system memory from the frame
buffer). In either case, the client can register (using
'glXSelectEvent', to receive pixel buffer clobber events that
are generated when the pbuffer contents have been preserved or
damaged.
GLXPbuffers contain the color and ancillary buffers specified by
CONFIG. It is possible to create a pixel buffer with back buffers
and to swap those buffers using 'glXSwapBuffers'.
'BadAlloc' is generated if there are insufficient resources to
allocate the requested GLXPbuffer.
'GLXBadFBConfig' is generated if CONFIG is not a valid GLXFBConfig.
'BadMatch' is generated if CONFIG does not support rendering to
pixel buffers (e.g., 'GLX_DRAWABLE_TYPE' does not contain
'GLX_PBUFFER_BIT').
-- Function: GLXPixmap glXCreatePixmap dpy config pixmap attrib_list
Create an off-screen rendering area.
DPY
Specifies the connection to the X server.
CONFIG
Specifies a GLXFBConfig structure with the desired attributes
for the window.
PIXMAP
Specifies the X pixmap to be used as the rendering area.
ATTRIB_LIST
Currently unused. This must be set to 'NULL' or be an empty
list (i.e., one in which the first element is 'None').
'glXCreatePixmap' creates an off-screen rendering area and returns
its XID. Any GLX rendering context that was created with respect to
CONFIG can be used to render into this window. Use
'glXMakeCurrent' to associate the rendering area with a GLX
rendering context.
'BadMatch' is generated if PIXMAP was not created with a visual
that corresponds to CONFIG.
'BadMatch' is generated if CONFIG does not support rendering to
windows (e.g., 'GLX_DRAWABLE_TYPE' does not contain
'GLX_WINDOW_BIT').
'BadWindow' is generated if PIXMAP is not a valid window XID.
'BadAlloc' is generated if there is already a GLXFBConfig
associated with PIXMAP.
'BadAlloc' is generated if the X server cannot allocate a new GLX
window.
'GLXBadFBConfig' is generated if CONFIG is not a valid GLXFBConfig.
-- Function: GLXWindow glXCreateWindow dpy config win attrib_list
Create an on-screen rendering area.
DPY
Specifies the connection to the X server.
CONFIG
Specifies a GLXFBConfig structure with the desired attributes
for the window.
WIN
Specifies the X window to be used as the rendering area.
ATTRIB_LIST
Currently unused. This must be set to 'NULL' or be an empty
list (i.e., one in which the first element is 'None').
'glXCreateWindow' creates an on-screen rendering area from an
existing X window that was created with a visual matching CONFIG.
The XID of the GLXWindow is returned. Any GLX rendering context
that was created with respect to CONFIG can be used to render into
this window. Use 'glXMakeContextCurrent' to associate the
rendering area with a GLX rendering context.
'BadMatch' is generated if WIN was not created with a visual that
corresponds to CONFIG.
'BadMatch' is generated if CONFIG does not support rendering to
windows (i.e., 'GLX_DRAWABLE_TYPE' does not contain
'GLX_WINDOW_BIT').
'BadWindow' is generated if WIN is not a valid pixmap XID.
'BadAlloc' is generated if there is already a GLXFBConfig
associated with WIN.
'BadAlloc' is generated if the X server cannot allocate a new GLX
window.
'GLXBadFBConfig' is generated if CONFIG is not a valid GLXFBConfig.
-- Function: void glXDestroyContext dpy ctx
Destroy a GLX context.
DPY
Specifies the connection to the X server.
CTX
Specifies the GLX context to be destroyed.
If the GLX rendering context CTX is not current to any thread,
'glXDestroyContext' destroys it immediately. Otherwise, CTX is
destroyed when it becomes not current to any thread. In either
case, the resource ID referenced by CTX is freed immediately.
'GLXBadContext' is generated if CTX is not a valid GLX context.
-- Function: void glXDestroyGLXPixmap dpy pix
Destroy a GLX pixmap.
DPY
Specifies the connection to the X server.
PIX
Specifies the GLX pixmap to be destroyed.
If the GLX pixmap PIX is not current to any client,
'glXDestroyGLXPixmap' destroys it immediately. Otherwise, PIX is
destroyed when it becomes not current to any client. In either
case, the resource ID is freed immediately.
'GLXBadPixmap' is generated if PIX is not a valid GLX pixmap.
-- Function: void glXDestroyPbuffer dpy pbuf
Destroy an off-screen rendering area.
DPY
Specifies the connection to the X server.
PBUF
Specifies the GLXPbuffer to be destroyed.
'glXDestroyPbuffer' destroys a GLXPbuffer created by
'glXCreatePbuffer'.
'GLXBadPbuffer' is generated if PBUF is not a valid GLXPbuffer.
-- Function: void glXDestroyPixmap dpy pixmap
Destroy an off-screen rendering area.
DPY
Specifies the connection to the X server.
PIXMAP
Specifies the GLXPixmap to be destroyed.
'glXDestroyPixmap' destroys a GLXPixmap created by
'glXCreatePixmap'.
'GLXBadPixmap' is generated if PIXMAP is not a valid GLXPixmap.
-- Function: void glXDestroyWindow dpy win
Destroy an on-screen rendering area.
DPY
Specifies the connection to the X server.
WIN
Specifies the GLXWindow to be destroyed.
'glXDestroyWindow' destroys a GLXWindow created by
'glXCreateWindow'.
'GLXBadWindow' is generated if WIN is not a valid GLXPixmap.
-- Function: void glXFreeContextEXT dpy ctx
Free client-side memory for imported context.
DPY
Specifies the connection to the X server.
CTX
Specifies a GLX rendering context.
'glXFreeContextEXT' frees the client-side part of a GLXContext that
was created with 'glXImportContextEXT'. 'glXFreeContextEXT' does
not free the server-side context information or the XID associated
with the server-side context.
'glXFreeContextEXT' is part of the 'EXT_import_context' extension,
not part of the core GLX command set. If
_glxextstring(EXT_import_context) is included in the string
returned by 'glXQueryExtensionsString', when called with argument
'GLX_EXTENSIONS', extension 'EXT_vertex_array' is supported.
'GLXBadContext' is generated if CTX does not refer to a valid
context.
-- Function: const-char-* glXGetClientString dpy name
Return a string describing the client.
DPY
Specifies the connection to the X server.
NAME
Specifies which string is returned. The symbolic constants
'GLX_VENDOR', 'GLX_VERSION', and 'GLX_EXTENSIONS' are
accepted.
'glXGetClientString' returns a string describing some aspect of the
client library. The possible values for NAME are 'GLX_VENDOR',
'GLX_VERSION', and 'GLX_EXTENSIONS'. If NAME is not set to one of
these values, 'glXGetClientString' returns 'NULL'. The format and
contents of the vendor string is implementation dependent.
The extensions string is null-terminated and contains a
space-separated list of extension names. (The extension names
never contain spaces.) If there are no extensions to GLX, then the
empty string is returned.
The version string is laid out as follows:
Both the major and minor portions of the version number are of
arbitrary length. The vendor-specific information is optional.
However, if it is present, the format and contents are
implementation specific.
-- Function: int glXGetConfig dpy vis attrib value
Return information about GLX visuals.
DPY
Specifies the connection to the X server.
VIS
Specifies the visual to be queried. It is a pointer to an
'XVisualInfo' structure, not a visual ID or a pointer to a
'Visual'.
ATTRIB
Specifies the visual attribute to be returned.
VALUE
Returns the requested value.
'glXGetConfig' sets VALUE to the ATTRIB value of windows or GLX
pixmaps created with respect to VIS. 'glXGetConfig' returns an
error code if it fails for any reason. Otherwise, zero is
returned.
ATTRIB is one of the following:
'GLX_USE_GL'
'True' if OpenGL rendering is supported by this visual,
'False' otherwise.
'GLX_BUFFER_SIZE'
Number of bits per color buffer. For RGBA visuals,
'GLX_BUFFER_SIZE' is the sum of 'GLX_RED_SIZE',
'GLX_GREEN_SIZE', 'GLX_BLUE_SIZE', and 'GLX_ALPHA_SIZE'. For
color index visuals, 'GLX_BUFFER_SIZE' is the size of the
color indexes.
'GLX_LEVEL'
Frame buffer level of the visual. Level zero is the default
frame buffer. Positive levels correspond to frame buffers
that overlay the default buffer, and negative levels
correspond to frame buffers that underlay the default buffer.
'GLX_RGBA'
'True' if color buffers store red, green, blue, and alpha
values. 'False' if they store color indexes.
'GLX_DOUBLEBUFFER'
'True' if color buffers exist in front/back pairs that can be
swapped, 'False' otherwise.
'GLX_STEREO'
'True' if color buffers exist in left/right pairs, 'False'
otherwise.
'GLX_AUX_BUFFERS'
Number of auxiliary color buffers that are available. Zero
indicates that no auxiliary color buffers exist.
'GLX_RED_SIZE'
Number of bits of red stored in each color buffer. Undefined
if 'GLX_RGBA' is 'False'.
'GLX_GREEN_SIZE'
Number of bits of green stored in each color buffer.
Undefined if 'GLX_RGBA' is 'False'.
'GLX_BLUE_SIZE'
Number of bits of blue stored in each color buffer. Undefined
if 'GLX_RGBA' is 'False'.
'GLX_ALPHA_SIZE'
Number of bits of alpha stored in each color buffer.
Undefined if 'GLX_RGBA' is 'False'.
'GLX_DEPTH_SIZE'
Number of bits in the depth buffer.
'GLX_STENCIL_SIZE'
Number of bits in the stencil buffer.
'GLX_ACCUM_RED_SIZE'
Number of bits of red stored in the accumulation buffer.
'GLX_ACCUM_GREEN_SIZE'
Number of bits of green stored in the accumulation buffer.
'GLX_ACCUM_BLUE_SIZE'
Number of bits of blue stored in the accumulation buffer.
'GLX_ACCUM_ALPHA_SIZE'
Number of bits of alpha stored in the accumulation buffer.
The X protocol allows a single visual ID to be instantiated with
different numbers of bits per pixel. Windows or GLX pixmaps that
will be rendered with OpenGL, however, must be instantiated with a
color buffer depth of 'GLX_BUFFER_SIZE'.
Although a GLX implementation can export many visuals that support
GL rendering, it must support at least one RGBA visual. This
visual must have at least one color buffer, a stencil buffer of at
least 1 bit, a depth buffer of at least 12 bits, and an
accumulation buffer. Alpha bitplanes are optional in this visual.
However, its color buffer size must be as great as that of the
deepest 'TrueColor', 'DirectColor', 'PseudoColor', or 'StaticColor'
visual supported on level zero, and it must itself be made
available on level zero.
In addition, if the X server exports a 'PseudoColor' or
'StaticColor' visual on framebuffer level 0, a color index visual
is also required on that level. It must have at least one color
buffer, a stencil buffer of at least 1 bit, and a depth buffer of
at least 12 bits. This visual must have as many color bitplanes as
the deepest 'PseudoColor' or 'StaticColor' visual supported on
level 0.
Applications are best written to select the visual that most
closely meets their requirements. Creating windows or GLX pixmaps
with unnecessary buffers can result in reduced rendering
performance as well as poor resource allocation.
'GLX_NO_EXTENSION' is returned if DPY does not support the GLX
extension.
'GLX_BAD_SCREEN' is returned if the screen of VIS does not
correspond to a screen.
'GLX_BAD_ATTRIBUTE' is returned if ATTRIB is not a valid GLX
attribute.
'GLX_BAD_VISUAL' is returned if VIS doesn't support GLX and an
attribute other than 'GLX_USE_GL' is requested.
-- Function: GLXContextID glXGetContextIDEXT ctx
Get the XID for a context..
CTX
Specifies a GLX rendering context.
'glXGetContextIDEXT' returns the XID associated with a GLXContext.
No round trip is forced to the server; unlike most X calls that
return a value, 'glXGetContextIDEXT' does not flush any pending
events.
'glXGetContextIDEXT' is part of the 'EXT_import_context' extension,
not part of the core GLX command set. If
_glxextstring(EXT_import_context) is included in the string
returned by 'glXQueryExtensionsString', when called with argument
'GLX_EXTENSIONS', extension 'EXT_import_context' is supported.
'GLXBadContext' is generated if CTX does not refer to a valid
context.
-- Function: GLXContext glXGetCurrentContext
Return the current context.
'glXGetCurrentContext' returns the current context, as specified by
'glXMakeCurrent'. If there is no current context, 'NULL' is
returned.
'glXGetCurrentContext' returns client-side information. It does
not make a round trip to the server.
-- Function: Display-* glXGetCurrentDisplay
Get display for current context.
'glXGetCurrentDisplay' returns the display for the current context.
If no context is current, 'NULL' is returned.
'glXGetCurrentDisplay' returns client-side information. It does
not make a round-trip to the server, and therefore does not flush
any pending events.
-- Function: GLXDrawable glXGetCurrentDrawable
Return the current drawable.
'glXGetCurrentDrawable' returns the current drawable, as specified
by 'glXMakeCurrent'. If there is no current drawable, 'None' is
returned.
'glXGetCurrentDrawable' returns client-side information. It does
not make a round trip to the server.
-- Function: GLXDrawable glXGetCurrentReadDrawable
Return the current drawable.
'glXGetCurrentReadDrawable' returns the current read drawable, as
specified by 'read' parameter of 'glXMakeContextCurrent'. If there
is no current drawable, 'None' is returned.
'glXGetCurrentReadDrawable' returns client-side information. It
does not make a round-trip to the server.
-- Function: int glXGetFBConfigAttrib dpy config attribute value
Return information about a GLX frame buffer configuration.
DPY
Specifies the connection to the X server.
CONFIG
Specifies the GLX frame buffer configuration to be queried.
ATTRIBUTE
Specifies the attribute to be returned.
VALUE
Returns the requested value.
'glXGetFBConfigAttrib' sets VALUE to the ATTRIBUTE value of GLX
drawables created with respect to CONFIG. 'glXGetFBConfigAttrib'
returns an error code if it fails for any reason. Otherwise,
'Success' is returned.
ATTRIBUTE is one of the following:
'GLX_FBCONFIG_ID'
XID of the given GLXFBConfig.
'GLX_BUFFER_SIZE'
Number of bits per color buffer. If the frame buffer
configuration supports RGBA contexts, then 'GLX_BUFFER_SIZE'
is the sum of 'GLX_RED_SIZE', 'GLX_GREEN_SIZE',
'GLX_BLUE_SIZE', and 'GLX_ALPHA_SIZE'. If the frame buffer
configuration supports only color index contexts,
'GLX_BUFFER_SIZE' is the size of the color indexes.
'GLX_LEVEL'
Frame buffer level of the configuration. Level zero is the
default frame buffer. Positive levels correspond to frame
buffers that overlay the default buffer, and negative levels
correspond to frame buffers that underlie the default buffer.
'GLX_DOUBLEBUFFER'
'True' if color buffers exist in front/back pairs that can be
swapped, 'False' otherwise.
'GLX_STEREO'
'True' if color buffers exist in left/right pairs, 'False'
otherwise.
'GLX_AUX_BUFFERS'
Number of auxiliary color buffers that are available. Zero
indicates that no auxiliary color buffers exist.
'GLX_RED_SIZE'
Number of bits of red stored in each color buffer. Undefined
if RGBA contexts are not supported by the frame buffer
configuration.
'GLX_GREEN_SIZE'
Number of bits of green stored in each color buffer.
Undefined if RGBA contexts are not supported by the frame
buffer configuration.
'GLX_BLUE_SIZE'
Number of bits of blue stored in each color buffer. Undefined
if RGBA contexts are not supported by the frame buffer
configuration.
'GLX_ALPHA_SIZE'
Number of bits of alpha stored in each color buffer.
Undefined if RGBA contexts are not supported by the frame
buffer configuration.
'GLX_DEPTH_SIZE'
Number of bits in the depth buffer.
'GLX_STENCIL_SIZE'
Number of bits in the stencil buffer.
'GLX_ACCUM_RED_SIZE'
Number of bits of red stored in the accumulation buffer.
'GLX_ACCUM_GREEN_SIZE'
Number of bits of green stored in the accumulation buffer.
'GLX_ACCUM_BLUE_SIZE'
Number of bits of blue stored in the accumulation buffer.
'GLX_ACCUM_ALPHA_SIZE'
Number of bits of alpha stored in the accumulation buffer.
'GLX_RENDER_TYPE'
Mask indicating what type of GLX contexts can be made current
to the frame buffer configuration. Valid bits are
'GLX_RGBA_BIT' and 'GLX_COLOR_INDEX_BIT'.
'GLX_DRAWABLE_TYPE'
Mask indicating what drawable types the frame buffer
configuration supports. Valid bits are 'GLX_WINDOW_BIT',
'GLX_PIXMAP_BIT', and 'GLX_PBUFFER_BIT'.
'GLX_X_RENDERABLE'
'True' if drawables created with the frame buffer
configuration can be rendered to by X.
'GLX_VISUAL_ID'
XID of the corresponding visual, or zero if there is no
associated visual (i.e., if 'GLX_X_RENDERABLE' is 'False' or
'GLX_DRAWABLE_TYPE' does not have the 'GLX_WINDOW_BIT' bit
set).
'GLX_X_VISUAL_TYPE'
Visual type of associated visual. The returned value will be
one of: 'GLX_TRUE_COLOR', 'GLX_DIRECT_COLOR',
'GLX_PSEUDO_COLOR', 'GLX_STATIC_COLOR', 'GLX_GRAY_SCALE',
'GLX_STATIC_GRAY', or 'GLX_NONE', if there is no associated
visual (i.e., if 'GLX_X_RENDERABLE' is 'False' or
'GLX_DRAWABLE_TYPE' does not have the 'GLX_WINDOW_BIT' bit
set).
'GLX_CONFIG_CAVEAT'
One of 'GLX_NONE', 'GLX_SLOW_CONFIG', or
'GLX_NON_CONFORMANT_CONFIG', indicating that the frame buffer
configuration has no caveats, some aspect of the frame buffer
configuration runs slower than other frame buffer
configurations, or some aspect of the frame buffer
configuration is nonconformant, respectively.
'GLX_TRANSPARENT_TYPE'
One of 'GLX_NONE', 'GLX_TRANSPARENT_RGB',
'GLX_TRANSPARENT_INDEX', indicating that the frame buffer
configuration is opaque, is transparent for particular values
of red, green, and blue, or is transparent for particular
index values, respectively.
'GLX_TRANSPARENT_INDEX_VALUE'
Integer value between 0 and the maximum frame buffer value for
indices, indicating the transparent index value for the frame
buffer configuration. Undefined if 'GLX_TRANSPARENT_TYPE' is
not 'GLX_TRANSPARENT_INDEX'.
'GLX_TRANSPARENT_RED_VALUE'
Integer value between 0 and the maximum frame buffer value for
red, indicating the transparent red value for the frame buffer
configuration. Undefined if 'GLX_TRANSPARENT_TYPE' is not
'GLX_TRANSPARENT_RGB'.
'GLX_TRANSPARENT_GREEN_VALUE'
Integer value between 0 and the maximum frame buffer value for
green, indicating the transparent green value for the frame
buffer configuration. Undefined if 'GLX_TRANSPARENT_TYPE' is
not 'GLX_TRANSPARENT_RGB'.
'GLX_TRANSPARENT_BLUE_VALUE'
Integer value between 0 and the maximum frame buffer value for
blue, indicating the transparent blue value for the frame
buffer configuration. Undefined if 'GLX_TRANSPARENT_TYPE' is
not 'GLX_TRANSPARENT_RGB'.
'GLX_TRANSPARENT_ALPHA_VALUE'
Integer value between 0 and the maximum frame buffer value for
alpha, indicating the transparent blue value for the frame
buffer configuration. Undefined if 'GLX_TRANSPARENT_TYPE' is
not 'GLX_TRANSPARENT_RGB'.
'GLX_MAX_PBUFFER_WIDTH'
The maximum width that can be specified to 'glXCreatePbuffer'.
'GLX_MAX_PBUFFER_HEIGHT'
The maximum height that can be specified to
'glXCreatePbuffer'.
'GLX_MAX_PBUFFER_PIXELS'
The maximum number of pixels (width times height) for a pixel
buffer. Note that this value may be less than
'GLX_MAX_PBUFFER_WIDTH' times 'GLX_MAX_PBUFFER_HEIGHT'. Also,
this value is static and assumes that no other pixel buffers
or X resources are contending for the frame buffer memory. As
a result, it may not be possible to allocate a pixel buffer of
the size given by 'GLX_MAX_PBUFFER_PIXELS'.
Applications should choose the frame buffer configuration that most
closely meets their requirements. Creating windows, GLX pixmaps,
or GLX pixel buffers with unnecessary buffers can result in reduced
rendering performance as well as poor resource allocation.
'GLX_NO_EXTENSION' is returned if DPY does not support the GLX
extension. 'GLX_BAD_ATTRIBUTE' is returned if ATTRIBUTE is not a
valid GLX attribute.
-- Function: GLXFBConfig-* glXGetFBConfigs dpy screen nelements
List all GLX frame buffer configurations for a given screen.
DPY
Specifies the connection to the X server.
SCREEN
Specifies the screen number.
NELEMENTS
Returns the number of GLXFBConfigs returned.
'glXGetFBConfigs' returns a list of all GLXFBConfigs available on
the screen specified by SCREEN. Use 'glXGetFBConfigAttrib' to
obtain attribute values from a specific GLXFBConfig.
-- Function: void(*)() glXGetProcAddress procName
Obtain a pointer to an OpenGL or GLX function.
PROCNAME
Specifies the name of the OpenGL or GLX function whose address
is to be returned.
'glXGetProcAddress' returns the address of the function specified
in PROCNAME. This is necessary in environments where the OpenGL
link library exports a different set of functions than the runtime
library.
-- Function: void glXGetSelectedEvent dpy draw event_mask
Returns GLX events that are selected for a window or a GLX pixel
buffer.
DPY
Specifies the connection to the X server.
DRAW
Specifies a GLX drawable. Must be a GLX pixel buffer or a
window.
EVENT_MASK
Returns the events that are selected for DRAW.
'glXGetSelectedEvent' returns in EVENT_MASK the events selected for
DRAW.
'GLXBadDrawable' is generated if DRAW is not a valid window or a
valid GLX pixel buffer.
-- Function: XVisualInfo-* glXGetVisualFromFBConfig dpy config
Return visual that is associated with the frame buffer
configuration.
DPY
Specifies the connection to the X server.
CONFIG
Specifies the GLX frame buffer configuration.
If CONFIG is a valid GLX frame buffer configuration and it has an
associated X Visual, then information describing that visual is
returned; otherwise 'NULL' is returned. Use 'XFree' to free the
data returned.
Returns 'NULL' if CONFIG is not a valid GLXFBConfig.
-- Function: GLXContext glXImportContextEXT dpy contextID
Import another process's indirect rendering context..
DPY
Specifies the connection to the X server.
CONTEXTID
Specifies a GLX rendering context.
'glXImportContextEXT' creates a GLXContext given the XID of an
existing GLXContext. It may be used in place of
'glXCreateContext', to share another process's indirect rendering
context.
Only the server-side context information can be shared between X
clients; client-side state, such as pixel storage modes, cannot be
shared. Thus, 'glXImportContextEXT' must allocate memory to store
client-side information. This memory is freed by calling
'glXFreeContextEXT'.
This call does not create a new XID. It merely makes an existing
object available to the importing client (Display *). Like any
XID, it goes away when the creating client drops its connection or
the ID is explicitly deleted. Note that this is when the XID goes
away. The object goes away when the XID goes away AND the context
is not current to any thread.
If CONTEXTID refers to a direct rendering context then no error is
generated but 'glXImportContextEXT' returns NULL.
'glXImportContextEXT' is part of the 'EXT_import_context'
extension, not part of the core GLX command set. If
_glxextstring(EXT_import_context) is included in the string
returned by 'glXQueryExtensionsString', when called with argument
'GLX_EXTENSIONS', extension 'EXT_import_context' is supported.
'GLXBadContext' is generated if CONTEXTID does not refer to a valid
context.
-- Function: Bool glXIsDirect dpy ctx
Indicate whether direct rendering is enabled.
DPY
Specifies the connection to the X server.
CTX
Specifies the GLX context that is being queried.
'glXIsDirect' returns 'True' if CTX is a direct rendering context,
'False' otherwise. Direct rendering contexts pass rendering
commands directly from the calling process's address space to the
rendering system, bypassing the X server. Nondirect rendering
contexts pass all rendering commands to the X server.
'GLXBadContext' is generated if CTX is not a valid GLX context.
-- Function: Bool glXMakeContextCurrent display draw read ctx
Attach a GLX context to a GLX drawable.
DISPLAY
Specifies the connection to the X server.
DRAW
Specifies a GLX drawable to render into. Must be an XID
representing a GLXWindow, GLXPixmap, or GLXPbuffer.
READ
Specifies a GLX drawable to read from. Must be an XID
representing a GLXWindow, GLXPixmap, or GLXPbuffer.
CTX
Specifies the GLX context to be bound to READ and CTX.
'glXMakeContextCurrent' binds CTX to the current rendering thread
and to the DRAW and READ GLX drawables. DRAW and READ may be the
same.
DRAW is used for all OpenGL operations except:
Any pixel data that are read based on the value of
'GLX_READ_BUFFER'. Note that accumulation operations use the value
of 'GLX_READ_BUFFER', but are not allowed unless DRAW is identical
to READ.
Any depth values that are retrieved by 'glReadPixels' or
'glCopyPixels'.
Any stencil values that are retrieved by 'glReadPixels' or
'glCopyPixels'.
Frame buffer values are taken from DRAW.
If the current rendering thread has a current rendering context,
that context is flushed and replaced by CTX.
The first time that CTX is made current, the viewport and scissor
dimensions are set to the size of the DRAW drawable. The viewport
and scissor are not modified when CTX is subsequently made current.
To release the current context without assigning a new one, call
'glXMakeContextCurrent' with DRAW and READ set to 'None' and CTX
set to 'NULL'.
'glXMakeContextCurrent' returns 'True' if it is successful, 'False'
otherwise. If 'False' is returned, the previously current
rendering context and drawable (if any) remain unchanged.
'BadMatch' is generated if DRAW and READ are not compatible.
'BadAccess' is generated if CTX is current to some other thread.
'GLXContextState' is generated if there is a current rendering
context and its render mode is either 'GLX_FEEDBACK' or
'GLX_SELECT'.
'GLXBadContext' is generated if CTX is not a valid GLX rendering
context.
'GLXBadDrawable' is generated if DRAW or READ is not a valid GLX
drawable.
'GLXBadWindow' is generated if the underlying X window for either
DRAW or READ is no longer valid.
'GLXBadCurrentDrawable' is generated if the previous context of the
calling thread has unflushed commands and the previous drawable is
no longer valid.
'BadAlloc' is generated if the X server does not have enough
resources to allocate the buffers.
'BadMatch' is generated if:
DRAW and READ cannot fit into frame buffer memory simultaneously.
DRAW or READ is a GLXPixmap and CTX is a direct-rendering context.
DRAW or READ is a GLXPixmap and CTX was previously bound to a
GLXWindow or GLXPbuffer.
DRAW or READ is a GLXWindow or GLXPbuffer and CTX was previously
bound to a GLXPixmap.
-- Function: Bool glXMakeCurrent dpy drawable ctx
Attach a GLX context to a window or a GLX pixmap.
DPY
Specifies the connection to the X server.
DRAWABLE
Specifies a GLX drawable. Must be either an X window ID or a
GLX pixmap ID.
CTX
Specifies a GLX rendering context that is to be attached to
DRAWABLE.
'glXMakeCurrent' does two things: It makes CTX the current GLX
rendering context of the calling thread, replacing the previously
current context if there was one, and it attaches CTX to a GLX
drawable, either a window or a GLX pixmap. As a result of these
two actions, subsequent GL rendering calls use rendering context
CTX to modify GLX drawable DRAWABLE (for reading and writing).
Because 'glXMakeCurrent' always replaces the current rendering
context with CTX, there can be only one current context per thread.
Pending commands to the previous context, if any, are flushed
before it is released.
The first time CTX is made current to any thread, its viewport is
set to the full size of DRAWABLE. Subsequent calls by any thread
to 'glXMakeCurrent' with CTX have no effect on its viewport.
To release the current context without assigning a new one, call
'glXMakeCurrent' with DRAWABLE set to 'None' and CTX set to 'NULL'.
'glXMakeCurrent' returns 'True' if it is successful, 'False'
otherwise. If 'False' is returned, the previously current
rendering context and drawable (if any) remain unchanged.
'BadMatch' is generated if DRAWABLE was not created with the same X
screen and visual as CTX. It is also generated if DRAWABLE is
'None' and CTX is not 'NULL'.
'BadAccess' is generated if CTX was current to another thread at
the time 'glXMakeCurrent' was called.
'GLXBadDrawable' is generated if DRAWABLE is not a valid GLX
drawable.
'GLXBadContext' is generated if CTX is not a valid GLX context.
'GLXBadContextState' is generated if 'glXMakeCurrent' is executed
between the execution of 'glBegin' and the corresponding execution
of 'glEnd'.
'GLXBadContextState' is also generated if the rendering context
current to the calling thread has GL renderer state 'GLX_FEEDBACK'
or 'GLX_SELECT'.
'GLXBadCurrentWindow' is generated if there are pending GL commands
for the previous context and the current drawable is a window that
is no longer valid.
'BadAlloc' may be generated if the server has delayed allocation of
ancillary buffers until 'glXMakeCurrent' is called, only to find
that it has insufficient resources to complete the allocation.
-- Function: int glXQueryContextInfoEXT dpy ctx attribute value
Query context information.
DPY
Specifies the connection to the X server.
CTX
Specifies a GLX rendering context.
ATTRIBUTE
Specifies that a context parameter should be retrieved. Must
be one of 'GLX_SHARED_CONTEXT_EXT', 'GLX_VISUAL_ID_EXT', or
'GLX_SCREEN_EXT'.
VALUE
Contains the return value for ATTRIBUTE.
'glXQueryContextInfoEXT' sets VALUE to the value of ATTRIBUTE with
respect to CTX. 'glXQueryContextInfoEXT' returns an error code if
it fails for any reason. Otherwise, 'Success' is returned.
ATTRIBUTE may be one of the following:
'GLX_SHARED_CONTEXT_EXT'
Returns the XID of the share list context associated with CTX
at its creation.
'GLX_VISUAL_ID_EXT'
Returns the XID of the GLX Visual associated with CTX.
'GLX_SCREEN_EXT'
Returns the screen number associated with CTX.
This call may cause a round-trip to the server.
'glXQueryContextInfoEXT' is part of the 'EXT_import_context'
extension, not part of the core GLX command set. If
_glxextstring(EXT_import_context) is included in the string
returned by 'glXQueryExtensionsString', when called with argument
'GLX_EXTENSIONS', extension 'EXT_import_context' is supported.
'GLXBadContext' is generated if CTX does not refer to a valid
context.
'GLX_BAD_ATTRIBUTE' is returned if ATTRIBUTE is not a valid GLX
context attribute.
fred 'GLX_BAD_CONTEXT' is returned if ATTRIBUTE is not a valid
context.
-- Function: int glXQueryContext dpy ctx attribute value
Query context information.
DPY
Specifies the connection to the X server.
CTX
Specifies a GLX rendering context.
ATTRIBUTE
Specifies that a context parameter should be retrieved. Must
be one of 'GLX_FBCONFIG_ID', 'GLX_RENDER_TYPE', or
'GLX_SCREEN'.
VALUE
Contains the return value for ATTRIBUTE.
'glXQueryContext' sets VALUE to the value of ATTRIBUTE with respect
to CTX. ATTRIBUTE may be one of the following:
'GLX_FBCONFIG_ID'
Returns the XID of the GLXFBConfig associated with CTX.
'GLX_RENDER_TYPE'
Returns the rendering type supported by CTX.
'GLX_SCREEN'
Returns the screen number associated with CTX.
'Success' is returned unless ATTRIBUTE is not a valid GLX context
attribute, in which case 'GLX_BAD_ATTRIBUTE' is returned.
This call may cause a round-trip to the server.
'GLXBadContext' is generated if CTX does not refer to a valid
context.
-- Function: int glXQueryDrawable dpy draw attribute value
Returns an attribute assoicated with a GLX drawable.
DPY
Specifies the connection to the X server.
DRAW
Specifies the GLX drawable to be queried.
ATTRIBUTE
Specifies the attribute to be returned. Must be one of
'GLX_WIDTH', 'GLX_HEIGHT', 'GLX_PRESERVED_CONTENTS',
'GLX_LARGEST_PBUFFER', or 'GLX_FBCONFIG_ID'.
VALUE
Contains the return value for ATTRIBUTE.
'glXQueryDrawable' sets VALUE to the value of ATTRIBUTE with
respect to the GLXDrawable DRAW.
ATTRIBUTE may be one of the following:
'GLX_WIDTH'
Returns the width of CTX.
'GLX_HEIGHT'
Returns the height of CTX.
'GLX_PRESERVED_CONTENTS'
Returns 'True' if the contents of a GLXPbuffer are preserved
when a resource conflict occurs; 'False' otherwise.
'GLX_LARGEST_PBUFFER'
Returns the value set when 'glXCreatePbuffer' was called to
create the GLXPbuffer. If 'False' is returned, then the call
to 'glXCreatePbuffer' will fail to create a GLXPbuffer if the
requested size is larger than the implementation maximum or
available resources. If 'True' is returned, a GLXPbuffer of
the maximum availble size (if less than the requested width
and height) is created.
'GLX_FBCONFIG_ID'
Returns the XID for DRAW.
If DRAW is a GLXWindow or GLXPixmap and ATTRIBUTE is set to
'GLX_PRESERVED_CONTENTS' or 'GLX_LARGETST_PBUFFER', the contents of
VALUE are undefined. If ATTRIBUTE is not one of the attributes
listed above, the contents of VALUE are unedfined.
A 'GLXBadDrawable' is generated if DRAW is not a valid GLXDrawable.
-- Function: const-char-* glXQueryExtensionsString dpy screen
Return list of supported extensions.
DPY
Specifies the connection to the X server.
SCREEN
Specifies the screen number.
'glXQueryExtensionsString' returns a pointer to a string describing
which GLX extensions are supported on the connection. The string
is null-terminated and contains a space-separated list of extension
names. (The extension names themselves never contain spaces.) If
there are no extensions to GLX, then the empty string is returned.
-- Function: Bool glXQueryExtension dpy errorBase eventBase
Indicate whether the GLX extension is supported.
DPY
Specifies the connection to the X server.
ERRORBASE
Returns the base error code of the GLX server extension.
EVENTBASE
Returns the base event code of the GLX server extension.
'glXQueryExtension' returns 'True' if the X server of connection
DPY supports the GLX extension, 'False' otherwise. If 'True' is
returned, then ERRORBASE and EVENTBASE return the error base and
event base of the GLX extension. These values should be added to
the constant error and event values to determine the actual event
or error values. Otherwise, ERRORBASE and EVENTBASE are unchanged.
ERRORBASE and EVENTBASE do not return values if they are specified
as 'NULL'.
-- Function: const-char-* glXQueryServerString dpy screen name
Return string describing the server.
DPY
Specifies the connection to the X server.
SCREEN
Specifies the screen number.
NAME
Specifies which string is returned: one of 'GLX_VENDOR',
'GLX_VERSION', or 'GLX_EXTENSIONS'.
'glXQueryServerString' returns a pointer to a static,
null-terminated string describing some aspect of the server's GLX
extension. The possible values for NAME and the format of the
strings is the same as for 'glXGetClientString'. If NAME is not
set to a recognized value, 'NULL' is returned.
-- Function: Bool glXQueryVersion dpy major minor
Return the version numbers of the GLX extension.
DPY
Specifies the connection to the X server.
MAJOR
Returns the major version number of the GLX server extension.
MINOR
Returns the minor version number of the GLX server extension.
'glXQueryVersion' returns the major and minor version numbers of
the GLX extension implemented by the server associated with
connection DPY. Implementations with the same major version number
are upward compatible, meaning that the implementation with the
higher minor number is a superset of the version with the lower
minor number.
MAJOR and MINOR do not return values if they are specified as
'NULL'.
'glXQueryVersion' returns 'False' if it fails, 'True' otherwise.
MAJOR and MINOR are not updated when 'False' is returned.
-- Function: void glXSelectEvent dpy draw event_mask
Select GLX events for a window or a GLX pixel buffer.
DPY
Specifies the connection to the X server.
DRAW
Specifies a GLX drawable. Must be a GLX pixel buffer or a
window.
EVENT_MASK
Specifies the events to be returned for DRAW.
'glXSelectEvent' sets the GLX event mask for a GLX pixel buffer or
a window. Calling 'glXSelectEvent' overrides any previous event
mask that was set by the client for DRAW. Note that it does not
affect the event masks that other clients may have specified for
DRAW since each client rendering to DRAW has a separate event mask
for it.
Currently, only one GLX event, 'GLX_PBUFFER_CLOBBER_MASK', can be
selected. The following data is returned to the client when a
'GLX_PBUFFER_CLOBBER_MASK' event occurs:
typedef struct {
int EVENT_TYPE;
/* GLX_DAMAGED or GLX_SAVED */
int DRAW_TYPE;
/* GLX_WINDOW or GLX_PBUFFER */
unsigned long SERIAL;
/* # of last request processed by server */
Bool SEND_EVENT;
/* true if this came for SendEvent request */
Display *DISPLAY;
/* display the event was read from */
GLXDrawable DRAWABLE;
/* i.d. of Drawable */
unsigned int BUFFER_MASK;
/* mask indicating affected buffers */
int X, Y;
int WIDTH, HEIGHT;
int COUNT;
/* if nonzero, at least this many more */
} GLXPbufferClobberEvent; The valid bit masks used in BUFFER_MASK
are:
*Bitmask*
*Corresponding Buffer*
'GLX_FRONT_LEFT_BUFFER_BIT'
Front left color buffer
'GLX_FRONT_RIGHT_BUFFER_BIT'
Front right color buffer
'GLX_BACK_LEFT_BUFFER_BIT'
Back left color buffer
'GLX_BACK_RIGHT_BUFFER_BIT'
Back right color buffer
'GLX_AUX_BUFFERS_BIT'
Auxiliary buffer
'GLX_DEPTH_BUFFER_BIT'
Depth buffer
'GLX_STENCIL_BUFFER_BIT'
Stencil buffer
'GLX_ACCUM_BUFFER_BIT'
Accumulation buffer
A single X server operation can cause several buffer clobber events
to be sent. (e.g., a single GLX pixel buffer may be damaged and
cause multiple buffer clobber events to be generated). Each event
specifies one region of the GLX drawable that was affected by the X
Server operation. The BUFFER_MASK field indicates which color
buffers and ancillary buffers were affected. All the buffer
clobber events generated by a single X server action are guaranteed
to be contiguous in the event queue. The conditions under which
this event is generated and the EVENT_TYPE varies, depending on the
type of the GLX drawable.
When the 'GLX_AUX_BUFFERS_BIT' is set in BUFFER_MASK, then
AUX_BUFFER is set to indicate which buffer was affected. If more
than one aux buffer was affected, then additional events are
generated as part of the same contiguous event group. Each
additional event will have only the 'GLX_AUX_BUFFERS_BIT' set in
BUFFER_MASK, and the AUX_BUFFER field will be set appropriately.
For nonstereo drawables, 'GLX_FRONT_LEFT_BUFFER_BIT' and
'GLX_BACK_LEFT_BUFFER_BIT' are used to specify the front and back
color buffers.
For preserved GLX pixel buffers, a buffer clobber event with type
'GLX_SAVED' is generated whenever the contents of the GLX pixel
buffer is moved out of offscreen memory. The event(s) describes
which portions of the GLX pixel buffer were affected. Clients who
receive many buffer clobber events, referring to different save
actions, should consider freeing the GLX pixel buffer resource in
order to prevent the system from thrashing due to insufficient
resources.
For an unpreserved GLXPbuffer, a buffer clobber event, with type
'GLX_DAMAGED', is generated whenever a portion of the GLX pixel
buffer becomes invalid. The client may wish to regenerate the
invalid portions of the GLX pixel buffer.
For Windows, buffer clobber events, with type 'GLX_SAVED', occur
whenever an ancillary buffer, associated with the window, gets
clobbered or moved out of off-screen memory. The event contains
information indicating which color buffers and ancillary
buffers\(emand which portions of those buffers\(emwere affected.
'GLXBadDrawable' is generated if DRAW is not a valid window or a
valid GLX pixel buffer.
-- Function: void glXSwapBuffers dpy drawable
Exchange front and back buffers.
DPY
Specifies the connection to the X server.
DRAWABLE
Specifies the drawable whose buffers are to be swapped.
'glXSwapBuffers' promotes the contents of the back buffer of
DRAWABLE to become the contents of the front buffer of DRAWABLE.
The contents of the back buffer then become undefined. The update
typically takes place during the vertical retrace of the monitor,
rather than immediately after 'glXSwapBuffers' is called.
'glXSwapBuffers' performs an implicit 'glFlush' before it returns.
Subsequent OpenGL commands may be issued immediately after calling
'glXSwapBuffers', but are not executed until the buffer exchange is
completed.
If DRAWABLE was not created with respect to a double-buffered
visual, 'glXSwapBuffers' has no effect, and no error is generated.
'GLXBadDrawable' is generated if DRAWABLE is not a valid GLX
drawable.
'GLXBadCurrentWindow' is generated if DPY and DRAWABLE are
respectively the display and drawable associated with the current
context of the calling thread, and DRAWABLE identifies a window
that is no longer valid.
-- Function: void glXUseXFont font first count listBase
Create bitmap display lists from an X font.
FONT
Specifies the font from which character glyphs are to be
taken.
FIRST
Specifies the index of the first glyph to be taken.
COUNT
Specifies the number of glyphs to be taken.
LISTBASE
Specifies the index of the first display list to be generated.
'glXUseXFont' generates COUNT display lists, named LISTBASE through
LISTBASE+COUNT-1, each containing a single 'glBitmap' command. The
parameters of the 'glBitmap' command of display list LISTBASE+I are
derived from glyph FIRST+I. Bitmap parameters XORIG, YORIG, WIDTH,
and HEIGHT are computed from font metrics as DESCENT-1, -LBEARING,
RBEARING-LBEARING, and ASCENT+DESCENT, respectively. XMOVE is
taken from the glyph's WIDTH metric, and YMOVE is set to zero.
Finally, the glyph's image is converted to the appropriate format
for 'glBitmap'.
Using 'glXUseXFont' may be more efficient than accessing the X font
and generating the display lists explicitly, both because the
display lists are created on the server without requiring a round
trip of the glyph data, and because the server may choose to delay
the creation of each bitmap until it is accessed.
Empty display lists are created for all glyphs that are requested
and are not defined in FONT. 'glXUseXFont' is ignored if there is
no current GLX context.
'BadFont' is generated if FONT is not a valid font.
'GLXBadContextState' is generated if the current GLX context is in
display-list construction mode.
'GLXBadCurrentWindow' is generated if the drawable associated with
the current context of the calling thread is a window, and that
window is no longer valid.
-- Function: void glXWaitGL
Complete GL execution prior to subsequent X calls.
GL rendering calls made prior to 'glXWaitGL' are guaranteed to be
executed before X rendering calls made after 'glXWaitGL'. Although
this same result can be achieved using 'glFinish', 'glXWaitGL' does
not require a round trip to the server, and it is therefore more
efficient in cases where client and server are on separate
machines.
'glXWaitGL' is ignored if there is no current GLX context.
'GLXBadCurrentWindow' is generated if the drawable associated with
the current context of the calling thread is a window, and that
window is no longer valid.
-- Function: void glXWaitX
Complete X execution prior to subsequent GL calls.
X rendering calls made prior to 'glXWaitX' are guaranteed to be
executed before GL rendering calls made after 'glXWaitX'. Although
the same result can be achieved using 'XSync', 'glXWaitX' does not
require a round trip to the server, and it is therefore more
efficient in cases where client and server are on separate
machines.
'glXWaitX' is ignored if there is no current GLX context.
'GLXBadCurrentWindow' is generated if the drawable associated with
the current context of the calling thread is a window, and that
window is no longer valid.
6 GLUT
******
Import the GLUT module to have access to these procedures:
(use-modules (glut))
The GLUT specification is available at
.
6.1 GLUT Initialization
=======================
-- Function: set-initial-display-mode mode
-- Function: set-initial-window-position x y
-- Function: set-initial-window-size width height
-- Function: initialize-glut [args] [#:window-position] [#:window-size]
[#:display-mode]
6.2 Beginning Event Processing
==============================
-- Function: glut-main-loop
6.3 Window Management
=====================
-- Function: window-id
-- Function: window-live?
-- Function: window?
-- Function: set-window-cursor! window cursor
-- Function: set-window-icon-title! window str
-- Function: set-window-title! window str
-- Function: show-window [window]
-- Function: sub-window? window
-- Function: swap-buffers [window]
-- Function: top-level-window? window
-- Macro: with-window window body1 body2 ...
-- Function: with-window* _ _
-- Function: make-sub-window window x y width height
-- Function: make-window str
-- Function: pop-window
-- Function: position-window window x y
-- Function: post-redisplay [window]
-- Function: push-window
-- Function: reshape-window window width height
-- Function: current-window
-- Function: destroy-window window
-- Function: full-screen window full-screen?
-- Function: hide-window [window]
-- Function: iconify-window [window]
6.4 Overlay Management
======================
6.5 Menu Management
===================
6.6 Callback Registration
=========================
-- Function: set-button-box-callback func
-- Function: set-current-window window
-- Function: set-dials-callback func
-- Function: set-display-callback func
-- Function: set-entry-callback func
-- Function: set-idle-callback func
-- Function: set-keyboard-callback func
-- Function: set-menu-status-callback func
-- Function: set-motion-callback func
-- Function: set-mouse-callback func
-- Function: set-overlay-display-callback func
-- Function: set-passive-motion-callback func
-- Function: set-reshape-callback func
-- Function: set-spaceball-button-callback func
-- Function: set-spaceball-motion-callback func
-- Function: set-spaceball-rotate-callback func
-- Function: set-special-callback func
-- Function: set-tablet-button-callback func
-- Function: set-tablet-motion-callback func
-- Function: set-visibility-callback func
-- Function: add-timer-callback msecs func value
6.7 Color Index Colormap Management
===================================
6.8 State Retrieval
===================
-- Function: window-alpha-size window
-- Function: window-blue-size window
-- Function: window-color-buffer-size window
-- Function: window-colormap-size window
-- Function: window-depth-buffer-size window
-- Function: window-double-buffered? window
-- Function: window-green-size window
-- Function: window-height width
-- Function: window-number-of-children window
-- Function: window-number-of-samples window
-- Function: window-parent window
-- Function: window-position window
-- Function: window-red-size window
-- Function: window-size window
-- Function: window-stencil-buffer-size window
-- Function: window-stereo? window
-- Function: window-rgba window
-- Function: window-width width
-- Function: window-x width
-- Function: window-y width
-- Function: screen-height
-- Function: screen-height-mm
-- Function: screen-size
-- Function: screen-size-mm
-- Function: screen-width
-- Function: screen-width-mm
-- Function: display-mode-possible?
-- Function: initial-display-mode
-- Function: initial-window-height
-- Function: initial-window-position
-- Function: initial-window-size
-- Function: initial-window-width
-- Function: initial-window-x
-- Function: initial-window-y
-- Function: elapsed-time
6.9 Font Rendering
==================
6.10 Geometric Object Rendering
===============================
Appendix A GNU General Public License
*************************************
Version 3, 29 June 2007
Copyright (C) 2007 Free Software Foundation, Inc.
Everyone is permitted to copy and distribute verbatim copies of this
license document, but changing it is not allowed.
Preamble
========
The GNU General Public License is a free, copyleft license for software
and other kinds of works.
The licenses for most software and other practical works are designed
to take away your freedom to share and change the works. By contrast,
the GNU General Public License is intended to guarantee your freedom to
share and change all versions of a program--to make sure it remains free
software for all its users. We, the Free Software Foundation, use the
GNU General Public License for most of our software; it applies also to
any other work released this way by its authors. You can apply it to
your programs, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
them if you wish), that you receive source code or can get it if you
want it, that you can change the software or use pieces of it in new
free programs, and that you know you can do these things.
To protect your rights, we need to prevent others from denying you
these rights or asking you to surrender the rights. Therefore, you have
certain responsibilities if you distribute copies of the software, or if
you modify it: responsibilities to respect the freedom of others.
For example, if you distribute copies of such a program, whether
gratis or for a fee, you must pass on to the recipients the same
freedoms that you received. You must make sure that they, too, receive
or can get the source code. And you must show them these terms so they
know their rights.
Developers that use the GNU GPL protect your rights with two steps:
(1) assert copyright on the software, and (2) offer you this License
giving you legal permission to copy, distribute and/or modify it.
For the developers' and authors' protection, the GPL clearly explains
that there is no warranty for this free software. For both users' and
authors' sake, the GPL requires that modified versions be marked as
changed, so that their problems will not be attributed erroneously to
authors of previous versions.
Some devices are designed to deny users access to install or run
modified versions of the software inside them, although the manufacturer
can do so. This is fundamentally incompatible with the aim of
protecting users' freedom to change the software. The systematic
pattern of such abuse occurs in the area of products for individuals to
use, which is precisely where it is most unacceptable. Therefore, we
have designed this version of the GPL to prohibit the practice for those
products. If such problems arise substantially in other domains, we
stand ready to extend this provision to those domains in future versions
of the GPL, as needed to protect the freedom of users.
Finally, every program is threatened constantly by software patents.
States should not allow patents to restrict development and use of
software on general-purpose computers, but in those that do, we wish to
avoid the special danger that patents applied to a free program could
make it effectively proprietary. To prevent this, the GPL assures that
patents cannot be used to render the program non-free.
The precise terms and conditions for copying, distribution and
modification follow.
TERMS AND CONDITIONS
====================
0. Definitions.
"This License" refers to version 3 of the GNU General Public
License.
"Copyright" also means copyright-like laws that apply to other
kinds of works, such as semiconductor masks.
"The Program" refers to any copyrightable work licensed under this
License. Each licensee is addressed as "you". "Licensees" and
"recipients" may be individuals or organizations.
To "modify" a work means to copy from or adapt all or part of the
work in a fashion requiring copyright permission, other than the
making of an exact copy. The resulting work is called a "modified
version" of the earlier work or a work "based on" the earlier work.
A "covered work" means either the unmodified Program or a work
based on the Program.
To "propagate" a work means to do anything with it that, without
permission, would make you directly or secondarily liable for
infringement under applicable copyright law, except executing it on
a computer or modifying a private copy. Propagation includes
copying, distribution (with or without modification), making
available to the public, and in some countries other activities as
well.
To "convey" a work means any kind of propagation that enables other
parties to make or receive copies. Mere interaction with a user
through a computer network, with no transfer of a copy, is not
conveying.
An interactive user interface displays "Appropriate Legal Notices"
to the extent that it includes a convenient and prominently visible
feature that (1) displays an appropriate copyright notice, and (2)
tells the user that there is no warranty for the work (except to
the extent that warranties are provided), that licensees may convey
the work under this License, and how to view a copy of this
License. If the interface presents a list of user commands or
options, such as a menu, a prominent item in the list meets this
criterion.
1. Source Code.
The "source code" for a work means the preferred form of the work
for making modifications to it. "Object code" means any non-source
form of a work.
A "Standard Interface" means an interface that either is an
official standard defined by a recognized standards body, or, in
the case of interfaces specified for a particular programming
language, one that is widely used among developers working in that
language.
The "System Libraries" of an executable work include anything,
other than the work as a whole, that (a) is included in the normal
form of packaging a Major Component, but which is not part of that
Major Component, and (b) serves only to enable use of the work with
that Major Component, or to implement a Standard Interface for
which an implementation is available to the public in source code
form. A "Major Component", in this context, means a major
essential component (kernel, window system, and so on) of the
specific operating system (if any) on which the executable work
runs, or a compiler used to produce the work, or an object code
interpreter used to run it.
The "Corresponding Source" for a work in object code form means all
the source code needed to generate, install, and (for an executable
work) run the object code and to modify the work, including scripts
to control those activities. However, it does not include the
work's System Libraries, or general-purpose tools or generally
available free programs which are used unmodified in performing
those activities but which are not part of the work. For example,
Corresponding Source includes interface definition files associated
with source files for the work, and the source code for shared
libraries and dynamically linked subprograms that the work is
specifically designed to require, such as by intimate data
communication or control flow between those subprograms and other
parts of the work.
The Corresponding Source need not include anything that users can
regenerate automatically from other parts of the Corresponding
Source.
The Corresponding Source for a work in source code form is that
same work.
2. Basic Permissions.
All rights granted under this License are granted for the term of
copyright on the Program, and are irrevocable provided the stated
conditions are met. This License explicitly affirms your unlimited
permission to run the unmodified Program. The output from running
a covered work is covered by this License only if the output, given
its content, constitutes a covered work. This License acknowledges
your rights of fair use or other equivalent, as provided by
copyright law.
You may make, run and propagate covered works that you do not
convey, without conditions so long as your license otherwise
remains in force. You may convey covered works to others for the
sole purpose of having them make modifications exclusively for you,
or provide you with facilities for running those works, provided
that you comply with the terms of this License in conveying all
material for which you do not control copyright. Those thus making
or running the covered works for you must do so exclusively on your
behalf, under your direction and control, on terms that prohibit
them from making any copies of your copyrighted material outside
their relationship with you.
Conveying under any other circumstances is permitted solely under
the conditions stated below. Sublicensing is not allowed; section
10 makes it unnecessary.
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
No covered work shall be deemed part of an effective technological
measure under any applicable law fulfilling obligations under
article 11 of the WIPO copyright treaty adopted on 20 December
1996, or similar laws prohibiting or restricting circumvention of
such measures.
When you convey a covered work, you waive any legal power to forbid
circumvention of technological measures to the extent such
circumvention is effected by exercising rights under this License
with respect to the covered work, and you disclaim any intention to
limit operation or modification of the work as a means of
enforcing, against the work's users, your or third parties' legal
rights to forbid circumvention of technological measures.
4. Conveying Verbatim Copies.
You may convey verbatim copies of the Program's source code as you
receive it, in any medium, provided that you conspicuously and
appropriately publish on each copy an appropriate copyright notice;
keep intact all notices stating that this License and any
non-permissive terms added in accord with section 7 apply to the
code; keep intact all notices of the absence of any warranty; and
give all recipients a copy of this License along with the Program.
You may charge any price or no price for each copy that you convey,
and you may offer support or warranty protection for a fee.
5. Conveying Modified Source Versions.
You may convey a work based on the Program, or the modifications to
produce it from the Program, in the form of source code under the
terms of section 4, provided that you also meet all of these
conditions:
a. The work must carry prominent notices stating that you
modified it, and giving a relevant date.
b. The work must carry prominent notices stating that it is
released under this License and any conditions added under
section 7. This requirement modifies the requirement in
section 4 to "keep intact all notices".
c. You must license the entire work, as a whole, under this
License to anyone who comes into possession of a copy. This
License will therefore apply, along with any applicable
section 7 additional terms, to the whole of the work, and all
its parts, regardless of how they are packaged. This License
gives no permission to license the work in any other way, but
it does not invalidate such permission if you have separately
received it.
d. If the work has interactive user interfaces, each must display
Appropriate Legal Notices; however, if the Program has
interactive interfaces that do not display Appropriate Legal
Notices, your work need not make them do so.
A compilation of a covered work with other separate and independent
works, which are not by their nature extensions of the covered
work, and which are not combined with it such as to form a larger
program, in or on a volume of a storage or distribution medium, is
called an "aggregate" if the compilation and its resulting
copyright are not used to limit the access or legal rights of the
compilation's users beyond what the individual works permit.
Inclusion of a covered work in an aggregate does not cause this
License to apply to the other parts of the aggregate.
6. Conveying Non-Source Forms.
You may convey a covered work in object code form under the terms
of sections 4 and 5, provided that you also convey the
machine-readable Corresponding Source under the terms of this
License, in one of these ways:
a. Convey the object code in, or embodied in, a physical product
(including a physical distribution medium), accompanied by the
Corresponding Source fixed on a durable physical medium
customarily used for software interchange.
b. Convey the object code in, or embodied in, a physical product
(including a physical distribution medium), accompanied by a
written offer, valid for at least three years and valid for as
long as you offer spare parts or customer support for that
product model, to give anyone who possesses the object code
either (1) a copy of the Corresponding Source for all the
software in the product that is covered by this License, on a
durable physical medium customarily used for software
interchange, for a price no more than your reasonable cost of
physically performing this conveying of source, or (2) access
to copy the Corresponding Source from a network server at no
charge.
c. Convey individual copies of the object code with a copy of the
written offer to provide the Corresponding Source. This
alternative is allowed only occasionally and noncommercially,
and only if you received the object code with such an offer,
in accord with subsection 6b.
d. Convey the object code by offering access from a designated
place (gratis or for a charge), and offer equivalent access to
the Corresponding Source in the same way through the same
place at no further charge. You need not require recipients
to copy the Corresponding Source along with the object code.
If the place to copy the object code is a network server, the
Corresponding Source may be on a different server (operated by
you or a third party) that supports equivalent copying
facilities, provided you maintain clear directions next to the
object code saying where to find the Corresponding Source.
Regardless of what server hosts the Corresponding Source, you
remain obligated to ensure that it is available for as long as
needed to satisfy these requirements.
e. Convey the object code using peer-to-peer transmission,
provided you inform other peers where the object code and
Corresponding Source of the work are being offered to the
general public at no charge under subsection 6d.
A separable portion of the object code, whose source code is
excluded from the Corresponding Source as a System Library, need
not be included in conveying the object code work.
A "User Product" is either (1) a "consumer product", which means
any tangible personal property which is normally used for personal,
family, or household purposes, or (2) anything designed or sold for
incorporation into a dwelling. In determining whether a product is
a consumer product, doubtful cases shall be resolved in favor of
coverage. For a particular product received by a particular user,
"normally used" refers to a typical or common use of that class of
product, regardless of the status of the particular user or of the
way in which the particular user actually uses, or expects or is
expected to use, the product. A product is a consumer product
regardless of whether the product has substantial commercial,
industrial or non-consumer uses, unless such uses represent the
only significant mode of use of the product.
"Installation Information" for a User Product means any methods,
procedures, authorization keys, or other information required to
install and execute modified versions of a covered work in that
User Product from a modified version of its Corresponding Source.
The information must suffice to ensure that the continued
functioning of the modified object code is in no case prevented or
interfered with solely because modification has been made.
If you convey an object code work under this section in, or with,
or specifically for use in, a User Product, and the conveying
occurs as part of a transaction in which the right of possession
and use of the User Product is transferred to the recipient in
perpetuity or for a fixed term (regardless of how the transaction
is characterized), the Corresponding Source conveyed under this
section must be accompanied by the Installation Information. But
this requirement does not apply if neither you nor any third party
retains the ability to install modified object code on the User
Product (for example, the work has been installed in ROM).
The requirement to provide Installation Information does not
include a requirement to continue to provide support service,
warranty, or updates for a work that has been modified or installed
by the recipient, or for the User Product in which it has been
modified or installed. Access to a network may be denied when the
modification itself materially and adversely affects the operation
of the network or violates the rules and protocols for
communication across the network.
Corresponding Source conveyed, and Installation Information
provided, in accord with this section must be in a format that is
publicly documented (and with an implementation available to the
public in source code form), and must require no special password
or key for unpacking, reading or copying.
7. Additional Terms.
"Additional permissions" are terms that supplement the terms of
this License by making exceptions from one or more of its
conditions. Additional permissions that are applicable to the
entire Program shall be treated as though they were included in
this License, to the extent that they are valid under applicable
law. If additional permissions apply only to part of the Program,
that part may be used separately under those permissions, but the
entire Program remains governed by this License without regard to
the additional permissions.
When you convey a copy of a covered work, you may at your option
remove any additional permissions from that copy, or from any part
of it. (Additional permissions may be written to require their own
removal in certain cases when you modify the work.) You may place
additional permissions on material, added by you to a covered work,
for which you have or can give appropriate copyright permission.
Notwithstanding any other provision of this License, for material
you add to a covered work, you may (if authorized by the copyright
holders of that material) supplement the terms of this License with
terms:
a. Disclaiming warranty or limiting liability differently from
the terms of sections 15 and 16 of this License; or
b. Requiring preservation of specified reasonable legal notices
or author attributions in that material or in the Appropriate
Legal Notices displayed by works containing it; or
c. Prohibiting misrepresentation of the origin of that material,
or requiring that modified versions of such material be marked
in reasonable ways as different from the original version; or
d. Limiting the use for publicity purposes of names of licensors
or authors of the material; or
e. Declining to grant rights under trademark law for use of some
trade names, trademarks, or service marks; or
f. Requiring indemnification of licensors and authors of that
material by anyone who conveys the material (or modified
versions of it) with contractual assumptions of liability to
the recipient, for any liability that these contractual
assumptions directly impose on those licensors and authors.
All other non-permissive additional terms are considered "further
restrictions" within the meaning of section 10. If the Program as
you received it, or any part of it, contains a notice stating that
it is governed by this License along with a term that is a further
restriction, you may remove that term. If a license document
contains a further restriction but permits relicensing or conveying
under this License, you may add to a covered work material governed
by the terms of that license document, provided that the further
restriction does not survive such relicensing or conveying.
If you add terms to a covered work in accord with this section, you
must place, in the relevant source files, a statement of the
additional terms that apply to those files, or a notice indicating
where to find the applicable terms.
Additional terms, permissive or non-permissive, may be stated in
the form of a separately written license, or stated as exceptions;
the above requirements apply either way.
8. Termination.
You may not propagate or modify a covered work except as expressly
provided under this License. Any attempt otherwise to propagate or
modify it is void, and will automatically terminate your rights
under this License (including any patent licenses granted under the
third paragraph of section 11).
However, if you cease all violation of this License, then your
license from a particular copyright holder is reinstated (a)
provisionally, unless and until the copyright holder explicitly and
finally terminates your license, and (b) permanently, if the
copyright holder fails to notify you of the violation by some
reasonable means prior to 60 days after the cessation.
Moreover, your license from a particular copyright holder is
reinstated permanently if the copyright holder notifies you of the
violation by some reasonable means, this is the first time you have
received notice of violation of this License (for any work) from
that copyright holder, and you cure the violation prior to 30 days
after your receipt of the notice.
Termination of your rights under this section does not terminate
the licenses of parties who have received copies or rights from you
under this License. If your rights have been terminated and not
permanently reinstated, you do not qualify to receive new licenses
for the same material under section 10.
9. Acceptance Not Required for Having Copies.
You are not required to accept this License in order to receive or
run a copy of the Program. Ancillary propagation of a covered work
occurring solely as a consequence of using peer-to-peer
transmission to receive a copy likewise does not require
acceptance. However, nothing other than this License grants you
permission to propagate or modify any covered work. These actions
infringe copyright if you do not accept this License. Therefore,
by modifying or propagating a covered work, you indicate your
acceptance of this License to do so.
10. Automatic Licensing of Downstream Recipients.
Each time you convey a covered work, the recipient automatically
receives a license from the original licensors, to run, modify and
propagate that work, subject to this License. You are not
responsible for enforcing compliance by third parties with this
License.
An "entity transaction" is a transaction transferring control of an
organization, or substantially all assets of one, or subdividing an
organization, or merging organizations. If propagation of a
covered work results from an entity transaction, each party to that
transaction who receives a copy of the work also receives whatever
licenses to the work the party's predecessor in interest had or
could give under the previous paragraph, plus a right to possession
of the Corresponding Source of the work from the predecessor in
interest, if the predecessor has it or can get it with reasonable
efforts.
You may not impose any further restrictions on the exercise of the
rights granted or affirmed under this License. For example, you
may not impose a license fee, royalty, or other charge for exercise
of rights granted under this License, and you may not initiate
litigation (including a cross-claim or counterclaim in a lawsuit)
alleging that any patent claim is infringed by making, using,
selling, offering for sale, or importing the Program or any portion
of it.
11. Patents.
A "contributor" is a copyright holder who authorizes use under this
License of the Program or a work on which the Program is based.
The work thus licensed is called the contributor's "contributor
version".
A contributor's "essential patent claims" are all patent claims
owned or controlled by the contributor, whether already acquired or
hereafter acquired, that would be infringed by some manner,
permitted by this License, of making, using, or selling its
contributor version, but do not include claims that would be
infringed only as a consequence of further modification of the
contributor version. For purposes of this definition, "control"
includes the right to grant patent sublicenses in a manner
consistent with the requirements of this License.
Each contributor grants you a non-exclusive, worldwide,
royalty-free patent license under the contributor's essential
patent claims, to make, use, sell, offer for sale, import and
otherwise run, modify and propagate the contents of its contributor
version.
In the following three paragraphs, a "patent license" is any
express agreement or commitment, however denominated, not to
enforce a patent (such as an express permission to practice a
patent or covenant not to sue for patent infringement). To "grant"
such a patent license to a party means to make such an agreement or
commitment not to enforce a patent against the party.
If you convey a covered work, knowingly relying on a patent
license, and the Corresponding Source of the work is not available
for anyone to copy, free of charge and under the terms of this
License, through a publicly available network server or other
readily accessible means, then you must either (1) cause the
Corresponding Source to be so available, or (2) arrange to deprive
yourself of the benefit of the patent license for this particular
work, or (3) arrange, in a manner consistent with the requirements
of this License, to extend the patent license to downstream
recipients. "Knowingly relying" means you have actual knowledge
that, but for the patent license, your conveying the covered work
in a country, or your recipient's use of the covered work in a
country, would infringe one or more identifiable patents in that
country that you have reason to believe are valid.
If, pursuant to or in connection with a single transaction or
arrangement, you convey, or propagate by procuring conveyance of, a
covered work, and grant a patent license to some of the parties
receiving the covered work authorizing them to use, propagate,
modify or convey a specific copy of the covered work, then the
patent license you grant is automatically extended to all
recipients of the covered work and works based on it.
A patent license is "discriminatory" if it does not include within
the scope of its coverage, prohibits the exercise of, or is
conditioned on the non-exercise of one or more of the rights that
are specifically granted under this License. You may not convey a
covered work if you are a party to an arrangement with a third
party that is in the business of distributing software, under which
you make payment to the third party based on the extent of your
activity of conveying the work, and under which the third party
grants, to any of the parties who would receive the covered work
from you, a discriminatory patent license (a) in connection with
copies of the covered work conveyed by you (or copies made from
those copies), or (b) primarily for and in connection with specific
products or compilations that contain the covered work, unless you
entered into that arrangement, or that patent license was granted,
prior to 28 March 2007.
Nothing in this License shall be construed as excluding or limiting
any implied license or other defenses to infringement that may
otherwise be available to you under applicable patent law.
12. No Surrender of Others' Freedom.
If conditions are imposed on you (whether by court order, agreement
or otherwise) that contradict the conditions of this License, they
do not excuse you from the conditions of this License. If you
cannot convey a covered work so as to satisfy simultaneously your
obligations under this License and any other pertinent obligations,
then as a consequence you may not convey it at all. For example,
if you agree to terms that obligate you to collect a royalty for
further conveying from those to whom you convey the Program, the
only way you could satisfy both those terms and this License would
be to refrain entirely from conveying the Program.
13. Use with the GNU Affero General Public License.
Notwithstanding any other provision of this License, you have
permission to link or combine any covered work with a work licensed
under version 3 of the GNU Affero General Public License into a
single combined work, and to convey the resulting work. The terms
of this License will continue to apply to the part which is the
covered work, but the special requirements of the GNU Affero
General Public License, section 13, concerning interaction through
a network will apply to the combination as such.
14. Revised Versions of this License.
The Free Software Foundation may publish revised and/or new
versions of the GNU General Public License from time to time. Such
new versions will be similar in spirit to the present version, but
may differ in detail to address new problems or concerns.
Each version is given a distinguishing version number. If the
Program specifies that a certain numbered version of the GNU
General Public License "or any later version" applies to it, you
have the option of following the terms and conditions either of
that numbered version or of any later version published by the Free
Software Foundation. If the Program does not specify a version
number of the GNU General Public License, you may choose any
version ever published by the Free Software Foundation.
If the Program specifies that a proxy can decide which future
versions of the GNU General Public License can be used, that
proxy's public statement of acceptance of a version permanently
authorizes you to choose that version for the Program.
Later license versions may give you additional or different
permissions. However, no additional obligations are imposed on any
author or copyright holder as a result of your choosing to follow a
later version.
15. Disclaimer of Warranty.
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE
COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS"
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
NECESSARY SERVICING, REPAIR OR CORRECTION.
16. Limitation of Liability.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES
AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR
DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF
THE POSSIBILITY OF SUCH DAMAGES.
17. Interpretation of Sections 15 and 16.
If the disclaimer of warranty and limitation of liability provided
above cannot be given local legal effect according to their terms,
reviewing courts shall apply local law that most closely
approximates an absolute waiver of all civil liability in
connection with the Program, unless a warranty or assumption of
liability accompanies a copy of the Program in return for a fee.
END OF TERMS AND CONDITIONS
===========================
How to Apply These Terms to Your New Programs
=============================================
If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these
terms.
To do so, attach the following notices to the program. It is safest
to attach them to the start of each source file to most effectively
state the exclusion of warranty; and each file should have at least the
"copyright" line and a pointer to where the full notice is found.
ONE LINE TO GIVE THE PROGRAM'S NAME AND A BRIEF IDEA OF WHAT IT DOES.
Copyright (C) YEAR NAME OF AUTHOR
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or (at
your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .
Also add information on how to contact you by electronic and paper
mail.
If the program does terminal interaction, make it output a short
notice like this when it starts in an interactive mode:
PROGRAM Copyright (C) YEAR NAME OF AUTHOR
This program comes with ABSOLUTELY NO WARRANTY; for details type 'show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type 'show c' for details.
The hypothetical commands 'show w' and 'show c' should show the
appropriate parts of the General Public License. Of course, your
program's commands might be different; for a GUI interface, you would
use an "about box".
You should also get your employer (if you work as a programmer) or
school, if any, to sign a "copyright disclaimer" for the program, if
necessary. For more information on this, and how to apply and follow
the GNU GPL, see .
The GNU General Public License does not permit incorporating your
program into proprietary programs. If your program is a subroutine
library, you may consider it more useful to permit linking proprietary
applications with the library. If this is what you want to do, use the
GNU Lesser General Public License instead of this License. But first,
please read .
Appendix B GNU Lesser General Public License
********************************************
Version 3, 29 June 2007
Copyright (C) 2007 Free Software Foundation, Inc.
Everyone is permitted to copy and distribute verbatim copies of this
license document, but changing it is not allowed.
This version of the GNU Lesser General Public License incorporates
the terms and conditions of version 3 of the GNU General Public License,
supplemented by the additional permissions listed below.
0. Additional Definitions.
As used herein, "this License" refers to version 3 of the GNU
Lesser General Public License, and the "GNU GPL" refers to version
3 of the GNU General Public License.
"The Library" refers to a covered work governed by this License,
other than an Application or a Combined Work as defined below.
An "Application" is any work that makes use of an interface
provided by the Library, but which is not otherwise based on the
Library. Defining a subclass of a class defined by the Library is
deemed a mode of using an interface provided by the Library.
A "Combined Work" is a work produced by combining or linking an
Application with the Library. The particular version of the
Library with which the Combined Work was made is also called the
"Linked Version".
The "Minimal Corresponding Source" for a Combined Work means the
Corresponding Source for the Combined Work, excluding any source
code for portions of the Combined Work that, considered in
isolation, are based on the Application, and not on the Linked
Version.
The "Corresponding Application Code" for a Combined Work means the
object code and/or source code for the Application, including any
data and utility programs needed for reproducing the Combined Work
from the Application, but excluding the System Libraries of the
Combined Work.
1. Exception to Section 3 of the GNU GPL.
You may convey a covered work under sections 3 and 4 of this
License without being bound by section 3 of the GNU GPL.
2. Conveying Modified Versions.
If you modify a copy of the Library, and, in your modifications, a
facility refers to a function or data to be supplied by an
Application that uses the facility (other than as an argument
passed when the facility is invoked), then you may convey a copy of
the modified version:
a. under this License, provided that you make a good faith effort
to ensure that, in the event an Application does not supply
the function or data, the facility still operates, and
performs whatever part of its purpose remains meaningful, or
b. under the GNU GPL, with none of the additional permissions of
this License applicable to that copy.
3. Object Code Incorporating Material from Library Header Files.
The object code form of an Application may incorporate material
from a header file that is part of the Library. You may convey
such object code under terms of your choice, provided that, if the
incorporated material is not limited to numerical parameters, data
structure layouts and accessors, or small macros, inline functions
and templates (ten or fewer lines in length), you do both of the
following:
a. Give prominent notice with each copy of the object code that
the Library is used in it and that the Library and its use are
covered by this License.
b. Accompany the object code with a copy of the GNU GPL and this
license document.
4. Combined Works.
You may convey a Combined Work under terms of your choice that,
taken together, effectively do not restrict modification of the
portions of the Library contained in the Combined Work and reverse
engineering for debugging such modifications, if you also do each
of the following:
a. Give prominent notice with each copy of the Combined Work that
the Library is used in it and that the Library and its use are
covered by this License.
b. Accompany the Combined Work with a copy of the GNU GPL and
this license document.
c. For a Combined Work that displays copyright notices during
execution, include the copyright notice for the Library among
these notices, as well as a reference directing the user to
the copies of the GNU GPL and this license document.
d. Do one of the following:
0. Convey the Minimal Corresponding Source under the terms
of this License, and the Corresponding Application Code
in a form suitable for, and under terms that permit, the
user to recombine or relink the Application with a
modified version of the Linked Version to produce a
modified Combined Work, in the manner specified by
section 6 of the GNU GPL for conveying Corresponding
Source.
1. Use a suitable shared library mechanism for linking with
the Library. A suitable mechanism is one that (a) uses
at run time a copy of the Library already present on the
user's computer system, and (b) will operate properly
with a modified version of the Library that is
interface-compatible with the Linked Version.
e. Provide Installation Information, but only if you would
otherwise be required to provide such information under
section 6 of the GNU GPL, and only to the extent that such
information is necessary to install and execute a modified
version of the Combined Work produced by recombining or
relinking the Application with a modified version of the
Linked Version. (If you use option 4d0, the Installation
Information must accompany the Minimal Corresponding Source
and Corresponding Application Code. If you use option 4d1,
you must provide the Installation Information in the manner
specified by section 6 of the GNU GPL for conveying
Corresponding Source.)
5. Combined Libraries.
You may place library facilities that are a work based on the
Library side by side in a single library together with other
library facilities that are not Applications and are not covered by
this License, and convey such a combined library under terms of
your choice, if you do both of the following:
a. Accompany the combined library with a copy of the same work
based on the Library, uncombined with any other library
facilities, conveyed under the terms of this License.
b. Give prominent notice with the combined library that part of
it is a work based on the Library, and explaining where to
find the accompanying uncombined form of the same work.
6. Revised Versions of the GNU Lesser General Public License.
The Free Software Foundation may publish revised and/or new
versions of the GNU Lesser General Public License from time to
time. Such new versions will be similar in spirit to the present
version, but may differ in detail to address new problems or
concerns.
Each version is given a distinguishing version number. If the
Library as you received it specifies that a certain numbered
version of the GNU Lesser General Public License "or any later
version" applies to it, you have the option of following the terms
and conditions either of that published version or of any later
version published by the Free Software Foundation. If the Library
as you received it does not specify a version number of the GNU
Lesser General Public License, you may choose any version of the
GNU Lesser General Public License ever published by the Free
Software Foundation.
If the Library as you received it specifies that a proxy can decide
whether future versions of the GNU Lesser General Public License
shall apply, that proxy's public statement of acceptance of any
version is permanent authorization for you to choose that version
for the Library.
Function Index
**************
* Menu:
* 3dfx-multisample: GL Enumerations. (line 658)
* 3dfx-texture-compression-fxt1: GL Enumerations. (line 4588)
* accum-op: GL Enumerations. (line 1242)
* add-timer-callback: Callback Registration.
(line 33138)
* alpha-function: GL Enumerations. (line 1249)
* amd-blend-minmax-factor: GL Enumerations. (line 6547)
* amd-compressed-3dc-texture: GL Enumerations. (line 4905)
* amd-compressed-atc-texture: GL Enumerations. (line 4884)
* amd-debug-output: GL Enumerations. (line 6761)
* amd-depth-clamp-separate: GL Enumerations. (line 6554)
* amd-name-gen-delete: GL Enumerations. (line 6776)
* amd-performance-monitor: GL Enumerations. (line 5764)
* amd-pinned-memory: GL Enumerations. (line 6784)
* amd-program-binary-z400: GL Enumerations. (line 4682)
* amd-query-buffer-object: GL Enumerations. (line 6791)
* amd-sample-positions: GL Enumerations. (line 5020)
* amd-sparse-texture: GL Enumerations. (line 6799)
* amd-stencil-operation-extended: GL Enumerations. (line 4720)
* amd-vertex-shader-tesselator: GL Enumerations. (line 6517)
* angle-depth-texture: GL Enumerations. (line 6927)
* angle-framebuffer-blit: GL Enumerations. (line 5978)
* angle-framebuffer-multisample: GL Enumerations. (line 5994)
* angle-instanced-arrays: GL Enumerations. (line 5305)
* angle-pack-reverse-row-order: GL Enumerations. (line 6920)
* angle-texture-compression-dxt-3: GL Enumerations. (line 3826)
* angle-texture-compression-dxt-5: GL Enumerations. (line 3833)
* angle-texture-usage: GL Enumerations. (line 6913)
* angle-translated-shader-source: GL Enumerations. (line 6906)
* apple-aux-depth-stencil: GL Enumerations. (line 5477)
* apple-client-storage: GL Enumerations. (line 4358)
* apple-element-array: GL Enumerations. (line 5438)
* apple-fence: GL Enumerations. (line 5431)
* apple-float-pixels: GL Enumerations. (line 2115)
* apple-flush-buffer-range: GL Enumerations. (line 5470)
* apple-object-purgeable: GL Enumerations. (line 4365)
* apple-rgb-422: GL Enumerations. (line 5491)
* apple-row-bytes: GL Enumerations. (line 5484)
* apple-specular-vector: GL Enumerations. (line 4344)
* apple-sync: GL Enumerations. (line 5522)
* apple-texture-range: GL Enumerations. (line 4387)
* apple-transform-hint: GL Enumerations. (line 4351)
* apple-vertex-array-object: GL Enumerations. (line 4380)
* apple-vertex-array-range: GL Enumerations. (line 4226)
* apple-vertex-program-evaluators: GL Enumerations. (line 5419)
* apple-ycbcr-422: GL Enumerations. (line 4396)
* arb-blend-func-extended: GL Enumerations. (line 5276)
* arb-cl-event: GL Enumerations. (line 3543)
* arb-color-buffer-float: GL Enumerations. (line 4953)
* arb-compressed-texture-pixel-storage: GL Enumerations. (line 6720)
* arb-compute-shader: GL Enumerations. (line 926)
* arb-copy-buffer: GL Enumerations. (line 6463)
* arb-create-context-profile: GLX Enumerations. (line 30873)
* arb-debug-output: GL Enumerations. (line 3550)
* arb-depth-buffer-float: GL Enumerations. (line 6028)
* arb-depth-clamp: GL Enumerations. (line 4470)
* arb-depth-texture: GL Enumerations. (line 3374)
* arb-draw-buffers: GL Enumerations. (line 4976)
* arb-draw-indirect: GL Enumerations. (line 6471)
* arb-es2-compatibility: GL Enumerations. (line 2127)
* arb-es3-compatibility: GL Enumerations. (line 6093)
* arb-explicit-uniform-location: GL Enumerations. (line 3586)
* arb-fragment-program: GL Enumerations. (line 4484)
* arb-fragment-shader: GL Enumerations. (line 5622)
* arb-framebuffer-no-attachments: GL Enumerations. (line 6888)
* arb-framebuffer-object: GL Enumerations. (line 1487)
* arb-framebuffer-s-rgb: GL Enumerations. (line 6174)
* arb-geometry-shader-4: GL Enumerations. (line 1109)
* arb-get-program-binary: GL Enumerations. (line 3568)
* arb-gpu-shader-5: GL Enumerations. (line 5161)
* arb-gpu-shader-fp-64: GL Enumerations. (line 6478)
* arb-half-float-pixel: GL Enumerations. (line 2101)
* arb-half-float-vertex: GL Enumerations. (line 2094)
* arb-instanced-arrays: GL Enumerations. (line 5298)
* arb-internalformat-query: GL Enumerations. (line 6899)
* arb-internalformat-query-2: GL Enumerations. (line 3593)
* arb-map-buffer-alignment: GL Enumerations. (line 6673)
* arb-map-buffer-range: GL Enumerations. (line 857)
* arb-matrix-palette: GL Enumerations. (line 5027)
* arb-multisample: GL Enumerations. (line 635)
* arb-multitexture: GL Enumerations. (line 3994)
* arb-occlusion-query: GL Enumerations. (line 5109)
* arb-occlusion-query-2: GL Enumerations. (line 5821)
* arb-pixel-buffer-object: GL Enumerations. (line 5225)
* arb-point-parameters: GL Enumerations. (line 3140)
* arb-point-sprite: GL Enumerations. (line 5088)
* arb-program-interface-query: GL Enumerations. (line 6862)
* arb-provoking-vertex: GL Enumerations. (line 6335)
* arb-robustness: GL Enumerations. (line 906)
* arb-sample-shading: GL Enumerations. (line 5828)
* arb-sampler-objects: GL Enumerations. (line 5337)
* arb-seamless-cube-map: GL Enumerations. (line 5064)
* arb-separate-shader-objects: GL Enumerations. (line 916)
* arb-shader-atomic-counters: GL Enumerations. (line 6832)
* arb-shader-image-load-store: GL Enumerations. (line 990)
* arb-shader-objects: GL Enumerations. (line 5536)
* arb-shader-storage-buffer-object: GL Enumerations. (line 1027)
* arb-shader-subroutine: GL Enumerations. (line 6250)
* arb-shading-language-include: GL Enumerations. (line 6166)
* arb-shadow: GL Enumerations. (line 5038)
* arb-stencil-texturing: GL Enumerations. (line 6695)
* arb-sync: GL Enumerations. (line 6709)
* arb-tessellation-shader: GL Enumerations. (line 1200)
* arb-texture-border-clamp: GL Enumerations. (line 3172)
* arb-texture-buffer-object: GL Enumerations. (line 5801)
* arb-texture-buffer-range: GL Enumerations. (line 6810)
* arb-texture-compression: GL Enumerations. (line 4039)
* arb-texture-compression-bptc: GL Enumerations. (line 6415)
* arb-texture-compression-rgtc: GL Enumerations. (line 6188)
* arb-texture-cube-map: GL Enumerations. (line 4203)
* arb-texture-cube-map-array: GL Enumerations. (line 6526)
* arb-texture-env-combine: GL Enumerations. (line 4032)
* arb-texture-env-dot-3: GL Enumerations. (line 4571)
* arb-texture-float: GL Enumerations. (line 4928)
* arb-texture-gather: GL Enumerations. (line 6398)
* arb-texture-mirrored-repeat: GL Enumerations. (line 3782)
* arb-texture-multisample: GL Enumerations. (line 6353)
* arb-texture-rectangle: GL Enumerations. (line 4095)
* arb-texture-rg: GL Enumerations. (line 3534)
* arb-texture-rgb-10-a-2-ui: GL Enumerations. (line 6593)
* arb-texture-storage: GL Enumerations. (line 6730)
* arb-texture-swizzle: GL Enumerations. (line 6318)
* arb-texture-view: GL Enumerations. (line 3651)
* arb-timer-query: GL Enumerations. (line 5211)
* arb-transform-feedback-2: GL Enumerations. (line 6277)
* arb-transform-feedback-3: GL Enumerations. (line 6408)
* arb-transpose-matrix: GL Enumerations. (line 4023)
* arb-uniform-buffer-object: GL Enumerations. (line 5446)
* arb-vertex-array-bgra: GL Enumerations. (line 3110)
* arb-vertex-array-object: GL Enumerations. (line 4373)
* arb-vertex-attrib-binding: GL Enumerations. (line 3641)
* arb-vertex-blend: GL Enumerations. (line 4535)
* arb-vertex-buffer-object: GL Enumerations. (line 4779)
* arb-vertex-program: GL Enumerations. (line 3924)
* arb-vertex-shader: GL Enumerations. (line 5579)
* arb-vertex-type-2-10-10-10-rev: GL Enumerations. (line 6140)
* arb-viewport-array: GL Enumerations. (line 3576)
* arm-mali-shader-binary: GL Enumerations. (line 6488)
* ati-draw-buffers: GL Enumerations. (line 4988)
* ati-element-array: GL Enumerations. (line 4802)
* ati-envmap-bumpmap: GL Enumerations. (line 4820)
* ati-fragment-shader: GL Enumerations. (line 5344)
* ati-meminfo: GL Enumerations. (line 4912)
* ati-pixel-format-float: GL Enumerations. (line 4962)
* ati-pn-triangles: GL Enumerations. (line 4892)
* ati-separate-stencil: GL Enumerations. (line 4920)
* ati-text-fragment-shader: GL Enumerations. (line 3511)
* ati-texture-env-combine-3: GL Enumerations. (line 4712)
* ati-texture-float: GL Enumerations. (line 4942)
* ati-texture-mirror-once: GL Enumerations. (line 4697)
* ati-vertex-array-object: GL Enumerations. (line 4770)
* ati-vertex-streams: GL Enumerations. (line 4810)
* attrib-mask: GL Enumerations. (line 587)
* begin-mode: GL Enumerations. (line 1062)
* blend-equation-mode-ext: GL Enumerations. (line 1278)
* blending-factor-dest: GL Enumerations. (line 1257)
* blending-factor-src: GL Enumerations. (line 1267)
* boolean: GL Enumerations. (line 1055)
* clear-buffer-mask: GL Enumerations. (line 666)
* client-attrib-mask: GL Enumerations. (line 675)
* clip-plane-name: GL Enumerations. (line 2636)
* color-material-face: GL Enumerations. (line 1287)
* color-material-parameter: GL Enumerations. (line 1294)
* color-pointer-type: GL Enumerations. (line 1302)
* color-table-parameter-p-name-sgi: GL Enumerations. (line 1310)
* color-table-target-sgi: GL Enumerations. (line 1317)
* convolution-border-mode-ext: GL Enumerations. (line 1328)
* convolution-parameter-ext: GL Enumerations. (line 1335)
* convolution-target-ext: GL Enumerations. (line 1343)
* cull-face-mode: GL Enumerations. (line 1350)
* current-window: Window Management. (line 33079)
* data-type: GL Enumerations. (line 2059)
* depth-function: GL Enumerations. (line 1357)
* destroy-window: Window Management. (line 33081)
* display-mode-possible?: State Retrieval. (line 33198)
* dmp-shader-binary: GL Enumerations. (line 6818)
* draw-buffer-mode: GL Enumerations. (line 1365)
* elapsed-time: State Retrieval. (line 33214)
* enable-cap: GL Enumerations. (line 1438)
* error-code: GL Enumerations. (line 1478)
* ext-422-pixels: GL Enumerations. (line 3088)
* ext-abgr: GL Enumerations. (line 2655)
* ext-bgra: GL Enumerations. (line 3117)
* ext-bindable-uniform: GL Enumerations. (line 6239)
* ext-blend-color: GL Enumerations. (line 2717)
* ext-blend-equation-separate: GL Enumerations. (line 2795)
* ext-blend-func-separate: GL Enumerations. (line 3072)
* ext-blend-minmax: GL Enumerations. (line 2726)
* ext-blend-subtract: GL Enumerations. (line 2809)
* ext-buffer-age: GLX Enumerations. (line 30847)
* ext-cmyka: GL Enumerations. (line 2825)
* ext-color-buffer-half-float: GL Enumerations. (line 3518)
* ext-compiled-vertex-array: GL Enumerations. (line 3405)
* ext-convolution: GL Enumerations. (line 2833)
* ext-cull-vertex: GL Enumerations. (line 3412)
* ext-debug-label: GL Enumerations. (line 5506)
* ext-depth-bounds-test: GL Enumerations. (line 5189)
* ext-direct-state-access: GL Enumerations. (line 6310)
* ext-discard-framebuffer: GL Enumerations. (line 2248)
* ext-fog-coord: GL Enumerations. (line 3904)
* ext-framebuffer-blit: GL Enumerations. (line 5969)
* ext-framebuffer-multisample: GL Enumerations. (line 6002)
* ext-framebuffer-multisample-blit-scaled: GL Enumerations. (line 6666)
* ext-framebuffer-object: GL Enumerations. (line 1565)
* ext-framebuffer-s-rgb: GL Enumerations. (line 6181)
* ext-geometry-shader-4: GL Enumerations. (line 5715)
* ext-gpu-shader-4: GL Enumerations. (line 6205)
* ext-histogram: GL Enumerations. (line 2851)
* ext-index-array-formats: GL Enumerations. (line 3420)
* ext-index-func: GL Enumerations. (line 3429)
* ext-index-material: GL Enumerations. (line 3436)
* ext-light-texture: GL Enumerations. (line 3739)
* ext-map-buffer-range: GL Enumerations. (line 867)
* ext-multisample: GL Enumerations. (line 645)
* ext-multisampled-render-to-texture: GL Enumerations. (line 6107)
* ext-multiview-draw-buffers: GL Enumerations. (line 1928)
* ext-occlusion-query-boolean: GL Enumerations. (line 5125)
* ext-packed-depth-stencil: GL Enumerations. (line 4111)
* ext-packed-float: GL Enumerations. (line 5835)
* ext-packed-pixels: GL Enumerations. (line 2863)
* ext-pixel-buffer-object: GL Enumerations. (line 5233)
* ext-pixel-transform: GL Enumerations. (line 3728)
* ext-point-parameters: GL Enumerations. (line 3148)
* ext-polygon-offset: GL Enumerations. (line 2883)
* ext-provoking-vertex: GL Enumerations. (line 6344)
* ext-rescale-normal: GL Enumerations. (line 2891)
* ext-secondary-color: GL Enumerations. (line 3914)
* ext-separate-shader-objects: GL Enumerations. (line 944)
* ext-separate-specular-color: GL Enumerations. (line 3496)
* ext-shader-framebuffer-fetch: GL Enumerations. (line 5515)
* ext-shader-image-load-store: GL Enumerations. (line 954)
* ext-shadow-samplers: GL Enumerations. (line 5046)
* ext-shared-texture-palette: GL Enumerations. (line 3504)
* ext-stencil-clear-tag: GL Enumerations. (line 5253)
* ext-stencil-two-side: GL Enumerations. (line 5330)
* ext-stencil-wrap: GL Enumerations. (line 4168)
* ext-swap-control: GLX Enumerations. (line 30833)
* ext-swap-control-tear: GLX Enumerations. (line 30840)
* ext-texture: GL Enumerations. (line 2898)
* ext-texture-3d: GL Enumerations. (line 2928)
* ext-texture-array: GL Enumerations. (line 5054)
* ext-texture-buffer-object: GL Enumerations. (line 5811)
* ext-texture-compression-latc: GL Enumerations. (line 5865)
* ext-texture-compression-rgtc: GL Enumerations. (line 6196)
* ext-texture-compression-s-3-tc: GL Enumerations. (line 3818)
* ext-texture-cube-map: GL Enumerations. (line 4182)
* ext-texture-env-combine: GL Enumerations. (line 4307)
* ext-texture-env-dot-3: GL Enumerations. (line 4675)
* ext-texture-filter-anisotropic: GL Enumerations. (line 4142)
* ext-texture-integer: GL Enumerations. (line 6114)
* ext-texture-lod-bias: GL Enumerations. (line 4134)
* ext-texture-mirror-clamp: GL Enumerations. (line 4704)
* ext-texture-object: GL Enumerations. (line 2919)
* ext-texture-perturb-normal: GL Enumerations. (line 4337)
* ext-texture-rg: GL Enumerations. (line 2272)
* ext-texture-s-rgb: GL Enumerations. (line 5851)
* ext-texture-s-rgb-decode: GL Enumerations. (line 5499)
* ext-texture-shared-exponent: GL Enumerations. (line 5843)
* ext-texture-snorm: GL Enumerations. (line 6536)
* ext-texture-swizzle: GL Enumerations. (line 6326)
* ext-texture-type-2-10-10-10-rev: GL Enumerations. (line 2875)
* ext-timer-query: GL Enumerations. (line 5218)
* ext-transform-feedback: GL Enumerations. (line 5875)
* ext-unpack-subimage: GL Enumerations. (line 1921)
* ext-vertex-array: GL Enumerations. (line 2947)
* ext-vertex-attrib-64-bit: GL Enumerations. (line 2083)
* ext-vertex-shader: GL Enumerations. (line 4829)
* ext-vertex-weighting: GL Enumerations. (line 4149)
* ext-x-11-sync-object: GL Enumerations. (line 6688)
* feed-back-token: GL Enumerations. (line 1634)
* feedback-type: GL Enumerations. (line 1627)
* ffd-mask-sgix: GL Enumerations. (line 1643)
* ffd-target-sgix: GL Enumerations. (line 1651)
* fj-shader-binary-gccso: GL Enumerations. (line 6825)
* fog-mode: GL Enumerations. (line 1658)
* fog-parameter: GL Enumerations. (line 1665)
* fragment-light-model-parameter-sgix: GL Enumerations. (line 1673)
* front-face-direction: GL Enumerations. (line 1683)
* full-screen: Window Management. (line 33083)
* get-color-table-parameter-p-name-sgi: GL Enumerations. (line 1690)
* get-convolution-parameter: GL Enumerations. (line 1701)
* get-histogram-parameter-p-name-ext: GL Enumerations. (line 1711)
* get-map-query: GL Enumerations. (line 1721)
* get-minmax-parameter-p-name-ext: GL Enumerations. (line 1728)
* get-p-name: GL Enumerations. (line 1756)
* get-pixel-map: GL Enumerations. (line 1735)
* get-pointerv-p-name: GL Enumerations. (line 1745)
* get-texture-parameter: GL Enumerations. (line 1944)
* gl-begin: OpenGL Operation. (line 330)
* gl-clear: Per Fragment Operations.
(line 530)
* gl-color: OpenGL Operation. (line 360)
* gl-copy-pixels: Per Fragment Operations.
(line 561)
* gl-depth-range: OpenGL Operation. (line 390)
* gl-disable: OpenGL Operation. (line 445)
* gl-edge-flag: OpenGL Operation. (line 338)
* gl-enable: OpenGL Operation. (line 444)
* gl-fog-coordinate: OpenGL Operation. (line 371)
* gl-frustum: OpenGL Operation. (line 429)
* gl-index: OpenGL Operation. (line 377)
* gl-khr-texture-compression-astc-ldr: GL Enumerations. (line 6934)
* gl-load-identity: OpenGL Operation. (line 416)
* gl-load-matrix: OpenGL Operation. (line 398)
* gl-multi-texture-coordinates: OpenGL Operation. (line 356)
* gl-multiply-matrix: OpenGL Operation. (line 405)
* gl-normal: OpenGL Operation. (line 366)
* gl-ortho: OpenGL Operation. (line 435)
* gl-rectangle: OpenGL Operation. (line 383)
* gl-rotate: OpenGL Operation. (line 419)
* gl-scale: OpenGL Operation. (line 426)
* gl-secondary-color: OpenGL Operation. (line 374)
* gl-texture-coordinates: OpenGL Operation. (line 353)
* gl-translate: OpenGL Operation. (line 423)
* gl-vertex: OpenGL Operation. (line 346)
* gl-vertex-attribute: OpenGL Operation. (line 363)
* gl-viewport: OpenGL Operation. (line 394)
* glAccum: Low-Level GL. (line 6992)
* glActiveTexture: Low-Level GL. (line 7084)
* glAlphaFunc: Low-Level GL. (line 7108)
* glAreTexturesResident: Low-Level GL. (line 7179)
* glArrayElement: Low-Level GL. (line 7224)
* glAttachShader: Low-Level GL. (line 7258)
* glBegin: Low-Level GL. (line 7353)
* glBeginQuery: Low-Level GL. (line 7306)
* glBindAttribLocation: Low-Level GL. (line 7476)
* glBindBuffer: Low-Level GL. (line 7548)
* glBindTexture: Low-Level GL. (line 7650)
* glBitmap: Low-Level GL. (line 7720)
* glBlendColor: Low-Level GL. (line 7804)
* glBlendEquation: Low-Level GL. (line 7898)
* glBlendEquationSeparate: Low-Level GL. (line 7823)
* glBlendFunc: Low-Level GL. (line 8108)
* glBlendFuncSeparate: Low-Level GL. (line 7966)
* glBufferData: Low-Level GL. (line 8238)
* glBufferSubData: Low-Level GL. (line 8329)
* glCallList: Low-Level GL. (line 8477)
* glCallLists: Low-Level GL. (line 8374)
* glClear: Low-Level GL. (line 8585)
* glClearAccum: Low-Level GL. (line 8500)
* glClearColor: Low-Level GL. (line 8519)
* glClearDepth: Low-Level GL. (line 8537)
* glClearIndex: Low-Level GL. (line 8552)
* glClearStencil: Low-Level GL. (line 8570)
* glClientActiveTexture: Low-Level GL. (line 8633)
* glClipPlane: Low-Level GL. (line 8654)
* glColor3b: Low-Level GL. (line 9179)
* glColor3bv: Low-Level GL. (line 9195)
* glColor3d: Low-Level GL. (line 9183)
* glColor3dv: Low-Level GL. (line 9199)
* glColor3f: Low-Level GL. (line 9182)
* glColor3fv: Low-Level GL. (line 9198)
* glColor3i: Low-Level GL. (line 9181)
* glColor3iv: Low-Level GL. (line 9197)
* glColor3s: Low-Level GL. (line 9180)
* glColor3sv: Low-Level GL. (line 9196)
* glColor3ub: Low-Level GL. (line 9184)
* glColor3ubv: Low-Level GL. (line 9200)
* glColor3ui: Low-Level GL. (line 9186)
* glColor3uiv: Low-Level GL. (line 9202)
* glColor3us: Low-Level GL. (line 9185)
* glColor3usv: Low-Level GL. (line 9201)
* glColor4b: Low-Level GL. (line 9187)
* glColor4bv: Low-Level GL. (line 9203)
* glColor4d: Low-Level GL. (line 9191)
* glColor4dv: Low-Level GL. (line 9207)
* glColor4f: Low-Level GL. (line 9190)
* glColor4fv: Low-Level GL. (line 9206)
* glColor4i: Low-Level GL. (line 9189)
* glColor4iv: Low-Level GL. (line 9205)
* glColor4s: Low-Level GL. (line 9188)
* glColor4sv: Low-Level GL. (line 9204)
* glColor4ub: Low-Level GL. (line 9192)
* glColor4ubv: Low-Level GL. (line 9208)
* glColor4ui: Low-Level GL. (line 9194)
* glColor4uiv: Low-Level GL. (line 9210)
* glColor4us: Low-Level GL. (line 9193)
* glColor4usv: Low-Level GL. (line 9209)
* glColorMask: Low-Level GL. (line 8699)
* glColorMaterial: Low-Level GL. (line 8725)
* glColorPointer: Low-Level GL. (line 8757)
* glColorSubTable: Low-Level GL. (line 8812)
* glColorTable: Low-Level GL. (line 8934)
* glColorTableParameterfv: Low-Level GL. (line 8891)
* glColorTableParameteriv: Low-Level GL. (line 8892)
* glCompileShader: Low-Level GL. (line 9251)
* glCompressedTexImage1D: Low-Level GL. (line 9282)
* glCompressedTexImage2D: Low-Level GL. (line 9377)
* glCompressedTexImage3D: Low-Level GL. (line 9488)
* glCompressedTexSubImage1D: Low-Level GL. (line 9596)
* glCompressedTexSubImage2D: Low-Level GL. (line 9682)
* glCompressedTexSubImage3D: Low-Level GL. (line 9784)
* glConvolutionFilter1D: Low-Level GL. (line 9883)
* glConvolutionFilter2D: Low-Level GL. (line 10041)
* glConvolutionParameterf: Low-Level GL. (line 10209)
* glConvolutionParameterfv: Low-Level GL. (line 10211)
* glConvolutionParameteri: Low-Level GL. (line 10210)
* glConvolutionParameteriv: Low-Level GL. (line 10212)
* glCopyColorSubTable: Low-Level GL. (line 10283)
* glCopyColorTable: Low-Level GL. (line 10323)
* glCopyConvolutionFilter1D: Low-Level GL. (line 10424)
* glCopyConvolutionFilter2D: Low-Level GL. (line 10534)
* glCopyPixels: Low-Level GL. (line 10653)
* glCopyTexImage1D: Low-Level GL. (line 10813)
* glCopyTexImage2D: Low-Level GL. (line 10920)
* glCopyTexSubImage1D: Low-Level GL. (line 11038)
* glCopyTexSubImage2D: Low-Level GL. (line 11101)
* glCopyTexSubImage3D: Low-Level GL. (line 11193)
* glCreateProgram: Low-Level GL. (line 11281)
* glCreateShader: Low-Level GL. (line 11311)
* glCullFace: Low-Level GL. (line 11343)
* glDeleteBuffers: Low-Level GL. (line 11368)
* glDeleteLists: Low-Level GL. (line 11393)
* glDeleteProgram: Low-Level GL. (line 11419)
* glDeleteQueries: Low-Level GL. (line 11450)
* glDeleteShader: Low-Level GL. (line 11473)
* glDeleteTextures: Low-Level GL. (line 11501)
* glDepthFunc: Low-Level GL. (line 11525)
* glDepthMask: Low-Level GL. (line 11582)
* glDepthRange: Low-Level GL. (line 11600)
* glDetachShader: Low-Level GL. (line 11628)
* glDisable: Low-Level GL. (line 12579)
* glDisableClientState: Low-Level GL. (line 12478)
* glDisableVertexAttribArray: Low-Level GL. (line 12553)
* glDrawArrays: Low-Level GL. (line 11663)
* glDrawBuffer: Low-Level GL. (line 11789)
* glDrawBuffers: Low-Level GL. (line 11710)
* glDrawElements: Low-Level GL. (line 11874)
* glDrawPixels: Low-Level GL. (line 11927)
* glDrawRangeElements: Low-Level GL. (line 12339)
* glEdgeFlag: Low-Level GL. (line 12452)
* glEdgeFlagPointer: Low-Level GL. (line 12414)
* glEdgeFlagv: Low-Level GL. (line 12453)
* glEnable: Low-Level GL. (line 12578)
* glEnableClientState: Low-Level GL. (line 12477)
* glEnableVertexAttribArray: Low-Level GL. (line 12552)
* glEnd: Low-Level GL. (line 7354)
* glEndList: Low-Level GL. (line 21235)
* glEndQuery: Low-Level GL. (line 7307)
* glEvalCoord1d: Low-Level GL. (line 12989)
* glEvalCoord1dv: Low-Level GL. (line 12993)
* glEvalCoord1f: Low-Level GL. (line 12988)
* glEvalCoord1fv: Low-Level GL. (line 12992)
* glEvalCoord2d: Low-Level GL. (line 12991)
* glEvalCoord2dv: Low-Level GL. (line 12995)
* glEvalCoord2f: Low-Level GL. (line 12990)
* glEvalCoord2fv: Low-Level GL. (line 12994)
* glEvalMesh1: Low-Level GL. (line 13062)
* glEvalMesh2: Low-Level GL. (line 13063)
* glEvalPoint1: Low-Level GL. (line 13161)
* glEvalPoint2: Low-Level GL. (line 13162)
* glFeedbackBuffer: Low-Level GL. (line 13199)
* glFinish: Low-Level GL. (line 13331)
* glFlush: Low-Level GL. (line 13343)
* glFogCoordd: Low-Level GL. (line 13411)
* glFogCoorddv: Low-Level GL. (line 13413)
* glFogCoordf: Low-Level GL. (line 13412)
* glFogCoordfv: Low-Level GL. (line 13414)
* glFogCoordPointer: Low-Level GL. (line 13364)
* glFogf: Low-Level GL. (line 13424)
* glFogfv: Low-Level GL. (line 13426)
* glFogi: Low-Level GL. (line 13425)
* glFogiv: Low-Level GL. (line 13427)
* glFrontFace: Low-Level GL. (line 13528)
* glFrustum: Low-Level GL. (line 13561)
* glGenBuffers: Low-Level GL. (line 13613)
* glGenLists: Low-Level GL. (line 13641)
* glGenQueries: Low-Level GL. (line 13660)
* glGenTextures: Low-Level GL. (line 13688)
* glGetActiveAttrib: Low-Level GL. (line 13717)
* glGetActiveUniform: Low-Level GL. (line 13817)
* glGetAttachedShaders: Low-Level GL. (line 13945)
* glGetAttribLocation: Low-Level GL. (line 13990)
* glGetBooleanv: Low-Level GL. (line 16771)
* glGetBufferParameteriv: Low-Level GL. (line 14034)
* glGetBufferPointerv: Low-Level GL. (line 14081)
* glGetBufferSubData: Low-Level GL. (line 14113)
* glGetClipPlane: Low-Level GL. (line 14158)
* glGetColorTable: Low-Level GL. (line 14261)
* glGetColorTableParameterfv: Low-Level GL. (line 14182)
* glGetColorTableParameteriv: Low-Level GL. (line 14183)
* glGetCompressedTexImage: Low-Level GL. (line 14365)
* glGetConvolutionFilter: Low-Level GL. (line 14432)
* glGetConvolutionParameterfv: Low-Level GL. (line 14535)
* glGetConvolutionParameteriv: Low-Level GL. (line 14536)
* glGetDoublev: Low-Level GL. (line 16772)
* glGetError: Low-Level GL. (line 14617)
* glGetFloatv: Low-Level GL. (line 16773)
* glGetHistogram: Low-Level GL. (line 14754)
* glGetHistogramParameterfv: Low-Level GL. (line 14692)
* glGetHistogramParameteriv: Low-Level GL. (line 14693)
* glGetIntegerv: Low-Level GL. (line 16774)
* glGetLightfv: Low-Level GL. (line 14858)
* glGetLightiv: Low-Level GL. (line 14859)
* glGetMapdv: Low-Level GL. (line 14989)
* glGetMapfv: Low-Level GL. (line 14990)
* glGetMapiv: Low-Level GL. (line 14991)
* glGetMaterialfv: Low-Level GL. (line 15056)
* glGetMaterialiv: Low-Level GL. (line 15057)
* glGetMinmax: Low-Level GL. (line 15178)
* glGetMinmaxParameterfv: Low-Level GL. (line 15143)
* glGetMinmaxParameteriv: Low-Level GL. (line 15144)
* glGetPixelMapfv: Low-Level GL. (line 15292)
* glGetPixelMapuiv: Low-Level GL. (line 15293)
* glGetPixelMapusv: Low-Level GL. (line 15294)
* glGetPointerv: Low-Level GL. (line 15363)
* glGetPolygonStipple: Low-Level GL. (line 15392)
* glGetProgramInfoLog: Low-Level GL. (line 15424)
* glGetProgramiv: Low-Level GL. (line 15476)
* glGetQueryiv: Low-Level GL. (line 15561)
* glGetQueryObjectiv: Low-Level GL. (line 15599)
* glGetQueryObjectuiv: Low-Level GL. (line 15600)
* glGetSeparableFilter: Low-Level GL. (line 15643)
* glGetShaderInfoLog: Low-Level GL. (line 15756)
* glGetShaderiv: Low-Level GL. (line 15851)
* glGetShaderSource: Low-Level GL. (line 15806)
* glGetString: Low-Level GL. (line 15907)
* glGetTexEnvfv: Low-Level GL. (line 15973)
* glGetTexEnviv: Low-Level GL. (line 15974)
* glGetTexGendv: Low-Level GL. (line 16118)
* glGetTexGenfv: Low-Level GL. (line 16119)
* glGetTexGeniv: Low-Level GL. (line 16120)
* glGetTexImage: Low-Level GL. (line 16169)
* glGetTexLevelParameterfv: Low-Level GL. (line 16292)
* glGetTexLevelParameteriv: Low-Level GL. (line 16293)
* glGetTexParameterfv: Low-Level GL. (line 16424)
* glGetTexParameteriv: Low-Level GL. (line 16425)
* glGetUniformfv: Low-Level GL. (line 16593)
* glGetUniformiv: Low-Level GL. (line 16594)
* glGetUniformLocation: Low-Level GL. (line 16539)
* glGetVertexAttribdv: Low-Level GL. (line 16678)
* glGetVertexAttribfv: Low-Level GL. (line 16679)
* glGetVertexAttribiv: Low-Level GL. (line 16680)
* glGetVertexAttribPointerv: Low-Level GL. (line 16647)
* glHint: Low-Level GL. (line 18982)
* glHistogram: Low-Level GL. (line 19086)
* glIndexd: Low-Level GL. (line 19236)
* glIndexdv: Low-Level GL. (line 19241)
* glIndexf: Low-Level GL. (line 19235)
* glIndexfv: Low-Level GL. (line 19240)
* glIndexi: Low-Level GL. (line 19234)
* glIndexiv: Low-Level GL. (line 19239)
* glIndexMask: Low-Level GL. (line 19164)
* glIndexPointer: Low-Level GL. (line 19187)
* glIndexs: Low-Level GL. (line 19233)
* glIndexsv: Low-Level GL. (line 19238)
* glIndexub: Low-Level GL. (line 19237)
* glIndexubv: Low-Level GL. (line 19242)
* glInitNames: Low-Level GL. (line 19262)
* glInterleavedArrays: Low-Level GL. (line 19278)
* glIsBuffer: Low-Level GL. (line 19321)
* glIsEnabled: Low-Level GL. (line 19340)
* glIsList: Low-Level GL. (line 19580)
* glIsProgram: Low-Level GL. (line 19597)
* glIsQuery: Low-Level GL. (line 19613)
* glIsShader: Low-Level GL. (line 19632)
* glIsTexture: Low-Level GL. (line 19648)
* glLightf: Low-Level GL. (line 19775)
* glLightfv: Low-Level GL. (line 19777)
* glLighti: Low-Level GL. (line 19776)
* glLightiv: Low-Level GL. (line 19778)
* glLightModelf: Low-Level GL. (line 19666)
* glLightModelfv: Low-Level GL. (line 19668)
* glLightModeli: Low-Level GL. (line 19667)
* glLightModeliv: Low-Level GL. (line 19669)
* glLineStipple: Low-Level GL. (line 19928)
* glLineWidth: Low-Level GL. (line 19975)
* glLinkProgram: Low-Level GL. (line 20022)
* glListBase: Low-Level GL. (line 20129)
* glLoadIdentity: Low-Level GL. (line 20145)
* glLoadMatrixd: Low-Level GL. (line 20160)
* glLoadMatrixf: Low-Level GL. (line 20161)
* glLoadName: Low-Level GL. (line 20192)
* glLoadTransposeMatrixd: Low-Level GL. (line 20217)
* glLoadTransposeMatrixf: Low-Level GL. (line 20218)
* glLogicOp: Low-Level GL. (line 20254)
* glMap1d: Low-Level GL. (line 20339)
* glMap1f: Low-Level GL. (line 20338)
* glMap2d: Low-Level GL. (line 20494)
* glMap2f: Low-Level GL. (line 20492)
* glMapBuffer: Low-Level GL. (line 20684)
* glMapGrid1d: Low-Level GL. (line 20759)
* glMapGrid1f: Low-Level GL. (line 20760)
* glMapGrid2d: Low-Level GL. (line 20761)
* glMapGrid2f: Low-Level GL. (line 20762)
* glMaterialf: Low-Level GL. (line 20820)
* glMaterialfv: Low-Level GL. (line 20822)
* glMateriali: Low-Level GL. (line 20821)
* glMaterialiv: Low-Level GL. (line 20823)
* glMatrixMode: Low-Level GL. (line 20926)
* glMinmax: Low-Level GL. (line 20965)
* glMultiDrawArrays: Low-Level GL. (line 21026)
* glMultiDrawElements: Low-Level GL. (line 21080)
* glMultiTexCoord1d: Low-Level GL. (line 21136)
* glMultiTexCoord1dv: Low-Level GL. (line 21152)
* glMultiTexCoord1f: Low-Level GL. (line 21135)
* glMultiTexCoord1fv: Low-Level GL. (line 21151)
* glMultiTexCoord1i: Low-Level GL. (line 21134)
* glMultiTexCoord1iv: Low-Level GL. (line 21150)
* glMultiTexCoord1s: Low-Level GL. (line 21133)
* glMultiTexCoord1sv: Low-Level GL. (line 21149)
* glMultiTexCoord2d: Low-Level GL. (line 21140)
* glMultiTexCoord2dv: Low-Level GL. (line 21156)
* glMultiTexCoord2f: Low-Level GL. (line 21139)
* glMultiTexCoord2fv: Low-Level GL. (line 21155)
* glMultiTexCoord2i: Low-Level GL. (line 21138)
* glMultiTexCoord2iv: Low-Level GL. (line 21154)
* glMultiTexCoord2s: Low-Level GL. (line 21137)
* glMultiTexCoord2sv: Low-Level GL. (line 21153)
* glMultiTexCoord3d: Low-Level GL. (line 21144)
* glMultiTexCoord3dv: Low-Level GL. (line 21160)
* glMultiTexCoord3f: Low-Level GL. (line 21143)
* glMultiTexCoord3fv: Low-Level GL. (line 21159)
* glMultiTexCoord3i: Low-Level GL. (line 21142)
* glMultiTexCoord3iv: Low-Level GL. (line 21158)
* glMultiTexCoord3s: Low-Level GL. (line 21141)
* glMultiTexCoord3sv: Low-Level GL. (line 21157)
* glMultiTexCoord4d: Low-Level GL. (line 21148)
* glMultiTexCoord4dv: Low-Level GL. (line 21164)
* glMultiTexCoord4f: Low-Level GL. (line 21147)
* glMultiTexCoord4fv: Low-Level GL. (line 21163)
* glMultiTexCoord4i: Low-Level GL. (line 21146)
* glMultiTexCoord4iv: Low-Level GL. (line 21162)
* glMultiTexCoord4s: Low-Level GL. (line 21145)
* glMultiTexCoord4sv: Low-Level GL. (line 21161)
* glMultMatrixd: Low-Level GL. (line 21194)
* glMultMatrixf: Low-Level GL. (line 21195)
* glMultTransposeMatrixd: Low-Level GL. (line 21213)
* glMultTransposeMatrixf: Low-Level GL. (line 21214)
* glNewList: Low-Level GL. (line 21234)
* glNormal3b: Low-Level GL. (line 21362)
* glNormal3bv: Low-Level GL. (line 21367)
* glNormal3d: Low-Level GL. (line 21363)
* glNormal3dv: Low-Level GL. (line 21368)
* glNormal3f: Low-Level GL. (line 21364)
* glNormal3fv: Low-Level GL. (line 21369)
* glNormal3i: Low-Level GL. (line 21365)
* glNormal3iv: Low-Level GL. (line 21370)
* glNormal3s: Low-Level GL. (line 21366)
* glNormal3sv: Low-Level GL. (line 21371)
* glNormalPointer: Low-Level GL. (line 21315)
* glOrtho: Low-Level GL. (line 21398)
* glPassThrough: Low-Level GL. (line 21447)
* glPixelMapfv: Low-Level GL. (line 21473)
* glPixelMapuiv: Low-Level GL. (line 21474)
* glPixelMapusv: Low-Level GL. (line 21475)
* glPixelStoref: Low-Level GL. (line 21649)
* glPixelStorei: Low-Level GL. (line 21650)
* glPixelTransferf: Low-Level GL. (line 21953)
* glPixelTransferi: Low-Level GL. (line 21954)
* glPixelZoom: Low-Level GL. (line 22244)
* glPointParameterf: Low-Level GL. (line 22272)
* glPointParameterfv: Low-Level GL. (line 22274)
* glPointParameteri: Low-Level GL. (line 22273)
* glPointParameteriv: Low-Level GL. (line 22275)
* glPointSize: Low-Level GL. (line 22329)
* glPolygonMode: Low-Level GL. (line 22417)
* glPolygonOffset: Low-Level GL. (line 22469)
* glPolygonStipple: Low-Level GL. (line 22499)
* glPopAttrib: Low-Level GL. (line 22597)
* glPopClientAttrib: Low-Level GL. (line 23103)
* glPopMatrix: Low-Level GL. (line 23142)
* glPopName: Low-Level GL. (line 23177)
* glPrioritizeTextures: Low-Level GL. (line 22548)
* glPushAttrib: Low-Level GL. (line 22596)
* glPushClientAttrib: Low-Level GL. (line 23102)
* glPushMatrix: Low-Level GL. (line 23141)
* glPushName: Low-Level GL. (line 23176)
* glRasterPos2d: Low-Level GL. (line 23215)
* glRasterPos2dv: Low-Level GL. (line 23227)
* glRasterPos2f: Low-Level GL. (line 23214)
* glRasterPos2fv: Low-Level GL. (line 23226)
* glRasterPos2i: Low-Level GL. (line 23213)
* glRasterPos2iv: Low-Level GL. (line 23225)
* glRasterPos2s: Low-Level GL. (line 23212)
* glRasterPos2sv: Low-Level GL. (line 23224)
* glRasterPos3d: Low-Level GL. (line 23219)
* glRasterPos3dv: Low-Level GL. (line 23231)
* glRasterPos3f: Low-Level GL. (line 23218)
* glRasterPos3fv: Low-Level GL. (line 23230)
* glRasterPos3i: Low-Level GL. (line 23217)
* glRasterPos3iv: Low-Level GL. (line 23229)
* glRasterPos3s: Low-Level GL. (line 23216)
* glRasterPos3sv: Low-Level GL. (line 23228)
* glRasterPos4d: Low-Level GL. (line 23223)
* glRasterPos4dv: Low-Level GL. (line 23235)
* glRasterPos4f: Low-Level GL. (line 23222)
* glRasterPos4fv: Low-Level GL. (line 23234)
* glRasterPos4i: Low-Level GL. (line 23221)
* glRasterPos4iv: Low-Level GL. (line 23233)
* glRasterPos4s: Low-Level GL. (line 23220)
* glRasterPos4sv: Low-Level GL. (line 23232)
* glReadBuffer: Low-Level GL. (line 23300)
* glReadPixels: Low-Level GL. (line 23339)
* glRectd: Low-Level GL. (line 23585)
* glRectdv: Low-Level GL. (line 23589)
* glRectf: Low-Level GL. (line 23586)
* glRectfv: Low-Level GL. (line 23590)
* glRecti: Low-Level GL. (line 23587)
* glRectiv: Low-Level GL. (line 23591)
* glRects: Low-Level GL. (line 23588)
* glRectsv: Low-Level GL. (line 23592)
* glRenderMode: Low-Level GL. (line 23626)
* glResetHistogram: Low-Level GL. (line 23692)
* glResetMinmax: Low-Level GL. (line 23707)
* glRotated: Low-Level GL. (line 23724)
* glRotatef: Low-Level GL. (line 23725)
* glSampleCoverage: Low-Level GL. (line 23759)
* glScaled: Low-Level GL. (line 23798)
* glScalef: Low-Level GL. (line 23799)
* glScissor: Low-Level GL. (line 23829)
* glSecondaryColor3b: Low-Level GL. (line 23921)
* glSecondaryColor3bv: Low-Level GL. (line 23929)
* glSecondaryColor3d: Low-Level GL. (line 23925)
* glSecondaryColor3dv: Low-Level GL. (line 23933)
* glSecondaryColor3f: Low-Level GL. (line 23924)
* glSecondaryColor3fv: Low-Level GL. (line 23932)
* glSecondaryColor3i: Low-Level GL. (line 23923)
* glSecondaryColor3iv: Low-Level GL. (line 23931)
* glSecondaryColor3s: Low-Level GL. (line 23922)
* glSecondaryColor3sv: Low-Level GL. (line 23930)
* glSecondaryColor3ub: Low-Level GL. (line 23926)
* glSecondaryColor3ubv: Low-Level GL. (line 23934)
* glSecondaryColor3ui: Low-Level GL. (line 23928)
* glSecondaryColor3uiv: Low-Level GL. (line 23936)
* glSecondaryColor3us: Low-Level GL. (line 23927)
* glSecondaryColor3usv: Low-Level GL. (line 23935)
* glSecondaryColorPointer: Low-Level GL. (line 23867)
* glSelectBuffer: Low-Level GL. (line 23980)
* glSeparableFilter2D: Low-Level GL. (line 24045)
* glShadeModel: Low-Level GL. (line 24218)
* glShaderSource: Low-Level GL. (line 24276)
* glStencilFunc: Low-Level GL. (line 24416)
* glStencilFuncSeparate: Low-Level GL. (line 24320)
* glStencilMask: Low-Level GL. (line 24540)
* glStencilMaskSeparate: Low-Level GL. (line 24507)
* glStencilOp: Low-Level GL. (line 24675)
* glStencilOpSeparate: Low-Level GL. (line 24568)
* glTexCoord1d: Low-Level GL. (line 24832)
* glTexCoord1dv: Low-Level GL. (line 24848)
* glTexCoord1f: Low-Level GL. (line 24831)
* glTexCoord1fv: Low-Level GL. (line 24847)
* glTexCoord1i: Low-Level GL. (line 24830)
* glTexCoord1iv: Low-Level GL. (line 24846)
* glTexCoord1s: Low-Level GL. (line 24829)
* glTexCoord1sv: Low-Level GL. (line 24845)
* glTexCoord2d: Low-Level GL. (line 24836)
* glTexCoord2dv: Low-Level GL. (line 24852)
* glTexCoord2f: Low-Level GL. (line 24835)
* glTexCoord2fv: Low-Level GL. (line 24851)
* glTexCoord2i: Low-Level GL. (line 24834)
* glTexCoord2iv: Low-Level GL. (line 24850)
* glTexCoord2s: Low-Level GL. (line 24833)
* glTexCoord2sv: Low-Level GL. (line 24849)
* glTexCoord3d: Low-Level GL. (line 24840)
* glTexCoord3dv: Low-Level GL. (line 24856)
* glTexCoord3f: Low-Level GL. (line 24839)
* glTexCoord3fv: Low-Level GL. (line 24855)
* glTexCoord3i: Low-Level GL. (line 24838)
* glTexCoord3iv: Low-Level GL. (line 24854)
* glTexCoord3s: Low-Level GL. (line 24837)
* glTexCoord3sv: Low-Level GL. (line 24853)
* glTexCoord4d: Low-Level GL. (line 24844)
* glTexCoord4dv: Low-Level GL. (line 24860)
* glTexCoord4f: Low-Level GL. (line 24843)
* glTexCoord4fv: Low-Level GL. (line 24859)
* glTexCoord4i: Low-Level GL. (line 24842)
* glTexCoord4iv: Low-Level GL. (line 24858)
* glTexCoord4s: Low-Level GL. (line 24841)
* glTexCoord4sv: Low-Level GL. (line 24857)
* glTexCoordPointer: Low-Level GL. (line 24774)
* glTexEnvf: Low-Level GL. (line 24881)
* glTexEnvfv: Low-Level GL. (line 24883)
* glTexEnvi: Low-Level GL. (line 24882)
* glTexEnviv: Low-Level GL. (line 24884)
* glTexGend: Low-Level GL. (line 25227)
* glTexGendv: Low-Level GL. (line 25230)
* glTexGenf: Low-Level GL. (line 25226)
* glTexGenfv: Low-Level GL. (line 25229)
* glTexGeni: Low-Level GL. (line 25225)
* glTexGeniv: Low-Level GL. (line 25228)
* glTexImage1D: Low-Level GL. (line 25338)
* glTexImage2D: Low-Level GL. (line 25664)
* glTexImage3D: Low-Level GL. (line 26018)
* glTexParameterf: Low-Level GL. (line 26338)
* glTexParameterfv: Low-Level GL. (line 26340)
* glTexParameteri: Low-Level GL. (line 26339)
* glTexParameteriv: Low-Level GL. (line 26341)
* glTexSubImage1D: Low-Level GL. (line 26618)
* glTexSubImage2D: Low-Level GL. (line 26733)
* glTexSubImage3D: Low-Level GL. (line 26866)
* glTranslated: Low-Level GL. (line 27000)
* glTranslatef: Low-Level GL. (line 27001)
* glu-perspective: Matrix Manipulation.
(line 27774)
* gluBeginCurve: Low-Level GLU. (line 27812)
* gluBeginPolygon: Low-Level GLU. (line 27833)
* gluBeginSurface: Low-Level GLU. (line 27852)
* gluBeginTrim: Low-Level GLU. (line 27877)
* gluBuild1DMipmapLevels: Low-Level GLU. (line 27935)
* gluBuild1DMipmaps: Low-Level GLU. (line 28067)
* gluBuild2DMipmapLevels: Low-Level GLU. (line 28189)
* gluBuild2DMipmaps: Low-Level GLU. (line 28325)
* gluBuild3DMipmapLevels: Low-Level GLU. (line 28458)
* gluBuild3DMipmaps: Low-Level GLU. (line 28595)
* gluCheckExtension: Low-Level GLU. (line 28728)
* gluCylinder: Low-Level GLU. (line 28746)
* gluDeleteNurbsRenderer: Low-Level GLU. (line 28784)
* gluDeleteQuadric: Low-Level GLU. (line 28795)
* gluDeleteTess: Low-Level GLU. (line 28805)
* gluDisk: Low-Level GLU. (line 28814)
* gluEndCurve: Low-Level GLU. (line 27813)
* gluEndPolygon: Low-Level GLU. (line 27834)
* gluEndSurface: Low-Level GLU. (line 27853)
* gluEndTrim: Low-Level GLU. (line 27878)
* gluErrorString: Low-Level GLU. (line 28850)
* gluGetNurbsProperty: Low-Level GLU. (line 28868)
* gluGetString: Low-Level GLU. (line 28891)
* gluGetTessProperty: Low-Level GLU. (line 28923)
* gluLoadSamplingMatrices: Low-Level GLU. (line 28943)
* gluLookAt: Low-Level GLU. (line 28975)
* gluNewNurbsRenderer: Low-Level GLU. (line 29029)
* gluNewQuadric: Low-Level GLU. (line 29037)
* gluNewTess: Low-Level GLU. (line 29045)
* gluNextContour: Low-Level GLU. (line 29053)
* glUniform1f: Low-Level GL. (line 27026)
* glUniform1fv: Low-Level GL. (line 27034)
* glUniform1i: Low-Level GL. (line 27030)
* glUniform1iv: Low-Level GL. (line 27038)
* glUniform2f: Low-Level GL. (line 27027)
* glUniform2fv: Low-Level GL. (line 27035)
* glUniform2i: Low-Level GL. (line 27031)
* glUniform2iv: Low-Level GL. (line 27039)
* glUniform3f: Low-Level GL. (line 27028)
* glUniform3fv: Low-Level GL. (line 27036)
* glUniform3i: Low-Level GL. (line 27032)
* glUniform3iv: Low-Level GL. (line 27040)
* glUniform4f: Low-Level GL. (line 27029)
* glUniform4fv: Low-Level GL. (line 27037)
* glUniform4i: Low-Level GL. (line 27033)
* glUniform4iv: Low-Level GL. (line 27041)
* glUniformMatrix2fv: Low-Level GL. (line 27042)
* glUniformMatrix2x3fv: Low-Level GL. (line 27045)
* glUniformMatrix2x4fv: Low-Level GL. (line 27047)
* glUniformMatrix3fv: Low-Level GL. (line 27043)
* glUniformMatrix3x2fv: Low-Level GL. (line 27046)
* glUniformMatrix3x4fv: Low-Level GL. (line 27049)
* glUniformMatrix4fv: Low-Level GL. (line 27044)
* glUniformMatrix4x2fv: Low-Level GL. (line 27048)
* glUniformMatrix4x3fv: Low-Level GL. (line 27050)
* glUnmapBuffer: Low-Level GL. (line 20685)
* gluNurbsCallback: Low-Level GLU. (line 29141)
* gluNurbsCallbackData: Low-Level GLU. (line 29126)
* gluNurbsCallbackDataEXT: Low-Level GLU. (line 29111)
* gluNurbsCurve: Low-Level GLU. (line 29345)
* gluNurbsProperty: Low-Level GLU. (line 29401)
* gluNurbsSurface: Low-Level GLU. (line 29547)
* gluOrtho2D: Low-Level GLU. (line 29624)
* gluPartialDisk: Low-Level GLU. (line 29640)
* gluPerspective: Low-Level GLU. (line 29690)
* gluPickMatrix: Low-Level GLU. (line 29730)
* gluProject: Low-Level GLU. (line 29769)
* gluPwlCurve: Low-Level GLU. (line 29815)
* gluQuadricCallback: Low-Level GLU. (line 29851)
* gluQuadricDrawStyle: Low-Level GLU. (line 29877)
* gluQuadricNormals: Low-Level GLU. (line 29905)
* gluQuadricOrientation: Low-Level GLU. (line 29928)
* gluQuadricTexture: Low-Level GLU. (line 29952)
* gluScaleImage: Low-Level GLU. (line 29971)
* glUseProgram: Low-Level GL. (line 27163)
* gluSphere: Low-Level GLU. (line 30070)
* glut-main-loop: Beginning Event Processing.
(line 33036)
* gluTessBeginContour: Low-Level GLU. (line 30104)
* gluTessBeginPolygon: Low-Level GLU. (line 30120)
* gluTessCallback: Low-Level GLU. (line 30149)
* gluTessEndContour: Low-Level GLU. (line 30105)
* gluTessEndPolygon: Low-Level GLU. (line 30376)
* gluTessNormal: Low-Level GLU. (line 30397)
* gluTessProperty: Low-Level GLU. (line 30434)
* gluTessVertex: Low-Level GLU. (line 30511)
* gluUnProject: Low-Level GLU. (line 30593)
* gluUnProject4: Low-Level GLU. (line 30536)
* glValidateProgram: Low-Level GL. (line 27271)
* glVertex2d: Low-Level GL. (line 27572)
* glVertex2dv: Low-Level GL. (line 27584)
* glVertex2f: Low-Level GL. (line 27571)
* glVertex2fv: Low-Level GL. (line 27583)
* glVertex2i: Low-Level GL. (line 27570)
* glVertex2iv: Low-Level GL. (line 27582)
* glVertex2s: Low-Level GL. (line 27569)
* glVertex2sv: Low-Level GL. (line 27581)
* glVertex3d: Low-Level GL. (line 27576)
* glVertex3dv: Low-Level GL. (line 27588)
* glVertex3f: Low-Level GL. (line 27575)
* glVertex3fv: Low-Level GL. (line 27587)
* glVertex3i: Low-Level GL. (line 27574)
* glVertex3iv: Low-Level GL. (line 27586)
* glVertex3s: Low-Level GL. (line 27573)
* glVertex3sv: Low-Level GL. (line 27585)
* glVertex4d: Low-Level GL. (line 27580)
* glVertex4dv: Low-Level GL. (line 27592)
* glVertex4f: Low-Level GL. (line 27579)
* glVertex4fv: Low-Level GL. (line 27591)
* glVertex4i: Low-Level GL. (line 27578)
* glVertex4iv: Low-Level GL. (line 27590)
* glVertex4s: Low-Level GL. (line 27577)
* glVertex4sv: Low-Level GL. (line 27589)
* glVertexAttrib1d: Low-Level GL. (line 27388)
* glVertexAttrib1dv: Low-Level GL. (line 27401)
* glVertexAttrib1f: Low-Level GL. (line 27386)
* glVertexAttrib1fv: Low-Level GL. (line 27399)
* glVertexAttrib1s: Low-Level GL. (line 27387)
* glVertexAttrib1sv: Low-Level GL. (line 27400)
* glVertexAttrib2d: Low-Level GL. (line 27391)
* glVertexAttrib2dv: Low-Level GL. (line 27404)
* glVertexAttrib2f: Low-Level GL. (line 27389)
* glVertexAttrib2fv: Low-Level GL. (line 27402)
* glVertexAttrib2s: Low-Level GL. (line 27390)
* glVertexAttrib2sv: Low-Level GL. (line 27403)
* glVertexAttrib3d: Low-Level GL. (line 27394)
* glVertexAttrib3dv: Low-Level GL. (line 27407)
* glVertexAttrib3f: Low-Level GL. (line 27392)
* glVertexAttrib3fv: Low-Level GL. (line 27405)
* glVertexAttrib3s: Low-Level GL. (line 27393)
* glVertexAttrib3sv: Low-Level GL. (line 27406)
* glVertexAttrib4bv: Low-Level GL. (line 27412)
* glVertexAttrib4d: Low-Level GL. (line 27397)
* glVertexAttrib4dv: Low-Level GL. (line 27410)
* glVertexAttrib4f: Low-Level GL. (line 27395)
* glVertexAttrib4fv: Low-Level GL. (line 27408)
* glVertexAttrib4iv: Low-Level GL. (line 27411)
* glVertexAttrib4Nbv: Low-Level GL. (line 27416)
* glVertexAttrib4Niv: Low-Level GL. (line 27418)
* glVertexAttrib4Nsv: Low-Level GL. (line 27417)
* glVertexAttrib4Nub: Low-Level GL. (line 27398)
* glVertexAttrib4Nubv: Low-Level GL. (line 27419)
* glVertexAttrib4Nuiv: Low-Level GL. (line 27421)
* glVertexAttrib4Nusv: Low-Level GL. (line 27420)
* glVertexAttrib4s: Low-Level GL. (line 27396)
* glVertexAttrib4sv: Low-Level GL. (line 27409)
* glVertexAttrib4ubv: Low-Level GL. (line 27413)
* glVertexAttrib4uiv: Low-Level GL. (line 27415)
* glVertexAttrib4usv: Low-Level GL. (line 27414)
* glVertexAttribPointer: Low-Level GL. (line 27311)
* glVertexPointer: Low-Level GL. (line 27516)
* glViewport: Low-Level GL. (line 27610)
* glWindowPos2d: Low-Level GL. (line 27647)
* glWindowPos2dv: Low-Level GL. (line 27655)
* glWindowPos2f: Low-Level GL. (line 27646)
* glWindowPos2fv: Low-Level GL. (line 27654)
* glWindowPos2i: Low-Level GL. (line 27645)
* glWindowPos2iv: Low-Level GL. (line 27653)
* glWindowPos2s: Low-Level GL. (line 27644)
* glWindowPos2sv: Low-Level GL. (line 27652)
* glWindowPos3d: Low-Level GL. (line 27651)
* glWindowPos3dv: Low-Level GL. (line 27659)
* glWindowPos3f: Low-Level GL. (line 27650)
* glWindowPos3fv: Low-Level GL. (line 27658)
* glWindowPos3i: Low-Level GL. (line 27649)
* glWindowPos3iv: Low-Level GL. (line 27657)
* glWindowPos3s: Low-Level GL. (line 27648)
* glWindowPos3sv: Low-Level GL. (line 27656)
* glx-amd-gpu-association: GLX Enumerations. (line 30854)
* glx-arb-create-context-robustness: GLX Enumerations. (line 30864)
* glx-attribute: GLX Enumerations. (line 30762)
* glx-bind-to-texture-target-mask: GLX Enumerations. (line 30737)
* glx-context-flags: GLX Enumerations. (line 30745)
* glx-context-profile-mask: GLX Enumerations. (line 30753)
* glx-drawable-type-mask: GLX Enumerations. (line 30669)
* glx-error-code: GLX Enumerations. (line 30660)
* glx-event-mask: GLX Enumerations. (line 30693)
* glx-hyperpipe-attrib: GLX Enumerations. (line 30722)
* glx-hyperpipe-misc: GLX Enumerations. (line 30730)
* glx-hyperpipe-type-mask: GLX Enumerations. (line 30715)
* glx-pbuffer-clobber-mask: GLX Enumerations. (line 30701)
* glx-render-type-mask: GLX Enumerations. (line 30677)
* glx-string-name: GLX Enumerations. (line 30653)
* glx-sync-type: GLX Enumerations. (line 30686)
* glXChooseFBConfig: Low-Level GLX. (line 30896)
* glXChooseVisual: Low-Level GLX. (line 31229)
* glXCopyContext: Low-Level GLX. (line 31364)
* glXCreateContext: Low-Level GLX. (line 31415)
* glXCreateGLXPixmap: Low-Level GLX. (line 31482)
* glXCreateNewContext: Low-Level GLX. (line 31526)
* glXCreatePbuffer: Low-Level GLX. (line 31599)
* glXCreatePixmap: Low-Level GLX. (line 31664)
* glXCreateWindow: Low-Level GLX. (line 31703)
* glXDestroyContext: Low-Level GLX. (line 31744)
* glXDestroyGLXPixmap: Low-Level GLX. (line 31760)
* glXDestroyPbuffer: Low-Level GLX. (line 31776)
* glXDestroyPixmap: Low-Level GLX. (line 31790)
* glXDestroyWindow: Low-Level GLX. (line 31804)
* glXFreeContextEXT: Low-Level GLX. (line 31818)
* glXGetClientString: Low-Level GLX. (line 31841)
* glXGetConfig: Low-Level GLX. (line 31872)
* glXGetContextIDEXT: Low-Level GLX. (line 32003)
* glXGetCurrentContext: Low-Level GLX. (line 32024)
* glXGetCurrentDisplay: Low-Level GLX. (line 32034)
* glXGetCurrentDrawable: Low-Level GLX. (line 32044)
* glXGetCurrentReadDrawable: Low-Level GLX. (line 32054)
* glXGetFBConfigAttrib: Low-Level GLX. (line 32064)
* glXGetFBConfigs: Low-Level GLX. (line 32282)
* glXGetProcAddress: Low-Level GLX. (line 32298)
* glXGetSelectedEvent: Low-Level GLX. (line 32310)
* glXGetVisualFromFBConfig: Low-Level GLX. (line 32330)
* glXImportContextEXT: Low-Level GLX. (line 32347)
* glXIsDirect: Low-Level GLX. (line 32386)
* glXMakeContextCurrent: Low-Level GLX. (line 32403)
* glXMakeCurrent: Low-Level GLX. (line 32490)
* glXQueryContext: Low-Level GLX. (line 32605)
* glXQueryContextInfoEXT: Low-Level GLX. (line 32555)
* glXQueryDrawable: Low-Level GLX. (line 32642)
* glXQueryExtension: Low-Level GLX. (line 32708)
* glXQueryExtensionsString: Low-Level GLX. (line 32693)
* glXQueryServerString: Low-Level GLX. (line 32730)
* glXQueryVersion: Low-Level GLX. (line 32749)
* glXSelectEvent: Low-Level GLX. (line 32775)
* glXSwapBuffers: Low-Level GLX. (line 32903)
* glXUseXFont: Low-Level GLX. (line 32934)
* glXWaitGL: Low-Level GLX. (line 32979)
* glXWaitX: Low-Level GLX. (line 32995)
* hide-window: Window Management. (line 33085)
* hint-mode: GL Enumerations. (line 1982)
* hint-target: GL Enumerations. (line 1989)
* histogram-target-ext: GL Enumerations. (line 2000)
* hp-convolution-border-modes: GL Enumerations. (line 3253)
* ibm-texture-mirrored-repeat: GL Enumerations. (line 3789)
* iconify-window: Window Management. (line 33087)
* img-multisampled-render-to-texture: GL Enumerations. (line 6744)
* img-program-binary: GL Enumerations. (line 6737)
* img-shader-binary: GL Enumerations. (line 5794)
* img-texture-compression-pvrtc: GL Enumerations. (line 5784)
* img-texture-compression-pvrtc-2: GL Enumerations. (line 6753)
* img-texture-env-enhanced-fixed-function: GL Enumerations. (line 4578)
* index-pointer-type: GL Enumerations. (line 2007)
* ingr-color-clamp: GL Enumerations. (line 4290)
* ingr-interlace-read: GL Enumerations. (line 4300)
* initial-display-mode: State Retrieval. (line 33200)
* initial-window-height: State Retrieval. (line 33202)
* initial-window-position: State Retrieval. (line 33204)
* initial-window-size: State Retrieval. (line 33206)
* initial-window-width: State Retrieval. (line 33208)
* initial-window-x: State Retrieval. (line 33210)
* initial-window-y: State Retrieval. (line 33212)
* initialize-glut: GLUT Initialization.
(line 33030)
* intel-map-texture: GL Enumerations. (line 1047)
* intel-parallel-arrays: GL Enumerations. (line 3840)
* interleaved-array-format: GL Enumerations. (line 2620)
* khr-debug: GL Enumerations. (line 884)
* light-env-mode-sgix: GL Enumerations. (line 2014)
* light-env-parameter-sgix: GL Enumerations. (line 2021)
* light-model-color-control: GL Enumerations. (line 2028)
* light-model-parameter: GL Enumerations. (line 2035)
* light-name: GL Enumerations. (line 2644)
* light-parameter: GL Enumerations. (line 2043)
* list-mode: GL Enumerations. (line 2052)
* list-name-type: GL Enumerations. (line 2153)
* list-parameter-name: GL Enumerations. (line 2161)
* logic-op: GL Enumerations. (line 2168)
* make-sub-window: Window Management. (line 33065)
* make-window: Window Management. (line 33067)
* map-target: GL Enumerations. (line 2177)
* material-face: GL Enumerations. (line 2191)
* material-parameter: GL Enumerations. (line 2198)
* matrix-mode: GL Enumerations. (line 2206)
* mesa-pack-invert: GL Enumerations. (line 4747)
* mesa-packed-depth-stencil: GL Enumerations. (line 4728)
* mesa-program-debug: GL Enumerations. (line 5752)
* mesa-shader-debug: GL Enumerations. (line 4763)
* mesa-trace: GL Enumerations. (line 4737)
* mesa-ycbcr-texture: GL Enumerations. (line 4404)
* mesax-texture-stack: GL Enumerations. (line 4754)
* mesh-mode-1: GL Enumerations. (line 2213)
* mesh-mode-2: GL Enumerations. (line 2220)
* minmax-target-ext: GL Enumerations. (line 2227)
* normal-pointer-type: GL Enumerations. (line 2234)
* nv-compute-program-5: GL Enumerations. (line 6702)
* nv-conditional-render: GL Enumerations. (line 6269)
* nv-copy-depth-to-color: GL Enumerations. (line 5143)
* nv-coverage-sample: GL Enumerations. (line 6425)
* nv-deep-texture-3d: GL Enumerations. (line 6680)
* nv-depth-buffer-float: GL Enumerations. (line 6158)
* nv-depth-clamp: GL Enumerations. (line 4477)
* nv-depth-nonlinear: GL Enumerations. (line 6303)
* nv-draw-buffers: GL Enumerations. (line 5000)
* nv-evaluators: GL Enumerations. (line 4595)
* nv-explicit-multisample: GL Enumerations. (line 6372)
* nv-fbo-color-attachments: GL Enumerations. (line 6036)
* nv-fence: GL Enumerations. (line 4052)
* nv-float-buffer: GL Enumerations. (line 5171)
* nv-fog-distance: GL Enumerations. (line 4276)
* nv-fragment-program: GL Enumerations. (line 5134)
* nv-fragment-program-2: GL Enumerations. (line 5267)
* nv-framebuffer-blit: GL Enumerations. (line 5986)
* nv-framebuffer-multisample: GL Enumerations. (line 6010)
* nv-framebuffer-multisample-coverage: GL Enumerations. (line 6018)
* nv-geometry-program-4: GL Enumerations. (line 1182)
* nv-gpu-program-4: GL Enumerations. (line 5319)
* nv-gpu-program-5: GL Enumerations. (line 6384)
* nv-gpu-shader-5: GL Enumerations. (line 1226)
* nv-half-float: GL Enumerations. (line 2108)
* nv-instanced-arrays: GL Enumerations. (line 5312)
* nv-light-max-exponent: GL Enumerations. (line 4161)
* nv-multisample-coverage: GL Enumerations. (line 2998)
* nv-occlusion-query: GL Enumerations. (line 5117)
* nv-packed-depth-stencil: GL Enumerations. (line 4119)
* nv-parameter-buffer-object: GL Enumerations. (line 6147)
* nv-path-rendering: GL Enumerations. (line 6600)
* nv-pixel-data-range: GL Enumerations. (line 5150)
* nv-point-sprite: GL Enumerations. (line 5095)
* nv-present-video: GL Enumerations. (line 6295)
* nv-present-video <1>: GLX Enumerations. (line 30826)
* nv-primitive-restart: GL Enumerations. (line 4269)
* nv-read-buffer: GL Enumerations. (line 1937)
* nv-register-combiners: GL Enumerations. (line 4236)
* nv-register-combiners-2: GL Enumerations. (line 4262)
* nv-s-rgb-formats: GL Enumerations. (line 5241)
* nv-shader-buffer-load: GL Enumerations. (line 6436)
* nv-shader-buffer-store: GL Enumerations. (line 5204)
* nv-shadow-samplers-array: GL Enumerations. (line 6225)
* nv-shadow-samplers-cube: GL Enumerations. (line 6232)
* nv-tessellation-program-5: GL Enumerations. (line 4613)
* nv-texgen-emboss: GL Enumerations. (line 4283)
* nv-texgen-reflection: GL Enumerations. (line 4196)
* nv-texture-border-clamp: GL Enumerations. (line 1975)
* nv-texture-env-combine-4: GL Enumerations. (line 4320)
* nv-texture-expand-normal: GL Enumerations. (line 5182)
* nv-texture-multisample: GL Enumerations. (line 6586)
* nv-texture-rectangle: GL Enumerations. (line 4103)
* nv-texture-shader: GL Enumerations. (line 4623)
* nv-texture-shader-2: GL Enumerations. (line 4668)
* nv-texture-shader-3: GL Enumerations. (line 5071)
* nv-transform-feedback: GL Enumerations. (line 5921)
* nv-transform-feedback-2: GL Enumerations. (line 6286)
* nv-vdpau-interop: GL Enumerations. (line 4660)
* nv-vertex-array-range: GL Enumerations. (line 4217)
* nv-vertex-attrib-integer-64-bit: GL Enumerations. (line 2146)
* nv-vertex-buffer-unified-memory: GL Enumerations. (line 6444)
* nv-vertex-program: GL Enumerations. (line 4426)
* nv-vertex-program-2-option: GL Enumerations. (line 5260)
* nv-vertex-program-3: GL Enumerations. (line 5665)
* nv-vertex-program-4: GL Enumerations. (line 5284)
* nv-video-capture: GL Enumerations. (line 6561)
* oes-blend-equation-separate: GL Enumerations. (line 2802)
* oes-blend-func-separate: GL Enumerations. (line 3080)
* oes-blend-subtract: GL Enumerations. (line 2817)
* oes-compressed-etc1-rgb8-texture: GL Enumerations. (line 6078)
* oes-compressed-paletted-texture: GL Enumerations. (line 5727)
* oes-depth-24: GL Enumerations. (line 3391)
* oes-depth-32: GL Enumerations. (line 3398)
* oes-depth-texture: GL Enumerations. (line 2265)
* oes-draw-texture: GL Enumerations. (line 5745)
* oes-egl-image-external: GL Enumerations. (line 6085)
* oes-element-index-uint: GL Enumerations. (line 2068)
* oes-fixed-point: GL Enumerations. (line 2139)
* oes-framebuffer-object: GL Enumerations. (line 1374)
* oes-get-program-binary: GL Enumerations. (line 4689)
* oes-mapbuffer: GL Enumerations. (line 5196)
* oes-matrix-get: GL Enumerations. (line 5410)
* oes-matrix-palette: GL Enumerations. (line 4556)
* oes-packed-depth-stencil: GL Enumerations. (line 4126)
* oes-point-size-array: GL Enumerations. (line 5401)
* oes-point-sprite: GL Enumerations. (line 5102)
* oes-read-format: GL Enumerations. (line 5737)
* oes-rgb-8-rgba-8: GL Enumerations. (line 2613)
* oes-standard-derivatives: GL Enumerations. (line 5708)
* oes-stencil-1: GL Enumerations. (line 6043)
* oes-stencil-4: GL Enumerations. (line 6050)
* oes-stencil-8: GL Enumerations. (line 6057)
* oes-stencil-wrap: GL Enumerations. (line 4175)
* oes-surfaceless-context: GL Enumerations. (line 3527)
* oes-texture-3d: GL Enumerations. (line 2938)
* oes-texture-cube-map: GL Enumerations. (line 2510)
* oes-texture-env-crossbar: GL Enumerations. (line 4010)
* oes-texture-float: GL Enumerations. (line 2076)
* oes-texture-mirrored-repeat: GL Enumerations. (line 3796)
* oes-vertex-half-float: GL Enumerations. (line 6064)
* oes-vertex-type-10-10-10-2: GL Enumerations. (line 6262)
* oml-interlace: GL Enumerations. (line 5378)
* oml-resample: GL Enumerations. (line 5392)
* oml-subsample: GL Enumerations. (line 5385)
* pixel-copy-type: GL Enumerations. (line 2241)
* pixel-format: GL Enumerations. (line 2255)
* pixel-internal-format: GL Enumerations. (line 2589)
* pixel-map: GL Enumerations. (line 2279)
* pixel-store-parameter: GL Enumerations. (line 2289)
* pixel-store-resample-mode: GL Enumerations. (line 2308)
* pixel-store-subsample-rate: GL Enumerations. (line 2316)
* pixel-tex-gen-mode: GL Enumerations. (line 2324)
* pixel-tex-gen-parameter-name-sgis: GL Enumerations. (line 2334)
* pixel-transfer-parameter: GL Enumerations. (line 2342)
* pixel-type: GL Enumerations. (line 2366)
* point-parameter-name-sgis: GL Enumerations. (line 2376)
* polygon-mode: GL Enumerations. (line 2384)
* pop-window: Window Management. (line 33069)
* position-window: Window Management. (line 33071)
* post-redisplay: Window Management. (line 33073)
* push-window: Window Management. (line 33075)
* qcom-alpha-test: GL Enumerations. (line 1914)
* qcom-binning-control: GL Enumerations. (line 6502)
* qcom-driver-control: GL Enumerations. (line 6495)
* qcom-extended-get: GL Enumerations. (line 5773)
* qcom-writeonly-rendering: GL Enumerations. (line 4969)
* read-buffer-mode: GL Enumerations. (line 2391)
* rend-screen-coordinates: GL Enumerations. (line 3987)
* rendering-mode: GL Enumerations. (line 2399)
* reshape-window: Window Management. (line 33077)
* s3-s-3-tc: GL Enumerations. (line 3803)
* sample-pattern-sgis: GL Enumerations. (line 2406)
* screen-height: State Retrieval. (line 33186)
* screen-height-mm: State Retrieval. (line 33188)
* screen-size: State Retrieval. (line 33190)
* screen-size-mm: State Retrieval. (line 33192)
* screen-width: State Retrieval. (line 33194)
* screen-width-mm: State Retrieval. (line 33196)
* separable-target-ext: GL Enumerations. (line 2414)
* set-button-box-callback: Callback Registration.
(line 33098)
* set-current-window: Callback Registration.
(line 33100)
* set-dials-callback: Callback Registration.
(line 33102)
* set-display-callback: Callback Registration.
(line 33104)
* set-entry-callback: Callback Registration.
(line 33106)
* set-gl-accumulation-buffer-operation: Per Fragment Operations.
(line 549)
* set-gl-active-texture: OpenGL Operation. (line 441)
* set-gl-alpha-function: Per Fragment Operations.
(line 491)
* set-gl-blend-color: Per Fragment Operations.
(line 499)
* set-gl-blend-equation: Per Fragment Operations.
(line 473)
* set-gl-blend-function: Per Fragment Operations.
(line 478)
* set-gl-clear-accumulation-color: Per Fragment Operations.
(line 546)
* set-gl-clear-color: Per Fragment Operations.
(line 534)
* set-gl-clear-depth: Per Fragment Operations.
(line 540)
* set-gl-clear-index: Per Fragment Operations.
(line 537)
* set-gl-clear-stencil-value: Per Fragment Operations.
(line 543)
* set-gl-color-mask: Per Fragment Operations.
(line 524)
* set-gl-depth-function: Per Fragment Operations.
(line 495)
* set-gl-depth-mask: Per Fragment Operations.
(line 527)
* set-gl-draw-buffer: Per Fragment Operations.
(line 517)
* set-gl-draw-buffers: Per Fragment Operations.
(line 508)
* set-gl-index-mask: Per Fragment Operations.
(line 520)
* set-gl-logic-operation: Per Fragment Operations.
(line 502)
* set-gl-matrix-mode: OpenGL Operation. (line 409)
* set-gl-read-buffer: Per Fragment Operations.
(line 557)
* set-gl-sample-coverage: Per Fragment Operations.
(line 488)
* set-gl-scissor: Per Fragment Operations.
(line 484)
* set-gl-shade-model: OpenGL Operation. (line 451)
* set-gl-stencil-function: Per Fragment Operations.
(line 460)
* set-gl-stencil-mask: Per Fragment Operations.
(line 512)
* set-gl-stencil-operation: Per Fragment Operations.
(line 466)
* set-idle-callback: Callback Registration.
(line 33108)
* set-initial-display-mode: GLUT Initialization.
(line 33024)
* set-initial-window-position: GLUT Initialization.
(line 33026)
* set-initial-window-size: GLUT Initialization.
(line 33028)
* set-keyboard-callback: Callback Registration.
(line 33110)
* set-menu-status-callback: Callback Registration.
(line 33112)
* set-motion-callback: Callback Registration.
(line 33114)
* set-mouse-callback: Callback Registration.
(line 33116)
* set-overlay-display-callback: Callback Registration.
(line 33118)
* set-passive-motion-callback: Callback Registration.
(line 33120)
* set-reshape-callback: Callback Registration.
(line 33122)
* set-spaceball-button-callback: Callback Registration.
(line 33124)
* set-spaceball-motion-callback: Callback Registration.
(line 33126)
* set-spaceball-rotate-callback: Callback Registration.
(line 33128)
* set-special-callback: Callback Registration.
(line 33130)
* set-tablet-button-callback: Callback Registration.
(line 33132)
* set-tablet-motion-callback: Callback Registration.
(line 33134)
* set-visibility-callback: Callback Registration.
(line 33136)
* set-window-cursor!: Window Management. (line 33047)
* set-window-icon-title!: Window Management. (line 33049)
* set-window-title!: Window Management. (line 33051)
* sgi-color-matrix: GL Enumerations. (line 3013)
* sgi-color-table: GL Enumerations. (line 3095)
* sgi-texture-color-table: GL Enumerations. (line 3029)
* sgis-detail-texture: GL Enumerations. (line 2976)
* sgis-fog-function: GL Enumerations. (line 3164)
* sgis-generate-mipmap: GL Enumerations. (line 3344)
* sgis-multisample: GL Enumerations. (line 2986)
* sgis-pixel-texture: GL Enumerations. (line 3750)
* sgis-point-line-texgen: GL Enumerations. (line 3486)
* sgis-point-parameters: GL Enumerations. (line 3156)
* sgis-sharpen-texture: GL Enumerations. (line 3005)
* sgis-texture-4d: GL Enumerations. (line 3200)
* sgis-texture-border-clamp: GL Enumerations. (line 3179)
* sgis-texture-color-mask: GL Enumerations. (line 3479)
* sgis-texture-edge-clamp: GL Enumerations. (line 3193)
* sgis-texture-filter-4: GL Enumerations. (line 3237)
* sgis-texture-lod: GL Enumerations. (line 3218)
* sgis-texture-select: GL Enumerations. (line 3124)
* sgix-async: GL Enumerations. (line 3714)
* sgix-async-histogram: GL Enumerations. (line 3721)
* sgix-async-pixel: GL Enumerations. (line 3765)
* sgix-blend-alpha-minmax: GL Enumerations. (line 3700)
* sgix-calligraphic-fragment: GL Enumerations. (line 3311)
* sgix-clipmap: GL Enumerations. (line 3261)
* sgix-convolution-accuracy: GL Enumerations. (line 3677)
* sgix-depth-pass-instrument: GL Enumerations. (line 3660)
* sgix-depth-texture: GL Enumerations. (line 3383)
* sgix-fog-offset: GL Enumerations. (line 3359)
* sgix-fragment-lighting: GL Enumerations. (line 3850)
* sgix-fragments-instrument: GL Enumerations. (line 3669)
* sgix-framezoom: GL Enumerations. (line 3328)
* sgix-icc-texture: GL Enumerations. (line 3978)
* sgix-impact-pixel-texture: GL Enumerations. (line 3318)
* sgix-instruments: GL Enumerations. (line 3297)
* sgix-interlace: GL Enumerations. (line 2969)
* sgix-ir-instrument-1: GL Enumerations. (line 3290)
* sgix-line-quality-hint: GL Enumerations. (line 3758)
* sgix-list-priority: GL Enumerations. (line 3304)
* sgix-pixel-texture: GL Enumerations. (line 3211)
* sgix-pixel-tiles: GL Enumerations. (line 3226)
* sgix-polynomial-ffd: GL Enumerations. (line 3351)
* sgix-reference-plane: GL Enumerations. (line 3283)
* sgix-resample: GL Enumerations. (line 3869)
* sgix-scalebias-hint: GL Enumerations. (line 3707)
* sgix-shadow: GL Enumerations. (line 3366)
* sgix-shadow-ambient: GL Enumerations. (line 3043)
* sgix-slim: GL Enumerations. (line 3691)
* sgix-sprite: GL Enumerations. (line 3244)
* sgix-subsample: GL Enumerations. (line 4328)
* sgix-texture-add-env: GL Enumerations. (line 3036)
* sgix-texture-coordinate-clamp: GL Enumerations. (line 3774)
* sgix-texture-lod-bias: GL Enumerations. (line 3336)
* sgix-texture-multi-buffer: GL Enumerations. (line 3186)
* sgix-texture-scale-bias: GL Enumerations. (line 3274)
* sgix-vertex-preclip: GL Enumerations. (line 3811)
* sgix-ycrcb: GL Enumerations. (line 3444)
* sgix-ycrcba: GL Enumerations. (line 3684)
* shading-model: GL Enumerations. (line 2421)
* show-window: Window Management. (line 33053)
* stencil-function: GL Enumerations. (line 2428)
* stencil-op: GL Enumerations. (line 2436)
* string-name: GL Enumerations. (line 2443)
* sub-window?: Window Management. (line 33055)
* sun-global-alpha: GL Enumerations. (line 3472)
* sun-mesh-array: GL Enumerations. (line 4419)
* sun-slice-accum: GL Enumerations. (line 4412)
* sunx-constant-data: GL Enumerations. (line 3465)
* sunx-general-triangle-list: GL Enumerations. (line 3451)
* swap-buffers: Window Management. (line 33057)
* tex-coord-pointer-type: GL Enumerations. (line 2450)
* texture-coord-name: GL Enumerations. (line 2457)
* texture-env-mode: GL Enumerations. (line 2464)
* texture-env-parameter: GL Enumerations. (line 2472)
* texture-env-target: GL Enumerations. (line 2479)
* texture-filter-func-sgis: GL Enumerations. (line 2486)
* texture-gen-mode: GL Enumerations. (line 2493)
* texture-gen-parameter: GL Enumerations. (line 2502)
* texture-mag-filter: GL Enumerations. (line 2525)
* texture-min-filter: GL Enumerations. (line 2537)
* texture-parameter-name: GL Enumerations. (line 2550)
* texture-target: GL Enumerations. (line 2571)
* texture-wrap-mode: GL Enumerations. (line 2582)
* top-level-window?: Window Management. (line 33059)
* version-1-2: GL Enumerations. (line 2662)
* version-1-3: GL Enumerations. (line 599)
* version-1-4: GL Enumerations. (line 3050)
* version-1-5: GL Enumerations. (line 3878)
* version-2-0: GL Enumerations. (line 2734)
* version-2-1: GL Enumerations. (line 3965)
* version-3-0: GL Enumerations. (line 683)
* version-3-1: GL Enumerations. (line 4059)
* version-3-2: GL Enumerations. (line 1070)
* version-3-3: GL Enumerations. (line 5291)
* version-4-1: GL Enumerations. (line 6071)
* version-4-3: GL Enumerations. (line 876)
* vertex-pointer-type: GL Enumerations. (line 2629)
* viv-shader-binary: GL Enumerations. (line 6510)
* window-alpha-size: State Retrieval. (line 33146)
* window-blue-size: State Retrieval. (line 33148)
* window-color-buffer-size: State Retrieval. (line 33150)
* window-colormap-size: State Retrieval. (line 33152)
* window-depth-buffer-size: State Retrieval. (line 33154)
* window-double-buffered?: State Retrieval. (line 33156)
* window-green-size: State Retrieval. (line 33158)
* window-height: State Retrieval. (line 33160)
* window-id: Window Management. (line 33041)
* window-live?: Window Management. (line 33043)
* window-number-of-children: State Retrieval. (line 33162)
* window-number-of-samples: State Retrieval. (line 33164)
* window-parent: State Retrieval. (line 33166)
* window-position: State Retrieval. (line 33168)
* window-red-size: State Retrieval. (line 33170)
* window-rgba: State Retrieval. (line 33178)
* window-size: State Retrieval. (line 33172)
* window-stencil-buffer-size: State Retrieval. (line 33174)
* window-stereo?: State Retrieval. (line 33176)
* window-width: State Retrieval. (line 33180)
* window-x: State Retrieval. (line 33182)
* window-y: State Retrieval. (line 33184)
* window?: Window Management. (line 33045)
* with-gl-push-attrib: State and State Requests.
(line 575)
* with-gl-push-matrix: OpenGL Operation. (line 412)
* with-window: Window Management. (line 33061)
* with-window*: Window Management. (line 33063)