glNormal3iv function

Sets the current normal vector.

Syntax

void WINAPI glNormal3iv(
   const GLint *v
);

Parameters

v

A pointer to an array of three elements: the x, y, and z coordinates of the new current normal.

Return value

This function does not return a value.

Remarks

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

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 usingglNormal3iv need not have unit length. If normalization is enabled, then normals specified with glNormal3iv 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 callglNormal3ivbetween a call to glBegin and the corresponding call to glEnd. The following functions retrieve information related to glNormal3iv:

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