glNormal3f function

Sets the current normal vector.

Syntax

void WINAPI glNormal3f(
   GLfloat nx,
   GLfloat ny,
   GLfloat nz
);

Parameters

nx

Specifies the x-coordinate for the new current normal vector.

ny

Specifies the y-coordinate for the new current normal vector.

nz

Specifies the z-coordinate for the new current normal vector.

Return value

This function does not return a value.

Remarks

The current normal is set to the given coordinates whenever you call the glNormal3f function.

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 by using glNormal3f need not have unit length. If normalization is enabled, then normals specified with glNormal3f are normalized after transformation. You can control normalization by using glEnable and glDisable with the argument GL_NORMALIZE. By default, normalization is disabled. You can update the current normal at any time. In particular, you can call glNormal3f between a call to glBegin and the corresponding call to glEnd. The following functions retrieve information related to glNormal3f:

glGet with argument GL_CURRENT_NORMAL

glIsEnable with argument GL_NORMALIZE

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Gl.h
Library	Opengl32.lib
DLL	Opengl32.dll

See also

glBegin

glColor

glEnd

glIndex

glTexCoord

glVertex