~ubuntu-branches/ubuntu/vivid/gimp/vivid

« back to all changes in this revision

Viewing changes to libgimp/gimpselectiontools_pdb.c

  • Committer: Package Import Robot
  • Author(s): Jordi Mallach
  • Date: 2012-05-08 18:50:03 UTC
  • mto: (1.1.26) (0.5.1 experimental)
  • mto: This revision was merged to the branch mainline in revision 71.
  • Revision ID: package-import@ubuntu.com-20120508185003-tltkvbaysf8d2426
ImportĀ upstreamĀ versionĀ 2.8.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
 *
4
4
 * gimpselectiontools_pdb.c
5
5
 *
6
 
 * This library is free software; you can redistribute it and/or
 
6
 * This library is free software: you can redistribute it and/or
7
7
 * modify it under the terms of the GNU Lesser General Public
8
8
 * License as published by the Free Software Foundation; either
9
 
 * version 2 of the License, or (at your option) any later version.
 
9
 * version 3 of the License, or (at your option) any later version.
10
10
 *
11
11
 * This library is distributed in the hope that it will be useful,
12
12
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14
14
 * Lesser General Public License for more details.
15
15
 *
16
16
 * You should have received a copy of the GNU Lesser General Public
17
 
 * License along with this library; if not, write to the
18
 
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19
 
 * Boston, MA 02111-1307, USA.
 
17
 * License along with this library.  If not, see
 
18
 * <http://www.gnu.org/licenses/>.
20
19
 */
21
20
 
22
21
/* NOTE: This file is auto-generated by pdbgen.pl */
24
23
#include "config.h"
25
24
 
26
25
#include "gimp.h"
 
26
#undef GIMP_DISABLE_DEPRECATED
 
27
#undef __GIMP_SELECTION_TOOLS_PDB_H__
 
28
#include "gimpselectiontools_pdb.h"
 
29
 
 
30
 
 
31
/**
 
32
 * SECTION: gimpselectiontools
 
33
 * @title: gimpselectiontools
 
34
 * @short_description: Access to toolbox selection tools.
 
35
 *
 
36
 * Functions giving access to toolbox selection tools.
 
37
 **/
 
38
 
27
39
 
28
40
/**
29
41
 * gimp_by_color_select:
36
48
 * @feather_radius: Radius for feather operation.
37
49
 * @sample_merged: Use the composite image, not the drawable.
38
50
 *
39
 
 * Create a selection by selecting all pixels (in the specified
40
 
 * drawable) with the same (or similar) color to that specified.
41
 
 *
42
 
 * This tool creates a selection over the specified image. A by-color
43
 
 * selection is determined by the supplied color under the constraints
44
 
 * of the specified threshold. Essentially, all pixels (in the
45
 
 * drawable) that have color sufficiently close to the specified color
46
 
 * (as determined by the threshold value) are included in the
47
 
 * selection. The antialiasing parameter allows the final selection
48
 
 * mask to contain intermediate values based on close misses to the
49
 
 * threshold bar. Feathering can be enabled optionally and is
50
 
 * controlled with the 'feather-radius' parameter. If the
51
 
 * 'sample-merged' parameter is TRUE, the data of the composite image
52
 
 * will be used instead of that for the specified drawable. This is
53
 
 * equivalent to sampling for colors after merging all visible layers.
54
 
 * In the case of a merged sampling, the supplied drawable is ignored.
 
51
 * Deprecated: Use gimp_image_select_color() instead.
55
52
 *
56
53
 * Returns: TRUE on success.
57
 
 */
 
54
 **/
