← Back to branch summary

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

« back to all changes in this revision

Viewing changes to devel-docs/libgimp/html/libgimp-gimpcolor.html

  • 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/libgimp/html/libgimp-gimpcolor.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>gimpcolor</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
7
<link rel="start" href="index.html" title="GIMP Library Reference Manual">
8
 
<link rel="up" href="libgimp-image.html" title="Manupulating Images and all their Properties">
 
8
<link rel="up" href="libgimp-image.html" title="Manupulating Images and their Properties">
9
9
<link rel="prev" href="libgimp-gimpchannel.html" title="gimpchannel">
10
10
<link rel="next" href="libgimp-gimpconvert.html" title="gimpconvert">
11
 
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
 
<link rel="part" href="gimpdefinitions.html" title="Part&#160;I.&#160;GIMP Constants">
14
 
<link rel="part" href="libgimp.html" title="Part&#160;II.&#160;GIMP Library">
 
13
<link rel="part" href="libgimp.html" title="Part&#160;I.&#160;GIMP Library">
15
14
<link rel="chapter" href="libgimp-general.html" title="Functions not Related to Specific Images">
16
 
<link rel="chapter" href="libgimp-image.html" title="Manupulating Images and all their Properties">
 
15
<link rel="chapter" href="libgimp-image.html" title="Manupulating Images and their Properties">
17
16
<link rel="chapter" href="libgimp-data.html" title="Data Objects">
18
17
<link rel="chapter" href="libgimp-selectors.html" title="Controlling the Core's Selection Dialogs">
19
 
<link rel="part" href="libgimpui.html" title="Part&#160;III.&#160;GIMP User Interface Library">
 
18
<link rel="part" href="libgimpui.html" title="Part&#160;II.&#160;GIMP User Interface Library">
20
19
<link rel="chapter" href="libgimpui-hierarchy.html" title="Object Hierarchy">
 
20
<link rel="index" href="libgimp-index.html" title="Index">
 
21
<link rel="index" href="libgimp-index-new-in-2-2.html" title="Index of new symbols in GIMP 2.2">
 
22
<link rel="index" href="libgimp-index-new-in-2-4.html" title="Index of new symbols in GIMP 2.4">
 
23
<link rel="index" href="libgimp-index-deprecated.html" title="Index of deprecated symbols">
21
24
</head>
22
25
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
23
26
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
28
31
<th width="100%" align="center">GIMP Library Reference Manual</th>
29
32
<td><a accesskey="n" href="libgimp-gimpconvert.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
30
33
</tr>
31
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2551753" class="shortcut">Top</a>
 
34
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2594982" class="shortcut">Top</a>
32
35
                  &#160;|&#160;
33
 
                  <a href="#id2574991" class="shortcut">Description</a></nobr></td></tr>
 
36
                  <a href="#id2612500" class="shortcut">Description</a></nobr></td></tr>
34
37
</table>
35
38
<div class="refentry" lang="en">
36
39
<a name="libgimp-gimpcolor"></a><div class="titlepage"></div>
37
40
<div class="refnamediv"><table width="100%"><tr>
38
41
<td valign="top">
39
42
<h2>
40
 
<a name="id2551753"></a><span class="refentrytitle">gimpcolor</span>
 
43
<a name="id2594982"></a><span class="refentrytitle">gimpcolor</span>
41
44
</h2>
42
45
<p>gimpcolor &#8212; Functions for manipulating color.</p>
43
46
</td>
49
52
 
50
53
 
51
54
 
52
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-brightness-contrast">gimp_brightness_contrast</a>        (gint32 drawable_ID,
53
 
                                             gint brightness,
54
 
                                             gint contrast);
55
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-levels">gimp_levels</a>                     (gint32 drawable_ID,
56
 
                                             <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
57
 
                                             gint low_input,
58
 
                                             gint high_input,
59
 
                                             gdouble gamma,
60
 
                                             gint low_output,
61
 
                                             gint high_output);
62
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-levels-auto">gimp_levels_auto</a>                (gint32 drawable_ID);
63
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-levels-stretch">gimp_levels_stretch</a>             (gint32 drawable_ID);
64
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-posterize">gimp_posterize</a>                  (gint32 drawable_ID,
65
 
                                             gint levels);
66
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-desaturate">gimp_desaturate</a>                 (gint32 drawable_ID);
67
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-equalize">gimp_equalize</a>                   (gint32 drawable_ID,
68
 
                                             gboolean mask_only);
69
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-invert">gimp_invert</a>                     (gint32 drawable_ID);
70
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-curves-spline">gimp_curves_spline</a>              (gint32 drawable_ID,
71
 
                                             <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
72
 
                                             gint num_points,
73
 
                                             const guint8 *control_pts);
74
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-curves-explicit">gimp_curves_explicit</a>            (gint32 drawable_ID,
75
 
                                             <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
76
 
                                             gint num_bytes,
77
 
                                             const guint8 *curve);
78
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-color-balance">gimp_color_balance</a>              (gint32 drawable_ID,
79
 
                                             <a href="libgimp-gimpenums.html#GimpTransferMode">GimpTransferMode</a> transfer_mode,
80
 
                                             gboolean preserve_lum,
81
 
                                             gdouble cyan_red,
82
 
                                             gdouble magenta_green,
83
 
                                             gdouble yellow_blue);
84
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-colorize">gimp_colorize</a>                   (gint32 drawable_ID,
85
 
                                             gdouble hue,
86
 
                                             gdouble saturation,
87
 
                                             gdouble lightness);
88
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-histogram">gimp_histogram</a>                  (gint32 drawable_ID,
89
 
                                             <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
90
 
                                             gint start_range,
91
 
                                             gint end_range,
92
 
                                             gdouble *mean,
93
 
                                             gdouble *std_dev,
94
 
                                             gdouble *median,
95
 
                                             gdouble *pixels,
96
 
                                             gdouble *count,
97
 
                                             gdouble *percentile);
98
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-hue-saturation">gimp_hue_saturation</a>             (gint32 drawable_ID,
99
 
                                             <a href="libgimp-gimpenums.html#GimpHueRange">GimpHueRange</a> hue_range,
