diff options
Diffstat (limited to '')
| -rw-r--r-- | libgimp/gimppainttools_pdb.c | 775 |
1 files changed, 775 insertions, 0 deletions
diff --git a/libgimp/gimppainttools_pdb.c b/libgimp/gimppainttools_pdb.c new file mode 100644 index 0000000..f03b43a --- /dev/null +++ b/libgimp/gimppainttools_pdb.c @@ -0,0 +1,775 @@ +/* LIBGIMP - The GIMP Library + * Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball + * + * gimppainttools_pdb.c + * + * This library is free software: you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 3 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library. If not, see + * <https://www.gnu.org/licenses/>. + */ + +/* NOTE: This file is auto-generated by pdbgen.pl */ + +#include "config.h" + +#include "gimp.h" + + +/** + * SECTION: gimppainttools + * @title: gimppainttools + * @short_description: Access to toolbox paint tools. + * + * Functions giving access to toolbox paint tools. + **/ + + +/** + * gimp_airbrush: + * @drawable_ID: The affected drawable. + * @pressure: The pressure of the airbrush strokes. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * 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. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_airbrush (gint32 drawable_ID, + gdouble pressure, + gint num_strokes, + const gdouble *strokes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-airbrush", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_FLOAT, pressure, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_airbrush_default: + * @drawable_ID: The affected drawable. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * 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. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_airbrush_default (gint32 drawable_ID, + gint num_strokes, + const gdouble *strokes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-airbrush-default", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_clone: + * @drawable_ID: The affected drawable. + * @src_drawable_ID: The source drawable. + * @clone_type: The type of clone. + * @src_x: The x coordinate in the source image. + * @src_y: The y coordinate in the source image. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * 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. + * + * Returns: TRUE on success. + **/ +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) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-clone", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_DRAWABLE, src_drawable_ID, + GIMP_PDB_INT32, clone_type, + GIMP_PDB_FLOAT, src_x, + GIMP_PDB_FLOAT, src_y, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_clone_default: + * @drawable_ID: The affected drawable. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * 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. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_clone_default (gint32 drawable_ID, + gint num_strokes, + const gdouble *strokes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-clone-default", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_convolve: + * @drawable_ID: The affected drawable. + * @pressure: The pressure. + * @convolve_type: Convolve type. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * 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. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_convolve (gint32 drawable_ID, + gdouble pressure, + GimpConvolveType convolve_type, + gint num_strokes, + const gdouble *strokes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-convolve", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_FLOAT, pressure, + GIMP_PDB_INT32, convolve_type, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_convolve_default: + * @drawable_ID: The affected drawable. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * 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. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_convolve_default (gint32 drawable_ID, + gint num_strokes, + const gdouble *strokes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-convolve-default", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_dodgeburn: + * @drawable_ID: The affected drawable. + * @exposure: The exposure of the strokes. + * @dodgeburn_type: The type either dodge or burn. + * @dodgeburn_mode: The mode. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * Dodgeburn image with varying exposure. + * + * Dodgeburn. More details here later. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_dodgeburn (gint32 drawable_ID, + gdouble exposure, + GimpDodgeBurnType dodgeburn_type, + GimpTransferMode dodgeburn_mode, + gint num_strokes, + const gdouble *strokes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-dodgeburn", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_FLOAT, exposure, + GIMP_PDB_INT32, dodgeburn_type, + GIMP_PDB_INT32, dodgeburn_mode, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_dodgeburn_default: + * @drawable_ID: The affected drawable. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * 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. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_dodgeburn_default (gint32 drawable_ID, + gint num_strokes, + const gdouble *strokes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-dodgeburn-default", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_eraser: + * @drawable_ID: The affected drawable. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * @hardness: How to apply the brush. + * @method: The paint method to use. + * + * 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. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_eraser (gint32 drawable_ID, + gint num_strokes, + const gdouble *strokes, + GimpBrushApplicationMode hardness, + GimpPaintApplicationMode method) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-eraser", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_INT32, hardness, + GIMP_PDB_INT32, method, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_eraser_default: + * @drawable_ID: The affected drawable. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * 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. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_eraser_default (gint32 drawable_ID, + gint num_strokes, + const gdouble *strokes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-eraser-default", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_heal: + * @drawable_ID: The affected drawable. + * @src_drawable_ID: The source drawable. + * @src_x: The x coordinate in the source image. + * @src_y: The y coordinate in the source image. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * Heal from the source to the dest drawable using the current brush + * + * This tool heals the source drawable starting at the specified source + * coordinates to the dest drawable. For image healing, if the sum of + * the src coordinates and subsequent stroke offsets exceeds the + * extents of the src drawable, then no paint is transferred. The + * healing tool is capable of transforming between any image types + * except RGB->Indexed. + * + * Returns: TRUE on success. + * + * Since: 2.4 + **/ +gboolean +gimp_heal (gint32 drawable_ID, + gint32 src_drawable_ID, + gdouble src_x, + gdouble src_y, + gint num_strokes, + const gdouble *strokes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-heal", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_DRAWABLE, src_drawable_ID, + GIMP_PDB_FLOAT, src_x, + GIMP_PDB_FLOAT, src_y, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_heal_default: + * @drawable_ID: The affected drawable. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * Heal from the source to the dest drawable using the current brush + * + * This tool heals from the source drawable starting at the specified + * source coordinates to the dest drawable. This function performs + * exactly the same as the gimp_heal() function except that the tools + * arguments are obtained from the healing option dialog. It this + * dialog has not been activated then the dialogs default values will + * be used. + * + * Returns: TRUE on success. + * + * Since: 2.4 + **/ +gboolean +gimp_heal_default (gint32 drawable_ID, + gint num_strokes, + const gdouble *strokes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-heal-default", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_paintbrush: + * @drawable_ID: The affected drawable. + * @fade_out: Fade out parameter. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * @method: The paint method to use. + * @gradient_length: Length of gradient to draw. + * + * 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. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_paintbrush (gint32 drawable_ID, + gdouble fade_out, + gint num_strokes, + const gdouble *strokes, + GimpPaintApplicationMode method, + gdouble gradient_length) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-paintbrush", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_FLOAT, fade_out, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_INT32, method, + GIMP_PDB_FLOAT, gradient_length, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_paintbrush_default: + * @drawable_ID: The affected drawable. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * 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. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_paintbrush_default (gint32 drawable_ID, + gint num_strokes, + const gdouble *strokes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-paintbrush-default", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_pencil: + * @drawable_ID: The affected drawable. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * 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. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_pencil (gint32 drawable_ID, + gint num_strokes, + const gdouble *strokes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-pencil", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_smudge: + * @drawable_ID: The affected drawable. + * @pressure: The pressure of the smudge strokes. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * 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. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_smudge (gint32 drawable_ID, + gdouble pressure, + gint num_strokes, + const gdouble *strokes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-smudge", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_FLOAT, pressure, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} + +/** + * gimp_smudge_default: + * @drawable_ID: The affected drawable. + * @num_strokes: Number of stroke control points (count each coordinate as 2 points). + * @strokes: Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }. + * + * 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. + * + * Returns: TRUE on success. + **/ +gboolean +gimp_smudge_default (gint32 drawable_ID, + gint num_strokes, + const gdouble *strokes) +{ + GimpParam *return_vals; + gint nreturn_vals; + gboolean success = TRUE; + + return_vals = gimp_run_procedure ("gimp-smudge-default", + &nreturn_vals, + GIMP_PDB_DRAWABLE, drawable_ID, + GIMP_PDB_INT32, num_strokes, + GIMP_PDB_FLOATARRAY, strokes, + GIMP_PDB_END); + + success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; + + gimp_destroy_params (return_vals, nreturn_vals); + + return success; +} |