OpenSuSE Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
x SuSE Linux 13.1-RELEASE x
x SuSE Linux 13.1-RELEASEx
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
       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 contain
       only uniform scales for proper results.  To enable and disable  normal-
       ization,  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)

Want to link to this manual page? Use this URL:
<
http://star2.abcm.com/cgi-bin/bsdi-man?query=glNormal&sektion=3g&manpath=>

home | help