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=
"glClampColor">
9 <holder>Khronos Group
</holder>
12 <refentrytitle>glClampColor
</refentrytitle>
13 <manvolnum>3G
</manvolnum>
16 <refname>glClampColor
</refname>
17 <refpurpose>specify whether data read via
<citerefentry><refentrytitle>glReadPixels
</refentrytitle></citerefentry> should be clamped
</refpurpose>
19 <refsynopsisdiv><title>C Specification
</title>
22 <funcdef>void
<function>glClampColor
</function></funcdef>
23 <paramdef>GLenum
<parameter>target
</parameter></paramdef>
24 <paramdef>GLenum
<parameter>clamp
</parameter></paramdef>
28 <refsect1 id=
"parameters"><title>Parameters
</title>
31 <term><parameter>target
</parameter></term>
34 Target for color clamping.
<parameter>target
</parameter> must be
<constant>GL_CLAMP_READ_COLOR
</constant>.
39 <term><parameter>clamp
</parameter></term>
42 Specifies whether to apply color clamping.
<parameter>clamp
</parameter> must be
<constant>GL_TRUE
</constant> or
<constant>GL_FALSE
</constant>.
48 <refsect1 id=
"description"><title>Description
</title>
50 <function>glClampColor
</function> controls color clamping that is performed during
<citerefentry><refentrytitle>glReadPixels
</refentrytitle></citerefentry>.
51 <parameter>target
</parameter> must be
<constant>GL_CLAMP_READ_COLOR
</constant>. If
<parameter>clamp
</parameter> is
<constant>GL_TRUE
</constant>,
52 read color clamping is enabled; if
<parameter>clamp
</parameter> is
<constant>GL_FALSE
</constant>, read color clamping is disabled. If
53 <parameter>clamp
</parameter> is
<constant>GL_FIXED_ONLY
</constant>, read color clamping is enabled only if the selected read buffer has
54 fixed point components and disabled otherwise.
57 <refsect1 id=
"errors"><title>Errors
</title>
59 <constant>GL_INVALID_ENUM
</constant> is generated if
<parameter>target
</parameter> is not
60 <constant>GL_CLAMP_READ_COLOR
</constant>.
63 <constant>GL_INVALID_ENUM
</constant> is generated if
<parameter>clamp
</parameter> is not
<constant>GL_TRUE
</constant> or
<constant>GL_FALSE
</constant>.
66 <refsect1 id=
"associatedgets"><title>Associated Gets
</title>
68 <citerefentry><refentrytitle>glGet
</refentrytitle></citerefentry> with argument
<constant>GL_CLAMP_READ_COLOR
</constant>.
71 <refsect1 id=
"Copyright"><title>Copyright
</title>
73 Copyright
<trademark class=
"copyright"></trademark> 2010 Khronos Group.
74 This material may be distributed subject to the terms and conditions set forth in
75 the Open Publication License, v
1.0,
8 June
1999.
76 <ulink url=
"http://opencontent.org/openpub/">http://opencontent.org/openpub/
</ulink>.