100
 
                                             gdouble hue_offset,
101
 
                                             gdouble lightness,
102
 
                                             gdouble saturation);
103
 
gboolean    <a href="libgimp-gimpcolor.html#gimp-threshold">gimp_threshold</a>                  (gint32 drawable_ID,
104
 
                                             gint low_threshold,
105
 
                                             gint high_threshold);
 
55
gboolean            <a href="libgimp-gimpcolor.html#gimp-brightness-contrast">gimp_brightness_contrast</a>            (gint32 drawable_ID,
 
56
                                                         gint brightness,
 
57
                                                         gint contrast);
 
58
gboolean            <a href="libgimp-gimpcolor.html#gimp-levels">gimp_levels</a>                         (gint32 drawable_ID,
 
59
                                                         <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
 
60
                                                         gint low_input,
 
61
                                                         gint high_input,
 
62
                                                         gdouble gamma,
 
63
                                                         gint low_output,
 
64
                                                         gint high_output);
 
65
gboolean            <a href="libgimp-gimpcolor.html#gimp-levels-auto">gimp_levels_auto</a>                    (gint32 drawable_ID);
 
66
gboolean            <a href="libgimp-gimpcolor.html#gimp-levels-stretch">gimp_levels_stretch</a>                 (gint32 drawable_ID);
 
67
gboolean            <a href="libgimp-gimpcolor.html#gimp-posterize">gimp_posterize</a>                      (gint32 drawable_ID,
 
68
                                                         gint levels);
 
69
gboolean            <a href="libgimp-gimpcolor.html#gimp-desaturate">gimp_desaturate</a>                     (gint32 drawable_ID);
 
70
gboolean            <a href="libgimp-gimpcolor.html#gimp-desaturate-full">gimp_desaturate_full</a>                (gint32 drawable_ID,
 
71
                                                         <a
 
72
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpDesaturateMode"
 
73
>GimpDesaturateMode</a> desaturate_mode);
 
74
gboolean            <a href="libgimp-gimpcolor.html#gimp-equalize">gimp_equalize</a>                       (gint32 drawable_ID,
 
75
                                                         gboolean mask_only);
 
76
gboolean            <a href="libgimp-gimpcolor.html#gimp-invert">gimp_invert</a>                         (gint32 drawable_ID);
 
77
gboolean            <a href="libgimp-gimpcolor.html#gimp-curves-spline">gimp_curves_spline</a>                  (gint32 drawable_ID,
 
78
                                                         <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
 
79
                                                         gint num_points,
 
80
                                                         const guint8 *control_pts);
 
81
gboolean            <a href="libgimp-gimpcolor.html#gimp-curves-explicit">gimp_curves_explicit</a>                (gint32 drawable_ID,
 
82
                                                         <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
 
83
                                                         gint num_bytes,
 
84
                                                         const guint8 *curve);
 
85
gboolean            <a href="libgimp-gimpcolor.html#gimp-color-balance">gimp_color_balance</a>                  (gint32 drawable_ID,
 
86
                                                         <a
 
87
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpTransferMode"
 
88
>GimpTransferMode</a> transfer_mode,
 
89
                                                         gboolean preserve_lum,
 
90
                                                         gdouble cyan_red,
 
91
                                                         gdouble magenta_green,
 
92
                                                         gdouble yellow_blue);
 
93
gboolean            <a href="libgimp-gimpcolor.html#gimp-colorize">gimp_colorize</a>                       (gint32 drawable_ID,
 
94
                                                         gdouble hue,
 
95
                                                         gdouble saturation,
 
96
                                                         gdouble lightness);
 
97
gboolean            <a href="libgimp-gimpcolor.html#gimp-histogram">gimp_histogram</a>                      (gint32 drawable_ID,
 
98
                                                         <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
 
99
                                                         gint start_range,
 
100
                                                         gint end_range,
 
101
                                                         gdouble *mean,
 
102
                                                         gdouble *std_dev,
 
103
                                                         gdouble *median,
 
104
                                                         gdouble *pixels,
 
105
                                                         gdouble *count,
 
106
                                                         gdouble *percentile);
 
107
gboolean            <a href="libgimp-gimpcolor.html#gimp-hue-saturation">gimp_hue_saturation</a>                 (gint32 drawable_ID,
 
108
                                                         <a href="libgimp-gimpenums.html#GimpHueRange">GimpHueRange</a> hue_range,
 
109
                                                         gdouble hue_offset,
 
110
                                                         gdouble lightness,
 
111
                                                         gdouble saturation);
 
112
gboolean            <a href="libgimp-gimpcolor.html#gimp-threshold">gimp_threshold</a>                      (gint32 drawable_ID,
 
113
                                                         gint low_threshold,
 
114
                                                         gint high_threshold);
106
115
</pre>
107
116
</div>
108
117
<div class="refsect1" lang="en">
109
 
<a name="id2574991"></a><h2>Description</h2>
 
118
<a name="id2612500"></a><h2>Description</h2>
110
119
<p>
111
120
Functions for manipulating color, including curves and histograms.
112
121
 
113
122
</p>
114
123
</div>
115
124
<div class="refsect1" lang="en">
116
 
<a name="id2575008"></a><h2>Details</h2>
 
125
<a name="id2612517"></a><h2>Details</h2>
117
126
<div class="refsect2" lang="en">
118
 
<a name="id2575019"></a><h3>
 
127
<a name="id2612528"></a><h3>
119
128
<a name="gimp-brightness-contrast"></a>gimp_brightness_contrast ()</h3>
120
 
<a class="indexterm" name="id2575030"></a><pre class="programlisting">gboolean    gimp_brightness_contrast        (gint32 drawable_ID,
121
 
                                             gint brightness,
122
 
                                             gint contrast);</pre>
 
129
<a class="indexterm" name="id2612539"></a><pre class="programlisting">gboolean            gimp_brightness_contrast            (gint32 drawable_ID,
 
130
                                                         gint brightness,
 
131
                                                         gint contrast);</pre>
