← Back to branch summary

~ubuntu-branches/ubuntu/jaunty/gimp/jaunty-security

« back to all changes in this revision

Viewing changes to devel-docs/libgimpcolor/xml/gimpcolorspace.xml

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Holbach
  • Date: 2007-05-02 16:33:03 UTC
  • mfrom: (1.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20070502163303-bvzhjzbpw8qglc4y
Tags: 2.3.16-1ubuntu1
* Resynchronized with Debian, remaining Ubuntu changes:
  - debian/rules: i18n magic.
* debian/control.in:
  - Maintainer: Ubuntu Core Developers <ubuntu-devel@lists.ubuntu.com>
* debian/patches/02_help-message.patch,
  debian/patches/03_gimp.desktop.in.in.patch,
  debian/patches/10_dont_show_wizard.patch: updated.
* debian/patches/04_composite-signedness.patch,
  debian/patches/05_add-letter-spacing.patch: dropped, used upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
devel-docs/libgimpcolor/xml/gimpcolorspace.xml
4
4
 
5
5
<refentry id="libgimpcolor-GimpColorSpace">
6
6
<refmeta>
7
 
<refentrytitle>GimpColorSpace</refentrytitle>
 
7
<refentrytitle role="top_of_page">GimpColorSpace</refentrytitle>
8
8
<manvolnum>3</manvolnum>
9
9
<refmiscinfo>LIBGIMPCOLOR Library</refmiscinfo>
10
10
</refmeta>
11
11
 
12
12
<refnamediv>
13
 
<refname>GimpColorSpace</refname><refpurpose>Utility functions which convert colors between different color models.</refpurpose>
 
13
<refname>GimpColorSpace</refname>
 
14
<refpurpose>Utility functions which convert colors between different color models.</refpurpose>
 
15
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
14
16
</refnamediv>
15
17
 
16
 
<refsynopsisdiv><title>Synopsis</title>
 
18
<refsynopsisdiv role="synopsis">
 
19
<title role="synopsis.title">Synopsis</title>
17
20
 
18
21
<synopsis>
19
22
 
20
23
 
21
24
 
22
 
            <link linkend="GimpHSL">GimpHSL</link>;
23
 
<link linkend="void">void</link>        <link linkend="gimp-rgb-to-hsv">gimp_rgb_to_hsv</link>                 (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
24
 
                                             <link linkend="GimpHSV">GimpHSV</link> *hsv);
25
 
<link linkend="void">void</link>        <link linkend="gimp-rgb-to-hsl">gimp_rgb_to_hsl</link>                 (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
26
 
                                             <link linkend="GimpHSL">GimpHSL</link> *hsl);
27
 
<link linkend="void">void</link>        <link linkend="gimp-rgb-to-cmyk">gimp_rgb_to_cmyk</link>                (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
28
 
                                             <link linkend="gdouble">gdouble</link> pullout,
29
 
                                             <link linkend="GimpCMYK">GimpCMYK</link> *cmyk);
30
 
<link linkend="void">void</link>        <link linkend="gimp-hsv-to-rgb">gimp_hsv_to_rgb</link>                 (const <link linkend="GimpHSV">GimpHSV</link> *hsv,
31
 
                                             <link linkend="GimpRGB">GimpRGB</link> *rgb);
32
 
<link linkend="void">void</link>        <link linkend="gimp-hsl-to-rgb">gimp_hsl_to_rgb</link>                 (const <link linkend="GimpHSL">GimpHSL</link> *hsl,
33
 
                                             <link linkend="GimpRGB">GimpRGB</link> *rgb);
34
 
<link linkend="void">void</link>        <link linkend="gimp-cmyk-to-rgb">gimp_cmyk_to_rgb</link>                (const <link linkend="GimpCMYK">GimpCMYK</link> *cmyk,
35
 
                                             <link linkend="GimpRGB">GimpRGB</link> *rgb);
36
 
<link linkend="void">void</link>        <link linkend="gimp-rgb-to-hwb">gimp_rgb_to_hwb</link>                 (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
37
 
                                             <link linkend="gdouble">gdouble</link> *hue,
38
 
                                             <link linkend="gdouble">gdouble</link> *whiteness,
39
 
                                             <link linkend="gdouble">gdouble</link> *blackness);
40
 
<link linkend="void">void</link>        <link linkend="gimp-hwb-to-rgb">gimp_hwb_to_rgb</link>                 (<link linkend="gdouble">gdouble</link> hue,
41
 
                                             <link linkend="gdouble">gdouble</link> whiteness,
42
 
                                             <link linkend="gdouble">gdouble</link> blackness,
43
 
                                             <link linkend="GimpRGB">GimpRGB</link> *rgb);
44
 
<link linkend="void">void</link>        <link linkend="gimp-rgb-to-hsv-int">gimp_rgb_to_hsv_int</link>             (<link linkend="gint">gint</link> *red,
45
 
                                             <link linkend="gint">gint</link> *green,
46
 
                                             <link linkend="gint">gint</link> *blue);
47
 
<link linkend="void">void</link>        <link linkend="gimp-hsv-to-rgb-int">gimp_hsv_to_rgb_int</link>             (<link linkend="gint">gint</link> *hue,
48
 
                                             <link linkend="gint">gint</link> *saturation,
49
 
                                             <link linkend="gint">gint</link> *value);
50
 
<link linkend="void">void</link>        <link linkend="gimp-rgb-to-hsl-int">gimp_rgb_to_hsl_int</link>             (<link linkend="gint">gint</link> *red,
51
 
                                             <link linkend="gint">gint</link> *green,
52
 
                                             <link linkend="gint">gint</link> *blue);
53
 
<link linkend="void">void</link>        <link linkend="gimp-rgb-to-cmyk-int">gimp_rgb_to_cmyk_int</link>            (<link linkend="gint">gint</link> *red,
54
 
                                             <link linkend="gint">gint</link> *green,
55
 
                                             <link linkend="gint">gint</link> *blue,
56
 
                                             <link linkend="gint">gint</link> *pullout);
57
 
<link linkend="void">void</link>        <link linkend="gimp-cmyk-to-rgb-int">gimp_cmyk_to_rgb_int</link>            (<link linkend="gint">gint</link> *cyan,
58
 
                                             <link linkend="gint">gint</link> *magenta,
59
 
                                             <link linkend="gint">gint</link> *yellow,
60
 
                                             <link linkend="gint">gint</link> *black);
61
 
<link linkend="gint">gint</link>        <link linkend="gimp-rgb-to-l-int">gimp_rgb_to_l_int</link>               (<link linkend="gint">gint</link> red,
62
 
                                             <link linkend="gint">gint</link> green,
63
 
                                             <link linkend="gint">gint</link> blue);
64
 
<link linkend="void">void</link>        <link linkend="gimp-hsl-to-rgb-int">gimp_hsl_to_rgb_int</link>             (<link linkend="gint">gint</link> *hue,
65
 
                                             <link linkend="gint">gint</link> *saturation,
66
 
                                             <link linkend="gint">gint</link> *lightness);
67
 
<link linkend="void">void</link>        <link linkend="gimp-rgb-to-hsv4">gimp_rgb_to_hsv4</link>                (<link linkend="guchar">guchar</link> *rgb,
68
 
                                             <link linkend="gdouble">gdouble</link> *hue,
69
 
                                             <link linkend="gdouble">gdouble</link> *saturation,
70
 
                                             <link linkend="gdouble">gdouble</link> *value);
71
 
<link linkend="void">void</link>        <link linkend="gimp-hsv-to-rgb4">gimp_hsv_to_rgb4</link>                (<link linkend="guchar">guchar</link> *rgb,
72
 
                                             <link linkend="gdouble">gdouble</link> hue,
73
 
                                             <link linkend="gdouble">gdouble</link> saturation,
74
 
                                             <link linkend="gdouble">gdouble</link> value);
 
25
<link linkend="void">void</link>                <link linkend="gimp-rgb-to-hsv">gimp_rgb_to_hsv</link>                     (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
 
26
                                                         <link linkend="GimpHSV">GimpHSV</link> *hsv);
 
27
<link linkend="void">void</link>                <link linkend="gimp-rgb-to-hsl">gimp_rgb_to_hsl</link>                     (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
 
28
                                                         <link linkend="GimpHSL">GimpHSL</link> *hsl);
 
29
<link linkend="void">void</link>                <link linkend="gimp-rgb-to-cmyk">gimp_rgb_to_cmyk</link>                    (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
 
30
                                                         <link linkend="gdouble">gdouble</link> pullout,
 
31
                                                         <link linkend="GimpCMYK">GimpCMYK</link> *cmyk);
 
32
<link linkend="void">void</link>                <link linkend="gimp-hsv-to-rgb">gimp_hsv_to_rgb</link>                     (const <link linkend="GimpHSV">GimpHSV</link> *hsv,
 
33
                                                         <link linkend="GimpRGB">GimpRGB</link> *rgb);
 
34
<link linkend="void">void</link>                <link linkend="gimp-hsl-to-rgb">gimp_hsl_to_rgb</link>                     (const <link linkend="GimpHSL">GimpHSL</link> *hsl,
 
35
                                                         <link linkend="GimpRGB">GimpRGB</link> *rgb);
 
36
<link linkend="void">void</link>                <link linkend="gimp-cmyk-to-rgb">gimp_cmyk_to_rgb</link>                    (const <link linkend="GimpCMYK">GimpCMYK</link> *cmyk,
 
37
                                                         <link linkend="GimpRGB">GimpRGB</link> *rgb);
 
38
<link linkend="void">void</link>                <link linkend="gimp-rgb-to-hwb">gimp_rgb_to_hwb</link>                     (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
 
39
                                                         <link linkend="gdouble">gdouble</link> *hue,
 
40
                                                         <link linkend="gdouble">gdouble</link> *whiteness,
 
41
                                                         <link linkend="gdouble">gdouble</link> *blackness);
 
42
<link linkend="void">void</link>                <link linkend="gimp-hwb-to-rgb">gimp_hwb_to_rgb</link>                     (<link linkend="gdouble">gdouble</link> hue,
 
43
                                                         <link linkend="gdouble">gdouble</link> whiteness,
 
44
                                                         <link linkend="gdouble">gdouble</link> blackness,
 
45
                                                         <link linkend="GimpRGB">GimpRGB</link> *rgb);
 
46
<link linkend="void">void</link>                <link linkend="gimp-rgb-to-hsv-int">gimp_rgb_to_hsv_int</link>                 (<link linkend="gint">gint</link> *red,
 
47
                                                         <link linkend="gint">gint</link> *green,
 
48
                                                         <link linkend="gint">gint</link> *blue);
 
49
<link linkend="void">void</link>                <link linkend="gimp-hsv-to-rgb-int">gimp_hsv_to_rgb_int</link>                 (<link linkend="gint">gint</link> *hue,
 
50
                                                         <link linkend="gint">gint</link> *saturation,
 
51
                                                         <link linkend="gint">gint</link> *value);
 
52
<link linkend="void">void</link>                <link linkend="gimp-rgb-to-hsl-int">gimp_rgb_to_hsl_int</link>                 (<link linkend="gint">gint</link> *red,
 
53
                                                         <link linkend="gint">gint</link> *green,
 
54
                                                         <link linkend="gint">gint</link> *blue);
 
55
<link linkend="void">void</link>                <link linkend="gimp-rgb-to-cmyk-int">gimp_rgb_to_cmyk_int</link>                (<link linkend="gint">gint</link> *red,
 
56
                                                         <link linkend="gint">gint</link> *green,
 
57
                                                         <link linkend="gint">gint</link> *blue,
 
58
                                                         <link linkend="gint">gint</link> *pullout);
 
59
<link linkend="void">void</link>                <link linkend="gimp-cmyk-to-rgb-int">gimp_cmyk_to_rgb_int</link>                (<link linkend="gint">gint</link> *cyan,
 
60
                                                         <link linkend="gint">gint</link> *magenta,
 
61
                                                         <link linkend="gint">gint</link> *yellow,
 
62
                                                         <link linkend="gint">gint</link> *black);
 
63
<link linkend="gint">gint</link>                <link linkend="gimp-rgb-to-l-int">gimp_rgb_to_l_int</link>                   (<link linkend="gint">gint</link> red,
 
64
                                                         <link linkend="gint">gint</link> green,
 
65
                                                         <link linkend="gint">gint</link> blue);
 
66
<link linkend="void">void</link>                <link linkend="gimp-hsl-to-rgb-int">gimp_hsl_to_rgb_int</link>                 (<link linkend="gint">gint</link> *hue,
 
67
                                                         <link linkend="gint">gint</link> *saturation,
 
68
                                                         <link linkend="gint">gint</link> *lightness);
 
69
<link linkend="void">void</link>                <link linkend="gimp-rgb-to-hsv4">gimp_rgb_to_hsv4</link>                    (const <link linkend="guchar">guchar</link> *rgb,
 
70
                                                         <link linkend="gdouble">gdouble</link> *hue,
 
71
                                                         <link linkend="gdouble">gdouble</link> *saturation,
 
72
                                                         <link linkend="gdouble">gdouble</link> *value);
 
73
<link linkend="void">void</link>                <link linkend="gimp-hsv-to-rgb4">gimp_hsv_to_rgb4</link>                    (<link linkend="guchar">guchar</link> *rgb,
 
74
                                                         <link linkend="gdouble">gdouble</link> hue,
 
75
                                                         <link linkend="gdouble">gdouble</link> saturation,
 
76
                                                         <link linkend="gdouble">gdouble</link> value);
75
77
</synopsis>
76
78
</refsynopsisdiv>
77
79
 
83
85
 
84
86
 
85
87
 
86
 
<refsect1>
87
 
<title>Description</title>
 
88
<refsect1 role="desc">
 
89
<title role="desc.title">Description</title>
88
90
<para>
89
91
When programming pixel data manipulation functions you will often use
90
92
algorithms operating on a color model different from the one GIMP
93
95
</para>
94
96
</refsect1>
95
97
 
96
 
<refsect1>
97
 
<title>Details</title>
98
 
<refsect2>
99
 
<title><anchor id="GimpHSL"/>GimpHSL</title>
100
 
<indexterm><primary>GimpHSL</primary></indexterm><programlisting>typedef struct {
101
 
  gdouble h, s, l, a;
102
 
} GimpHSL;
103
 
</programlisting>
104
 
<para>
105
 
 
106
 
</para></refsect2>
107
 
<refsect2>
108
 
<title><anchor id="gimp-rgb-to-hsv"/>gimp_rgb_to_hsv ()</title>
109
 
<indexterm><primary>gimp_rgb_to_hsv</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_rgb_to_hsv                 (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
110
 
                                             <link linkend="GimpHSV">GimpHSV</link> *hsv);</programlisting>
 
98
<refsect1 role="details">
 
99
<title role="details.title">Details</title>
 
100
<refsect2>
 
101
<title><anchor id="gimp-rgb-to-hsv" role="function"/>gimp_rgb_to_hsv ()</title>
 
102
<indexterm><primary>gimp_rgb_to_hsv</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_rgb_to_hsv                     (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
 
103
                                                         <link linkend="GimpHSV">GimpHSV</link> *hsv);</programlisting>
111
104
<para>
112
105
Does a conversion from RGB to HSV (Hue, Saturation,
113
106
Value) colorspace.</para>
122
115
</simpara></listitem></varlistentry>
123
116
</variablelist></refsect2>
124
117
<refsect2>
125
 
<title><anchor id="gimp-rgb-to-hsl"/>gimp_rgb_to_hsl ()</title>
126
 
<indexterm><primary>gimp_rgb_to_hsl</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_rgb_to_hsl                 (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
127
 
                                             <link linkend="GimpHSL">GimpHSL</link> *hsl);</programlisting>
 
118
<title><anchor id="gimp-rgb-to-hsl" role="function"/>gimp_rgb_to_hsl ()</title>
 
119
<indexterm><primary>gimp_rgb_to_hsl</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_rgb_to_hsl                     (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
 
120
                                                         <link linkend="GimpHSL">GimpHSL</link> *hsl);</programlisting>
128
121
<para>
129
122
Convert an RGB color value to a HSL (Hue, Saturation, Lightness)
130
123
color value.</para>
139
132
</simpara></listitem></varlistentry>
140
133
</variablelist></refsect2>
141
134
<refsect2>
142
 
<title><anchor id="gimp-rgb-to-cmyk"/>gimp_rgb_to_cmyk ()</title>
143
 
<indexterm><primary>gimp_rgb_to_cmyk</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_rgb_to_cmyk                (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
144
 
                                             <link linkend="gdouble">gdouble</link> pullout,
145
 
                                             <link linkend="GimpCMYK">GimpCMYK</link> *cmyk);</programlisting>
 
135
<title><anchor id="gimp-rgb-to-cmyk" role="function"/>gimp_rgb_to_cmyk ()</title>
 
136
<indexterm><primary>gimp_rgb_to_cmyk</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_rgb_to_cmyk                    (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
 
137
                                                         <link linkend="gdouble">gdouble</link> pullout,
 
138
                                                         <link linkend="GimpCMYK">GimpCMYK</link> *cmyk);</programlisting>
146
139
<para>
147
140
Does a naive conversion from RGB to CMYK colorspace. A simple
148
141
formula that doesn't take any color-profiles into account is used.
164
157
</simpara></listitem></varlistentry>
165
158
</variablelist></refsect2>
166
159
<refsect2>
167
 
<title><anchor id="gimp-hsv-to-rgb"/>gimp_hsv_to_rgb ()</title>
168
 
<indexterm><primary>gimp_hsv_to_rgb</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_hsv_to_rgb                 (const <link linkend="GimpHSV">GimpHSV</link> *hsv,
169
 
                                             <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
 
160
<title><anchor id="gimp-hsv-to-rgb" role="function"/>gimp_hsv_to_rgb ()</title>
 
161
<indexterm><primary>gimp_hsv_to_rgb</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_hsv_to_rgb                     (const <link linkend="GimpHSV">GimpHSV</link> *hsv,
 
162
                                                         <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
170
163
<para>
171
164
Converts a color value from HSV to RGB colorspace</para>
172
165
<para>
180
173
</simpara></listitem></varlistentry>
181
174
</variablelist></refsect2>
182
175
<refsect2>
183
 
<title><anchor id="gimp-hsl-to-rgb"/>gimp_hsl_to_rgb ()</title>
184
 
<indexterm><primary>gimp_hsl_to_rgb</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_hsl_to_rgb                 (const <link linkend="GimpHSL">GimpHSL</link> *hsl,
185
 
                                             <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
 
176
<title><anchor id="gimp-hsl-to-rgb" role="function"/>gimp_hsl_to_rgb ()</title>
 
177
<indexterm><primary>gimp_hsl_to_rgb</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_hsl_to_rgb                     (const <link linkend="GimpHSL">GimpHSL</link> *hsl,
 
178
                                                         <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
186
179
<para>
187
180
Convert a HSL color value to an RGB color value.</para>
188
181
<para>
196
189
</simpara></listitem></varlistentry>
197
190
</variablelist></refsect2>
198
191
<refsect2>
199
 
<title><anchor id="gimp-cmyk-to-rgb"/>gimp_cmyk_to_rgb ()</title>
200
 
<indexterm><primary>gimp_cmyk_to_rgb</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_cmyk_to_rgb                (const <link linkend="GimpCMYK">GimpCMYK</link> *cmyk,
201
 
                                             <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
 
192
<title><anchor id="gimp-cmyk-to-rgb" role="function"/>gimp_cmyk_to_rgb ()</title>
 
193
<indexterm><primary>gimp_cmyk_to_rgb</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_cmyk_to_rgb                    (const <link linkend="GimpCMYK">GimpCMYK</link> *cmyk,
 
194
                                                         <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
202
195
<para>
203
196
Does a simple transformation from the CMYK colorspace to the RGB
204
197
colorspace, without taking color profiles into account.</para>
213
206
</simpara></listitem></varlistentry>
214
207
</variablelist></refsect2>
215
208
<refsect2>
216
 
<title><anchor id="gimp-rgb-to-hwb"/>gimp_rgb_to_hwb ()</title>
217
 
<indexterm><primary>gimp_rgb_to_hwb</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_rgb_to_hwb                 (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
218
 
                                             <link linkend="gdouble">gdouble</link> *hue,
219
 
                                             <link linkend="gdouble">gdouble</link> *whiteness,
220
 
                                             <link linkend="gdouble">gdouble</link> *blackness);</programlisting>
 
209
<title><anchor id="gimp-rgb-to-hwb" role="function"/>gimp_rgb_to_hwb ()</title>
 
210
<indexterm><primary>gimp_rgb_to_hwb</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_rgb_to_hwb                     (const <link linkend="GimpRGB">GimpRGB</link> *rgb,
 
211
                                                         <link linkend="gdouble">gdouble</link> *hue,
 
212
                                                         <link linkend="gdouble">gdouble</link> *whiteness,
 
213
                                                         <link linkend="gdouble">gdouble</link> *blackness);</programlisting>
221
214
<para>
222
215
Theoretically, hue 0 (pure red) is identical to hue 6 in these transforms.
223
216
Pure red always maps to 6 in this implementation. Therefore UNDEFINED can
244
237
</simpara></listitem></varlistentry>
245
238
</variablelist></refsect2>
246
239
<refsect2>
247
 
<title><anchor id="gimp-hwb-to-rgb"/>gimp_hwb_to_rgb ()</title>
248
 
<indexterm><primary>gimp_hwb_to_rgb</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_hwb_to_rgb                 (<link linkend="gdouble">gdouble</link> hue,
249
 
                                             <link linkend="gdouble">gdouble</link> whiteness,
250
 
                                             <link linkend="gdouble">gdouble</link> blackness,
251
 
                                             <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
 
240
<title><anchor id="gimp-hwb-to-rgb" role="function"/>gimp_hwb_to_rgb ()</title>
 
241
<indexterm><primary>gimp_hwb_to_rgb</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_hwb_to_rgb                     (<link linkend="gdouble">gdouble</link> hue,
 
242
                                                         <link linkend="gdouble">gdouble</link> whiteness,
 
243
                                                         <link linkend="gdouble">gdouble</link> blackness,
 
244
                                                         <link linkend="GimpRGB">GimpRGB</link> *rgb);</programlisting>
252
245
<para>
253
246
H is defined in the range [0, 6] or UNDEFINED, B and W are both in the
254
247
range [0, 1]. The returned RGB values are all in the range [0, 1].</para>
269
262
</simpara></listitem></varlistentry>
270
263
</variablelist></refsect2>
271
264
<refsect2>
272
 
<title><anchor id="gimp-rgb-to-hsv-int"/>gimp_rgb_to_hsv_int ()</title>
273
 
<indexterm><primary>gimp_rgb_to_hsv_int</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_rgb_to_hsv_int             (<link linkend="gint">gint</link> *red,
274
 
                                             <link linkend="gint">gint</link> *green,
275
 
                                             <link linkend="gint">gint</link> *blue);</programlisting>
 
265
<title><anchor id="gimp-rgb-to-hsv-int" role="function"/>gimp_rgb_to_hsv_int ()</title>
 
266
<indexterm><primary>gimp_rgb_to_hsv_int</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_rgb_to_hsv_int                 (<link linkend="gint">gint</link> *red,
 
267
                                                         <link linkend="gint">gint</link> *green,
 
268
                                                         <link linkend="gint">gint</link> *blue);</programlisting>
276
269
<para>
277
270
The arguments are pointers to int representing channel values in
278
271
the RGB colorspace, and the values pointed to are all in the range
296
289
</simpara></listitem></varlistentry>
297
290
</variablelist></refsect2>
298
291
<refsect2>
299
 
<title><anchor id="gimp-hsv-to-rgb-int"/>gimp_hsv_to_rgb_int ()</title>
300
 
<indexterm><primary>gimp_hsv_to_rgb_int</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_hsv_to_rgb_int             (<link linkend="gint">gint</link> *hue,
301
 
                                             <link linkend="gint">gint</link> *saturation,
302
 
                                             <link linkend="gint">gint</link> *value);</programlisting>
 
292
<title><anchor id="gimp-hsv-to-rgb-int" role="function"/>gimp_hsv_to_rgb_int ()</title>
 
293
<indexterm><primary>gimp_hsv_to_rgb_int</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_hsv_to_rgb_int                 (<link linkend="gint">gint</link> *hue,
 
294
                                                         <link linkend="gint">gint</link> *saturation,
 
295
                                                         <link linkend="gint">gint</link> *value);</programlisting>
303
296
<para>
304
297
The arguments are pointers to int, with the values pointed to in the
305
298
following ranges:  H [0, 360], S [0, 255], V [0, 255].
321
314
</simpara></listitem></varlistentry>
322
315
</variablelist></refsect2>
323
316
<refsect2>
324
 
<title><anchor id="gimp-rgb-to-hsl-int"/>gimp_rgb_to_hsl_int ()</title>
325
 
<indexterm><primary>gimp_rgb_to_hsl_int</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_rgb_to_hsl_int             (<link linkend="gint">gint</link> *red,
326
 
                                             <link linkend="gint">gint</link> *green,
327
 
                                             <link linkend="gint">gint</link> *blue);</programlisting>
 
317
<title><anchor id="gimp-rgb-to-hsl-int" role="function"/>gimp_rgb_to_hsl_int ()</title>
 
318
<indexterm><primary>gimp_rgb_to_hsl_int</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_rgb_to_hsl_int                 (<link linkend="gint">gint</link> *red,
 
319
                                                         <link linkend="gint">gint</link> *green,
 
320
                                                         <link linkend="gint">gint</link> *blue);</programlisting>
328
321
<para>
329
322
The arguments are pointers to int representing channel values in the
330
323
RGB colorspace, and the values pointed to are all in the range [0, 255].
347
340
</simpara></listitem></varlistentry>
348
341
</variablelist></refsect2>
349
342
<refsect2>
350
 
<title><anchor id="gimp-rgb-to-cmyk-int"/>gimp_rgb_to_cmyk_int ()</title>
351
 
<indexterm><primary>gimp_rgb_to_cmyk_int</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_rgb_to_cmyk_int            (<link linkend="gint">gint</link> *red,
352
 
                                             <link linkend="gint">gint</link> *green,
353
 
                                             <link linkend="gint">gint</link> *blue,
354
 
                                             <link linkend="gint">gint</link> *pullout);</programlisting>
 
343
<title><anchor id="gimp-rgb-to-cmyk-int" role="function"/>gimp_rgb_to_cmyk_int ()</title>
 
344
<indexterm><primary>gimp_rgb_to_cmyk_int</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_rgb_to_cmyk_int                (<link linkend="gint">gint</link> *red,
 
345
                                                         <link linkend="gint">gint</link> *green,
 
346
                                                         <link linkend="gint">gint</link> *blue,
 
347
                                                         <link linkend="gint">gint</link> *pullout);</programlisting>
355
348
<para>
356
349
Does a naive conversion from RGB to CMYK colorspace. A simple
357
350
formula that doesn't take any color-profiles into account is used.
376
369
</simpara></listitem></varlistentry>
377
370
</variablelist></refsect2>
378
371
<refsect2>
379
 
<title><anchor id="gimp-cmyk-to-rgb-int"/>gimp_cmyk_to_rgb_int ()</title>
380
 
<indexterm><primary>gimp_cmyk_to_rgb_int</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_cmyk_to_rgb_int            (<link linkend="gint">gint</link> *cyan,
381
 
                                             <link linkend="gint">gint</link> *magenta,
382
 
                                             <link linkend="gint">gint</link> *yellow,
383
 
                                             <link linkend="gint">gint</link> *black);</programlisting>
 
372
<title><anchor id="gimp-cmyk-to-rgb-int" role="function"/>gimp_cmyk_to_rgb_int ()</title>
 
373
<indexterm><primary>gimp_cmyk_to_rgb_int</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_cmyk_to_rgb_int                (<link linkend="gint">gint</link> *cyan,
 
374
                                                         <link linkend="gint">gint</link> *magenta,
 
375
                                                         <link linkend="gint">gint</link> *yellow,
 
376
                                                         <link linkend="gint">gint</link> *black);</programlisting>
384
377
<para>
385
378
Does a naive conversion from CMYK to RGB colorspace. A simple
386
379
formula that doesn't take any color-profiles into account is used.</para>
401
394
</simpara></listitem></varlistentry>
402
395
</variablelist></refsect2>
403
396
<refsect2>
404
 
<title><anchor id="gimp-rgb-to-l-int"/>gimp_rgb_to_l_int ()</title>
405
 
<indexterm><primary>gimp_rgb_to_l_int</primary></indexterm><programlisting><link linkend="gint">gint</link>        gimp_rgb_to_l_int               (<link linkend="gint">gint</link> red,
406
 
                                             <link linkend="gint">gint</link> green,
407
 
                                             <link linkend="gint">gint</link> blue);</programlisting>
 
397
<title><anchor id="gimp-rgb-to-l-int" role="function"/>gimp_rgb_to_l_int ()</title>
 
398
<indexterm><primary>gimp_rgb_to_l_int</primary></indexterm><programlisting><link linkend="gint">gint</link>                gimp_rgb_to_l_int                   (<link linkend="gint">gint</link> red,
 
399
                                                         <link linkend="gint">gint</link> green,
 
400
                                                         <link linkend="gint">gint</link> blue);</programlisting>
408
401
<para>
409
402
Calculates the lightness value of an RGB triplet with the formula
410
403
L = (max(R, G, B) + min (R, G, B)) / 2</para>
424
417
</simpara></listitem></varlistentry>
425
418
</variablelist></refsect2>
426
419
<refsect2>
427
 
<title><anchor id="gimp-hsl-to-rgb-int"/>gimp_hsl_to_rgb_int ()</title>
428
 
<indexterm><primary>gimp_hsl_to_rgb_int</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_hsl_to_rgb_int             (<link linkend="gint">gint</link> *hue,
429
 
                                             <link linkend="gint">gint</link> *saturation,
430
 
                                             <link linkend="gint">gint</link> *lightness);</programlisting>
 
420
<title><anchor id="gimp-hsl-to-rgb-int" role="function"/>gimp_hsl_to_rgb_int ()</title>
 
421
<indexterm><primary>gimp_hsl_to_rgb_int</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_hsl_to_rgb_int                 (<link linkend="gint">gint</link> *hue,
 
422
                                                         <link linkend="gint">gint</link> *saturation,
 
423
                                                         <link linkend="gint">gint</link> *lightness);</programlisting>
431
424
<para>
432
425
The arguments are pointers to int, with the values pointed to in the
433
426
following ranges:  H [0, 360], L [0, 255], S [0, 255].
449
442
</simpara></listitem></varlistentry>
450
443
</variablelist></refsect2>
451
444
<refsect2>
452
 
<title><anchor id="gimp-rgb-to-hsv4"/>gimp_rgb_to_hsv4 ()</title>
453
 
<indexterm><primary>gimp_rgb_to_hsv4</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_rgb_to_hsv4                (<link linkend="guchar">guchar</link> *rgb,
454
 
                                             <link linkend="gdouble">gdouble</link> *hue,
455
 
                                             <link linkend="gdouble">gdouble</link> *saturation,
456
 
                                             <link linkend="gdouble">gdouble</link> *value);</programlisting>
 
445
<title><anchor id="gimp-rgb-to-hsv4" role="function"/>gimp_rgb_to_hsv4 ()</title>
 
446
<indexterm><primary>gimp_rgb_to_hsv4</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_rgb_to_hsv4                    (const <link linkend="guchar">guchar</link> *rgb,
 
447
                                                         <link linkend="gdouble">gdouble</link> *hue,
 
448
                                                         <link linkend="gdouble">gdouble</link> *saturation,
 
449
                                                         <link linkend="gdouble">gdouble</link> *value);</programlisting>
457
450
<para>
458
451
</para>
459
452
<para>
474
467
</simpara></listitem></varlistentry>
475
468
</variablelist></refsect2>
476
469
<refsect2>
477
 
<title><anchor id="gimp-hsv-to-rgb4"/>gimp_hsv_to_rgb4 ()</title>
478
 
<indexterm><primary>gimp_hsv_to_rgb4</primary></indexterm><programlisting><link linkend="void">void</link>        gimp_hsv_to_rgb4                (<link linkend="guchar">guchar</link> *rgb,
479
 
                                             <link linkend="gdouble">gdouble</link> hue,
480
 
                                             <link linkend="gdouble">gdouble</link> saturation,
481
 
                                             <link linkend="gdouble">gdouble</link> value);</programlisting>
 
470
<title><anchor id="gimp-hsv-to-rgb4" role="function"/>gimp_hsv_to_rgb4 ()</title>
 
471
<indexterm><primary>gimp_hsv_to_rgb4</primary></indexterm><programlisting><link linkend="void">void</link>                gimp_hsv_to_rgb4                    (<link linkend="guchar">guchar</link> *rgb,
 
472
                                                         <link linkend="gdouble">gdouble</link> hue,
 
473
                                                         <link linkend="gdouble">gdouble</link> saturation,
 
474
                                                         <link linkend="gdouble">gdouble</link> value);</programlisting>
482
475
<para>
483
476
</para>
484
477
<para>