Manual Reference Pages  - GLNORMAL (3G)

NAME

glNormal3b, glNormal3d, glNormal3f, glNormal3i, glNormal3s, glNormal3bv, glNormal3dv, glNormal3fv, glNormal3iv, glNormal3sv - set the current normal vector

CONTENTS

C Specification
Parameters
C Specification
Parameters
Description
Notes
Associated Gets
See Also

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
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(3G),  glColor(3G),  glIndex(3G),  glNormalPointer(3G),  glTexCoord(3G),  glVertex(3G)
Jump to page    or go to Top of page |  Section 3G |  Main Index.


GLNORMAL (3G)
Generated by manServer 1.07 from /usr/X11R6/man/man3/../man3/glNormal.3x.gz using man macros with eqn support.