123
132
<p>
124
133
Modify brightness/contrast in the specified drawable.
125
134
</p>
134
143
<col align="left" valign="top">
135
144
<tbody>
136
145
<tr>
137
 
<td>
138
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
146
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
139
147
<td> The drawable.
140
148
</td>
141
149
</tr>
142
150
<tr>
143
 
<td>
144
 
<span class="term"><em class="parameter"><code>brightness</code></em>&#160;:</span></td>
 
151
<td><span class="term"><em class="parameter"><code>brightness</code></em>&#160;:</span></td>
145
152
<td> Brightness adjustment.
146
153
</td>
147
154
</tr>
148
155
<tr>
149
 
<td>
150
 
<span class="term"><em class="parameter"><code>contrast</code></em>&#160;:</span></td>
 
156
<td><span class="term"><em class="parameter"><code>contrast</code></em>&#160;:</span></td>
151
157
<td> Contrast adjustment.
152
158
</td>
153
159
</tr>
154
160
<tr>
155
 
<td>
156
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
161
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
157
162
<td> TRUE on success.
158
163
</td>
159
164
</tr>
162
167
</div>
163
168
<hr>
164
169
<div class="refsect2" lang="en">
165
 
<a name="id2575138"></a><h3>
 
170
<a name="id2609020"></a><h3>
166
171
<a name="gimp-levels"></a>gimp_levels ()</h3>
167
 
<a class="indexterm" name="id2575150"></a><pre class="programlisting">gboolean    gimp_levels                     (gint32 drawable_ID,
168
 
                                             <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
169
 
                                             gint low_input,
170
 
                                             gint high_input,
171
 
                                             gdouble gamma,
172
 
                                             gint low_output,
173
 
                                             gint high_output);</pre>
 
172
<a class="indexterm" name="id2609032"></a><pre class="programlisting">gboolean            gimp_levels                         (gint32 drawable_ID,
 
173
                                                         <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
 
174
                                                         gint low_input,
 
175
                                                         gint high_input,
 
176
                                                         gdouble gamma,
 
177
                                                         gint low_output,
 
178
                                                         gint high_output);</pre>
174
179
<p>
175
180
Modifies intensity levels in the specified drawable.
176
181
</p>
194
199
<col align="left" valign="top">
195
200
<tbody>
196
201
<tr>
197
 
<td>
198
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
202
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
199
203
<td> The drawable.
200
204
</td>
201
205
</tr>
202
206
<tr>
203
 
<td>
204
 
<span class="term"><em class="parameter"><code>channel</code></em>&#160;:</span></td>
 
207
<td><span class="term"><em class="parameter"><code>channel</code></em>&#160;:</span></td>
205
208
<td> The channel to modify.
206
209
</td>
207
210
</tr>
208
211
<tr>
209
 
<td>
210
 
<span class="term"><em class="parameter"><code>low_input</code></em>&#160;:</span></td>
 
212
<td><span class="term"><em class="parameter"><code>low_input</code></em>&#160;:</span></td>
211
213
<td> Intensity of lowest input.
212
214
</td>
213
215
</tr>
214
216
<tr>
215
 
<td>
216
 
<span class="term"><em class="parameter"><code>high_input</code></em>&#160;:</span></td>
 
217
<td><span class="term"><em class="parameter"><code>high_input</code></em>&#160;:</span></td>
217
218
<td> Intensity of highest input.
218
219
</td>
219
220
</tr>
220
221
<tr>
221
 
<td>
222
 
<span class="term"><em class="parameter"><code>gamma</code></em>&#160;:</span></td>
 
222
<td><span class="term"><em class="parameter"><code>gamma</code></em>&#160;:</span></td>
223
223
<td> Gamma correction factor.
224
224
</td>
225
225
</tr>
226
226
<tr>
227
 
<td>
228
 
<span class="term"><em class="parameter"><code>low_output</code></em>&#160;:</span></td>
 
227
<td><span class="term"><em class="parameter"><code>low_output</code></em>&#160;:</span></td>
229
228
<td> Intensity of lowest output.
230
229
</td>
231
230
</tr>
232
231
<tr>
233
 
<td>
234
 
<span class="term"><em class="parameter"><code>high_output</code></em>&#160;:</span></td>
 
232
<td><span class="term"><em class="parameter"><code>high_output</code></em>&#160;:</span></td>
235
233
<td> Intensity of highest output.
236
234
</td>
237
235
</tr>
238
236
<tr>
239
 
<td>
240
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
237
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
241
238
<td> TRUE on success.
242
239
</td>
243
240
</tr>
246
243
</div>
247
244
<hr>
248
245
<div class="refsect2" lang="en">
249
 
<a name="id2581814"></a><h3>
 
246
<a name="id2617385"></a><h3>
250
247
<a name="gimp-levels-auto"></a>gimp_levels_auto ()</h3>
251
 
<a class="indexterm" name="id2581826"></a><pre class="programlisting">gboolean    gimp_levels_auto                (gint32 drawable_ID);</pre>
 
248
<a class="indexterm" name="id2617397"></a><pre class="programlisting">gboolean            gimp_levels_auto                    (gint32 drawable_ID);</pre>
252
249
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
253
250
<h3 class="title">Warning</h3>
254
251
<p><code class="literal">gimp_levels_auto</code> is deprecated and should not be used in newly-written code.</p>
262
259
<col align="left" valign="top">
263
260
<tbody>
264
261
<tr>
265
 
<td>
266
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
262
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
267
263
<td> The drawable.
268
264
</td>
269
265
</tr>
270
266
<tr>
271
 
<td>
272
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
267
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
273
268
<td> TRUE on success.
274
269
</td>
275
270
</tr>
278
273
</div>
279
274
<hr>
280
275
<div class="refsect2" lang="en">
281
 
<a name="id2581898"></a><h3>
 
276
<a name="id2617471"></a><h3>
282
277
<a name="gimp-levels-stretch"></a>gimp_levels_stretch ()</h3>
283
 
<a class="indexterm" name="id2581909"></a><pre class="programlisting">gboolean    gimp_levels_stretch             (gint32 drawable_ID);</pre>
 
