glNormal3f
Collapse the table of content
Expand the table of content

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

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

 

 

Show:
© 2016 Microsoft