Index for Section 3G

Alphabetical listing for G

Bottom of page

glNormal(3G)
NAME
  glNormal, glNormal3b, glNormal3d, glNormal3f, glNormal3i, glNormal3s,
  glNormal3bv, glNormal3dv, glNormal3fv, glNormal3iv, glNormal3sv - set the
  current normal vector

SYNOPSIS
  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).

SYNOPSIS
  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 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(3), glColor(3), glIndex(3), glNormalPointer(3), glTexCoord(3),
  glVertex(3)

Index for Section 3G

Alphabetical listing for G

Top of page