278
<a class="indexterm" name="id2617481"></a><pre class="programlisting">gboolean            gimp_levels_stretch                 (gint32 drawable_ID);</pre>
284
279
<p>
285
280
Automatically modifies intensity levels in the specified drawable.
286
281
</p>
297
292
<col align="left" valign="top">
298
293
<tbody>
299
294
<tr>
300
 
<td>
301
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
295
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
302
296
<td> The drawable.
303
297
</td>
304
298
</tr>
305
299
<tr>
306
 
<td>
307
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
300
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
308
301
<td> TRUE on success.
309
302
</td>
310
303
</tr>
313
306
</div>
314
307
<hr>
315
308
<div class="refsect2" lang="en">
316
 
<a name="id2581971"></a><h3>
 
309
<a name="id2617544"></a><h3>
317
310
<a name="gimp-posterize"></a>gimp_posterize ()</h3>
318
 
<a class="indexterm" name="id2581981"></a><pre class="programlisting">gboolean    gimp_posterize                  (gint32 drawable_ID,
319
 
                                             gint levels);</pre>
 
311
<a class="indexterm" name="id2617555"></a><pre class="programlisting">gboolean            gimp_posterize                      (gint32 drawable_ID,
 
312
                                                         gint levels);</pre>
320
313
<p>
321
314
Posterize the specified drawable.
322
315
</p>
330
323
<col align="left" valign="top">
331
324
<tbody>
332
325
<tr>
333
 
<td>
334
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
326
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
335
327
<td> The drawable.
336
328
</td>
337
329
</tr>
338
330
<tr>
339
 
<td>
340
 
<span class="term"><em class="parameter"><code>levels</code></em>&#160;:</span></td>
 
331
<td><span class="term"><em class="parameter"><code>levels</code></em>&#160;:</span></td>
341
332
<td> Levels of posterization.
342
333
</td>
343
334
</tr>
344
335
<tr>
345
 
<td>
346
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
336
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
347
337
<td> TRUE on success.
348
338
</td>
349
339
</tr>
352
342
</div>
353
343
<hr>
354
344
<div class="refsect2" lang="en">
355
 
<a name="id2582058"></a><h3>
 
345
<a name="id2617632"></a><h3>
356
346
<a name="gimp-desaturate"></a>gimp_desaturate ()</h3>
357
 
<a class="indexterm" name="id2582068"></a><pre class="programlisting">gboolean    gimp_desaturate                 (gint32 drawable_ID);</pre>
 
347
<a class="indexterm" name="id2617643"></a><pre class="programlisting">gboolean            gimp_desaturate                     (gint32 drawable_ID);</pre>
358
348
<p>
359
349
Desaturate the contents of the specified drawable.
360
350
</p>
368
358
<col align="left" valign="top">
369
359
<tbody>
370
360
<tr>
371
 
<td>
372
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
373
 
<td> The drawable.
374
 
</td>
375
 
</tr>
376
 
<tr>
377
 
<td>
378
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
379
 
<td> TRUE on success.
380
 
</td>
381
 
</tr>
382
 
</tbody>
383
 
</table></div>
384
 
</div>
385
 
<hr>
386
 
<div class="refsect2" lang="en">
387
 
<a name="id2582128"></a><h3>
 
361
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
362
<td> The drawable.
 
363
</td>
 
364
</tr>
 
365
<tr>
 
366
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
367
<td> TRUE on success.
 
368
</td>
 
369
</tr>
 
370
</tbody>
 
371
</table></div>
 
372
</div>
 
373
<hr>
 
374
<div class="refsect2" lang="en">
 
375
<a name="id2617703"></a><h3>
 
376
<a name="gimp-desaturate-full"></a>gimp_desaturate_full ()</h3>
 
377
<a class="indexterm" name="id2617715"></a><pre class="programlisting">gboolean            gimp_desaturate_full                (gint32 drawable_ID,
 
378
                                                         <a
 
379
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpDesaturateMode"
 
380
>GimpDesaturateMode</a> desaturate_mode);</pre>
 
381
<p>
 
382
Desaturate the contents of the specified drawable, with the
 
383
specified formula.
 
384
</p>
 
385
<p>
 
386
This procedure desaturates the contents of the specified drawable,
 
387
with the specified formula. This procedure only works on drawables
 
388
of type RGB color.</p>
 
389
<p>
 
390
 
 
391
</p>
 
392
<div class="variablelist"><table border="0">
 
393
<col align="left" valign="top">
 
394
<tbody>
 
395
<tr>
 
396
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
397
<td> The drawable.
 
398
</td>
 
399
</tr>
 
400
<tr>
 
401
<td><span class="term"><em class="parameter"><code>desaturate_mode</code></em>&#160;:</span></td>
 
402
<td> The formula to use to desaturate.
 
403
</td>
 
404
</tr>
 
405
<tr>
 
406
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
407
<td> TRUE on success.
 
408
 
 
409
</td>
 
410
</tr>
 
411
</tbody>
 
412
</table></div>
 
413
<p class="since">Since  GIMP 2.4
 
414
</p>
 
415
</div>
 
416
<hr>
 
417
<div class="refsect2" lang="en">
 
418
<a name="id2617801"></a><h3>
388
419
<a name="gimp-equalize"></a>gimp_equalize ()</h3>
389
 
<a class="indexterm" name="id2582139"></a><pre class="programlisting">gboolean    gimp_equalize                   (gint32 drawable_ID,
390
 
                                             gboolean mask_only);</pre>
 
420
<a class="indexterm" name="id2617812"></a><pre class="programlisting">gboolean            gimp_equalize                       (gint32 drawable_ID,
 
421
                                                         gboolean mask_only);</pre>
391
422
<p>
392
423
Equalize the contents of the specified drawable.
393
424
</p>
407
438
<col align="left" valign="top">
408
439
<tbody>
409
440
<tr>
410
 
<td>
411
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
441
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
412
442
<td> The drawable.
413
443
</td>
414
444
</tr>
415
445
<tr>
416
 
<td>
417
 
<span class="term"><em class="parameter"><code>mask_only</code></em>&#160;:</span></td>
 
