glNormal3iv function

Article
03/09/2021

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