glNormal — set the current normal vector
void glNormal3b( | GLbyte | nx, |
GLbyte | ny, | |
GLbyte | nz) ; |
void glNormal3d( | GLdouble | nx, |
GLdouble | ny, | |
GLdouble | nz) ; |
void glNormal3f( | GLfloat | nx, |
GLfloat | ny, | |
GLfloat | nz) ; |
void glNormal3i( | GLint | nx, |
GLint | ny, | |
GLint | nz) ; |
void glNormal3s( | GLshort | nx, |
GLshort | ny, | |
GLshort | nz) ; |
nx
, ny
, nz
Specify the
void glNormal3bv( | const GLbyte * | v) ; |
void glNormal3dv( | const GLdouble * | v) ; |
void glNormal3fv( | const GLfloat * | v) ; |
void glNormal3iv( | const GLint * | v) ; |
void glNormal3sv( | const GLshort * | v) ; |
v
Specifies a pointer to an array of three elements:
the
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
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.
The current normal can be updated at any time.
In particular, glNormal
can be called between a call to glBegin and
the corresponding call to glEnd.
glGet with argument GL_CURRENT_NORMAL
glIsEnabled with argument GL_NORMALIZE
glIsEnabled with argument GL_RESCALE_NORMAL
Copyright © 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/.