446
<td><span class="term"><em class="parameter"><code>mask_only</code></em>&#160;:</span></td>
418
447
<td> Equalization option.
419
448
</td>
420
449
</tr>
421
450
<tr>
422
 
<td>
423
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
451
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
424
452
<td> TRUE on success.
425
453
</td>
426
454
</tr>
429
457
</div>
430
458
<hr>
431
459
<div class="refsect2" lang="en">
432
 
<a name="id2582224"></a><h3>
 
460
<a name="id2617897"></a><h3>
433
461
<a name="gimp-invert"></a>gimp_invert ()</h3>
434
 
<a class="indexterm" name="id2582234"></a><pre class="programlisting">gboolean    gimp_invert                     (gint32 drawable_ID);</pre>
 
462
<a class="indexterm" name="id2617908"></a><pre class="programlisting">gboolean            gimp_invert                         (gint32 drawable_ID);</pre>
435
463
<p>
436
464
Invert the contents of the specified drawable.
437
465
</p>
447
475
<col align="left" valign="top">
448
476
<tbody>
449
477
<tr>
450
 
<td>
451
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
478
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
452
479
<td> The drawable.
453
480
</td>
454
481
</tr>
455
482
<tr>
456
 
<td>
457
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
483
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
458
484
<td> TRUE on success.
459
485
</td>
460
486
</tr>
463
489
</div>
464
490
<hr>
465
491
<div class="refsect2" lang="en">
466
 
<a name="id2582296"></a><h3>
 
492
<a name="id2617969"></a><h3>
467
493
<a name="gimp-curves-spline"></a>gimp_curves_spline ()</h3>
468
 
<a class="indexterm" name="id2582306"></a><pre class="programlisting">gboolean    gimp_curves_spline              (gint32 drawable_ID,
469
 
                                             <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
470
 
                                             gint num_points,
471
 
                                             const guint8 *control_pts);</pre>
 
494
<a class="indexterm" name="id2617980"></a><pre class="programlisting">gboolean            gimp_curves_spline                  (gint32 drawable_ID,
 
495
                                                         <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
 
496
                                                         gint num_points,
 
497
                                                         const guint8 *control_pts);</pre>
472
498
<p>
473
499
Modifies the intensity curve(s) for specified drawable.
474
500
</p>
478
504
channel can be either an intensity component, or the value. The
479
505
'control_pts' parameter is an array of integers which define a set
480
506
of control points which describe a Catmull Rom spline which yields
481
 
the final intensity curve. Use the 'gimp_curves_explicit' function
 
507
the final intensity curve. Use the <a href="libgimp-gimpcolor.html#gimp-curves-explicit"><code class="function">gimp_curves_explicit()</code></a> function
482
508
to explicitly modify intensity levels.</p>
483
509
<p>
484
510
 
487
513
<col align="left" valign="top">
488
514
<tbody>
489
515
<tr>
490
 
<td>
491
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
516
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
492
517
<td> The drawable.
493
518
</td>
494
519
</tr>
495
520
<tr>
496
 
<td>
497
 
<span class="term"><em class="parameter"><code>channel</code></em>&#160;:</span></td>
 
521
<td><span class="term"><em class="parameter"><code>channel</code></em>&#160;:</span></td>
498
522
<td> The channel to modify.
499
523
</td>
500
524
</tr>
501
525
<tr>
502
 
<td>
503
 
<span class="term"><em class="parameter"><code>num_points</code></em>&#160;:</span></td>
 
526
<td><span class="term"><em class="parameter"><code>num_points</code></em>&#160;:</span></td>
504
527
<td> The number of values in the control point array.
505
528
</td>
506
529
</tr>
507
530
<tr>
508
 
<td>
509
 
<span class="term"><em class="parameter"><code>control_pts</code></em>&#160;:</span></td>
 
531
<td><span class="term"><em class="parameter"><code>control_pts</code></em>&#160;:</span></td>
510
532
<td> The spline control points: { cp1.x, cp1.y, cp2.x, cp2.y, ... }.
511
533
</td>
512
534
</tr>
513
535
<tr>
514
 
<td>
515
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
536
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
516
537
<td> TRUE on success.
517
538
</td>
518
539
</tr>
521
542
</div>
522
543
<hr>
523
544
<div class="refsect2" lang="en">
524
 
<a name="id2582430"></a><h3>
 
545
<a name="id2618112"></a><h3>
525
546
<a name="gimp-curves-explicit"></a>gimp_curves_explicit ()</h3>
526
 
<a class="indexterm" name="id2582440"></a><pre class="programlisting">gboolean    gimp_curves_explicit            (gint32 drawable_ID,
527
 
                                             <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
528
 
                                             gint num_bytes,
529
 
                                             const guint8 *curve);</pre>
 
547
<a class="indexterm" name="id2618123"></a><pre class="programlisting">gboolean            gimp_curves_explicit                (gint32 drawable_ID,
 
548
                                                         <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
 
549
                                                         gint num_bytes,
 
550
                                                         const guint8 *curve);</pre>
530
551
<p>
531
552
Modifies the intensity curve(s) for specified drawable.
532
553
</p>
536
557
channel can be either an intensity component, or the value. The
537
558
'curve' parameter is an array of bytes which explicitly defines how
538
559
each pixel value in the drawable will be modified. Use the
539
 
'gimp_curves_spline' function to modify intensity levels with
 
560
<a href="libgimp-gimpcolor.html#gimp-curves-spline"><code class="function">gimp_curves_spline()</code></a> function to modify intensity levels with
540
561
Catmull Rom splines.</p>
541
562
<p>
542
563
 
545
566
<col align="left" valign="top">
546
567
<tbody>
547
568
<tr>
548
 
<td>
549
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
569
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
550
570
<td> The drawable.
551
571
</td>
552
572
</tr>
553
573
<tr>
554
 
<td>
555
 
<span class="term"><em class="parameter"><code>channel</code></em>&#160;:</span></td>
 
574
<td><span class="term"><em class="parameter"><code>channel</code></em>&#160;:</span></td>
556
575
<td> The channel to modify.
557
576
</td>
558
577
</tr>
559
578
<tr>
560
 
<td>
561
 