58
55
gboolean
59
56
gimp_by_color_select (gint32          drawable_ID,
60
57
                      const GimpRGB  *color,
102
99
 * @select_transparent: Whether to consider transparent pixels for selection. If TRUE, transparency is considered as a unique selectable color.
103
100
 * @select_criterion: The criterion used to determine color similarity. SELECT_CRITERION_COMPOSITE is the standard choice.
104
101
 *
105
 
 * Create a selection by selecting all pixels (in the specified
106
 
 * drawable) with the same (or similar) color to that specified.
107
 
 *
108
 
 * This tool creates a selection over the specified image. A by-color
109
 
 * selection is determined by the supplied color under the constraints
110
 
 * of the specified threshold. Essentially, all pixels (in the
111
 
 * drawable) that have color sufficiently close to the specified color
112
 
 * (as determined by the threshold value) are included in the
113
 
 * selection. To select transparent regions, the color specified must
114
 
 * also have minimum alpha. The antialiasing parameter allows the final
115
 
 * selection mask to contain intermediate values based on close misses
116
 
 * to the threshold bar. Feathering can be enabled optionally and is
117
 
 * controlled with the 'feather-radius' parameter. If the
118
 
 * 'sample-merged' parameter is TRUE, the data of the composite image
119
 
 * will be used instead of that for the specified drawable. This is
120
 
 * equivalent to sampling for colors after merging all visible layers.
121
 
 * In the case of a merged sampling, the supplied drawable is ignored.
 
102
 * Deprecated: Use gimp_image_select_color() instead.
122
103
 *
123
104
 * Returns: TRUE on success.
124
105
 *
125
106
 * Since: GIMP 2.4
126
 
 */
 
107
 **/
127
108
gboolean
128
109
gimp_by_color_select_full (gint32               drawable_ID,
129
110
                           const GimpRGB       *color,
175
156
 * @feather: Feather option for selections.
176
157
 * @feather_radius: Radius for feather operation.
177
158
 *
178
 
 * Create an elliptical selection over the specified image.
179
 
 *
180
 
 * This tool creates an elliptical selection over the specified image.
181
 
 * The elliptical region can be either added to, subtracted from, or
182
 
 * replace the contents of the previous selection mask. If antialiasing
183
 
 * is turned on, the edges of the elliptical region will contain
184
 
 * intermediate values which give the appearance of a sharper, less
185
 
 * pixelized edge. This should be set as TRUE most of the time. If the
186
 
 * feather option is enabled, the resulting selection is blurred before
187
 
 * combining. The blur is a gaussian blur with the specified feather
188
 
 * radius.
 
159
 * Deprecated: Use gimp_image_select_ellipse() instead.
189
160
 *
190
161
 * Returns: TRUE on success.
191
 
 */
 
162
 **/
192
163
gboolean
193
164
gimp_ellipse_select (gint32         image_ID,
194
165
                     gdouble        x,
234
205
 * @feather: Feather option for selections.
235
206
 * @feather_radius: Radius for feather operation.
236
207
 *
237
 
 * Create a polygonal selection over the specified image.
238
 
 *
239
 
 * This tool creates a polygonal selection over the specified image.
240
 
 * The polygonal region can be either added to, subtracted from, or
241
 
 * replace the contents of the previous selection mask. The polygon is
242
 
 * specified through an array of floating point numbers and its length.
243
 
 * The length of array must be 2n, where n is the number of points.
244
 
 * Each point is defined by 2 floating point values which correspond to
245
 
 * the x and y coordinates. If the final point does not connect to the
246
 
 * starting point, a connecting segment is automatically added. If the
247
 
 * feather option is enabled, the resulting selection is blurred before
248
 
 * combining. The blur is a gaussian blur with the specified feather
249
 
 * radius.
 
208
 * Deprecated: Use gimp_image_select_polygon() instead.
250
209
 *
251
210
 * Returns: TRUE on success.
252
 
 */
 
211
 **/
253
212
gboolean
254
213
gimp_free_select (gint32          image_ID,
255
214
                  gint            num_segs,
293
252
 * @feather_radius: Radius for feather operation.
294
253
 * @sample_merged: Use the composite image, not the drawable.
295
254
 *
296
 
 * Create a fuzzy selection starting at the specified coordinates on
297
 
 * the specified drawable.
298
 
 *
299
 
 * This tool creates a fuzzy selection over the specified image. A
300
 
 * fuzzy selection is determined by a seed fill under the constraints
301
 
 * of the specified threshold. Essentially, the color at the specified
302
 
 * coordinates (in the drawable) is measured and the selection expands
303
 
 * outwards from that point to any adjacent pixels which are not
304
 
 * significantly different (as determined by the threshold value). This
305
 
 * process continues until no more expansion is possible. The
306
 
 * antialiasing parameter allows the final selection mask to contain
307
 
 * intermediate values based on close misses to the threshold bar at
308
 
 * pixels along the seed fill boundary. Feathering can be enabled
309
 
 * optionally and is controlled with the 'feather-radius' paramter. If
310
 
 * the 'sample-merged' parameter is TRUE, the data of the composite
311
 
 * image will be used instead of that for the specified drawable. This
312
 
 * is equivalent to sampling for colors after merging all visible
313
 
 * layers. In the case of a merged sampling, the supplied drawable is
314
 
 * ignored. If the sample is merged, the specified coordinates are
315
 
 * relative to the image origin; otherwise, they are relative to the
316
 
 * drawable's origin.
 
255
 * Deprecated: Use gimp_image_select_contiguous_color() instead.
317
256
 *
318
257
 * Returns: TRUE on success.
319
 
 */
 
258
 **/
320
259
gboolean
321
260
gimp_fuzzy_select (gint32         drawable_ID,
322
261
                   gdouble        x,
367
306
 * @select_transparent: Whether to consider transparent pixels for selection. If TRUE, transparency is considered as a unique selectable color.
368
307
 * @select_criterion: The criterion used to determine color similarity. SELECT_CRITERION_COMPOSITE is the standard choice.
369
308
 *
370
 
 * Create a fuzzy selection starting at the specified coordinates on
371
 
 * the specified drawable.
372
 
 *
373
 
 * This tool creates a fuzzy selection over the specified image. A
374
 
 * fuzzy selection is determined by a seed fill under the constraints
375
 
 * of the specified threshold. Essentially, the color at the specified
376
 
 * coordinates (in the drawable) is measured and the selection expands
377
 
 * outwards from that point to any adjacent pixels which are not
378
 
 * significantly different (as determined by the threshold value). This
379
 
 * process continues until no more expansion is possible. The
380
 
 * antialiasing parameter allows the final selection mask to contain
381
 
 * intermediate values based on close misses to the threshold bar at
382
 
 * pixels along the seed fill boundary. Feathering can be enabled
383
 
 * optionally and is controlled with the 'feather-radius' paramter. If
384
 
 * the 'sample-merged' parameter is TRUE, the data of the composite
385
 
 * image will be used instead of that for the specified drawable. This
386
 
 * is equivalent to sampling for colors after merging all visible
387
 
 * layers. In the case of a merged sampling, the supplied drawable is
388
 
 * ignored. If the sample is merged, the specified coordinates are
389
 
 * relative to the image origin; otherwise, they are relative to the
390
 
 * drawable's origin.
 
309
 * Deprecated: Use gimp_image_select_contiguous_color() instead.
391
310
 *
392
311
 * Returns: TRUE on success.
393
312
 *
394
313
 * Since: GIMP 2.4
395
 
 */
 
314
 **/
396
315
gboolean
397
316
gimp_fuzzy_select_full (gint32              drawable_ID,
398
317
                        gdouble             x,
445
364
 * @feather: Feather option for selections.
446
365
 * @feather_radius: Radius for feather operation.
447
366
 *
448
 
 * Create a rectangular selection over the specified image;
449
 
 *
450
 
 * This tool creates a rectangular selection over the specified image.
451
 
 * The rectangular region can be either added to, subtracted from, or
452
 
 * replace the contents of the previous selection mask. If the feather
453
 
 * option is enabled, the resulting selection is blurred before
454
 
 * combining. The blur is a gaussian blur with the specified feather
455
 
 * radius.
 
367
 * Deprecated: Use gimp_image_select_rectangle() instead.
456
368
 *
457
369
 * Returns: TRUE on success.
458
 
 */
 
370
 **/
459
371
gboolean
460
372
gimp_rect_select (gint32         image_ID,
461
373
                  gdouble        x,
504
416
 * @feather_radius_x: Radius for feather operation in X direction.
505
417
 * @feather_radius_y: Radius for feather operation in Y direction.
506
418
 *
507
 
 * Create a rectangular selection with round corners over the specified
508
 
 * image;
509
 
 *
510
 
 * This tool creates a rectangular selection with round corners over
511
 
 * the specified image. The rectangular region can be either added to,
512
 
 * subtracted from, or replace the contents of the previous selection
513
 
 * mask. If the feather option is enabled, the resulting selection is
514
 
 * blurred before combining. The blur is a gaussian blur with the
515
 
 * specified feather radius.
 
419
 * Deprecated: Use gimp_image_select_round_rectangle() instead.
516
420
 *
517
421
 * Returns: TRUE on success.
518
422
 *
519
423
 * Since: GIMP 2.4
520
 
 */
 
424
 **/
521
425
gboolean
522
426
gimp_round_rect_select (gint32         image_ID,
523
427
                        gdouble        x,