glNormal(3) glNormal(3)
NAME
glNormal3b, glNormal3d, glNormal3f, glNormal3i, glNormal3s, glNor-
mal3bv, glNormal3dv, glNormal3fv, glNormal3iv, glNormal3sv - set the
current normal vector
C SPECIFICATION
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 )
PARAMETERS
nx, ny, nz
Specify the x, y, and z coordinates of the new current nor-
mal. The initial value of the current normal is the unit
vector, (0, 0, 1).
C SPECIFICATION
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 )
PARAMETERS
v Specifies a pointer to an array of three elements: the x, y, and
z coordinates of the new current normal.
DESCRIPTION
The current normal is set to the given coordinates whenever glNormal is
issued. Byte, short, or integer arguments are converted to floating-
point
with a linear mapping that maps the most positive representable inte-
ger 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 mod-
elview matrix. GL_RESCALE_NORMAL requires that the originally speci-
fied normals were of unit length, and that the modelview matrix contain
only uniform scales for proper results. To enable and disable normal-
ization, call glEnable and glDisable with either GL_NORMALIZE or
GL_RESCALE_NORMAL. Normalization is initially disabled.
NOTES
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.
ASSOCIATED GETS
glGet with argument GL_CURRENT_NORMAL
glIsEnabled with argument GL_NORMALIZE
glIsEnabled with argument GL_RESCALE_NORMAL
SEE ALSO
glBegin(3), glColor(3), glIndex(3), glNormalPointer(3), glTexCoord(3),
glVertex(3)
glNormal(3)
Mac OS X 10.6 - Generated Thu Sep 17 20:20:26 CDT 2009