gimp_airbrush ()

gboolean    gimp_airbrush                   (gint32 drawable_ID,
                                             gdouble pressure,
                                             gint num_strokes,
                                             const gdouble *strokes);

Paint in the current brush with varying pressure. Paint application is time-dependent.

This tool simulates the use of an airbrush. Paint pressure represents the relative intensity of the paint application. High pressure results in a thicker layer of paint while low pressure results in a thinner layer.

gimp_airbrush_default ()

gboolean    gimp_airbrush_default           (gint32 drawable_ID,
                                             gint num_strokes,
                                             const gdouble *strokes);

Paint in the current brush with varying pressure. Paint application is time-dependent.

This tool simulates the use of an airbrush. It is similar to gimp_airbrush except that the pressure is derived from the airbrush tools options box. It the option has not been set the default for the option will be used.

gimp_by_color_select ()

gboolean    gimp_by_color_select            (gint32 drawable_ID,
                                             const GimpRGB *color,
                                             gint threshold,
                                             GimpChannelOps operation,
                                             gboolean antialias,
                                             gboolean feather,
                                             gdouble feather_radius,
                                             gboolean sample_merged);

Create a selection by selecting all pixels (in the specified drawable) with the same (or similar) color to that specified.

This tool creates a selection over the specified image. A by-color selection is determined by the supplied color under the constraints of the specified threshold. Essentially, all pixels (in the drawable) that have color sufficiently close to the specified color (as determined by the threshold value) are included in the selection. The antialiasing parameter allows the final selection mask to contain intermediate values based on close misses to the threshold bar. Feathering can be enabled optionally and is controlled with the \"feather_radius\" parameter. If the sample_merged parameter is non-zero, the data of the composite image will be used instead of that for the specified drawable. This is equivalent to sampling for colors after merging all visible layers. In the case of a merged sampling, the supplied drawable is ignored.

gimp_clone ()

gboolean    gimp_clone                      (gint32 drawable_ID,
                                             gint32 src_drawable_ID,
                                             GimpCloneType clone_type,
                                             gdouble src_x,
                                             gdouble src_y,
                                             gint num_strokes,
                                             const gdouble *strokes);

Clone from the source to the dest drawable using the current brush

This tool clones (copies) from the source drawable starting at the specified source coordinates to the dest drawable. If the \"clone_type\" argument is set to PATTERN-CLONE, then the current pattern is used as the source and the \"src_drawable\" argument is ignored. Pattern cloning assumes a tileable pattern and mods the sum of the src coordinates and subsequent stroke offsets with the width and height of the pattern. For image cloning, if the sum of the src coordinates and subsequent stroke offsets exceeds the extents of the src drawable, then no paint is transferred. The clone tool is capable of transforming between any image types including RGB->Indexed--although converting from any type to indexed is significantly slower.

gimp_clone_default ()

gboolean    gimp_clone_default              (gint32 drawable_ID,
                                             gint num_strokes,
                                             const gdouble *strokes);

Clone from the source to the dest drawable using the current brush

This tool clones (copies) from the source drawable starting at the specified source coordinates to the dest drawable. This function performs exactly the same as the gimp_clone function except that the tools arguments are obtained from the clones option dialog. It this dialog has not been activated then the dialogs default values will be used.

gimp_convolve ()

gboolean    gimp_convolve                   (gint32 drawable_ID,
                                             gdouble pressure,
                                             GimpConvolveType convolve_type,
                                             gint num_strokes,
                                             const gdouble *strokes);

Convolve (Blur, Sharpen) using the current brush.

This tool convolves the specified drawable with either a sharpening or blurring kernel. The pressure parameter controls the magnitude of the operation. Like the paintbrush, this tool linearly interpolates between the specified stroke coordinates.

gimp_convolve_default ()

gboolean    gimp_convolve_default           (gint32 drawable_ID,
                                             gint num_strokes,
                                             const gdouble *strokes);

Convolve (Blur, Sharpen) using the current brush.

This tool convolves the specified drawable with either a sharpening or blurring kernel. This function performs exactly the same as the gimp_convolve function except that the tools arguments are obtained from the convolve option dialog. It this dialog has not been activated then the dialogs default values will be used.

gimp_dodgeburn ()

gboolean    gimp_dodgeburn                  (gint32 drawable_ID,
                                             gdouble exposure,
                                             GimpDodgeBurnType dodgeburn_type,
                                             GimpTransferMode dodgeburn_mode,
                                             gint num_strokes,
                                             const gdouble *strokes);

Dodgeburn image with varying exposure.

Dodgeburn. More details here later.

gimp_dodgeburn_default ()

gboolean    gimp_dodgeburn_default          (gint32 drawable_ID,
                                             gint num_strokes,
                                             const gdouble *strokes);

