GLNORMAL(3G)                                                      GLNORMAL(3G)



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
       GLNORMALIZE  is  enabled,  then  normals  of any length specified with
       glNormal are normalized after transformation.  If GLRESCALENORMAL  is
       enabled,  normals  are scaled by a scaling factor derived from the mod-
       elview matrix.  GLRESCALENORMAL 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  GLNORMALIZE or
       GLRESCALENORMAL.  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.

ASOCIATED GETS
       glGet with argument GLCURENTNORMAL
       glIsEnabled with argument GLNORMALIZE
       glIsEnabled with argument GLRESCALENORMAL

SEE ALSO
       glBegin, glColor, glIndex, glNormalPointer, glTexCoord, glVertex



                                                                  GLNORMAL(3G)