HP b2600 Reference Manual page 432

T
glTexGen
params
Description
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, or GL_SPHERE_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
is used, where g is the value computed for the coordinate named in coord, p
p
4
of the vertex. This function can be used, for example, to texture-map terrain using sea
level as a reference plane (defined by p
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
is used, where
( p
and x
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 pname 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' be the current normal, after
transformation to eye coordinates. Let f = (f
432
Specifies a pointer to an array of texture generation parameters. If
pname is GL_TEXTURE_GEN_MODE, then the array must contain a
single symbolic constant, one of GL_OBJECT_LINEAR,
GL_EYE_LINEAR, or GL_SPHERE_MAP. Otherwise, params holds
the coefficients for the texture-coordinate generation function specified
by pname.
x + p y + p z + p
1 o 2 o 3 o
are the four values supplied in params, and x
x + p y + p z
1' e 2' e 3' e
p p p ) = ( p p p
1' 2' 3' 4' 1 2
, y , z , and w are the eye coordinates of the vertex, p
e e e e
T
f = u 2n' n' u
w
4 o
o
, p , p , and p
1 2 3
+ p w
4' e
-1
p ) M
3 4
f f
x y
, y , z , and w are the object coordinates
o o o
). The altitude of a terrain vertex
4
, p , p , and p
1 2 3
T
) be the reflection vector such that
z
, p , p , and
1 2 3
are the
4
Chapter 18