Export (0) Print
Expand All

glNormal

These functions set the current normal vector.

glNormal3b, glNormal3d, glNormal3f, glNormal3i, glNormal3s,
glNormal3bv, glNormal3dv, glNormal3fv, glNormal3iv, glNormal3sv

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
The x, y, and z coordinates of the new current normal. The initial value of the current normal is (0,0,1).
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
A pointer to an array of three elements: the x, y, and z coordinates of the new current normal.

Remarks

The current normal is set to the given coordinates whenever glNormal is issued. Byte, short, or integer arguments are converted to floating-point format 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 normalization is enabled, then normals specified with glNormal are normalized after transformation. Normalization is controlled using glEnable and glDisable with the argument GL_NORMALIZE. By default, normalization is disabled.

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.

The following functions retrieve information related to glNormal:

glGet with argument GL_CURRENT_NORMAL

glIsEnable with argument GL_NORMALIZE

Requirements

  Windows NT/2000: Requires Windows NT 3.5 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in Gl.h.
  Library: Use Opengl32.lib.

See Also

glBegin, glColor, glEnd, glIndex, glTexCoord, glVertex


  

Community Additions

Show:
© 2014 Microsoft