1 <?xml version=
"1.0" encoding=
"UTF-8"?>
2 <!DOCTYPE book PUBLIC
"-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
3 "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">
4 <refentry id=
"glColorTableParameter">
9 <holder>Silicon Graphics, Inc.
</holder>
12 <refentrytitle>glColorTableParameter
</refentrytitle>
13 <manvolnum>3G
</manvolnum>
16 <refname>glColorTableParameter
</refname>
17 <refpurpose>set color lookup table parameters
</refpurpose>
19 <refsynopsisdiv><title>C Specification
</title>
22 <funcdef>void
<function>glColorTableParameterfv
</function></funcdef>
23 <paramdef>GLenum
<parameter>target
</parameter></paramdef>
24 <paramdef>GLenum
<parameter>pname
</parameter></paramdef>
25 <paramdef>const GLfloat *
<parameter>params
</parameter></paramdef>
30 <funcdef>void
<function>glColorTableParameteriv
</function></funcdef>
31 <paramdef>GLenum
<parameter>target
</parameter></paramdef>
32 <paramdef>GLenum
<parameter>pname
</parameter></paramdef>
33 <paramdef>const GLint *
<parameter>params
</parameter></paramdef>
37 <!-- eqn: ignoring delim $$ -->
38 <refsect1 id=
"parameters"><title>Parameters
</title>
41 <term><parameter>target
</parameter></term>
44 The target color table.
46 <constant>GL_COLOR_TABLE
</constant>,
47 <constant>GL_POST_CONVOLUTION_COLOR_TABLE
</constant>, or
48 <constant>GL_POST_COLOR_MATRIX_COLOR_TABLE
</constant>.
53 <term><parameter>pname
</parameter></term>
56 The symbolic name of a texture color lookup table parameter.
58 <constant>GL_COLOR_TABLE_SCALE
</constant> or
59 <constant>GL_COLOR_TABLE_BIAS
</constant>.
64 <term><parameter>params
</parameter></term>
67 A pointer to an array where the values of the parameters are stored.
73 <refsect1 id=
"description"><title>Description
</title>
75 <function>glColorTableParameter
</function> is used to specify the scale factors and bias terms applied to
76 color components when they are loaded into a color table.
<parameter>target
</parameter>
77 indicates which color table the scale and bias terms apply to; it
79 <constant>GL_COLOR_TABLE
</constant>,
80 <constant>GL_POST_CONVOLUTION_COLOR_TABLE
</constant>, or
81 <constant>GL_POST_COLOR_MATRIX_COLOR_TABLE
</constant>.
84 <parameter>pname
</parameter> must be
<constant>GL_COLOR_TABLE_SCALE
</constant> to set the
86 In this case,
<parameter>params
</parameter> points to an array of four values, which are
87 the scale factors for red, green, blue, and alpha, in that order.
90 <parameter>pname
</parameter> must be
<constant>GL_COLOR_TABLE_BIAS
</constant> to set the
91 bias terms. In this case,
92 <parameter>params
</parameter> points to an array of four values, which are the bias
93 terms for red, green, blue, and alpha, in that order.
96 The color tables themselves are specified by
97 calling
<citerefentry><refentrytitle>glColorTable
</refentrytitle></citerefentry>.
100 <refsect1 id=
"notes"><title>Notes
</title>
102 <function>glColorTableParameter
</function> is available only if
<code>ARB_imaging
</code> is returned from calling
103 <citerefentry><refentrytitle>glGetString
</refentrytitle></citerefentry> with an argument of
<constant>GL_EXTENSIONS
</constant>.
106 <refsect1 id=
"errors"><title>Errors
</title>
108 <constant>GL_INVALID_ENUM
</constant> is generated if
<parameter>target
</parameter> or
<parameter>pname
</parameter> is not
112 <constant>GL_INVALID_OPERATION
</constant> is generated if
<function>glColorTableParameter
</function> is executed
113 between the execution of
<citerefentry><refentrytitle>glBegin
</refentrytitle></citerefentry> and the corresponding
114 execution of
<citerefentry><refentrytitle>glEnd
</refentrytitle></citerefentry>.
117 <refsect1 id=
"associatedgets"><title>Associated Gets
</title>
119 <citerefentry><refentrytitle>glGetColorTableParameter
</refentrytitle></citerefentry>
122 <refsect1 id=
"seealso"><title>See Also
</title>
124 <citerefentry><refentrytitle>glColorTable
</refentrytitle></citerefentry>,
125 <citerefentry><refentrytitle>glPixelTransfer
</refentrytitle></citerefentry>
128 <refsect1 id=
"Copyright"><title>Copyright
</title>
130 Copyright
<trademark class=
"copyright"></trademark> 1991-
2006
131 Silicon Graphics, Inc. This document is licensed under the SGI
132 Free Software B License. For details, see
133 <ulink url=
"http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/
</ulink>.