Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   29550 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

GLSECONDARYCOLOR(3G)		 OpenGL Manual		  GLSECONDARYCOLOR(3G)

NAME
       glSecondaryColor - set the current secondary color

C SPECIFICATION
       void glSecondaryColor3b(GLbyte red, GLbyte green, GLbyte blue);

       void glSecondaryColor3s(GLshort red, GLshort green, GLshort blue);

       void glSecondaryColor3i(GLint red, GLint green, GLint blue);

       void glSecondaryColor3f(GLfloat red, GLfloat green, GLfloat blue);

       void glSecondaryColor3d(GLdouble red, GLdouble green, GLdouble blue);

       void glSecondaryColor3ub(GLubyte red, GLubyte green, GLubyte blue);

       void glSecondaryColor3us(GLushort red, GLushort green, GLushort blue);

       void glSecondaryColor3ui(GLuint red, GLuint green, GLuint blue);

PARAMETERS
       red, green, blue
	   Specify new red, green, and blue values for the current secondary
	   color.

C SPECIFICATION
       void glSecondaryColor3bv(const GLbyte * v);

       void glSecondaryColor3sv(const GLshort * v);

       void glSecondaryColor3iv(const GLint * v);

       void glSecondaryColor3fv(const GLfloat * v);

       void glSecondaryColor3dv(const GLdouble * v);

       void glSecondaryColor3ubv(const GLubyte * v);

       void glSecondaryColor3usv(const GLushort * v);

       void glSecondaryColor3uiv(const GLuint * v);

PARAMETERS
       v
	   Specifies a pointer to an array that contains red, green, blue.

DESCRIPTION
       The GL stores both a primary four-valued RGBA color and a secondary
       four-valued RGBA color (where alpha is always set to 0.0) that is
       associated with every vertex.

       The secondary color is interpolated and applied to each fragment during
       rasterization when GL_COLOR_SUM is enabled. When lighting is enabled,
       and GL_SEPARATE_SPECULAR_COLOR is specified, the value of the secondary
       color is assigned the value computed from the specular term of the
       lighting computation. Both the primary and secondary current colors are
       applied to each fragment, regardless of the state of GL_COLOR_SUM,
       under such conditions. When GL_SEPARATE_SPECULAR_COLOR is specified,
       the value returned from querying the current secondary color is
       undefined.

       glSecondaryColor3b, glSecondaryColor3s, and glSecondaryColor3i take
       three signed byte, short, or long integers as arguments. When v is
       appended to the name, the color commands can take a pointer to an array
       of such values.

       Color values are stored in floating-point format, with unspecified
       mantissa and exponent sizes. Unsigned integer color components, when
       specified, are linearly mapped to floating-point values such that the
       largest representable value maps to 1.0 (full intensity), and 0 maps to
       0.0 (zero intensity). Signed integer color components, when specified,
       are linearly mapped to floating-point values such that the most
       positive representable value maps to 1.0, and the most negative
       representable value maps to -1.0. (Note that this mapping does not
       convert 0 precisely to 0.0). Floating-point values are mapped directly.

       Neither floating-point nor signed integer values are clamped to the
       range 0 1 before the current color is updated. However, color
       components are clamped to this range before they are interpolated or
       written into a color buffer.

NOTES
       glSecondaryColor is available only if the GL version is 1.4 or greater.

       The initial value for the secondary color is (0, 0, 0, 0).

       The secondary color can be updated at any time. In particular,
       glSecondaryColor can be called between a call to glBegin() and the
       corresponding call to glEnd().

ASSOCIATED GETS
       glGet() with argument GL_CURRENT_SECONDARY_COLOR

       glGet() with argument GL_RGBA_MODE

       glIsEnabled() with argument GL_COLOR_SUM

SEE ALSO
       glColor(), glIndex(), glIsEnabled(), glLightModel(),
       glSecondaryColorPointer

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

AUTHORS
       opengl.org

opengl.org			  03/16/2013		  GLSECONDARYCOLOR(3G)

Vote for polarhome