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">
9 <holder>Khronos Group
</holder>
12 <refentrytitle>clamp
</refentrytitle>
13 <manvolnum>3G
</manvolnum>
16 <refname>clamp
</refname>
17 <refpurpose>constrain a value to lie between two further values
</refpurpose>
19 <refsynopsisdiv><title>Declaration
</title>
22 <funcdef>genType
<function>clamp
</function></funcdef>
23 <paramdef>genType
<parameter>x
</parameter></paramdef>
24 <paramdef>genType
<parameter>minVal
</parameter></paramdef>
25 <paramdef>genType
<parameter>maxVal
</parameter></paramdef>
30 <funcdef>genType
<function>clamp
</function></funcdef>
31 <paramdef>genType
<parameter>x
</parameter></paramdef>
32 <paramdef>float
<parameter>minVal
</parameter></paramdef>
33 <paramdef>float
<parameter>maxVal
</parameter></paramdef>
38 <funcdef>genDType
<function>clamp
</function></funcdef>
39 <paramdef>genDType
<parameter>x
</parameter></paramdef>
40 <paramdef>genDType
<parameter>minVal
</parameter></paramdef>
41 <paramdef>genDType
<parameter>maxVal
</parameter></paramdef>
46 <funcdef>genDType
<function>clamp
</function></funcdef>
47 <paramdef>genDType
<parameter>x
</parameter></paramdef>
48 <paramdef>double
<parameter>minVal
</parameter></paramdef>
49 <paramdef>double
<parameter>maxVal
</parameter></paramdef>
54 <funcdef>genIType
<function>clamp
</function></funcdef>
55 <paramdef>genIType
<parameter>x
</parameter></paramdef>
56 <paramdef>genIType
<parameter>minVal
</parameter></paramdef>
57 <paramdef>genIType
<parameter>maxVal
</parameter></paramdef>
62 <funcdef>genIType
<function>clamp
</function></funcdef>
63 <paramdef>genIType
<parameter>x
</parameter></paramdef>
64 <paramdef>int
<parameter>minVal
</parameter></paramdef>
65 <paramdef>int
<parameter>maxVal
</parameter></paramdef>
70 <funcdef>genUType
<function>clamp
</function></funcdef>
71 <paramdef>genUType
<parameter>x
</parameter></paramdef>
72 <paramdef>genUType
<parameter>minVal
</parameter></paramdef>
73 <paramdef>genUType
<parameter>maxVal
</parameter></paramdef>
78 <funcdef>genUType
<function>clamp
</function></funcdef>
79 <paramdef>genUType
<parameter>x
</parameter></paramdef>
80 <paramdef>uint
<parameter>minVal
</parameter></paramdef>
81 <paramdef>uint
<parameter>maxVal
</parameter></paramdef>
85 <refsect1 id=
"parameters"><title>Parameters
</title>
88 <term><parameter>x
</parameter></term>
91 Specify the value to constrain.
96 <term><parameter>minVal
</parameter></term>
99 Specify the lower end of the range into which to constrain
<parameter>x
</parameter>.
104 <term><parameter>maxVal
</parameter></term>
107 Specify the upper end of the range into which to constrain
<parameter>x
</parameter>.
113 <refsect1 id=
"description"><title>Description
</title>
115 <function>clamp
</function> returns the value of
<parameter>x
</parameter> constrained to the
116 range
<parameter>minVal
</parameter> to
<parameter>maxVal
</parameter>. The returned value is
118 <citerefentry><refentrytitle>min
</refentrytitle></citerefentry>(
<citerefentry><refentrytitle>max
</refentrytitle></citerefentry>(
<parameter>x
</parameter>,
119 <parameter>minVal
</parameter>),
<parameter>maxVal
</parameter>).
122 <refsect1 id=
"versions"><title>Version Support
</title>
123 <informaltable frame=
"topbot">
128 <entry>clamp (genType)
</entry>#newin11#
131 <entry>clamp (genIType)
</entry>#newin13#
134 <entry>clamp (genUType)
</entry>#newin13#
137 <entry>clamp (genDType)
</entry>#newin40#
143 <refsect1 id=
"seealso"><title>See Also
</title>
145 <citerefentry><refentrytitle>min
</refentrytitle></citerefentry>,
146 <citerefentry><refentrytitle>max
</refentrytitle></citerefentry>
149 <refsect1 id=
"Copyright"><title>Copyright
</title>
151 Copyright
<trademark class=
"copyright"></trademark> 2011 Khronos Group.
152 This material may be distributed subject to the terms and conditions set forth in
153 the Open Publication License, v
1.0,
8 June
1999.
154 <ulink url=
"http://opencontent.org/openpub/">http://opencontent.org/openpub/
</ulink>.