← Back to branch summary

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

« back to all changes in this revision

Viewing changes to devel-docs/libgimp/xml/gimptools.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/libgimp/xml/gimptools.xml
22
22
 
23
23
 
24
24
 
25
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-airbrush">gimp_airbrush</link>                   (<link linkend="gint32">gint32</link> drawable_ID,
26
 
                                             <link linkend="gdouble">gdouble</link> pressure,
27
 
                                             <link linkend="gint">gint</link> num_strokes,
28
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);
29
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-airbrush-default">gimp_airbrush_default</link>           (<link linkend="gint32">gint32</link> drawable_ID,
30
 
                                             <link linkend="gint">gint</link> num_strokes,
31
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);
32
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-by-color-select">gimp_by_color_select</link>            (<link linkend="gint32">gint32</link> drawable_ID,
33
 
                                             const <link linkend="GimpRGB">GimpRGB</link> *color,
34
 
                                             <link linkend="gint">gint</link> threshold,
35
 
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
36
 
                                             <link linkend="gboolean">gboolean</link> antialias,
37
 
                                             <link linkend="gboolean">gboolean</link> feather,
38
 
                                             <link linkend="gdouble">gdouble</link> feather_radius,
39
 
                                             <link linkend="gboolean">gboolean</link> sample_merged);
40
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-clone">gimp_clone</link>                      (<link linkend="gint32">gint32</link> drawable_ID,
41
 
                                             <link linkend="gint32">gint32</link> src_drawable_ID,
42
 
                                             <link linkend="GimpCloneType">GimpCloneType</link> clone_type,
43
 
                                             <link linkend="gdouble">gdouble</link> src_x,
44
 
                                             <link linkend="gdouble">gdouble</link> src_y,
45
 
                                             <link linkend="gint">gint</link> num_strokes,
46
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);
47
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-clone-default">gimp_clone_default</link>              (<link linkend="gint32">gint32</link> drawable_ID,
48
 
                                             <link linkend="gint">gint</link> num_strokes,
49
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);
50
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-convolve">gimp_convolve</link>                   (<link linkend="gint32">gint32</link> drawable_ID,
51
 
                                             <link linkend="gdouble">gdouble</link> pressure,
52
 
                                             <link linkend="GimpConvolveType">GimpConvolveType</link> convolve_type,
53
 
                                             <link linkend="gint">gint</link> num_strokes,
54
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);
55
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-convolve-default">gimp_convolve_default</link>           (<link linkend="gint32">gint32</link> drawable_ID,
56
 
                                             <link linkend="gint">gint</link> num_strokes,
57
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);
58
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-dodgeburn">gimp_dodgeburn</link>                  (<link linkend="gint32">gint32</link> drawable_ID,
59
 
                                             <link linkend="gdouble">gdouble</link> exposure,
60
 
                                             <link linkend="GimpDodgeBurnType">GimpDodgeBurnType</link> dodgeburn_type,
61
 
                                             <link linkend="GimpTransferMode">GimpTransferMode</link> dodgeburn_mode,
62
 
                                             <link linkend="gint">gint</link> num_strokes,
63
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);
64
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-dodgeburn-default">gimp_dodgeburn_default</link>          (<link linkend="gint32">gint32</link> drawable_ID,
65
 
                                             <link linkend="gint">gint</link> num_strokes,
66
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);
67
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-ellipse-select">gimp_ellipse_select</link>             (<link linkend="gint32">gint32</link> image_ID,
68
 
                                             <link linkend="gdouble">gdouble</link> x,
69
 
                                             <link linkend="gdouble">gdouble</link> y,
70
 
                                             <link linkend="gdouble">gdouble</link> width,
71
 
                                             <link linkend="gdouble">gdouble</link> height,
72
 
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
73
 
                                             <link linkend="gboolean">gboolean</link> antialias,
74
 
                                             <link linkend="gboolean">gboolean</link> feather,
75
 
                                             <link linkend="gdouble">gdouble</link> feather_radius);
76
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-eraser">gimp_eraser</link>                     (<link linkend="gint32">gint32</link> drawable_ID,
77
 
                                             <link linkend="gint">gint</link> num_strokes,
78
 
                                             const <link linkend="gdouble">gdouble</link> *strokes,
79
 
                                             <link linkend="GimpBrushApplicationMode">GimpBrushApplicationMode</link> hardness,
80
 
                                             <link linkend="GimpPaintApplicationMode">GimpPaintApplicationMode</link> method);
81
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-eraser-default">gimp_eraser_default</link>             (<link linkend="gint32">gint32</link> drawable_ID,
82
 
                                             <link linkend="gint">gint</link> num_strokes,
83
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);
84
 
<link linkend="gint32">gint32</link>      <link linkend="gimp-flip">gimp_flip</link>                       (<link linkend="gint32">gint32</link> drawable_ID,
85
 
                                             <link linkend="GimpOrientationType">GimpOrientationType</link> flip_type);
86
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-free-select">gimp_free_select</link>                (<link linkend="gint32">gint32</link> image_ID,
87
 
                                             <link linkend="gint">gint</link> num_segs,
88
 
                                             const <link linkend="gdouble">gdouble</link> *segs,
89
 
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
90
 
                                             <link linkend="gboolean">gboolean</link> antialias,
91
 
                                             <link linkend="gboolean">gboolean</link> feather,
92
 
                                             <link linkend="gdouble">gdouble</link> feather_radius);
93
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-fuzzy-select">gimp_fuzzy_select</link>               (<link linkend="gint32">gint32</link> drawable_ID,
94
 
                                             <link linkend="gdouble">gdouble</link> x,
95
 
                                             <link linkend="gdouble">gdouble</link> y,
96
 
                                             <link linkend="gint">gint</link> threshold,
97
 
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
98
 
                                             <link linkend="gboolean">gboolean</link> antialias,
99
 
                                             <link linkend="gboolean">gboolean</link> feather,
100
 
                                             <link linkend="gdouble">gdouble</link> feather_radius,
101
 
                                             <link linkend="gboolean">gboolean</link> sample_merged);
102
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-paintbrush">gimp_paintbrush</link>                 (<link linkend="gint32">gint32</link> drawable_ID,
103
 
                                             <link linkend="gdouble">gdouble</link> fade_out,
104
 
                                             <link linkend="gint">gint</link> num_strokes,
105
 
                                             const <link linkend="gdouble">gdouble</link> *strokes,
106
 
                                             <link linkend="GimpPaintApplicationMode">GimpPaintApplicationMode</link> method,
107
 
                                             <link linkend="gdouble">gdouble</link> gradient_length);
108
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-paintbrush-default">gimp_paintbrush_default</link>         (<link linkend="gint32">gint32</link> drawable_ID,
109
 
                                             <link linkend="gint">gint</link> num_strokes,
110
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);
111
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-pencil">gimp_pencil</link>                     (<link linkend="gint32">gint32</link> drawable_ID,
112
 
                                             <link linkend="gint">gint</link> num_strokes,
113
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);
114
 
<link linkend="gint32">gint32</link>      <link linkend="gimp-perspective">gimp_perspective</link>                (<link linkend="gint32">gint32</link> drawable_ID,
115
 
                                             <link linkend="gboolean">gboolean</link> interpolation,
116
 
                                             <link linkend="gdouble">gdouble</link> x0,
117
 
                                             <link linkend="gdouble">gdouble</link> y0,
118
 
                                             <link linkend="gdouble">gdouble</link> x1,
119
 
                                             <link linkend="gdouble">gdouble</link> y1,
120
 
                                             <link linkend="gdouble">gdouble</link> x2,
121
 
                                             <link linkend="gdouble">gdouble</link> y2,
122
 
                                             <link linkend="gdouble">gdouble</link> x3,
123
 
                                             <link linkend="gdouble">gdouble</link> y3);
124
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-rect-select">gimp_rect_select</link>                (<link linkend="gint32">gint32</link> image_ID,
125
 
                                             <link linkend="gdouble">gdouble</link> x,
126
 
                                             <link linkend="gdouble">gdouble</link> y,
127
 
                                             <link linkend="gdouble">gdouble</link> width,
128
 
                                             <link linkend="gdouble">gdouble</link> height,
129
 
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
130
 
                                             <link linkend="gboolean">gboolean</link> feather,
131
 
                                             <link linkend="gdouble">gdouble</link> feather_radius);
132
 
<link linkend="gint32">gint32</link>      <link linkend="gimp-rotate">gimp_rotate</link>                     (<link linkend="gint32">gint32</link> drawable_ID,
133
 
                                             <link linkend="gboolean">gboolean</link> interpolation,
134
 
                                             <link linkend="gdouble">gdouble</link> angle);
135
 
<link linkend="gint32">gint32</link>      <link linkend="gimp-scale">gimp_scale</link>                      (<link linkend="gint32">gint32</link> drawable_ID,
136
 
                                             <link linkend="gboolean">gboolean</link> interpolation,
137
 
                                             <link linkend="gdouble">gdouble</link> x0,
138
 
                                             <link linkend="gdouble">gdouble</link> y0,
139
 
                                             <link linkend="gdouble">gdouble</link> x1,
140
 
                                             <link linkend="gdouble">gdouble</link> y1);
141
 
<link linkend="gint32">gint32</link>      <link linkend="gimp-shear">gimp_shear</link>                      (<link linkend="gint32">gint32</link> drawable_ID,
142
 
                                             <link linkend="gboolean">gboolean</link> interpolation,
143
 
                                             <link linkend="GimpOrientationType">GimpOrientationType</link> shear_type,
144
 
                                             <link linkend="gdouble">gdouble</link> magnitude);
145
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-smudge">gimp_smudge</link>                     (<link linkend="gint32">gint32</link> drawable_ID,
146
 
                                             <link linkend="gdouble">gdouble</link> pressure,
147
 
                                             <link linkend="gint">gint</link> num_strokes,
148
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);
149
 
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-smudge-default">gimp_smudge_default</link>             (<link linkend="gint32">gint32</link> drawable_ID,
150
 
                                             <link linkend="gint">gint</link> num_strokes,
151
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);
152
 
<link linkend="gint32">gint32</link>      <link linkend="gimp-transform-2d">gimp_transform_2d</link>               (<link linkend="gint32">gint32</link> drawable_ID,
153
 
                                             <link linkend="gboolean">gboolean</link> interpolation,
154
 
                                             <link linkend="gdouble">gdouble</link> source_x,
155
 
                                             <link linkend="gdouble">gdouble</link> source_y,
156
 
                                             <link linkend="gdouble">gdouble</link> scale_x,
157
 
                                             <link linkend="gdouble">gdouble</link> scale_y,
158
 
                                             <link linkend="gdouble">gdouble</link> angle,
159
 
                                             <link linkend="gdouble">gdouble</link> dest_x,
160
 
                                             <link linkend="gdouble">gdouble</link> dest_y);
 
25
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-airbrush">gimp_airbrush</link>                       (<link linkend="gint32">gint32</link> drawable_ID,
 
26
                                                         <link linkend="gdouble">gdouble</link> pressure,
 
27
                                                         <link linkend="gint">gint</link> num_strokes,
 
28
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
29
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-airbrush-default">gimp_airbrush_default</link>               (<link linkend="gint32">gint32</link> drawable_ID,
 
30
                                                         <link linkend="gint">gint</link> num_strokes,
 
31
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
32
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-by-color-select">gimp_by_color_select</link>                (<link linkend="gint32">gint32</link> drawable_ID,
 
33
                                                         const <link linkend="GimpRGB">GimpRGB</link> *color,
 
34
                                                         <link linkend="gint">gint</link> threshold,
 
