1GLNORMAL(3G)                     OpenGL Manual                    GLNORMAL(3G)
2
3
4

NAME

6       glNormal - set the current normal vector
7

C SPECIFICATION

9       void glNormal3b(GLbyte nx, GLbyte ny, GLbyte nz);
10
11       void glNormal3d(GLdouble nx, GLdouble ny, GLdouble nz);
12
13       void glNormal3f(GLfloat nx, GLfloat ny, GLfloat nz);
14
15       void glNormal3i(GLint nx, GLint ny, GLint nz);
16
17       void glNormal3s(GLshort nx, GLshort ny, GLshort nz);
18

PARAMETERS

20       nx, ny, nz
21           Specify the x, y, and z coordinates of the new current normal. The
22           initial value of the current normal is the unit vector, (0, 0, 1).
23
24

C SPECIFICATION

26       void glNormal3bv(const GLbyte * v);
27
28       void glNormal3dv(const GLdouble * v);
29
30       void glNormal3fv(const GLfloat * v);
31
32       void glNormal3iv(const GLint * v);
33
34       void glNormal3sv(const GLshort * v);
35

PARAMETERS

37       v
38           Specifies a pointer to an array of three elements: the x, y, and z
39           coordinates of the new current normal.
40
41

DESCRIPTION

43       The current normal is set to the given coordinates whenever glNormal is
44       issued. Byte, short, or integer arguments are converted to
45       floating-point format with a linear mapping that maps the most positive
46       representable integer value to 1.0 and the most negative representable
47       integer value to -1.0.
48
49       Normals specified with glNormal need not have unit length. If
50       GL_NORMALIZE is enabled, then normals of any length specified with
51       glNormal are normalized after transformation. If GL_RESCALE_NORMAL is
52       enabled, normals are scaled by a scaling factor derived from the
53       modelview matrix.  GL_RESCALE_NORMAL requires that the originally
54       specified normals were of unit length, and that the modelview matrix
55       contain only uniform scales for proper results. To enable and disable
56       normalization, call glEnable() and glDisable() with either GL_NORMALIZE
57       or GL_RESCALE_NORMAL. Normalization is initially disabled.
58

NOTES

60       The current normal can be updated at any time. In particular, glNormal
61       can be called between a call to glBegin() and the corresponding call to
62       glEnd().
63

ASSOCIATED GETS

65       glGet() with argument GL_CURRENT_NORMAL
66
67       glIsEnabled() with argument GL_NORMALIZE
68
69       glIsEnabled() with argument GL_RESCALE_NORMAL
70

SEE ALSO

72       glBegin(), glColor(), glIndex(), glMultiTexCoord(), glNormalPointer(),
73       glTexCoord(), glVertex()
74

76       Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed
77       under the SGI Free Software B License. For details, see
78       http://oss.sgi.com/projects/FreeB/.
79

AUTHORS

81       opengl.org
82
83
84
85opengl.org                        06/10/2014                      GLNORMAL(3G)
Impressum