<span class="term"><em class="parameter"><code>num_bytes</code></em>&#160;:</span></td>
 
579
<td><span class="term"><em class="parameter"><code>num_bytes</code></em>&#160;:</span></td>
562
580
<td> The number of bytes in the new curve (always 256).
563
581
</td>
564
582
</tr>
565
583
<tr>
566
 
<td>
567
 
<span class="term"><em class="parameter"><code>curve</code></em>&#160;:</span></td>
 
584
<td><span class="term"><em class="parameter"><code>curve</code></em>&#160;:</span></td>
568
585
<td> The explicit curve.
569
586
</td>
570
587
</tr>
571
588
<tr>
572
 
<td>
573
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
589
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
574
590
<td> TRUE on success.
575
591
</td>
576
592
</tr>
579
595
</div>
580
596
<hr>
581
597
<div class="refsect2" lang="en">
582
 
<a name="id2582563"></a><h3>
 
598
<a name="id2618254"></a><h3>
583
599
<a name="gimp-color-balance"></a>gimp_color_balance ()</h3>
584
 
<a class="indexterm" name="id2582573"></a><pre class="programlisting">gboolean    gimp_color_balance              (gint32 drawable_ID,
585
 
                                             <a href="libgimp-gimpenums.html#GimpTransferMode">GimpTransferMode</a> transfer_mode,
586
 
                                             gboolean preserve_lum,
587
 
                                             gdouble cyan_red,
588
 
                                             gdouble magenta_green,
589
 
                                             gdouble yellow_blue);</pre>
 
600
<a class="indexterm" name="id2618264"></a><pre class="programlisting">gboolean            gimp_color_balance                  (gint32 drawable_ID,
 
601
                                                         <a
 
602
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpTransferMode"
 
603
>GimpTransferMode</a> transfer_mode,
 
604
                                                         gboolean preserve_lum,
 
605
                                                         gdouble cyan_red,
 
606
                                                         gdouble magenta_green,
 
607
                                                         gdouble yellow_blue);</pre>
590
608
<p>
591
609
Modify the color balance of the specified drawable.
592
610
</p>
596
614
yellow-blue. Negative values increase the amount of the former,
597
615
positive values increase the amount of the latter. Color balance can
598
616
be controlled with the 'transfer_mode' setting, which allows
599
 
shadows, midtones, and highlights in an image to be affected
600
 
differently. The 'preserve_lum' parameter, if non-zero, ensures that
601
 
the luminosity of each pixel remains fixed.</p>
 
617
shadows, mid-tones, and highlights in an image to be affected
 
618
differently. The 'preserve-lum' parameter, if TRUE, ensures that the
 
619
luminosity of each pixel remains fixed.</p>
602
620
<p>
603
621
 
604
622
</p>
606
624
<col align="left" valign="top">
607
625
<tbody>
608
626
<tr>
609
 
<td>
610
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
627
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
611
628
<td> The drawable.
612
629
</td>
613
630
</tr>
614
631
<tr>
615
 
<td>
616
 
<span class="term"><em class="parameter"><code>transfer_mode</code></em>&#160;:</span></td>
 
632
<td><span class="term"><em class="parameter"><code>transfer_mode</code></em>&#160;:</span></td>
617
633
<td> Transfer mode.
618
634
</td>
619
635
</tr>
620
636
<tr>
621
 
<td>
622
 
<span class="term"><em class="parameter"><code>preserve_lum</code></em>&#160;:</span></td>
 
637
<td><span class="term"><em class="parameter"><code>preserve_lum</code></em>&#160;:</span></td>
623
638
<td> Preserve luminosity values at each pixel.
624
639
</td>
625
640
</tr>
626
641
<tr>
627
 
<td>
628
 
<span class="term"><em class="parameter"><code>cyan_red</code></em>&#160;:</span></td>
 
642
<td><span class="term"><em class="parameter"><code>cyan_red</code></em>&#160;:</span></td>
629
643
<td> Cyan-Red color balance.
630
644
</td>
631
645
</tr>
632
646
<tr>
633
 
<td>
634
 
<span class="term"><em class="parameter"><code>magenta_green</code></em>&#160;:</span></td>
 
647
<td><span class="term"><em class="parameter"><code>magenta_green</code></em>&#160;:</span></td>
635
648
<td> Magenta-Green color balance.
636
649
</td>
637
650
</tr>
638
651
<tr>
639
 
<td>
640
 
<span class="term"><em class="parameter"><code>yellow_blue</code></em>&#160;:</span></td>
 
652
<td><span class="term"><em class="parameter"><code>yellow_blue</code></em>&#160;:</span></td>
641
653
<td> Yellow-Blue color balance.
642
654
</td>
643
655
</tr>
644
656
<tr>
645
 
<td>
646
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
657
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
647
658
<td> TRUE on success.
648
659
</td>
649
660
</tr>
652
663
</div>
653
664
<hr>
654
665
<div class="refsect2" lang="en">
655
 
<a name="id2582735"></a><h3>
 
666
<a name="id2618426"></a><h3>
656
667
<a name="gimp-colorize"></a>gimp_colorize ()</h3>
657
 
<a class="indexterm" name="id2582747"></a><pre class="programlisting">gboolean    gimp_colorize                   (gint32 drawable_ID,
658
 
                                             gdouble hue,
659
 
                                             gdouble saturation,
660
 
                                             gdouble lightness);</pre>
 
668
<a class="indexterm" name="id2618439"></a><pre class="programlisting">gboolean            gimp_colorize                       (gint32 drawable_ID,
 
669
                                                         gdouble hue,
 
670
                                                         gdouble saturation,
 
671
                                                         gdouble lightness);</pre>
661
672
<p>
662
673
Render the drawable as a grayscale image seen through a colored
663
674
glass.
664
675
</p>
665
676
<p>
666
 
Desatures the drawable, then tints it with the specified color. This
667
 
tool is only valid on RGB color images. It will not operate on
 
677
Desaturates the drawable, then tints it with the specified color.
 
678
This tool is only valid on RGB color images. It will not operate on
668
679
grayscale or indexed drawables.</p>
669
680
<p>
670
681
 