35
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
36
                                                         <link linkend="gboolean">gboolean</link> antialias,
 
37
                                                         <link linkend="gboolean">gboolean</link> feather,
 
38
                                                         <link linkend="gdouble">gdouble</link> feather_radius,
 
39
                                                         <link linkend="gboolean">gboolean</link> sample_merged);
 
40
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-by-color-select-full">gimp_by_color_select_full</link>           (<link linkend="gint32">gint32</link> drawable_ID,
 
41
                                                         const <link linkend="GimpRGB">GimpRGB</link> *color,
 
42
                                                         <link linkend="gint">gint</link> threshold,
 
43
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
44
                                                         <link linkend="gboolean">gboolean</link> antialias,
 
45
                                                         <link linkend="gboolean">gboolean</link> feather,
 
46
                                                         <link linkend="gdouble">gdouble</link> feather_radius_x,
 
47
                                                         <link linkend="gdouble">gdouble</link> feather_radius_y,
 
48
                                                         <link linkend="gboolean">gboolean</link> sample_merged,
 
49
                                                         <link linkend="gboolean">gboolean</link> select_transparent,
 
50
                                                         <link linkend="GimpSelectCriterion">GimpSelectCriterion</link> select_criterion);
 
51
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-clone">gimp_clone</link>                          (<link linkend="gint32">gint32</link> drawable_ID,
 
52
                                                         <link linkend="gint32">gint32</link> src_drawable_ID,
 
53
                                                         <link linkend="GimpCloneType">GimpCloneType</link> clone_type,
 
54
                                                         <link linkend="gdouble">gdouble</link> src_x,
 
55
                                                         <link linkend="gdouble">gdouble</link> src_y,
 
56
                                                         <link linkend="gint">gint</link> num_strokes,
 
57
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
58
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-clone-default">gimp_clone_default</link>                  (<link linkend="gint32">gint32</link> drawable_ID,
 
59
                                                         <link linkend="gint">gint</link> num_strokes,
 
60
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
61
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-convolve">gimp_convolve</link>                       (<link linkend="gint32">gint32</link> drawable_ID,
 
62
                                                         <link linkend="gdouble">gdouble</link> pressure,
 
63
                                                         <link linkend="GimpConvolveType">GimpConvolveType</link> convolve_type,
 
64
                                                         <link linkend="gint">gint</link> num_strokes,
 
65
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
66
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-convolve-default">gimp_convolve_default</link>               (<link linkend="gint32">gint32</link> drawable_ID,
 
67
                                                         <link linkend="gint">gint</link> num_strokes,
 
68
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
69
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-dodgeburn">gimp_dodgeburn</link>                      (<link linkend="gint32">gint32</link> drawable_ID,
 
70
                                                         <link linkend="gdouble">gdouble</link> exposure,
 
71
                                                         <link linkend="GimpDodgeBurnType">GimpDodgeBurnType</link> dodgeburn_type,
 
72
                                                         <link linkend="GimpTransferMode">GimpTransferMode</link> dodgeburn_mode,
 
73
                                                         <link linkend="gint">gint</link> num_strokes,
 
74
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
75
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-dodgeburn-default">gimp_dodgeburn_default</link>              (<link linkend="gint32">gint32</link> drawable_ID,
 
76
                                                         <link linkend="gint">gint</link> num_strokes,
 
77
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
78
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-edit-bucket-fill-full">gimp_edit_bucket_fill_full</link>          (<link linkend="gint32">gint32</link> drawable_ID,
 
79
                                                         <link linkend="GimpBucketFillMode">GimpBucketFillMode</link> fill_mode,
 
80
                                                         <link linkend="GimpLayerModeEffects">GimpLayerModeEffects</link> paint_mode,
 
81
                                                         <link linkend="gdouble">gdouble</link> opacity,
 
82
                                                         <link linkend="gdouble">gdouble</link> threshold,
 
83
                                                         <link linkend="gboolean">gboolean</link> sample_merged,
 
84
                                                         <link linkend="gboolean">gboolean</link> fill_transparent,
 
85
                                                         <link linkend="GimpSelectCriterion">GimpSelectCriterion</link> select_criterion,
 
86
                                                         <link linkend="gdouble">gdouble</link> x,
 
87
                                                         <link linkend="gdouble">gdouble</link> y);
 
88
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-ellipse-select">gimp_ellipse_select</link>                 (<link linkend="gint32">gint32</link> image_ID,
 
89
                                                         <link linkend="gdouble">gdouble</link> x,
 
90
                                                         <link linkend="gdouble">gdouble</link> y,
 
91
                                                         <link linkend="gdouble">gdouble</link> width,
 
92
                                                         <link linkend="gdouble">gdouble</link> height,
 
93
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
94
                                                         <link linkend="gboolean">gboolean</link> antialias,
 
95
                                                         <link linkend="gboolean">gboolean</link> feather,
 
96
                                                         <link linkend="gdouble">gdouble</link> feather_radius);
 
97
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-eraser">gimp_eraser</link>                         (<link linkend="gint32">gint32</link> drawable_ID,
 
98
                                                         <link linkend="gint">gint</link> num_strokes,
 
99
                                                         const <link linkend="gdouble">gdouble</link> *strokes,
 
100
                                                         <link linkend="GimpBrushApplicationMode">GimpBrushApplicationMode</link> hardness,
 
101
                                                         <link linkend="GimpPaintApplicationMode">GimpPaintApplicationMode</link> method);
 
102
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-eraser-default">gimp_eraser_default</link>                 (<link linkend="gint32">gint32</link> drawable_ID,
 
103
                                                         <link linkend="gint">gint</link> num_strokes,
 
104
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
105
<link linkend="gint32">gint32</link>              <link linkend="gimp-flip">gimp_flip</link>                           (<link linkend="gint32">gint32</link> drawable_ID,
 
106
                                                         <link linkend="GimpOrientationType">GimpOrientationType</link> flip_type);
 
107
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-free-select">gimp_free_select</link>                    (<link linkend="gint32">gint32</link> image_ID,
 
108
                                                         <link linkend="gint">gint</link> num_segs,
 
109
                                                         const <link linkend="gdouble">gdouble</link> *segs,
 
110
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
111
                                                         <link linkend="gboolean">gboolean</link> antialias,
 
112
                                                         <link linkend="gboolean">gboolean</link> feather,
 
113
                                                         <link linkend="gdouble">gdouble</link> feather_radius);
 
114
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-fuzzy-select">gimp_fuzzy_select</link>                   (<link linkend="gint32">gint32</link> drawable_ID,
 
115
                                                         <link linkend="gdouble">gdouble</link> x,
 
116
                                                         <link linkend="gdouble">gdouble</link> y,
 
117
                                                         <link linkend="gint">gint</link> threshold,
 
118
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
119
                                                         <link linkend="gboolean">gboolean</link> antialias,
 
120
                                                         <link linkend="gboolean">gboolean</link> feather,
 
121
                                                         <link linkend="gdouble">gdouble</link> feather_radius,
 
122
                                                         <link linkend="gboolean">gboolean</link> sample_merged);
 
123
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-fuzzy-select-full">gimp_fuzzy_select_full</link>              (<link linkend="gint32">gint32</link> drawable_ID,
 
124
                                                         <link linkend="gdouble">gdouble</link> x,
 
125
                                                         <link linkend="gdouble">gdouble</link> y,
 
126
                                                         <link linkend="gint">gint</link> threshold,
 
127
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
128
                                                         <link linkend="gboolean">gboolean</link> antialias,
 
129
                                                         <link linkend="gboolean">gboolean</link> feather,
 
130
                                                         <link linkend="gdouble">gdouble</link> feather_radius_x,
 
131
                                                         <link linkend="gdouble">gdouble</link> feather_radius_y,
 
132
                                                         <link linkend="gboolean">gboolean</link> sample_merged,
 
133
                                                         <link linkend="gboolean">gboolean</link> select_transparent,
 
134
                                                         <link linkend="GimpSelectCriterion">GimpSelectCriterion</link> select_criterion);
 
135
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-heal">gimp_heal</link>                           (<link linkend="gint32">gint32</link> drawable_ID,
 
136
                                                         <link linkend="gint32">gint32</link> src_drawable_ID,
 
137
                                                         <link linkend="gdouble">gdouble</link> src_x,
 
138
                                                         <link linkend="gdouble">gdouble</link> src_y,
 
139
                                                         <link linkend="gint">gint</link> num_strokes,
 
140
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
141
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-heal-default">gimp_heal_default</link>                   (<link linkend="gint32">gint32</link> drawable_ID,
 
142
                                                         <link linkend="gint">gint</link> num_strokes,
 
143
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
144
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-paintbrush">gimp_paintbrush</link>                     (<link linkend="gint32">gint32</link> drawable_ID,
 
145
                                                         <link linkend="gdouble">gdouble</link> fade_out,
 
146
                                                         <link linkend="gint">gint</link> num_strokes,
 
147
                                                         const <link linkend="gdouble">gdouble</link> *strokes,
 
148
                                                         <link linkend="GimpPaintApplicationMode">GimpPaintApplicationMode</link> method,
 
149
                                                         <link linkend="gdouble">gdouble</link> gradient_length);
 
150
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-paintbrush-default">gimp_paintbrush_default</link>             (<link linkend="gint32">gint32</link> drawable_ID,
 
151
                                                         <link linkend="gint">gint</link> num_strokes,
 
152
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
153
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-pencil">gimp_pencil</link>                         (<link linkend="gint32">gint32</link> drawable_ID,
 
154
                                                         <link linkend="gint">gint</link> num_strokes,
 
155
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
156
<link linkend="gint32">gint32</link>              <link linkend="gimp-perspective">gimp_perspective</link>                    (<link linkend="gint32">gint32</link> drawable_ID,
 
157
                                                         <link linkend="gboolean">gboolean</link> interpolation,
 
158
                                                         <link linkend="gdouble">gdouble</link> x0,
 
159
                                                         <link linkend="gdouble">gdouble</link> y0,
 
160
                                                         <link linkend="gdouble">gdouble</link> x1,
 
161
                                                         <link linkend="gdouble">gdouble</link> y1,
 
162
                                                         <link linkend="gdouble">gdouble</link> x2,
 
163
                                                         <link linkend="gdouble">gdouble</link> y2,
 
164
                                                         <link linkend="gdouble">gdouble</link> x3,
 
165
                                                         <link linkend="gdouble">gdouble</link> y3);
 
166
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-rect-select">gimp_rect_select</link>                    (<link linkend="gint32">gint32</link> image_ID,
 
167
                                                         <link linkend="gdouble">gdouble</link> x,
 
168
                                                         <link linkend="gdouble">gdouble</link> y,
 
169
                                                         <link linkend="gdouble">gdouble</link> width,
 
170
                                                         <link linkend="gdouble">gdouble</link> height,
 
171
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
172
                                                         <link linkend="gboolean">gboolean</link> feather,
 
173
                                                         <link linkend="gdouble">gdouble</link> feather_radius);
 
174
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-round-rect-select">gimp_round_rect_select</link>              (<link linkend="gint32">gint32</link> image_ID,
 
175
                                                         <link linkend="gdouble">gdouble</link> x,
 
176
                                                         <link linkend="gdouble">gdouble</link> y,
 
177
                                                         <link linkend="gdouble">gdouble</link> width,
 
178
                                                         <link linkend="gdouble">gdouble</link> height,
 
179
                                                         <link linkend="gdouble">gdouble</link> corner_radius_x,
 
180
                                                         <link linkend="gdouble">gdouble</link> corner_radius_y,
 
181
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
182
                                                         <link linkend="gboolean">gboolean</link> antialias,
 
