4
4
* gimpselectiontools_pdb.c
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.
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.
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/>.
22
21
/* NOTE: This file is auto-generated by pdbgen.pl */
24
23
#include "config.h"
26
#undef GIMP_DISABLE_DEPRECATED
27
#undef __GIMP_SELECTION_TOOLS_PDB_H__
28
#include "gimpselectiontools_pdb.h"
32
* SECTION: gimpselectiontools
33
* @title: gimpselectiontools
34
* @short_description: Access to toolbox selection tools.
36
* Functions giving access to toolbox selection tools.
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.
39
* Create a selection by selecting all pixels (in the specified
40
* drawable) with the same (or similar) color to that specified.
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.
56
53
* Returns: TRUE on success.
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.
105
* Create a selection by selecting all pixels (in the specified
106
* drawable) with the same (or similar) color to that specified.
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.
123
104
* Returns: TRUE on success.
125
106
* Since: GIMP 2.4
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.
178
* Create an elliptical selection over the specified image.
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
159
* Deprecated: Use gimp_image_select_ellipse() instead.
190
161
* Returns: TRUE on success.
193
164
gimp_ellipse_select (gint32 image_ID,
234
205
* @feather: Feather option for selections.
235
206
* @feather_radius: Radius for feather operation.
237
* Create a polygonal selection over the specified image.
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
208
* Deprecated: Use gimp_image_select_polygon() instead.
251
210
* Returns: TRUE on success.
254
213
gimp_free_select (gint32 image_ID,
293
252
* @feather_radius: Radius for feather operation.
294
253
* @sample_merged: Use the composite image, not the drawable.
296
* Create a fuzzy selection starting at the specified coordinates on
297
* the specified drawable.
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
255
* Deprecated: Use gimp_image_select_contiguous_color() instead.
318
257
* Returns: TRUE on success.
321
260
gimp_fuzzy_select (gint32 drawable_ID,
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.
370
* Create a fuzzy selection starting at the specified coordinates on
371
* the specified drawable.
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
309
* Deprecated: Use gimp_image_select_contiguous_color() instead.
392
311
* Returns: TRUE on success.
394
313
* Since: GIMP 2.4
397
316
gimp_fuzzy_select_full (gint32 drawable_ID,
445
364
* @feather: Feather option for selections.
446
365
* @feather_radius: Radius for feather operation.
448
* Create a rectangular selection over the specified image;
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
367
* Deprecated: Use gimp_image_select_rectangle() instead.
457
369
* Returns: TRUE on success.
460
372
gimp_rect_select (gint32 image_ID,
504
416
* @feather_radius_x: Radius for feather operation in X direction.
505
417
* @feather_radius_y: Radius for feather operation in Y direction.
507
* Create a rectangular selection with round corners over the specified
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.
517
421
* Returns: TRUE on success.
519
423
* Since: GIMP 2.4
522
426
gimp_round_rect_select (gint32 image_ID,