Dodgeburn image with varying exposure. This is the same as the gimp_dodgeburn function except that the exposure, type and mode are taken from the tools option dialog. If the dialog has not been activated then the defaults as used by the dialog will be used.

Dodgeburn. More details here later.

gimp_ellipse_select ()

gboolean    gimp_ellipse_select             (gint32 image_ID,
                                             gdouble x,
                                             gdouble y,
                                             gdouble width,
                                             gdouble height,
                                             GimpChannelOps operation,
                                             gboolean antialias,
                                             gboolean feather,
                                             gdouble feather_radius);

Create an elliptical selection over the specified image.

This tool creates an elliptical selection over the specified image. The elliptical region can be either added to, subtracted from, or replace the contents of the previous selection mask. If antialiasing is turned on, the edges of the elliptical region will contain intermediate values which give the appearance of a sharper, less pixelized edge. This should be set as TRUE most of the time. If the feather option is enabled, the resulting selection is blurred before combining. The blur is a gaussian blur with the specified feather radius.

gimp_eraser ()

gboolean    gimp_eraser                     (gint32 drawable_ID,
                                             gint num_strokes,
                                             const gdouble *strokes,
                                             GimpBrushApplicationMode hardness,
                                             GimpPaintApplicationMode method);

Erase using the current brush.

This tool erases using the current brush mask. If the specified drawable contains an alpha channel, then the erased pixels will become transparent. Otherwise, the eraser tool replaces the contents of the drawable with the background color. Like paintbrush, this tool linearly interpolates between the specified stroke coordinates.

gimp_eraser_default ()

gboolean    gimp_eraser_default             (gint32 drawable_ID,
                                             gint num_strokes,
                                             const gdouble *strokes);

Erase using the current brush.

This tool erases using the current brush mask. This function performs exactly the same as the gimp_eraser function except that the tools arguments are obtained from the eraser option dialog. It this dialog has not been activated then the dialogs default values will be used.

gimp_flip ()

gint32      gimp_flip                       (gint32 drawable_ID,
                                             GimpOrientationType flip_type);

This procedure is deprecated! Use gimp_drawable_transform_flip_simple() instead.

gimp_free_select ()

gboolean    gimp_free_select                (gint32 image_ID,
                                             gint num_segs,
                                             const gdouble *segs,
                                             GimpChannelOps operation,
                                             gboolean antialias,
                                             gboolean feather,
                                             gdouble feather_radius);

Create a polygonal selection over the specified image.

This tool creates a polygonal selection over the specified image. The polygonal region can be either added to, subtracted from, or replace the contents of the previous selection mask. The polygon is specified through an array of floating point numbers and its length. The length of array must be 2n, where n is the number of points. Each point is defined by 2 floating point values which correspond to the x and y coordinates. If the final point does not connect to the starting point, a connecting segment is automatically added. If the feather option is enabled, the resulting selection is blurred before combining. The blur is a gaussian blur with the specified feather radius.

gimp_fuzzy_select ()

gboolean    gimp_fuzzy_select               (gint32 drawable_ID,
                                             gdouble x,
                                             gdouble y,
                                             gint threshold,
                                             GimpChannelOps operation,
                                             gboolean antialias,
                                             gboolean feather,
                                             gdouble feather_radius,
                                             gboolean sample_merged);

Create a fuzzy selection starting at the specified coordinates on the specified drawable.

This tool creates a fuzzy selection over the specified image. A fuzzy selection is determined by a seed fill under the constraints of the specified threshold. Essentially, the color at the specified coordinates (in the drawable) is measured and the selection expands outwards from that point to any adjacent pixels which are not significantly different (as determined by the threshold value). This process continues until no more expansion is possible. The antialiasing parameter allows the final selection mask to contain intermediate values based on close misses to the threshold bar at pixels along the seed fill boundary. Feathering can be enabled optionally and is controlled with the \"feather_radius\" paramter. If the sample_merged parameter is non-zero, the data of the composite image will be used instead of that for the specified drawable. This is equivalent to sampling for colors after merging all visible layers. In the case of a merged sampling, the supplied drawable is ignored. If the sample is merged, the specified coordinates are relative to the image origin; otherwise, they are relative to the drawable's origin.

gimp_paintbrush ()

gboolean    gimp_paintbrush                 (gint32 drawable_ID,
                                             gdouble fade_out,
                                             gint num_strokes,
                                             const gdouble *strokes,
                                             GimpPaintApplicationMode method,
                                             gdouble gradient_length);

Paint in the current brush with optional fade out parameter and pull colors from a gradient.