183
                                                         <link linkend="gboolean">gboolean</link> feather,
 
184
                                                         <link linkend="gdouble">gdouble</link> feather_radius_x,
 
185
                                                         <link linkend="gdouble">gdouble</link> feather_radius_y);
 
186
<link linkend="gint32">gint32</link>              <link linkend="gimp-rotate">gimp_rotate</link>                         (<link linkend="gint32">gint32</link> drawable_ID,
 
187
                                                         <link linkend="gboolean">gboolean</link> interpolation,
 
188
                                                         <link linkend="gdouble">gdouble</link> angle);
 
189
<link linkend="gint32">gint32</link>              <link linkend="gimp-scale">gimp_scale</link>                          (<link linkend="gint32">gint32</link> drawable_ID,
 
190
                                                         <link linkend="gboolean">gboolean</link> interpolation,
 
191
                                                         <link linkend="gdouble">gdouble</link> x0,
 
192
                                                         <link linkend="gdouble">gdouble</link> y0,
 
193
                                                         <link linkend="gdouble">gdouble</link> x1,
 
194
                                                         <link linkend="gdouble">gdouble</link> y1);
 
195
<link linkend="gint32">gint32</link>              <link linkend="gimp-shear">gimp_shear</link>                          (<link linkend="gint32">gint32</link> drawable_ID,
 
196
                                                         <link linkend="gboolean">gboolean</link> interpolation,
 
197
                                                         <link linkend="GimpOrientationType">GimpOrientationType</link> shear_type,
 
198
                                                         <link linkend="gdouble">gdouble</link> magnitude);
 
199
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-smudge">gimp_smudge</link>                         (<link linkend="gint32">gint32</link> drawable_ID,
 
200
                                                         <link linkend="gdouble">gdouble</link> pressure,
 
201
                                                         <link linkend="gint">gint</link> num_strokes,
 
202
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
203
<link linkend="gboolean">gboolean</link>            <link linkend="gimp-smudge-default">gimp_smudge_default</link>                 (<link linkend="gint32">gint32</link> drawable_ID,
 
204
                                                         <link linkend="gint">gint</link> num_strokes,
 
205
                                                         const <link linkend="gdouble">gdouble</link> *strokes);
 
206
<link linkend="gint32">gint32</link>              <link linkend="gimp-transform-2d">gimp_transform_2d</link>                   (<link linkend="gint32">gint32</link> drawable_ID,
 
207
                                                         <link linkend="gboolean">gboolean</link> interpolation,
 
208
                                                         <link linkend="gdouble">gdouble</link> source_x,
 
209
                                                         <link linkend="gdouble">gdouble</link> source_y,
 
210
                                                         <link linkend="gdouble">gdouble</link> scale_x,
 
211
                                                         <link linkend="gdouble">gdouble</link> scale_y,
 
212
                                                         <link linkend="gdouble">gdouble</link> angle,
 
213
                                                         <link linkend="gdouble">gdouble</link> dest_x,
 
214
                                                         <link linkend="gdouble">gdouble</link> dest_y);
161
215
</synopsis>
162
216
</refsynopsisdiv>
163
217
 
181
235
<title role="details.title">Details</title>
182
236
<refsect2>
183
237
<title><anchor id="gimp-airbrush" role="function"/>gimp_airbrush ()</title>
184
 
