glNormal3sv

TriggerTek Logo
abcdefghijklmnopqrstuvwxyz_
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 float-
       ing-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 con-
       tain 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(3G),    glColor(3G),	glIndex(3G),	 glNormalPointer(3G),
       glTexCoord(3G), glVertex(3G)



								 GLNORMAL(3G)