673
684
<col align="left" valign="top">
674
685
<tbody>
675
686
<tr>
676
 
<td>
677
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
687
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
678
688
<td> The drawable.
679
689
</td>
680
690
</tr>
681
691
<tr>
682
 
<td>
683
 
<span class="term"><em class="parameter"><code>hue</code></em>&#160;:</span></td>
 
692
<td><span class="term"><em class="parameter"><code>hue</code></em>&#160;:</span></td>
684
693
<td> Hue in degrees.
685
694
</td>
686
695
</tr>
687
696
<tr>
688
 
<td>
689
 
<span class="term"><em class="parameter"><code>saturation</code></em>&#160;:</span></td>
 
697
<td><span class="term"><em class="parameter"><code>saturation</code></em>&#160;:</span></td>
690
698
<td> Saturation in percent.
691
699
</td>
692
700
</tr>
693
701
<tr>
694
 
<td>
695
 
<span class="term"><em class="parameter"><code>lightness</code></em>&#160;:</span></td>
 
702
<td><span class="term"><em class="parameter"><code>lightness</code></em>&#160;:</span></td>
696
703
<td> Lightness in percent.
697
704
</td>
698
705
</tr>
699
706
<tr>
700
 
<td>
701
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
707
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
702
708
<td> TRUE on success.
703
709
 
704
710
</td>
705
711
</tr>
706
712
</tbody>
707
713
</table></div>
708
 
<p>Since  GIMP 2.2
 
714
<p class="since">Since  GIMP 2.2
709
715
</p>
710
716
</div>
711
717
<hr>
712
718
<div class="refsect2" lang="en">
713
 
<a name="id2582869"></a><h3>
 
719
<a name="id2618563"></a><h3>
714
720
<a name="gimp-histogram"></a>gimp_histogram ()</h3>
715
 
<a class="indexterm" name="id2582879"></a><pre class="programlisting">gboolean    gimp_histogram                  (gint32 drawable_ID,
716
 
                                             <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
717
 
                                             gint start_range,
718
 
                                             gint end_range,
719
 
                                             gdouble *mean,
720
 
                                             gdouble *std_dev,
721
 
                                             gdouble *median,
722
 
                                             gdouble *pixels,
723
 
                                             gdouble *count,
724
 
                                             gdouble *percentile);</pre>
 
721
<a class="indexterm" name="id2618574"></a><pre class="programlisting">gboolean            gimp_histogram                      (gint32 drawable_ID,
 
722
                                                         <a href="libgimp-gimpenums.html#GimpHistogramChannel">GimpHistogramChannel</a> channel,
 
723
                                                         gint start_range,
 
724
                                                         gint end_range,
 
725
                                                         gdouble *mean,
 
726
                                                         gdouble *std_dev,
 
727
                                                         gdouble *median,
 
728
                                                         gdouble *pixels,
 
729
                                                         gdouble *count,
 
730
                                                         gdouble *percentile);</pre>
725
731
<p>
726
732
Returns information on the intensity histogram for the specified
727
733
drawable.
732
738
specified. This can be either value, red, green, or blue, depending
733
739
on whether the drawable is of type color or grayscale. The drawable
734
740
may not be indexed. Second, a range of intensities are specified.
735
 
The gimp_histogram function returns statistics based on the pixels
 
741
The <a href="libgimp-gimpcolor.html#gimp-histogram"><code class="function">gimp_histogram()</code></a> function returns statistics based on the pixels
736
742
in the drawable that fall under this range of values. Mean, standard
737
743
deviation, median, number of pixels, and percentile are all
738
744
returned. Additionally, the total count of pixels in the image is
747
753
<col align="left" valign="top">
748
754
<tbody>
749
755
<tr>
750
 
<td>
751
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
756
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
752
757
<td> The drawable.
753
758
</td>
754
759
</tr>
755
760
<tr>
756
 
<td>
757
 
<span class="term"><em class="parameter"><code>channel</code></em>&#160;:</span></td>
 
761
<td><span class="term"><em class="parameter"><code>channel</code></em>&#160;:</span></td>
758
762
<td> The channel to modify.
759
763
</td>
760
764
</tr>
761
765
<tr>
762
 
<td>
763
 
<span class="term"><em class="parameter"><code>start_range</code></em>&#160;:</span></td>
 
766
<td><span class="term"><em class="parameter"><code>start_range</code></em>&#160;:</span></td>
764
767
<td> Start of the intensity measurement range.
765
768
</td>
766
769
</tr>
767
770
<tr>
768
 
<td>
769
 
<span class="term"><em class="parameter"><code>end_range</code></em>&#160;:</span></td>
 
771
<td><span class="term"><em class="parameter"><code>end_range</code></em>&#160;:</span></td>
770
772
<td> End of the intensity measurement range.
771
773
</td>
772
774
</tr>
773
775
<tr>
774
 
<td>
775
 
<span class="term"><em class="parameter"><code>mean</code></em>&#160;:</span></td>
 
776
<td><span class="term"><em class="parameter"><code>mean</code></em>&#160;:</span></td>
776
777
<td> Mean intensity value.
777
778
</td>
778
779
</tr>
779
780
<tr>
780
 
<td>
781
 
<span class="term"><em class="parameter"><code>std_dev</code></em>&#160;:</span></td>
 
781
<td><span class="term"><em class="parameter"><code>std_dev</code></em>&#160;:</span></td>
782
782
<td> Standard deviation of intensity values.
783
783
</td>
784
784
</tr>
785
785
<tr>
786
 
<td>
787
 
<span class="term"><em class="parameter"><code>median</code></em>&#160;:</span></td>
 
786
<td><span class="term"><em class="parameter"><code>median</code></em>&#160;:</span></td>
788
787
<td> Median intensity value.
789
788
</td>
790
789
</tr>
791
790
<tr>
792
 
<td>
793
 
<span class="term"><em class="parameter"><code>pixels</code></em>&#160;:</span></td>
 
791
<td><span class="term"><em class="parameter"><code>pixels</code></em>&#160;:</span></td>
794
792
<td> Alpha-weighted pixel count for entire image.
795
793
</td>
796
794
</tr>
797
795
<tr>
798
 
