osx man page for glnormal

GLNORMAL(3G)															      GLNORMAL(3G)

NAME
       glNormal3b,  glNormal3d, glNormal3f, glNormal3i, glNormal3s, glNormal3bv, glNormal3dv, glNormal3fv, glNormal3iv, glNormal3sv - set the cur-
       rent 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 float-
       ing-point
	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

																      GLNORMAL(3G)