GLProgramming.com

home :: about :: development guides :: irc :: forums :: search :: paste :: links :: contribute :: code dump

-> Click here to learn how to get live help <-


Manpage of GLNORMAL

GLNORMAL

Index
 

NAME

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

delim $$  

C SPECIFICATION

void f3glNormal3bfP( GLbyte fInxfP,
   GLdouble fInyfP,
   GLdouble fInzfP )
void f3glNormal3ffP( GLfloat fInxfP,
   GLint fInyfP,
   GLint fInzfP )
void f3glNormal3sfP( GLshort fInxfP,
f2nxfP, f2nyfP, f2nzfP
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 f3glNormal3bvfP( const GLbyte fI*vfP )


void f3glNormal3dvfP(
const GLdouble fI*vfP )


void f3glNormal3fvfP(
const GLfloat fI*vfP )


void f3glNormal3ivfP(
const GLint fI*vfP )


void f3glNormal3svfP(
const GLshort fI*vfP )


 

PARAMETERS

f2vfP
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 %f3glNormalfP 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 %f3glNormalfP need not have unit length. If %f3GL_NORMALIZEfP is enabled, then normals of any length specified with %f3glNormalfP are normalized after transformation. If %f3GL_RESCALE_NORMALfP is enabled, normals are scaled by a scaling factor derived from the modelview matrix. %f3GL_RESCALE_NORMALfP 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 %f3glEnablefP and %f3glDisablefP with either %f3GL_NORMALIZEfP or %f3GL_RESCALE_NORMALfP. Normalization is initially disabled.  

NOTES

The current normal can be updated at any time. In particular, %f3glNormalfP can be called between a call to %f3glBeginfP and the corresponding call to %f3glEndfP.  

ASSOCIATED GETS

%f3glGetfP with argument %f3GL_CURRENT_NORMALfP
%f3glIsEnabledfP with argument %f3GL_NORMALIZEfP
%f3glIsEnabledfP with argument %f3GL_RESCALE_NORMALfP  

SEE ALSO

%f3glBegin(3G)fP, %f3glColor(3G)fP, %f3glIndex(3G)fP, %f3glNormalPointer(3G)fP, %f3glTexCoord(3G)fP, %f3glVertex(3G)fP


 

Index

NAME
C SPECIFICATION
C SPECIFICATION
PARAMETERS
DESCRIPTION
NOTES
ASSOCIATED GETS
SEE ALSO