glColor
NAME
glColor3b, glColor3d, glColor3f, glColor3i, glColor3s, glColor3ub, glColor3ui, glColor3us, glColor4b, glColor4d, glColor4f, glColor4i, glColor4s, glColor4ub, glColor4ui, glColor4us, glColor3bv, glColor3dv, glColor3fv, glColor3iv, glColor3sv, glColor3ubv, glColor3uiv, glColor3usv, glColor4bv, glColor4dv, glColor4fv, glColor4iv, glColor4sv, glColor4ubv, glColor4uiv, glColor4usv, -- set the current color
C SPECIFICATION
void glColor3b(GLbyte red,
GLbyte green,
GLbyte blue)
void glColor3d(GLdouble red,
GLdouble green,
GLdouble blue)
void glColor3f(GLfloat red,
GLfloat green,
GLfloat blue)
void glColor3i(GLint red,
GLint green,
GLint blue)
void glColor3s(GLshort red,
GLshort green,
GLshort blue)
void glColor3ub(GLubyte red,
GLubyte green,
GLubyte blue)
void glColor3ui(GLuint red,
GLuint green,
GLuint blue)
void glColor3us(GLushort red,
GLushort green,
GLushort blue)
void glColor4b(GLbyte red,
GLbyte green,
GLbyte blue,
GLbyte alpha)
void glColor4d(GLdouble red,
GLdouble green,
GLdouble blue,
GLdouble alpha)
void glColor4f(GLfloat red,
GLfloat green,
GLfloat blue,
GLfloat alpha)
void glColor4i(GLint red,
GLint green,
GLint blue,
GLint alpha)
void glColor4s(GLshort red,
GLshort green,
GLshort blue,
GLshort alpha)
void glColor4ub(GLubyte red,
GLubyte green,
GLubyte blue,
GLubyte alpha)
void glColor4ui(GLuint red,
GLuint green,
GLuint blue,
GLuint alpha)
void glColor4us(GLushort red,
GLushort green,
GLushort blue,
GLushort alpha)
PARAMETERS
red, green, blue
Specify new red, green, and blue values for the current color.
alpha
Specifies a new alpha value for the current color. Included only in the four-argument glColor4 command.
C SPECIFICATION
void glColor3bv(const GLbyte *v)
void glColor3dv(const GLdouble *v)
void glColor3fv(const GLfloat *v)
void glColor3iv(const GLint *v)
void glColor3sv(const GLshort *v)
void glColor3ubv(const GLubyte *v)
void glColor3uiv(const GLuint *v)
void glColor3usv(const GLushort *v)
void glColor4bv(const GLbyte *v)
void glColor4dv(const GLdouble *v)
void glColor4fv(const GLfloat *v)
void glColor4iv(const GLint *v)
void glColor4sv(const GLshort *v)
void glColor4ubv(const GLubyte *v)
void glColor4uiv(const GLuint *v)
void glColor4usv(const GLushort *v)
PARAMETERS
v
Specifies a pointer to an array that contains red, green, blue, and (sometimes) alpha values.
DESCRIPTION
The GL stores both a current single-valued color index and a current four-valued RGBA color. glColor sets a new four-valued RGBA color. glColor has two major variants: glColor3 and glColor4. glColor3 variants specify new red, green, and blue values explicitly, and set the current alpha value to 1.0 implicitly. glColor4 variants specify all four color components explicitly.
glColor3b, glColor4b, glColor3s, glColor4s, glColor3i, and glColor4i take three or four unsigned 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.
Current 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 zero 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. Floating-point values are mapped directly.
Neither floating-point nor signed integer values are clamped to the range [0, 1] before updating the current color. However, color components are clamped to this range before they are interpolated or written into a color buffer.
NOTES
The current color can be updated at any time. In particular, glColor can be called between a call to glBegin and the corresponding call to glEnd.
指定一個指針,指向一個數組,包含紅色,綠色,藍色,和(有時)的alpha值。
說明
GL店既是當前的單值的顯色指數和四值電流RGBA顏色。glColor設定一個新的四RGBA顏色值。glColor有兩大的變種:glColor3 glColor4。glColor3變種新紅,綠,藍值明確指定,並設定當前的Alpha值1.0含蓄。glColor4變種明確指定所有四色組件。
glColor3b,glColor4b glColor3s glColor4s,glColor3i,glColor4i需要3個或4個無符號位元組,或長或短的整數作為參數。當v附加到該名稱,顏色命令可以採取這種數值的數組的指針。
當前顏色值被存儲在浮點格式,與未指定的尾數和指數大小。無符號整數的顏色分量,指定時,線性映射等浮點值表示的最大值映射到1.0(全強度),和零映射到0.0(零點強度)。帶符號整數的顏色分量,指定時,線性映射等浮點值的最積極的表示值映射到1.0,最消極的表示值映射到-1.0。浮點值直接映射。
既不浮點也不帶符號整數的值將被鎖定到的範圍是[0,1]才更新當前顏色。然而,顏色分量將被鎖定到該範圍內,才進行插值或寫入的顏色緩衝區。
附註
當前顏色可以隨時更新。特別是,glColor可以被稱為glBegin和glEnd相應的呼叫的呼叫之間。
(谷歌翻譯)