This tool is the standard paintbrush. It draws linearly interpolated lines through the specified stroke coordinates. It operates on the specified drawable in the foreground color with the active brush. The \"fade_out\" parameter is measured in pixels and allows the brush stroke to linearly fall off. The pressure is set to the maximum at the beginning of the stroke. As the distance of the stroke nears the fade_out value, the pressure will approach zero. The gradient_length is the distance to spread the gradient over. It is measured in pixels. If the gradient_length is 0, no gradient is used.

gimp_paintbrush_default ()

gboolean    gimp_paintbrush_default         (gint32 drawable_ID,
                                             gint num_strokes,
                                             const gdouble *strokes);

Paint in the current brush. The fade out parameter and pull colors from a gradient parameter are set from the paintbrush options dialog. If this dialog has not been activated then the dialog defaults will be used.

This tool is similar to the standard paintbrush. It draws linearly interpolated lines through the specified stroke coordinates. It operates on the specified drawable in the foreground color with the active brush. The \"fade_out\" parameter is measured in pixels and allows the brush stroke to linearly fall off (value obtained from the option dialog). The pressure is set to the maximum at the beginning of the stroke. As the distance of the stroke nears the fade_out value, the pressure will approach zero. The gradient_length (value obtained from the option dialog) is the distance to spread the gradient over. It is measured in pixels. If the gradient_length is 0, no gradient is used.

gimp_pencil ()

gboolean    gimp_pencil                     (gint32 drawable_ID,
                                             gint num_strokes,
                                             const gdouble *strokes);

Paint in the current brush without sub-pixel sampling.

This tool is the standard pencil. It draws linearly interpolated lines through the specified stroke coordinates. It operates on the specified drawable in the foreground color with the active brush. The brush mask is treated as though it contains only black and white values. Any value below half is treated as black; any above half, as white.

gimp_perspective ()

gint32      gimp_perspective                (gint32 drawable_ID,
                                             gboolean interpolation,
                                             gdouble x0,
                                             gdouble y0,
                                             gdouble x1,
                                             gdouble y1,
                                             gdouble x2,
                                             gdouble y2,
                                             gdouble x3,
                                             gdouble y3);

This procedure is deprecated! Use gimp_drawable_transform_perspective_default() instead.

gimp_rect_select ()

gboolean    gimp_rect_select                (gint32 image_ID,
                                             gdouble x,
                                             gdouble y,
                                             gdouble width,
                                             gdouble height,
                                             GimpChannelOps operation,
                                             gboolean feather,
                                             gdouble feather_radius);

Create a rectangular selection over the specified image;

This tool creates a rectangular selection over the specified image. The rectangular region can be either added to, subtracted from, or replace the contents of the previous selection mask. If the feather option is enabled, the resulting selection is blurred before combining. The blur is a gaussian blur with the specified feather radius.

gimp_rotate ()

gint32      gimp_rotate                     (gint32 drawable_ID,
                                             gboolean interpolation,
                                             gdouble angle);

This procedure is deprecated! Use gimp_drawable_transform_rotate_default() instead.

gimp_scale ()

gint32      gimp_scale                      (gint32 drawable_ID,
                                             gboolean interpolation,
                                             gdouble x0,
                                             gdouble y0,
                                             gdouble x1,
                                             gdouble y1);

This procedure is deprecated! Use gimp_drawable_transform_scale_default() instead.

gimp_shear ()

gint32      gimp_shear                      (gint32 drawable_ID,
                                             gboolean interpolation,
                                             GimpOrientationType shear_type,
                                             gdouble magnitude);

This procedure is deprecated! Use gimp_drawable_transform_shear_default() instead.

gimp_smudge ()

gboolean    gimp_smudge                     (gint32 drawable_ID,
                                             gdouble pressure,
                                             gint num_strokes,
                                             const gdouble *strokes);

Smudge image with varying pressure.

This tool simulates a smudge using the current brush. High pressure results in a greater smudge of paint while low pressure results in a lesser smudge.

gimp_smudge_default ()

gboolean    gimp_smudge_default             (gint32 drawable_ID,
                                             gint num_strokes,
                                             const gdouble *strokes);

Smudge image with varying pressure.

This tool simulates a smudge using the current brush. It behaves exactly the same as gimp_smudge except that the pressure value is taken from the smudge tool options or the options default if the tools option dialog has not been activated.

gimp_transform_2d ()

gint32      gimp_transform_2d               (gint32 drawable_ID,
                                             gboolean interpolation,
                                             gdouble source_x,
                                             gdouble source_y,
                                             gdouble scale_x,
                                             gdouble scale_y,
                                             gdouble angle,
                                             gdouble dest_x,
                                             gdouble dest_y);

This procedure is deprecated! Use gimp_drawable_transform_2d_default() instead.