<indexterm><primary>gimp_airbrush</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_airbrush                   (<link linkend="gint32">gint32</link> drawable_ID,
185
 
                                             <link linkend="gdouble">gdouble</link> pressure,
186
 
                                             <link linkend="gint">gint</link> num_strokes,
187
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
238
<indexterm><primary>gimp_airbrush</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_airbrush                       (<link linkend="gint32">gint32</link> drawable_ID,
 
239
                                                         <link linkend="gdouble">gdouble</link> pressure,
 
240
                                                         <link linkend="gint">gint</link> num_strokes,
 
241
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
188
242
<para>
189
243
Paint in the current brush with varying pressure. Paint application
190
244
is time-dependent.
214
268
</variablelist></refsect2>
215
269
<refsect2>
216
270
<title><anchor id="gimp-airbrush-default" role="function"/>gimp_airbrush_default ()</title>
217
 
<indexterm><primary>gimp_airbrush_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_airbrush_default           (<link linkend="gint32">gint32</link> drawable_ID,
218
 
                                             <link linkend="gint">gint</link> num_strokes,
219
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
271
<indexterm><primary>gimp_airbrush_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_airbrush_default               (<link linkend="gint32">gint32</link> drawable_ID,
 
272
                                                         <link linkend="gint">gint</link> num_strokes,
 
273
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
220
274
<para>
221
275
Paint in the current brush with varying pressure. Paint application
222
276
is time-dependent.
223
277
</para>
224
278
<para>
225
279
This tool simulates the use of an airbrush. It is similar to
226
 
gimp_airbrush except that the pressure is derived from the airbrush
227
 
tools options box. It the option has not been set the default for
228
 
the option will be used.</para>
 
280
<link linkend="gimp-airbrush"><function>gimp_airbrush()</function></link> except that the pressure is derived from the
 
281
airbrush tools options box. It the option has not been set the
 
282
default for the option will be used.</para>
229
283
<para>
230
284
 
231
285
</para><variablelist role="params">
243
297
</variablelist></refsect2>
244
298
<refsect2>
245
299
<title><anchor id="gimp-by-color-select" role="function"/>gimp_by_color_select ()</title>
246
 
<indexterm><primary>gimp_by_color_select</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_by_color_select            (<link linkend="gint32">gint32</link> drawable_ID,
247
 
                                             const <link linkend="GimpRGB">GimpRGB</link> *color,
248
 
                                             <link linkend="gint">gint</link> threshold,
249
 
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
250
 
                                             <link linkend="gboolean">gboolean</link> antialias,
251
 
                                             <link linkend="gboolean">gboolean</link> feather,
252
 
                                             <link linkend="gdouble">gdouble</link> feather_radius,
253
 
                                             <link linkend="gboolean">gboolean</link> sample_merged);</programlisting>
 
300
<indexterm><primary>gimp_by_color_select</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_by_color_select                (<link linkend="gint32">gint32</link> drawable_ID,
 
301
                                                         const <link linkend="GimpRGB">GimpRGB</link> *color,
 
302
                                                         <link linkend="gint">gint</link> threshold,
 
303
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
304
                                                         <link linkend="gboolean">gboolean</link> antialias,
 
305
                                                         <link linkend="gboolean">gboolean</link> feather,
 
306
                                                         <link linkend="gdouble">gdouble</link> feather_radius,
 
307
                                                         <link linkend="gboolean">gboolean</link> sample_merged);</programlisting>
254
308
<para>
255
309
Create a selection by selecting all pixels (in the specified
256
310
drawable) with the same (or similar) color to that specified.
264
318
selection. The antialiasing parameter allows the final selection
265
319
mask to contain intermediate values based on close misses to the
266
320
threshold bar. Feathering can be enabled optionally and is
267
 
controlled with the \"feather_radius\" parameter. If the
268
 
sample_merged parameter is non-zero, the data of the composite image
 
321
controlled with the 'feather-radius' parameter. If the
 
322
'sample-merged' parameter is TRUE, the data of the composite image
269
323
will be used instead of that for the specified drawable. This is
270
324
equivalent to sampling for colors after merging all visible layers.
271
325
In the case of a merged sampling, the supplied drawable is ignored.</para>
279
333
<listitem><simpara> The color to select.
280
334
</simpara></listitem></varlistentry>
281
335
<varlistentry><term><parameter>threshold</parameter>&nbsp;:</term>
282
 
<listitem><simpara> Threshold in intensity levels %<link linkend="desc"><literal>desc</literal></link>%%.
 
336
<listitem><simpara> Threshold in intensity levels.
283
337
</simpara></listitem></varlistentry>
284
338
<varlistentry><term><parameter>operation</parameter>&nbsp;:</term>
285
339
<listitem><simpara> The selection operation.
300
354
</simpara></listitem></varlistentry>
301
355
</variablelist></refsect2>
302
356
<refsect2>
 
357
<title><anchor id="gimp-by-color-select-full" role="function" condition="since:GIMP 2.4"/>gimp_by_color_select_full ()</title>
 
358
<indexterm role="GIMP 2.4"><primary>gimp_by_color_select_full</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_by_color_select_full           (<link linkend="gint32">gint32</link> drawable_ID,
 
359
                                                         const <link linkend="GimpRGB">GimpRGB</link> *color,
 
360
                                                         <link linkend="gint">gint</link> threshold,
 
361
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
362
                                                         <link linkend="gboolean">gboolean</link> antialias,
 
363
                                                         <link linkend="gboolean">gboolean</link> feather,
 
364
                                                         <link linkend="gdouble">gdouble</link> feather_radius_x,
 
365
                                                         <link linkend="gdouble">gdouble</link> feather_radius_y,
 
366
                                                         <link linkend="gboolean">gboolean</link> sample_merged,
 
367
                                                         <link linkend="gboolean">gboolean</link> select_transparent,
 
368
                                                         <link linkend="GimpSelectCriterion">GimpSelectCriterion</link> select_criterion);</programlisting>
 
369
<para>
 
370
Create a selection by selecting all pixels (in the specified
 
371
drawable) with the same (or similar) color to that specified.
 
372
</para>
 
373
<para>
 
374
This tool creates a selection over the specified image. A by-color
 
375
selection is determined by the supplied color under the constraints
 
376
of the specified threshold. Essentially, all pixels (in the
 
377
drawable) that have color sufficiently close to the specified color
 
378
(as determined by the threshold value) are included in the
 
379
selection. To select transparent regions, the color specified must
 
380
also have minimum alpha. The antialiasing parameter allows the final
 
381
selection mask to contain intermediate values based on close misses
 
382
to the threshold bar. Feathering can be enabled optionally and is
 
383
controlled with the 'feather-radius' parameter. If the
 
384
'sample-merged' parameter is TRUE, the data of the composite image
 
385
will be used instead of that for the specified drawable. This is
 
386
equivalent to sampling for colors after merging all visible layers.
 
387
In the case of a merged sampling, the supplied drawable is ignored.</para>
 
388
<para>
 
389
 
 
390
</para><variablelist role="params">
 
391
<varlistentry><term><parameter>drawable_ID</parameter>&nbsp;:</term>
 
392
<listitem><simpara> The affected drawable.
 
393
</simpara></listitem></varlistentry>
 
394
<varlistentry><term><parameter>color</parameter>&nbsp;:</term>
 
395
<listitem><simpara> The color to select.
 
396
</simpara></listitem></varlistentry>
 
397
<varlistentry><term><parameter>threshold</parameter>&nbsp;:</term>
 
398
<listitem><simpara> Threshold in intensity levels.
 
399
</simpara></listitem></varlistentry>
 
400
<varlistentry><term><parameter>operation</parameter>&nbsp;:</term>
 
401
<listitem><simpara> The selection operation.
 
402
</simpara></listitem></varlistentry>
 
403
<varlistentry><term><parameter>antialias</parameter>&nbsp;:</term>
 
404
<listitem><simpara> Antialiasing.
 
405
</simpara></listitem></varlistentry>
 
406
<varlistentry><term><parameter>feather</parameter>&nbsp;:</term>
 
407
<listitem><simpara> Feather option for selections.
 
408
</simpara></listitem></varlistentry>
 
409
<varlistentry><term><parameter>feather_radius_x</parameter>&nbsp;:</term>
 
410
<listitem><simpara> Radius for feather operation in X direction.
 
411
</simpara></listitem></varlistentry>
 
412
<varlistentry><term><parameter>feather_radius_y</parameter>&nbsp;:</term>
 
413
<listitem><simpara> Radius for feather operation in Y direction.
 
414
</simpara></listitem></varlistentry>
 
415
<varlistentry><term><parameter>sample_merged</parameter>&nbsp;:</term>
 
416
<listitem><simpara> Use the composite image, not the drawable.
 
417
</simpara></listitem></varlistentry>
 
418
<varlistentry><term><parameter>select_transparent</parameter>&nbsp;:</term>
 
419
<listitem><simpara> Whether to consider transparent pixels for selection. If TRUE, transparency is considered as a unique selectable color.
 
420
</simpara></listitem></varlistentry>
 
421
<varlistentry><term><parameter>select_criterion</parameter>&nbsp;:</term>
 
422
<listitem><simpara> The criterion used to determine color similarity. SELECT_CRITERION_COMPOSITE is the standard choice.
 
423
</simpara></listitem></varlistentry>
 
424
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> TRUE on success.
 
425
 
 
426
</simpara></listitem></varlistentry>
 
427
</variablelist><para role="since">Since  GIMP 2.4
 
428
</para></refsect2>
 
429
<refsect2>
303
430
<title><anchor id="gimp-clone" role="function"/>gimp_clone ()</title>
304
 
<indexterm><primary>gimp_clone</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_clone                      (<link linkend="gint32">gint32</link> drawable_ID,
305
 
                                             <link linkend="gint32">gint32</link> src_drawable_ID,
306
 
                                             <link linkend="GimpCloneType">GimpCloneType</link> clone_type,
307
 
                                             <link linkend="gdouble">gdouble</link> src_x,
308
 
                                             <link linkend="gdouble">gdouble</link> src_y,
309
 
                                             <link linkend="gint">gint</link> num_strokes,
310
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
431
<indexterm><primary>gimp_clone</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_clone                          (<link linkend="gint32">gint32</link> drawable_ID,
 
432
                                                         <link linkend="gint32">gint32</link> src_drawable_ID,
 
433
                                                         <link linkend="GimpCloneType">GimpCloneType</link> clone_type,
 
434
                                                         <link linkend="gdouble">gdouble</link> src_x,
 
435
                                                         <link linkend="gdouble">gdouble</link> src_y,
 
436
                                                         <link linkend="gint">gint</link> num_strokes,
 
437
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
311
438
<para>
312
439
Clone from the source to the dest drawable using the current brush
313
440
</para>
353
480
</variablelist></refsect2>
354
481
<refsect2>
355
482
<title><anchor id="gimp-clone-default" role="function"/>gimp_clone_default ()</title>
356
 
<indexterm><primary>gimp_clone_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_clone_default              (<link linkend="gint32">gint32</link> drawable_ID,
357
 
                                             <link linkend="gint">gint</link> num_strokes,
358
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
483
<indexterm><primary>gimp_clone_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_clone_default                  (<link linkend="gint32">gint32</link> drawable_ID,
 
484
                                                         <link linkend="gint">gint</link> num_strokes,
 
485
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
359
486
<para>
360
487
Clone from the source to the dest drawable using the current brush
361
488
</para>
362
489
<para>
363
490
This tool clones (copies) from the source drawable starting at the
364
491
specified source coordinates to the dest drawable. This function
365
 
performs exactly the same as the gimp_clone function except that the
366
 
tools arguments are obtained from the clones option dialog. It this
367
 
dialog has not been activated then the dialogs default values will
368
 
be used.</para>
 
492
performs exactly the same as the <link linkend="gimp-clone"><function>gimp_clone()</function></link> function except that
 
493
the tools arguments are obtained from the clones option dialog. It
 
494
this dialog has not been activated then the dialogs default values
 
495
will be used.</para>
369
496
<para>
370
497
 
371
498
</para><variablelist role="params">
383
510
</variablelist></refsect2>
384
511
<refsect2>
385
512
<title><anchor id="gimp-convolve" role="function"/>gimp_convolve ()</title>
386
 
<indexterm><primary>gimp_convolve</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_convolve                   (<link linkend="gint32">gint32</link> drawable_ID,
387
 
                                             <link linkend="gdouble">gdouble</link> pressure,
388
 
                                             <link linkend="GimpConvolveType">GimpConvolveType</link> convolve_type,
389
 
                                             <link linkend="gint">gint</link> num_strokes,
390
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
513
<indexterm><primary>gimp_convolve</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_convolve                       (<link linkend="gint32">gint32</link> drawable_ID,
 
514
                                                         <link linkend="gdouble">gdouble</link> pressure,
 
515
                                                         <link linkend="GimpConvolveType">GimpConvolveType</link> convolve_type,
 
516
                                                         <link linkend="gint">gint</link> num_strokes,
 
517
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
391
518
<para>
392
519
Convolve (Blur, Sharpen) using the current brush.
393
520
</para>
419
546
</variablelist></refsect2>
420
547
<refsect2>
421
548
<title><anchor id="gimp-convolve-default" role="function"/>gimp_convolve_default ()</title>
422
 
<indexterm><primary>gimp_convolve_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_convolve_default           (<link linkend="gint32">gint32</link> drawable_ID,
423
 
                                             <link linkend="gint">gint</link> num_strokes,
424
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
549
<indexterm><primary>gimp_convolve_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_convolve_default               (<link linkend="gint32">gint32</link> drawable_ID,
 
550
                                                         <link linkend="gint">gint</link> num_strokes,
 
551
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
425
552
<para>
426
553
Convolve (Blur, Sharpen) using the current brush.
427
554
</para>
428
555
<para>
429
556
This tool convolves the specified drawable with either a sharpening
430
557
or blurring kernel. This function performs exactly the same as the
431
 
gimp_convolve function except that the tools arguments are obtained
432
 
from the convolve option dialog. It this dialog has not been
433
 
activated then the dialogs default values will be used.</para>
 
558
<link linkend="gimp-convolve"><function>gimp_convolve()</function></link> function except that the tools arguments are
 
559
obtained from the convolve option dialog. It this dialog has not
 
560
been activated then the dialogs default values will be used.</para>
434
561
<para>
435
562
 
436
563
</para><variablelist role="params">
448
575
</variablelist></refsect2>
449
576
<refsect2>
450
577
<title><anchor id="gimp-dodgeburn" role="function"/>gimp_dodgeburn ()</title>
451
 
<indexterm><primary>gimp_dodgeburn</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_dodgeburn                  (<link linkend="gint32">gint32</link> drawable_ID,
452
 
                                             <link linkend="gdouble">gdouble</link> exposure,
453
 
                                             <link linkend="GimpDodgeBurnType">GimpDodgeBurnType</link> dodgeburn_type,
454
 
                                             <link linkend="GimpTransferMode">GimpTransferMode</link> dodgeburn_mode,
455
 
                                             <link linkend="gint">gint</link> num_strokes,
456
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
578
<indexterm><primary>gimp_dodgeburn</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_dodgeburn                      (<link linkend="gint32">gint32</link> drawable_ID,
 
579
                                                         <link linkend="gdouble">gdouble</link> exposure,
 
580
                                                         <link linkend="GimpDodgeBurnType">GimpDodgeBurnType</link> dodgeburn_type,
 
581
                                                         <link linkend="GimpTransferMode">GimpTransferMode</link> dodgeburn_mode,
 
582
                                                         <link linkend="gint">gint</link> num_strokes,
 
583
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
457
584
<para>
458
585
Dodgeburn image with varying exposure.
459
586
</para>
466
593
<listitem><simpara> The affected drawable.
467
594
</simpara></listitem></varlistentry>
468
595
<varlistentry><term><parameter>exposure</parameter>&nbsp;:</term>
469
 
<listitem><simpara> The exposer of the strokes.
 
596
<listitem><simpara> The exposure of the strokes.
470
597
</simpara></listitem></varlistentry>
471
598
<varlistentry><term><parameter>dodgeburn_type</parameter>&nbsp;:</term>
472
599
<listitem><simpara> The type either dodge or burn.
485
612
</variablelist></refsect2>
486
613
<refsect2>
487
614
<title><anchor id="gimp-dodgeburn-default" role="function"/>gimp_dodgeburn_default ()</title>
488
 
<indexterm><primary>gimp_dodgeburn_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_dodgeburn_default          (<link linkend="gint32">gint32</link> drawable_ID,
489
 
                                             <link linkend="gint">gint</link> num_strokes,
490
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
615
<indexterm><primary>gimp_dodgeburn_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_dodgeburn_default              (<link linkend="gint32">gint32</link> drawable_ID,
 
616
                                                         <link linkend="gint">gint</link> num_strokes,
 
617
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
491
618
<para>
492
619
Dodgeburn image with varying exposure. This is the same as the
493
 
gimp_dodgeburn function except that the exposure, type and mode are
494
 
taken from the tools option dialog. If the dialog has not been
 
620
<link linkend="gimp-dodgeburn"><function>gimp_dodgeburn()</function></link> function except that the exposure, type and mode
 
621
are taken from the tools option dialog. If the dialog has not been
495
622
activated then the defaults as used by the dialog will be used.
496
623
</para>
497
624
<para>
512
639
</simpara></listitem></varlistentry>
513
640
</variablelist></refsect2>
514
641
<refsect2>
 
642
<title><anchor id="gimp-edit-bucket-fill-full" role="function" condition="since:GIMP 2.4"/>gimp_edit_bucket_fill_full ()</title>
 
643
<indexterm role="GIMP 2.4"><primary>gimp_edit_bucket_fill_full</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_edit_bucket_fill_full          (<link linkend="gint32">gint32</link> drawable_ID,
 
644
                                                         <link linkend="GimpBucketFillMode">GimpBucketFillMode</link> fill_mode,
 
645
                                                         <link linkend="GimpLayerModeEffects">GimpLayerModeEffects</link> paint_mode,
 
646
                                                         <link linkend="gdouble">gdouble</link> opacity,
 
647
                                                         <link linkend="gdouble">gdouble</link> threshold,
 
648
                                                         <link linkend="gboolean">gboolean</link> sample_merged,
 
649
                                                         <link linkend="gboolean">gboolean</link> fill_transparent,
 
650
                                                         <link linkend="GimpSelectCriterion">GimpSelectCriterion</link> select_criterion,
 
651
                                                         <link linkend="gdouble">gdouble</link> x,
 
652
                                                         <link linkend="gdouble">gdouble</link> y);</programlisting>
 
653
<para>
 
654
Fill the area specified either by the current selection if there is
 
655
one, or by a seed fill starting at the specified coordinates.
 
656
</para>
 
657
<para>
 
658
This tool requires information on the paint application mode, and
 
659
the fill mode, which can either be in the foreground color, or in
 
660
the currently active pattern. If there is no selection, a seed fill
 
661
is executed at the specified coordinates and extends outward in
 
662
keeping with the threshold parameter. If there is a selection in the
 
663
target image, the threshold, sample merged, x, and y arguments are
 
664
unused. If the sample_merged parameter is TRUE, the data of the
 
665
composite image will be used instead of that for the specified
 
666
drawable. This is equivalent to sampling for colors after merging
 
667
all visible layers. In the case of merged sampling, the x and y
 
668
coordinates are relative to the image's origin; otherwise, they are
 
669
relative to the drawable's origin.</para>
 
670
<para>
 
671
 
 
672
</para><variablelist role="params">
 
673
<varlistentry><term><parameter>drawable_ID</parameter>&nbsp;:</term>
 
674
<listitem><simpara> The affected drawable.
 
675
</simpara></listitem></varlistentry>
 
676
<varlistentry><term><parameter>fill_mode</parameter>&nbsp;:</term>
 
677
<listitem><simpara> The type of fill.
 
678
</simpara></listitem></varlistentry>
 
679
<varlistentry><term><parameter>paint_mode</parameter>&nbsp;:</term>
 
680
<listitem><simpara> The paint application mode.
 
681
</simpara></listitem></varlistentry>
 
682
<varlistentry><term><parameter>opacity</parameter>&nbsp;:</term>
 
683
<listitem><simpara> The opacity of the final bucket fill.
 
684
</simpara></listitem></varlistentry>
 
685
<varlistentry><term><parameter>threshold</parameter>&nbsp;:</term>
 
686
<listitem><simpara> The threshold determines how extensive the seed fill will be. It's value is specified in terms of intensity levels. This parameter is only valid when there is no selection in the specified image.
 
687
</simpara></listitem></varlistentry>
 
688
<varlistentry><term><parameter>sample_merged</parameter>&nbsp;:</term>
 
689
<listitem><simpara> Use the composite image, not the drawable.
 
690
</simpara></listitem></varlistentry>
 
691
<varlistentry><term><parameter>fill_transparent</parameter>&nbsp;:</term>
 
692
<listitem><simpara> Whether to consider transparent pixels for filling. If TRUE, transparency is considered as a unique fillable color.
 
693
</simpara></listitem></varlistentry>
 
694
<varlistentry><term><parameter>select_criterion</parameter>&nbsp;:</term>
 
695
<listitem><simpara> The criterion used to determine color similarity. SELECT_CRITERION_COMPOSITE is the standard choice.
 
696
</simpara></listitem></varlistentry>
 
697
<varlistentry><term><parameter>x</parameter>&nbsp;:</term>
 
698
<listitem><simpara> The x coordinate of this bucket fill's application. This parameter is only valid when there is no selection in the specified image.
 
699
</simpara></listitem></varlistentry>
 
700
<varlistentry><term><parameter>y</parameter>&nbsp;:</term>
 
701
<listitem><simpara> The y coordinate of this bucket fill's application. This parameter is only valid when there is no selection in the specified image.
 
702
</simpara></listitem></varlistentry>
 
703
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> TRUE on success.
 
704
 
 
705
</simpara></listitem></varlistentry>
 
706
</variablelist><para role="since">Since  GIMP 2.4
 
707
</para></refsect2>
 
708
<refsect2>
515
709
<title><anchor id="gimp-ellipse-select" role="function"/>gimp_ellipse_select ()</title>
516
 
<indexterm><primary>gimp_ellipse_select</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_ellipse_select             (<link linkend="gint32">gint32</link> image_ID,
517
 
                                             <link linkend="gdouble">gdouble</link> x,
518
 
                                             <link linkend="gdouble">gdouble</link> y,
519
 
                                             <link linkend="gdouble">gdouble</link> width,
520
 
                                             <link linkend="gdouble">gdouble</link> height,
521
 
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
522
 
                                             <link linkend="gboolean">gboolean</link> antialias,
523
 
                                             <link linkend="gboolean">gboolean</link> feather,
524
 
                                             <link linkend="gdouble">gdouble</link> feather_radius);</programlisting>
 
710
<indexterm><primary>gimp_ellipse_select</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_ellipse_select                 (<link linkend="gint32">gint32</link> image_ID,
 
711
                                                         <link linkend="gdouble">gdouble</link> x,
 
712
                                                         <link linkend="gdouble">gdouble</link> y,
 
713
                                                         <link linkend="gdouble">gdouble</link> width,
 
714
                                                         <link linkend="gdouble">gdouble</link> height,
 
715
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
716
                                                         <link linkend="gboolean">gboolean</link> antialias,
 
717
                                                         <link linkend="gboolean">gboolean</link> feather,
 
718
                                                         <link linkend="gdouble">gdouble</link> feather_radius);</programlisting>
525
719
<para>
526
720
Create an elliptical selection over the specified image.
527
721
</para>
570
764
</variablelist></refsect2>
571
765
<refsect2>
572
766
<title><anchor id="gimp-eraser" role="function"/>gimp_eraser ()</title>
573
 
<indexterm><primary>gimp_eraser</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_eraser                     (<link linkend="gint32">gint32</link> drawable_ID,
574
 
                                             <link linkend="gint">gint</link> num_strokes,
575
 
                                             const <link linkend="gdouble">gdouble</link> *strokes,
576
 
                                             <link linkend="GimpBrushApplicationMode">GimpBrushApplicationMode</link> hardness,
577
 
                                             <link linkend="GimpPaintApplicationMode">GimpPaintApplicationMode</link> method);</programlisting>
 
767
<indexterm><primary>gimp_eraser</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_eraser                         (<link linkend="gint32">gint32</link> drawable_ID,
 
768
                                                         <link linkend="gint">gint</link> num_strokes,
 
769
                                                         const <link linkend="gdouble">gdouble</link> *strokes,
 
770
                                                         <link linkend="GimpBrushApplicationMode">GimpBrushApplicationMode</link> hardness,
 
771
                                                         <link linkend="GimpPaintApplicationMode">GimpPaintApplicationMode</link> method);</programlisting>
578
772
<para>
579
773
Erase using the current brush.
580
774
</para>
597
791
<listitem><simpara> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
598
792
</simpara></listitem></varlistentry>
599
793
<varlistentry><term><parameter>hardness</parameter>&nbsp;:</term>
600
 
<listitem><simpara> %<link linkend="desc"><literal>desc</literal></link>%%.
 
794
<listitem><simpara> How to apply the brush.
601
795
</simpara></listitem></varlistentry>
602
796
<varlistentry><term><parameter>method</parameter>&nbsp;:</term>
603
 
<listitem><simpara> %<link linkend="desc"><literal>desc</literal></link>%%.
 
797
<listitem><simpara> The paint method to use.
604
798
</simpara></listitem></varlistentry>
605
799
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> TRUE on success.
606
800
</simpara></listitem></varlistentry>
607
801
</variablelist></refsect2>
608
802
<refsect2>
609
803
<title><anchor id="gimp-eraser-default" role="function"/>gimp_eraser_default ()</title>
610
 
<indexterm><primary>gimp_eraser_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_eraser_default             (<link linkend="gint32">gint32</link> drawable_ID,
611
 
                                             <link linkend="gint">gint</link> num_strokes,
612
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
804
<indexterm><primary>gimp_eraser_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_eraser_default                 (<link linkend="gint32">gint32</link> drawable_ID,
 
805
                                                         <link linkend="gint">gint</link> num_strokes,
 
806
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
613
807
<para>
614
808
Erase using the current brush.
615
809
</para>
616
810
<para>
617
811
This tool erases using the current brush mask. This function
618
 
performs exactly the same as the gimp_eraser function except that
 
812
performs exactly the same as the <link linkend="gimp-eraser"><function>gimp_eraser()</function></link> function except that
619
813
the tools arguments are obtained from the eraser option dialog. It
620
814
this dialog has not been activated then the dialogs default values
621
815
will be used.</para>
636
830
</variablelist></refsect2>
637
831
<refsect2>
638
832
<title><anchor id="gimp-flip" role="function" condition="deprecated:"/>gimp_flip ()</title>
639
 
<indexterm role="deprecated"><primary>gimp_flip</primary></indexterm><programlisting><link linkend="gint32">gint32</link>      gimp_flip                       (<link linkend="gint32">gint32</link> drawable_ID,
640
 
                                             <link linkend="GimpOrientationType">GimpOrientationType</link> flip_type);</programlisting>
 
833
<indexterm role="deprecated"><primary>gimp_flip</primary></indexterm><programlisting><link linkend="gint32">gint32</link>              gimp_flip                           (<link linkend="gint32">gint32</link> drawable_ID,
 
834
                                                         <link linkend="GimpOrientationType">GimpOrientationType</link> flip_type);</programlisting>
641
835
<warning><para><literal>gimp_flip</literal> is deprecated and should not be used in newly-written code.</para></warning>
642
836
<para>
643
837
This procedure is deprecated! Use
656
850
</variablelist></refsect2>
657
851
<refsect2>
658
852
<title><anchor id="gimp-free-select" role="function"/>gimp_free_select ()</title>
659
 
<indexterm><primary>gimp_free_select</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_free_select                (<link linkend="gint32">gint32</link> image_ID,
660
 
                                             <link linkend="gint">gint</link> num_segs,
661
 
                                             const <link linkend="gdouble">gdouble</link> *segs,
662
 
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
663
 
                                             <link linkend="gboolean">gboolean</link> antialias,
664
 
                                             <link linkend="gboolean">gboolean</link> feather,
665
 
                                             <link linkend="gdouble">gdouble</link> feather_radius);</programlisting>
 
853
<indexterm><primary>gimp_free_select</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_free_select                    (<link linkend="gint32">gint32</link> image_ID,
 
854
                                                         <link linkend="gint">gint</link> num_segs,
 
855
                                                         const <link linkend="gdouble">gdouble</link> *segs,
 
856
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
857
                                                         <link linkend="gboolean">gboolean</link> antialias,
 
858
                                                         <link linkend="gboolean">gboolean</link> feather,
 
859
                                                         <link linkend="gdouble">gdouble</link> feather_radius);</programlisting>
666
860
<para>
667
861
Create a polygonal selection over the specified image.
668
862
</para>
707
901
</variablelist></refsect2>
708
902
<refsect2>
709
903
<title><anchor id="gimp-fuzzy-select" role="function"/>gimp_fuzzy_select ()</title>
710
 
<indexterm><primary>gimp_fuzzy_select</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_fuzzy_select               (<link linkend="gint32">gint32</link> drawable_ID,
711
 
                                             <link linkend="gdouble">gdouble</link> x,
712
 
                                             <link linkend="gdouble">gdouble</link> y,
713
 
                                             <link linkend="gint">gint</link> threshold,
714
 
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
715
 
                                             <link linkend="gboolean">gboolean</link> antialias,
716
 
                                             <link linkend="gboolean">gboolean</link> feather,
717
 
                                             <link linkend="gdouble">gdouble</link> feather_radius,
718
 
                                             <link linkend="gboolean">gboolean</link> sample_merged);</programlisting>
 
904
<indexterm><primary>gimp_fuzzy_select</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_fuzzy_select                   (<link linkend="gint32">gint32</link> drawable_ID,
 
905
                                                         <link linkend="gdouble">gdouble</link> x,
 
906
                                                         <link linkend="gdouble">gdouble</link> y,
 
907
                                                         <link linkend="gint">gint</link> threshold,
 
908
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
909
                                                         <link linkend="gboolean">gboolean</link> antialias,
 
910
                                                         <link linkend="gboolean">gboolean</link> feather,
 
911
                                                         <link linkend="gdouble">gdouble</link> feather_radius,
 
912
                                                         <link linkend="gboolean">gboolean</link> sample_merged);</programlisting>
719
913
<para>
720
914
Create a fuzzy selection starting at the specified coordinates on
721
915
the specified drawable.
731
925
antialiasing parameter allows the final selection mask to contain
732
926
intermediate values based on close misses to the threshold bar at
733
927
pixels along the seed fill boundary. Feathering can be enabled
734
 
optionally and is controlled with the \"feather_radius\" paramter.
735
 
If the sample_merged parameter is non-zero, the data of the
736
 
composite image will be used instead of that for the specified
737
 
drawable. This is equivalent to sampling for colors after merging
738
 
all visible layers. In the case of a merged sampling, the supplied
739
 
drawable is ignored. If the sample is merged, the specified
740
 
coordinates are relative to the image origin; otherwise, they are
741
 
relative to the drawable's origin.</para>
 
928
optionally and is controlled with the 'feather-radius' paramter. If
 
929
the 'sample-merged' parameter is TRUE, the data of the composite
 
930
image will be used instead of that for the specified drawable. This
 
931
is equivalent to sampling for colors after merging all visible
 
932
layers. In the case of a merged sampling, the supplied drawable is
 
933
ignored. If the sample is merged, the specified coordinates are
 
934
relative to the image origin; otherwise, they are relative to the
 
935
drawable's origin.</para>
742
936
<para>
743
937
 
744
938
</para><variablelist role="params">
752
946
<listitem><simpara> y coordinate of initial seed fill point: (image coordinates).
753
947
</simpara></listitem></varlistentry>
754
948
<varlistentry><term><parameter>threshold</parameter>&nbsp;:</term>
755
 
<listitem><simpara> Threshold in intensity levels %<link linkend="desc"><literal>desc</literal></link>%%.
 
949
<listitem><simpara> Threshold in intensity levels.
756
950
</simpara></listitem></varlistentry>
757
951
<varlistentry><term><parameter>operation</parameter>&nbsp;:</term>
758
952
<listitem><simpara> The selection operation.
773
967
</simpara></listitem></varlistentry>
774
968
</variablelist></refsect2>
775
969
<refsect2>
 
970
<title><anchor id="gimp-fuzzy-select-full" role="function" condition="since:GIMP 2.4"/>gimp_fuzzy_select_full ()</title>
 
971
<indexterm role="GIMP 2.4"><primary>gimp_fuzzy_select_full</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_fuzzy_select_full              (<link linkend="gint32">gint32</link> drawable_ID,
 
972
                                                         <link linkend="gdouble">gdouble</link> x,
 
973
                                                         <link linkend="gdouble">gdouble</link> y,
 
974
                                                         <link linkend="gint">gint</link> threshold,
 
975
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
976
                                                         <link linkend="gboolean">gboolean</link> antialias,
 
977
                                                         <link linkend="gboolean">gboolean</link> feather,
 
978
                                                         <link linkend="gdouble">gdouble</link> feather_radius_x,
 
979
                                                         <link linkend="gdouble">gdouble</link> feather_radius_y,
 
980
                                                         <link linkend="gboolean">gboolean</link> sample_merged,
 
981
                                                         <link linkend="gboolean">gboolean</link> select_transparent,
 
982
                                                         <link linkend="GimpSelectCriterion">GimpSelectCriterion</link> select_criterion);</programlisting>
 
983
<para>
 
984
Create a fuzzy selection starting at the specified coordinates on
 
985
the specified drawable.
 
986
</para>
 
987
<para>
 
988
This tool creates a fuzzy selection over the specified image. A
 
989
fuzzy selection is determined by a seed fill under the constraints
 
990
of the specified threshold. Essentially, the color at the specified
 
991
coordinates (in the drawable) is measured and the selection expands
 
992
outwards from that point to any adjacent pixels which are not
 
993
significantly different (as determined by the threshold value). This
 
994
process continues until no more expansion is possible. The
 
995
antialiasing parameter allows the final selection mask to contain
 
996
intermediate values based on close misses to the threshold bar at
 
997
pixels along the seed fill boundary. Feathering can be enabled
 
998
optionally and is controlled with the 'feather-radius' paramter. If
 
999
the 'sample-merged' parameter is TRUE, the data of the composite
 
1000
image will be used instead of that for the specified drawable. This
 
1001
is equivalent to sampling for colors after merging all visible
 
1002
layers. In the case of a merged sampling, the supplied drawable is
 
1003
ignored. If the sample is merged, the specified coordinates are
 
1004
relative to the image origin; otherwise, they are relative to the
 
1005
drawable's origin.</para>
 
1006
<para>
 
1007
 
 
1008
</para><variablelist role="params">
 
1009
<varlistentry><term><parameter>drawable_ID</parameter>&nbsp;:</term>
 
1010
<listitem><simpara> The affected drawable.
 
1011
</simpara></listitem></varlistentry>
 
1012
<varlistentry><term><parameter>x</parameter>&nbsp;:</term>
 
1013
<listitem><simpara> x coordinate of initial seed fill point: (image coordinates).
 
1014
</simpara></listitem></varlistentry>
 
1015
<varlistentry><term><parameter>y</parameter>&nbsp;:</term>
 
1016
<listitem><simpara> y coordinate of initial seed fill point: (image coordinates).
 
1017
</simpara></listitem></varlistentry>
 
1018
<varlistentry><term><parameter>threshold</parameter>&nbsp;:</term>
 
1019
<listitem><simpara> Threshold in intensity levels.
 
1020
</simpara></listitem></varlistentry>
 
1021
<varlistentry><term><parameter>operation</parameter>&nbsp;:</term>
 
1022
<listitem><simpara> The selection operation.
 
1023
</simpara></listitem></varlistentry>
 
1024
<varlistentry><term><parameter>antialias</parameter>&nbsp;:</term>
 
1025
<listitem><simpara> Antialiasing.
 
1026
</simpara></listitem></varlistentry>
 
1027
<varlistentry><term><parameter>feather</parameter>&nbsp;:</term>
 
1028
<listitem><simpara> Feather option for selections.
 
1029
</simpara></listitem></varlistentry>
 
1030
<varlistentry><term><parameter>feather_radius_x</parameter>&nbsp;:</term>
 
1031
<listitem><simpara> Radius for feather operation in X direction.
 
1032
</simpara></listitem></varlistentry>
 
1033
<varlistentry><term><parameter>feather_radius_y</parameter>&nbsp;:</term>
 
1034
<listitem><simpara> Radius for feather operation in Y direction.
 
1035
</simpara></listitem></varlistentry>
 
1036
<varlistentry><term><parameter>sample_merged</parameter>&nbsp;:</term>
 
1037
<listitem><simpara> Use the composite image, not the drawable.
 
1038
</simpara></listitem></varlistentry>
 
1039
<varlistentry><term><parameter>select_transparent</parameter>&nbsp;:</term>
 
1040
<listitem><simpara> Whether to consider transparent pixels for selection. If TRUE, transparency is considered as a unique selectable color.
 
1041
</simpara></listitem></varlistentry>
 
1042
<varlistentry><term><parameter>select_criterion</parameter>&nbsp;:</term>
 
1043
<listitem><simpara> The criterion used to determine color similarity. SELECT_CRITERION_COMPOSITE is the standard choice.
 
1044
</simpara></listitem></varlistentry>
 
1045
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> TRUE on success.
 
1046
 
 
1047
</simpara></listitem></varlistentry>
 
1048
</variablelist><para role="since">Since  GIMP 2.4
 
1049
</para></refsect2>
 
1050
<refsect2>
 
1051
<title><anchor id="gimp-heal" role="function" condition="since:GIMP 2.4"/>gimp_heal ()</title>
 
1052
<indexterm role="GIMP 2.4"><primary>gimp_heal</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_heal                           (<link linkend="gint32">gint32</link> drawable_ID,
 
1053
                                                         <link linkend="gint32">gint32</link> src_drawable_ID,
 
1054
                                                         <link linkend="gdouble">gdouble</link> src_x,
 
1055
                                                         <link linkend="gdouble">gdouble</link> src_y,
 
1056
                                                         <link linkend="gint">gint</link> num_strokes,
 
1057
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
1058
<para>
 
1059
Heal from the source to the dest drawable using the current brush
 
1060
</para>
 
1061
<para>
 
1062
This tool heals the source drawable starting at the specified source
 
1063
coordinates to the dest drawable. For image healing, if the sum of
 
1064
the src coordinates and subsequent stroke offsets exceeds the
 
1065
extents of the src drawable, then no paint is transferred. The
 
1066
healing tool is capable of transforming between any image types
 
1067
except RGB-&gt;Indexed.</para>
 
1068
<para>
 
1069
 
 
1070
</para><variablelist role="params">
 
1071
<varlistentry><term><parameter>drawable_ID</parameter>&nbsp;:</term>
 
1072
<listitem><simpara> The affected drawable.
 
1073
</simpara></listitem></varlistentry>
 
1074
<varlistentry><term><parameter>src_drawable_ID</parameter>&nbsp;:</term>
 
1075
<listitem><simpara> The source drawable.
 
1076
</simpara></listitem></varlistentry>
 
1077
<varlistentry><term><parameter>src_x</parameter>&nbsp;:</term>
 
1078
<listitem><simpara> The x coordinate in the source image.
 
1079
</simpara></listitem></varlistentry>
 
1080
<varlistentry><term><parameter>src_y</parameter>&nbsp;:</term>
 
1081
<listitem><simpara> The y coordinate in the source image.
 
1082
</simpara></listitem></varlistentry>
 
1083
<varlistentry><term><parameter>num_strokes</parameter>&nbsp;:</term>
 
1084
<listitem><simpara> Number of stroke control points (count each coordinate as 2 points).
 
1085
</simpara></listitem></varlistentry>
 
1086
<varlistentry><term><parameter>strokes</parameter>&nbsp;:</term>
 
1087
<listitem><simpara> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
 
1088
</simpara></listitem></varlistentry>
 
1089
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> TRUE on success.
 
1090
 
 
1091
</simpara></listitem></varlistentry>
 
1092
</variablelist><para role="since">Since  GIMP 2.4
 
1093
</para></refsect2>
 
1094
<refsect2>
 
1095
<title><anchor id="gimp-heal-default" role="function" condition="since:GIMP 2.4"/>gimp_heal_default ()</title>
 
1096
<indexterm role="GIMP 2.4"><primary>gimp_heal_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_heal_default                   (<link linkend="gint32">gint32</link> drawable_ID,
 
1097
                                                         <link linkend="gint">gint</link> num_strokes,
 
1098
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
1099
<para>
 
1100
Heal from the source to the dest drawable using the current brush
 
1101
</para>
 
1102
<para>
 
1103
This tool heals from the source drawable starting at the specified
 
1104
source coordinates to the dest drawable. This function performs
 
1105
exactly the same as the <link linkend="gimp-heal"><function>gimp_heal()</function></link> function except that the tools
 
1106
arguments are obtained from the healing option dialog. It this
 
1107
dialog has not been activated then the dialogs default values will
 
1108
be used.</para>
 
1109
<para>
 
1110
 
 
1111
</para><variablelist role="params">
 
1112
<varlistentry><term><parameter>drawable_ID</parameter>&nbsp;:</term>
 
1113
<listitem><simpara> The affected drawable.
 
1114
</simpara></listitem></varlistentry>
 
1115
<varlistentry><term><parameter>num_strokes</parameter>&nbsp;:</term>
 
1116
<listitem><simpara> Number of stroke control points (count each coordinate as 2 points).
 
1117
</simpara></listitem></varlistentry>
 
1118
<varlistentry><term><parameter>strokes</parameter>&nbsp;:</term>
 
1119
<listitem><simpara> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
 
1120
</simpara></listitem></varlistentry>
 
1121
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> TRUE on success.
 
1122
 
 
1123
</simpara></listitem></varlistentry>
 
1124
</variablelist><para role="since">Since  GIMP 2.4
 
1125
</para></refsect2>
 
1126
<refsect2>
776
1127
<title><anchor id="gimp-paintbrush" role="function"/>gimp_paintbrush ()</title>
777
 
<indexterm><primary>gimp_paintbrush</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_paintbrush                 (<link linkend="gint32">gint32</link> drawable_ID,
778
 
                                             <link linkend="gdouble">gdouble</link> fade_out,
779
 
                                             <link linkend="gint">gint</link> num_strokes,
780
 
                                             const <link linkend="gdouble">gdouble</link> *strokes,
781
 
                                             <link linkend="GimpPaintApplicationMode">GimpPaintApplicationMode</link> method,
782
 
                                             <link linkend="gdouble">gdouble</link> gradient_length);</programlisting>
 
1128
<indexterm><primary>gimp_paintbrush</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_paintbrush                     (<link linkend="gint32">gint32</link> drawable_ID,
 
1129
                                                         <link linkend="gdouble">gdouble</link> fade_out,
 
1130
                                                         <link linkend="gint">gint</link> num_strokes,
 
1131
                                                         const <link linkend="gdouble">gdouble</link> *strokes,
 
1132
                                                         <link linkend="GimpPaintApplicationMode">GimpPaintApplicationMode</link> method,
 
1133
                                                         <link linkend="gdouble">gdouble</link> gradient_length);</programlisting>
783
1134
<para>
784
1135
Paint in the current brush with optional fade out parameter and pull
785
1136
colors from a gradient.
788
1139
This tool is the standard paintbrush. It draws linearly interpolated
789
1140
lines through the specified stroke coordinates. It operates on the
790
1141
specified drawable in the foreground color with the active brush.
791
 
The \"fade_out\" parameter is measured in pixels and allows the
792
 
brush stroke to linearly fall off. The pressure is set to the
793
 
maximum at the beginning of the stroke. As the distance of the
794
 
stroke nears the fade_out value, the pressure will approach zero.
795
 
The gradient_length is the distance to spread the gradient over. It
796
 
is measured in pixels. If the gradient_length is 0, no gradient is
797
 
used.</para>
 
1142
The 'fade-out' parameter is measured in pixels and allows the brush
 
1143
stroke to linearly fall off. The pressure is set to the maximum at
 
1144
the beginning of the stroke. As the distance of the stroke nears the
 
1145
fade-out value, the pressure will approach zero. The gradient-length
 
1146
is the distance to spread the gradient over. It is measured in
 
1147
pixels. If the gradient-length is 0, no gradient is used.</para>
798
1148
<para>
799
1149
 
800
1150
</para><variablelist role="params">
811
1161
<listitem><simpara> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
812
1162
</simpara></listitem></varlistentry>
813
1163
<varlistentry><term><parameter>method</parameter>&nbsp;:</term>
814
 
<listitem><simpara> %<link linkend="desc"><literal>desc</literal></link>%%.
 
1164
<listitem><simpara> The paint method to use.
815
1165
</simpara></listitem></varlistentry>
816
1166
<varlistentry><term><parameter>gradient_length</parameter>&nbsp;:</term>
817
1167
<listitem><simpara> Length of gradient to draw.
821
1171
</variablelist></refsect2>
822
1172
<refsect2>
823
1173
<title><anchor id="gimp-paintbrush-default" role="function"/>gimp_paintbrush_default ()</title>
824
 
<indexterm><primary>gimp_paintbrush_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_paintbrush_default         (<link linkend="gint32">gint32</link> drawable_ID,
825
 
                                             <link linkend="gint">gint</link> num_strokes,
826
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
1174
<indexterm><primary>gimp_paintbrush_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_paintbrush_default             (<link linkend="gint32">gint32</link> drawable_ID,
 
1175
                                                         <link linkend="gint">gint</link> num_strokes,
 
1176
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
827
1177
<para>
828
1178
Paint in the current brush. The fade out parameter and pull colors
829
1179
from a gradient parameter are set from the paintbrush options
834
1184
This tool is similar to the standard paintbrush. It draws linearly
835
1185
interpolated lines through the specified stroke coordinates. It
836
1186
operates on the specified drawable in the foreground color with the
837
 
active brush. The \"fade_out\" parameter is measured in pixels and
 
1187
active brush. The 'fade-out' parameter is measured in pixels and
838
1188
allows the brush stroke to linearly fall off (value obtained from
839
1189
the option dialog). The pressure is set to the maximum at the
840
1190
beginning of the stroke. As the distance of the stroke nears the
841
 
fade_out value, the pressure will approach zero. The gradient_length
 
1191
fade-out value, the pressure will approach zero. The gradient-length
842
1192
(value obtained from the option dialog) is the distance to spread
843
 
the gradient over. It is measured in pixels. If the gradient_length
 
1193
the gradient over. It is measured in pixels. If the gradient-length
844
1194
is 0, no gradient is used.</para>
845
1195
<para>
846
1196
 
859
1209
</variablelist></refsect2>
860
1210
<refsect2>
861
1211
<title><anchor id="gimp-pencil" role="function"/>gimp_pencil ()</title>
862
 
<indexterm><primary>gimp_pencil</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_pencil                     (<link linkend="gint32">gint32</link> drawable_ID,
863
 
                                             <link linkend="gint">gint</link> num_strokes,
864
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
1212
<indexterm><primary>gimp_pencil</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_pencil                         (<link linkend="gint32">gint32</link> drawable_ID,
 
1213
                                                         <link linkend="gint">gint</link> num_strokes,
 
1214
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
865
1215
<para>
866
1216
Paint in the current brush without sub-pixel sampling.
867
1217
</para>
889
1239
</variablelist></refsect2>
890
1240
<refsect2>
891
1241
<title><anchor id="gimp-perspective" role="function" condition="deprecated:"/>gimp_perspective ()</title>
892
 
<indexterm role="deprecated"><primary>gimp_perspective</primary></indexterm><programlisting><link linkend="gint32">gint32</link>      gimp_perspective                (<link linkend="gint32">gint32</link> drawable_ID,
893
 
                                             <link linkend="gboolean">gboolean</link> interpolation,
894
 
                                             <link linkend="gdouble">gdouble</link> x0,
895
 
                                             <link linkend="gdouble">gdouble</link> y0,
896
 
                                             <link linkend="gdouble">gdouble</link> x1,
897
 
                                             <link linkend="gdouble">gdouble</link> y1,
898
 
                                             <link linkend="gdouble">gdouble</link> x2,
899
 
                                             <link linkend="gdouble">gdouble</link> y2,
900
 
                                             <link linkend="gdouble">gdouble</link> x3,
901
 
                                             <link linkend="gdouble">gdouble</link> y3);</programlisting>
 
1242
<indexterm role="deprecated"><primary>gimp_perspective</primary></indexterm><programlisting><link linkend="gint32">gint32</link>              gimp_perspective                    (<link linkend="gint32">gint32</link> drawable_ID,
 
1243
                                                         <link linkend="gboolean">gboolean</link> interpolation,
 
1244
                                                         <link linkend="gdouble">gdouble</link> x0,
 
1245
                                                         <link linkend="gdouble">gdouble</link> y0,
 
1246
                                                         <link linkend="gdouble">gdouble</link> x1,
 
1247
                                                         <link linkend="gdouble">gdouble</link> y1,
 
1248
                                                         <link linkend="gdouble">gdouble</link> x2,
 
1249
                                                         <link linkend="gdouble">gdouble</link> y2,
 
1250
                                                         <link linkend="gdouble">gdouble</link> x3,
 
1251
                                                         <link linkend="gdouble">gdouble</link> y3);</programlisting>
902
1252
<warning><para><literal>gimp_perspective</literal> is deprecated and should not be used in newly-written code.</para></warning>
903
1253
<para>
904
1254
This procedure is deprecated! Use
941
1291
</variablelist></refsect2>
942
1292
<refsect2>
943
1293
<title><anchor id="gimp-rect-select" role="function"/>gimp_rect_select ()</title>
944
 
<indexterm><primary>gimp_rect_select</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_rect_select                (<link linkend="gint32">gint32</link> image_ID,
945
 
                                             <link linkend="gdouble">gdouble</link> x,
946
 
                                             <link linkend="gdouble">gdouble</link> y,
947
 
                                             <link linkend="gdouble">gdouble</link> width,
948
 
                                             <link linkend="gdouble">gdouble</link> height,
949
 
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
950
 
                                             <link linkend="gboolean">gboolean</link> feather,
951
 
                                             <link linkend="gdouble">gdouble</link> feather_radius);</programlisting>
 
1294
<indexterm><primary>gimp_rect_select</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_rect_select                    (<link linkend="gint32">gint32</link> image_ID,
 
1295
                                                         <link linkend="gdouble">gdouble</link> x,
 
1296
                                                         <link linkend="gdouble">gdouble</link> y,
 
1297
                                                         <link linkend="gdouble">gdouble</link> width,
 
1298
                                                         <link linkend="gdouble">gdouble</link> height,
 
1299
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
1300
                                                         <link linkend="gboolean">gboolean</link> feather,
 
1301
                                                         <link linkend="gdouble">gdouble</link> feather_radius);</programlisting>
952
1302
<para>
953
1303
Create a rectangular selection over the specified image;
954
1304
</para>
990
1340
</simpara></listitem></varlistentry>
991
1341
</variablelist></refsect2>
992
1342
<refsect2>
 
1343
<title><anchor id="gimp-round-rect-select" role="function" condition="since:GIMP 2.4"/>gimp_round_rect_select ()</title>
 
1344
<indexterm role="GIMP 2.4"><primary>gimp_round_rect_select</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_round_rect_select              (<link linkend="gint32">gint32</link> image_ID,
 
1345
                                                         <link linkend="gdouble">gdouble</link> x,
 
1346
                                                         <link linkend="gdouble">gdouble</link> y,
 
1347
                                                         <link linkend="gdouble">gdouble</link> width,
 
1348
                                                         <link linkend="gdouble">gdouble</link> height,
 
1349
                                                         <link linkend="gdouble">gdouble</link> corner_radius_x,
 
1350
                                                         <link linkend="gdouble">gdouble</link> corner_radius_y,
 
1351
                                                         <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
 
1352
                                                         <link linkend="gboolean">gboolean</link> antialias,
 
1353
                                                         <link linkend="gboolean">gboolean</link> feather,
 
1354
                                                         <link linkend="gdouble">gdouble</link> feather_radius_x,
 
1355
                                                         <link linkend="gdouble">gdouble</link> feather_radius_y);</programlisting>
 
1356
<para>
 
1357
Create a rectangular selection with round corners over the specified
 
1358
image;
 
1359
</para>
 
1360
<para>
 
1361
This tool creates a rectangular selection with round corners over
 
1362
the specified image. The rectangular region can be either added to,
 
1363
subtracted from, or replace the contents of the previous selection
 
1364
mask. If the feather option is enabled, the resulting selection is
 
1365
blurred before combining. The blur is a gaussian blur with the
 
1366
specified feather radius.</para>
 
1367
<para>
 
1368
 
 
1369
</para><variablelist role="params">
 
1370
<varlistentry><term><parameter>image_ID</parameter>&nbsp;:</term>
 
1371
<listitem><simpara> The image.
 
1372
</simpara></listitem></varlistentry>
 
1373
<varlistentry><term><parameter>x</parameter>&nbsp;:</term>
 
1374
<listitem><simpara> x coordinate of upper-left corner of rectangle.
 
1375
</simpara></listitem></varlistentry>
 
1376
<varlistentry><term><parameter>y</parameter>&nbsp;:</term>
 
1377
<listitem><simpara> y coordinate of upper-left corner of rectangle.
 
1378
</simpara></listitem></varlistentry>
 
1379
<varlistentry><term><parameter>width</parameter>&nbsp;:</term>
 
1380
<listitem><simpara> The width of the rectangle.
 
1381
</simpara></listitem></varlistentry>
 
1382
<varlistentry><term><parameter>height</parameter>&nbsp;:</term>
 
1383
<listitem><simpara> The height of the rectangle.
 
1384
</simpara></listitem></varlistentry>
 
1385
<varlistentry><term><parameter>corner_radius_x</parameter>&nbsp;:</term>
 
1386
<listitem><simpara> The corner radius in X direction.
 
1387
</simpara></listitem></varlistentry>
 
1388
<varlistentry><term><parameter>corner_radius_y</parameter>&nbsp;:</term>
 
1389
<listitem><simpara> The corner radius in Y direction.
 
1390
</simpara></listitem></varlistentry>
 
1391
<varlistentry><term><parameter>operation</parameter>&nbsp;:</term>
 
1392
<listitem><simpara> The selection operation.
 
1393
</simpara></listitem></varlistentry>
 
1394
<varlistentry><term><parameter>antialias</parameter>&nbsp;:</term>
 
1395
<listitem><simpara> Antialiasing.
 
1396
</simpara></listitem></varlistentry>
 
1397
<varlistentry><term><parameter>feather</parameter>&nbsp;:</term>
 
1398
<listitem><simpara> Feather option for selections.
 
1399
</simpara></listitem></varlistentry>
 
1400
<varlistentry><term><parameter>feather_radius_x</parameter>&nbsp;:</term>
 
1401
<listitem><simpara> Radius for feather operation in X direction.
 
1402
</simpara></listitem></varlistentry>
 
1403
<varlistentry><term><parameter>feather_radius_y</parameter>&nbsp;:</term>
 
1404
<listitem><simpara> Radius for feather operation in Y direction.
 
1405
</simpara></listitem></varlistentry>
 
1406
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> TRUE on success.
 
1407
 
 
1408
</simpara></listitem></varlistentry>
 
1409
</variablelist><para role="since">Since  GIMP 2.4
 
1410
</para></refsect2>
 
1411
<refsect2>
993
1412
<title><anchor id="gimp-rotate" role="function" condition="deprecated:"/>gimp_rotate ()</title>
994
 
<indexterm role="deprecated"><primary>gimp_rotate</primary></indexterm><programlisting><link linkend="gint32">gint32</link>      gimp_rotate                     (<link linkend="gint32">gint32</link> drawable_ID,
995
 
                                             <link linkend="gboolean">gboolean</link> interpolation,
996
 
                                             <link linkend="gdouble">gdouble</link> angle);</programlisting>
 
1413
<indexterm role="deprecated"><primary>gimp_rotate</primary></indexterm><programlisting><link linkend="gint32">gint32</link>              gimp_rotate                         (<link linkend="gint32">gint32</link> drawable_ID,
 
1414
                                                         <link linkend="gboolean">gboolean</link> interpolation,
 
1415
                                                         <link linkend="gdouble">gdouble</link> angle);</programlisting>
997
1416
<warning><para><literal>gimp_rotate</literal> is deprecated and should not be used in newly-written code.</para></warning>
998
1417
<para>
999
1418
This procedure is deprecated! Use
1015
1434
</variablelist></refsect2>
1016
1435
<refsect2>
1017
1436
<title><anchor id="gimp-scale" role="function" condition="deprecated:"/>gimp_scale ()</title>
1018
 
<indexterm role="deprecated"><primary>gimp_scale</primary></indexterm><programlisting><link linkend="gint32">gint32</link>      gimp_scale                      (<link linkend="gint32">gint32</link> drawable_ID,
1019
 
                                             <link linkend="gboolean">gboolean</link> interpolation,
1020
 
                                             <link linkend="gdouble">gdouble</link> x0,
1021
 
                                             <link linkend="gdouble">gdouble</link> y0,
1022
 
                                             <link linkend="gdouble">gdouble</link> x1,
1023
 
                                             <link linkend="gdouble">gdouble</link> y1);</programlisting>
 
1437
<indexterm role="deprecated"><primary>gimp_scale</primary></indexterm><programlisting><link linkend="gint32">gint32</link>              gimp_scale                          (<link linkend="gint32">gint32</link> drawable_ID,
 
1438
                                                         <link linkend="gboolean">gboolean</link> interpolation,
 
1439
                                                         <link linkend="gdouble">gdouble</link> x0,
 
1440
                                                         <link linkend="gdouble">gdouble</link> y0,
 
1441
                                                         <link linkend="gdouble">gdouble</link> x1,
 
1442
                                                         <link linkend="gdouble">gdouble</link> y1);</programlisting>
1024
1443
<warning><para><literal>gimp_scale</literal> is deprecated and should not be used in newly-written code.</para></warning>
1025
1444
<para>
1026
1445
This procedure is deprecated! Use
1035
1454
<listitem><simpara> Whether to use interpolation.
1036
1455
</simpara></listitem></varlistentry>
1037
1456
<varlistentry><term><parameter>x0</parameter>&nbsp;:</term>
1038
 
<listitem><simpara> The new x coordinate of upper-left corner of newly scaled region.
 
1457
<listitem><simpara> The new x coordinate of the upper-left corner of the scaled region.
1039
1458
</simpara></listitem></varlistentry>
1040
1459
<varlistentry><term><parameter>y0</parameter>&nbsp;:</term>
1041
 
<listitem><simpara> The new y coordinate of upper-left corner of newly scaled region.
 
1460
<listitem><simpara> The new y coordinate of the upper-left corner of the scaled region.
1042
1461
</simpara></listitem></varlistentry>
1043
1462
<varlistentry><term><parameter>x1</parameter>&nbsp;:</term>
1044
 
<listitem><simpara> The new x coordinate of lower-right corner of newly scaled region.
 
1463
<listitem><simpara> The new x coordinate of the lower-right corner of the scaled region.
1045
1464
</simpara></listitem></varlistentry>
1046
1465
<varlistentry><term><parameter>y1</parameter>&nbsp;:</term>
1047
 
<listitem><simpara> The new y coordinate of lower-right corner of newly scaled region.
 
1466
<listitem><simpara> The new y coordinate of the lower-right corner of the scaled region.
1048
1467
</simpara></listitem></varlistentry>
1049
1468
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> The scaled drawable.
1050
1469
</simpara></listitem></varlistentry>
1051
1470
</variablelist></refsect2>
1052
1471
<refsect2>
1053
1472
<title><anchor id="gimp-shear" role="function" condition="deprecated:"/>gimp_shear ()</title>
1054
 
<indexterm role="deprecated"><primary>gimp_shear</primary></indexterm><programlisting><link linkend="gint32">gint32</link>      gimp_shear                      (<link linkend="gint32">gint32</link> drawable_ID,
1055
 
                                             <link linkend="gboolean">gboolean</link> interpolation,
1056
 
                                             <link linkend="GimpOrientationType">GimpOrientationType</link> shear_type,
1057
 
                                             <link linkend="gdouble">gdouble</link> magnitude);</programlisting>
 
1473
<indexterm role="deprecated"><primary>gimp_shear</primary></indexterm><programlisting><link linkend="gint32">gint32</link>              gimp_shear                          (<link linkend="gint32">gint32</link> drawable_ID,
 
1474
                                                         <link linkend="gboolean">gboolean</link> interpolation,
 
1475
                                                         <link linkend="GimpOrientationType">GimpOrientationType</link> shear_type,
 
1476
                                                         <link linkend="gdouble">gdouble</link> magnitude);</programlisting>
1058
1477
<warning><para><literal>gimp_shear</literal> is deprecated and should not be used in newly-written code.</para></warning>
1059
1478
<para>
1060
1479
This procedure is deprecated! Use
1079
1498
</variablelist></refsect2>
1080
1499
<refsect2>
1081
1500
<title><anchor id="gimp-smudge" role="function"/>gimp_smudge ()</title>
1082
 
<indexterm><primary>gimp_smudge</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_smudge                     (<link linkend="gint32">gint32</link> drawable_ID,
1083
 
                                             <link linkend="gdouble">gdouble</link> pressure,
1084
 
                                             <link linkend="gint">gint</link> num_strokes,
1085
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
1501
<indexterm><primary>gimp_smudge</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_smudge                         (<link linkend="gint32">gint32</link> drawable_ID,
 
1502
                                                         <link linkend="gdouble">gdouble</link> pressure,
 
1503
                                                         <link linkend="gint">gint</link> num_strokes,
 
1504
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
1086
1505
<para>
1087
1506
Smudge image with varying pressure.
1088
1507
</para>
1110
1529
</variablelist></refsect2>
1111
1530
<refsect2>
1112
1531
<title><anchor id="gimp-smudge-default" role="function"/>gimp_smudge_default ()</title>
1113
 
<indexterm><primary>gimp_smudge_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gimp_smudge_default             (<link linkend="gint32">gint32</link> drawable_ID,
1114
 
                                             <link linkend="gint">gint</link> num_strokes,
1115
 
                                             const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
 
1532
<indexterm><primary>gimp_smudge_default</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gimp_smudge_default                 (<link linkend="gint32">gint32</link> drawable_ID,
 
1533
                                                         <link linkend="gint">gint</link> num_strokes,
 
1534
                                                         const <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
1116
1535
<para>
1117
1536
Smudge image with varying pressure.
1118
1537
</para>
1119
1538
<para>
1120
1539
This tool simulates a smudge using the current brush. It behaves
1121
 
exactly the same as gimp_smudge except that the pressure value is
 
1540
exactly the same as <link linkend="gimp-smudge"><function>gimp_smudge()</function></link> except that the pressure value is
1122
1541
taken from the smudge tool options or the options default if the
1123
1542
tools option dialog has not been activated.</para>
1124
1543
<para>
1138
1557
</variablelist></refsect2>
1139
1558
<refsect2>
1140
1559
<title><anchor id="gimp-transform-2d" role="function" condition="deprecated:"/>gimp_transform_2d ()</title>
1141
 
<indexterm role="deprecated"><primary>gimp_transform_2d</primary></indexterm><programlisting><link linkend="gint32">gint32</link>      gimp_transform_2d               (<link linkend="gint32">gint32</link> drawable_ID,
1142
 
                                             <link linkend="gboolean">gboolean</link> interpolation,
1143
 
                                             <link linkend="gdouble">gdouble</link> source_x,
1144
 
                                             <link linkend="gdouble">gdouble</link> source_y,
1145
 
                                             <link linkend="gdouble">gdouble</link> scale_x,
1146
 
                                             <link linkend="gdouble">gdouble</link> scale_y,
1147
 
                                             <link linkend="gdouble">gdouble</link> angle,
1148
 
                                             <link linkend="gdouble">gdouble</link> dest_x,
1149
 
                                             <link linkend="gdouble">gdouble</link> dest_y);</programlisting>
 
1560
<indexterm role="deprecated"><primary>gimp_transform_2d</primary></indexterm><programlisting><link linkend="gint32">gint32</link>              gimp_transform_2d                   (<link linkend="gint32">gint32</link> drawable_ID,
 
1561
                                                         <link linkend="gboolean">gboolean</link> interpolation,
 
1562
                                                         <link linkend="gdouble">gdouble</link> source_x,
 
1563
                                                         <link linkend="gdouble">gdouble</link> source_y,
 
1564
                                                         <link linkend="gdouble">gdouble</link> scale_x,
 
1565
                                                         <link linkend="gdouble">gdouble</link> scale_y,
 
1566
                                                         <link linkend="gdouble">gdouble</link> angle,
 
1567
                                                         <link linkend="gdouble">gdouble</link> dest_x,
 
1568
                                                         <link linkend="gdouble">gdouble</link> dest_y);</programlisting>
1150
1569
<warning><para><literal>gimp_transform_2d</literal> is deprecated and should not be used in newly-written code.</para></warning>
1151
1570
<para>
1152
1571
This procedure is deprecated! Use