<td>
799
 
<span class="term"><em class="parameter"><code>count</code></em>&#160;:</span></td>
 
796
<td><span class="term"><em class="parameter"><code>count</code></em>&#160;:</span></td>
800
797
<td> Alpha-weighted pixel count for range.
801
798
</td>
802
799
</tr>
803
800
<tr>
804
 
<td>
805
 
<span class="term"><em class="parameter"><code>percentile</code></em>&#160;:</span></td>
 
801
<td><span class="term"><em class="parameter"><code>percentile</code></em>&#160;:</span></td>
806
802
<td> Percentile that range falls under.
807
803
</td>
808
804
</tr>
809
805
<tr>
810
 
<td>
811
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
806
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
812
807
<td> TRUE on success.
813
808
</td>
814
809
</tr>
817
812
</div>
818
813
<hr>
819
814
<div class="refsect2" lang="en">
820
 
<a name="id2583127"></a><h3>
 
815
<a name="id2618827"></a><h3>
821
816
<a name="gimp-hue-saturation"></a>gimp_hue_saturation ()</h3>
822
 
<a class="indexterm" name="id2583137"></a><pre class="programlisting">gboolean    gimp_hue_saturation             (gint32 drawable_ID,
823
 
                                             <a href="libgimp-gimpenums.html#GimpHueRange">GimpHueRange</a> hue_range,
824
 
                                             gdouble hue_offset,
825
 
                                             gdouble lightness,
826
 
                                             gdouble saturation);</pre>
 
817
<a class="indexterm" name="id2618838"></a><pre class="programlisting">gboolean            gimp_hue_saturation                 (gint32 drawable_ID,
 
818
                                                         <a href="libgimp-gimpenums.html#GimpHueRange">GimpHueRange</a> hue_range,
 
819
                                                         gdouble hue_offset,
 
820
                                                         gdouble lightness,
 
821
                                                         gdouble saturation);</pre>
827
822
<p>
828
823
Modify hue, lightness, and saturation in the specified drawable.
829
824
</p>
830
825
<p>
831
826
This procedures allows the hue, lightness, and saturation in the
832
 
specified drawable to be modified. The 'hue_range' parameter
 
827
specified drawable to be modified. The 'hue-range' parameter
833
828
provides the capability to limit range of affected hues.</p>
834
829
<p>
835
830
 
838
833
<col align="left" valign="top">
839
834
<tbody>
840
835
<tr>
841
 
<td>
842
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
836
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
843
837
<td> The drawable.
844
838
</td>
845
839
</tr>
846
840
<tr>
847
 
<td>
848
 
<span class="term"><em class="parameter"><code>hue_range</code></em>&#160;:</span></td>
 
841
<td><span class="term"><em class="parameter"><code>hue_range</code></em>&#160;:</span></td>
849
842
<td> Range of affected hues.
850
843
</td>
851
844
</tr>
852
845
<tr>
853
 
<td>
854
 
<span class="term"><em class="parameter"><code>hue_offset</code></em>&#160;:</span></td>
 
846
<td><span class="term"><em class="parameter"><code>hue_offset</code></em>&#160;:</span></td>
855
847
<td> Hue offset in degrees.
856
848
</td>
857
849
</tr>
858
850
<tr>
859
 
<td>
860
 
<span class="term"><em class="parameter"><code>lightness</code></em>&#160;:</span></td>
861
 
<td> lightness modification.
862
 
</td>
863
 
</tr>
864
 
<tr>
865
 
<td>
866
 
<span class="term"><em class="parameter"><code>saturation</code></em>&#160;:</span></td>
867
 
<td> saturation modification.
868
 
</td>
869
 
</tr>
870
 
<tr>
871
 
<td>
872
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
851
<td><span class="term"><em class="parameter"><code>lightness</code></em>&#160;:</span></td>
 
852
<td> Lightness modification.
 
853
</td>
 
854
</tr>
 
855
<tr>
 
856
<td><span class="term"><em class="parameter"><code>saturation</code></em>&#160;:</span></td>
 
857
<td> Saturation modification.
 
858
</td>
 
859
</tr>
 
860
<tr>
 
861
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
873
862
<td> TRUE on success.
874
863
</td>
875
864
</tr>
878
867
</div>
879
868
<hr>
880
869
<div class="refsect2" lang="en">
881
 
<a name="id2583274"></a><h3>
 
870
<a name="id2618976"></a><h3>
882
871
<a name="gimp-threshold"></a>gimp_threshold ()</h3>
883
 
<a class="indexterm" name="id2583284"></a><pre class="programlisting">gboolean    gimp_threshold                  (gint32 drawable_ID,
884
 
                                             gint low_threshold,
885
 
                                             gint high_threshold);</pre>
 
872
<a class="indexterm" name="id2618986"></a><pre class="programlisting">gboolean            gimp_threshold                      (gint32 drawable_ID,
 
873
                                                         gint low_threshold,
 
874
                                                         gint high_threshold);</pre>
886
875
<p>
887
876
Threshold the specified drawable.
888
877
</p>
898
887
<col align="left" valign="top">
899
888
<tbody>
900
889
<tr>
901
 
<td>
902
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
890
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
903
891
<td> The drawable.
904
892
</td>
905
893
</tr>
906
894
<tr>
907
 
<td>
908
 
<span class="term"><em class="parameter"><code>low_threshold</code></em>&#160;:</span></td>
 
895
<td><span class="term"><em class="parameter"><code>low_threshold</code></em>&#160;:</span></td>
909
896
<td> The low threshold value.
910
897
</td>
911
898
</tr>
912
899
<tr>
913
 
<td>
914
 
<span class="term"><em class="parameter"><code>high_threshold</code></em>&#160;:</span></td>
 
900
<td><span class="term"><em class="parameter"><code>high_threshold</code></em>&#160;:</span></td>
915
901
<td> The high threshold value.
916
902
</td>
917
903
</tr>
918
904
<tr>
919
 
<td>
920
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
905
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
921
906
<td> TRUE on success.
922
907
</td>
923
908
</tr>