glNormal(3G)

NAME
     glNormal3b, glNormal3d, glNormal3f, glNormal3i, glNormal3s, glNormal3bv,
     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 normal.
               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 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.

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, glColor, glIndex, glNormalPointer, glTexCoord, glVertex