/* LIBGIMP - The GIMP Library * Copyright (C) 1995-2000 Peter Mattis and Spencer Kimball * * gimptools_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 2 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, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ /* NOTE: This file is autogenerated by pdbgen.pl */ #include "gimp.h" /** * 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, 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, 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_blend: * @drawable_ID: The affected drawable. * @blend_mode: The type of blend. * @paint_mode: The paint application mode. * @gradient_type: The type of gradient. * @opacity: The opacity of the final blend. * @offset: Offset relates to the starting and ending coordinates specified for the blend. This parameter is mode dependent. * @repeat: Repeat mode. * @supersample: Do adaptive supersampling. * @max_depth: Maximum recursion levels for supersampling. * @threshold: Supersampling threshold. * @x1: The x coordinate of this blend's starting point. * @y1: The y coordinate of this blend's starting point. * @x2: The x coordinate of this blend's ending point. * @y2: The y coordinate of this blend's ending point. * * Blend between the starting and ending coordinates with the specified * blend mode and gradient type. * * This tool requires information on the paint application mode, the * blend mode, and the gradient type. It creates the specified variety * of blend using the starting and ending coordinates as defined for * each gradient type. * * Returns: TRUE on success. */ gboolean gimp_blend (gint32 drawable_ID, GimpBlendMode blend_mode, GimpLayerModeEffects paint_mode, GimpGradientType gradient_type, gdouble opacity, gdouble offset, GimpRepeatMode repeat, gboolean supersample, gint max_depth, gdouble threshold, gdouble x1, gdouble y1, gdouble x2, gdouble y2) { GimpParam *return_vals; gint nreturn_vals; gboolean success = TRUE; return_vals = gimp_run_procedure ("gimp_blend", &nreturn_vals, GIMP_PDB_DRAWABLE, drawable_ID, GIMP_PDB_INT32, blend_mode, GIMP_PDB_INT32, paint_mode, GIMP_PDB_INT32, gradient_type, GIMP_PDB_FLOAT, opacity, GIMP_PDB_FLOAT, offset, GIMP_PDB_INT32, repeat, GIMP_PDB_INT32, supersample, GIMP_PDB_INT32, max_depth, GIMP_PDB_FLOAT, threshold, GIMP_PDB_FLOAT, x1, GIMP_PDB_FLOAT, y1, GIMP_PDB_FLOAT, x2, GIMP_PDB_FLOAT, y2, GIMP_PDB_END); success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; gimp_destroy_params (return_vals, nreturn_vals); return success; } /** * gimp_bucket_fill: * @drawable_ID: The affected drawable. * @fill_mode: The type of fill. * @paint_mode: The paint application mode. * @opacity: The opacity of the final bucket fill. * @threshold: 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. * @sample_merged: Use the composite image, not the drawable. * @x: The x coordinate of this bucket fill's application. This parameter is only valid when there is no selection in the specified image. * @y: The y coordinate of this bucket fill's application. This parameter is only valid when there is no selection in the specified image. * * Fill the area specified either by the current selection if there is * one, or by a seed fill starting at the specified coordinates. * * This tool requires information on the paint application mode, and * the fill mode, which can either be in the foreground color, or in * the currently active pattern. If there is no selection, a seed fill * is executed at the specified coordinates and extends outward in * keeping with the threshold parameter. If there is a selection in the * target image, the threshold, sample merged, x, and y arguments are * unused. 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 merged sampling, the x,y * coordinates are relative to the image's origin; otherwise, they are * relative to the drawable's origin. * * Returns: TRUE on success. */ gboolean gimp_bucket_fill (gint32 drawable_ID, GimpBucketFillMode fill_mode, GimpLayerModeEffects paint_mode, gdouble opacity, gdouble threshold, gboolean sample_merged, gdouble x, gdouble y) { GimpParam *return_vals; gint nreturn_vals; gboolean success = TRUE; return_vals = gimp_run_procedure ("gimp_bucket_fill", &nreturn_vals, GIMP_PDB_DRAWABLE, drawable_ID, GIMP_PDB_INT32, fill_mode, GIMP_PDB_INT32, paint_mode, GIMP_PDB_FLOAT, opacity, GIMP_PDB_FLOAT, threshold, GIMP_PDB_INT32, sample_merged, GIMP_PDB_FLOAT, x, GIMP_PDB_FLOAT, y, GIMP_PDB_END); success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; gimp_destroy_params (return_vals, nreturn_vals); return success; } /** * gimp_by_color_select: * @drawable_ID: The affected drawable. * @red: * @green: * @blue: The color to select. * @threshold: Threshold in intensity levels %%desc%%. * @operation: The selection operation. * @antialias: Antialiasing. * @feather: Feather option for selections. * @feather_radius: Radius for feather operation. * @sample_merged: Use the composite image, not the drawable. * * 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. * * Returns: TRUE on success. */ gboolean gimp_by_color_select (gint32 drawable_ID, guchar red, guchar green, guchar blue, gint threshold, GimpChannelOps operation, gboolean antialias, gboolean feather, gdouble feather_radius, gboolean sample_merged) { GimpParam *return_vals; gint nreturn_vals; gboolean success = TRUE; guchar color[3]; color[0] = red; color[1] = green; color[2] = blue; return_vals = gimp_run_procedure ("gimp_by_color_select", &nreturn_vals, GIMP_PDB_DRAWABLE, drawable_ID, GIMP_PDB_COLOR, color, GIMP_PDB_INT32, threshold, GIMP_PDB_INT32, operation, GIMP_PDB_INT32, antialias, GIMP_PDB_INT32, feather, GIMP_PDB_FLOAT, feather_radius, GIMP_PDB_INT32, sample_merged, 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, 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, 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_color_picker: * @image_ID: The image. * @drawable_ID: The affected drawable. * @x: x coordinate of upper-left corner of rectangle. * @y: y coordinate of upper-left corner of rectangle. * @sample_merged: Use the composite image, not the drawable. * @sample_average: Average the color of all the pixels in a specified radius. * @average_radius: The radius of pixels to average. * @save_color: Save the color to the active palette. * @red: * @green: * @blue: The return color. * * Determine the color at the given drawable coordinates * * This tool determines the color at the specified coordinates. The * returned color is an RGB triplet even for grayscale and indexed * drawables. If the coordinates lie outside of the extents of the * specified drawable, then an error is returned. If the drawable has * an alpha channel, the algorithm examines the alpha value of the * drawable at the coordinates. If the alpha value is completely * transparent (0), then an error is returned. 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. * * Returns: TRUE on success. */ gboolean gimp_color_picker (gint32 image_ID, gint32 drawable_ID, gdouble x, gdouble y, gboolean sample_merged, gboolean sample_average, gdouble average_radius, gboolean save_color, guchar *red, guchar *green, guchar *blue) { GimpParam *return_vals; gint nreturn_vals; gboolean success = TRUE; return_vals = gimp_run_procedure ("gimp_color_picker", &nreturn_vals, GIMP_PDB_IMAGE, image_ID, GIMP_PDB_DRAWABLE, drawable_ID, GIMP_PDB_FLOAT, x, GIMP_PDB_FLOAT, y, GIMP_PDB_INT32, sample_merged, GIMP_PDB_INT32, sample_average, GIMP_PDB_FLOAT, average_radius, GIMP_PDB_INT32, save_color, GIMP_PDB_END); success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; if (success) { *red = return_vals[1].data.d_color.red; *green = return_vals[1].data.d_color.green; *blue = return_vals[1].data.d_color.blue; } 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, 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, 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_crop: * @image_ID: The image. * @new_width: New image width: (0 < new_width <= width). * @new_height: New image height: (0 < new_height <= height). * @offx: x offset: (0 <= offx <= (width - new_width)). * @offy: y offset: (0 <= offy <= (height - new_height)). * * Crop the image to the specified extents. * * This procedure crops the image so that it's new width and height are * equal to the supplied parameters. Offsets are also provided which * describe the position of the previous image's content. All channels * and layers within the image are cropped to the new image extents; * this includes the image selection mask. If any parameters are out of * range, an error is returned. * * Returns: TRUE on success. */ gboolean gimp_crop (gint32 image_ID, gint new_width, gint new_height, gint offx, gint offy) { GimpParam *return_vals; gint nreturn_vals; gboolean success = TRUE; return_vals = gimp_run_procedure ("gimp_crop", &nreturn_vals, GIMP_PDB_IMAGE, image_ID, GIMP_PDB_INT32, new_width, GIMP_PDB_INT32, new_height, GIMP_PDB_INT32, offx, GIMP_PDB_INT32, offy, 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 exposer 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. * * Dodgebure. More details here later. * * Returns: TRUE on success. */ gboolean gimp_dodgeburn (gint32 drawable_ID, gdouble exposure, GimpDodgeBurnType dodgeburn_type, GimpDodgeBurnMode dodgeburn_mode, gint num_strokes, 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. * * Dodgebure. More details here later. * * Returns: TRUE on success. */ gboolean gimp_dodgeburn_default (gint32 drawable_ID, gint num_strokes, 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_ellipse_select: * @image_ID: The image. * @x: x coordinate of upper-left corner of ellipse bounding box. * @y: y coordinate of upper-left corner of ellipse bounding box. * @width: The width of the ellipse. * @height: The height of the ellipse. * @operation: The selection operation. * @antialias: Antialiasing. * @feather: Feather option for selections. * @feather_radius: Radius for feather operation. * * 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. * * Returns: TRUE on success. */ gboolean gimp_ellipse_select (gint32 image_ID, gdouble x, gdouble y, gdouble width, gdouble height, GimpChannelOps operation, gboolean antialias, gboolean feather, gdouble feather_radius) { GimpParam *return_vals; gint nreturn_vals; gboolean success = TRUE; return_vals = gimp_run_procedure ("gimp_ellipse_select", &nreturn_vals, GIMP_PDB_IMAGE, image_ID, GIMP_PDB_FLOAT, x, GIMP_PDB_FLOAT, y, GIMP_PDB_FLOAT, width, GIMP_PDB_FLOAT, height, GIMP_PDB_INT32, operation, GIMP_PDB_INT32, antialias, GIMP_PDB_INT32, feather, GIMP_PDB_FLOAT, feather_radius, 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: %%desc%%. * @method: %%desc%%. * * 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, 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, 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_flip: * @drawable_ID: The affected drawable. * @flip_type: Type of flip. * * Flip the specified drawable about its center either vertically or * horizontally. * * This tool flips the specified drawable if no selection exists. If a * selection exists, the portion of the drawable which lies under the * selection is cut from the drawable and made into a floating * selection which is then flipd by the specified amount. The return * value is the ID of the flipped drawable. If there was no selection, * this will be equal to the drawable ID supplied as input. Otherwise, * this will be the newly created and flipped drawable. The flip type * parameter indicates whether the flip will be applied horizontally or * vertically. * * Returns: The flipped drawable. */ gint32 gimp_flip (gint32 drawable_ID, GimpOrientationType flip_type) { GimpParam *return_vals; gint nreturn_vals; gint32 ret_drawable_ID = -1; return_vals = gimp_run_procedure ("gimp_flip", &nreturn_vals, GIMP_PDB_DRAWABLE, drawable_ID, GIMP_PDB_INT32, flip_type, GIMP_PDB_END); if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) ret_drawable_ID = return_vals[1].data.d_drawable; gimp_destroy_params (return_vals, nreturn_vals); return ret_drawable_ID; } /** * gimp_free_select: * @image_ID: The image. * @num_segs: Number of points (count 1 coordinate as two points). * @segs: Array of points: { p1.x, p1.y, p2.x, p2.y, ..., pn.x, pn.y}. * @operation: The selection operation. * @antialias: Antialiasing. * @feather: Feather option for selections. * @feather_radius: Radius for feather operation. * * 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. * * Returns: TRUE on success. */ gboolean gimp_free_select (gint32 image_ID, gint num_segs, gdouble *segs, GimpChannelOps operation, gboolean antialias, gboolean feather, gdouble feather_radius) { GimpParam *return_vals; gint nreturn_vals; gboolean success = TRUE; return_vals = gimp_run_procedure ("gimp_free_select", &nreturn_vals, GIMP_PDB_IMAGE, image_ID, GIMP_PDB_INT32, num_segs, GIMP_PDB_FLOATARRAY, segs, GIMP_PDB_INT32, operation, GIMP_PDB_INT32, antialias, GIMP_PDB_INT32, feather, GIMP_PDB_FLOAT, feather_radius, GIMP_PDB_END); success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; gimp_destroy_params (return_vals, nreturn_vals); return success; } /** * gimp_fuzzy_select: * @drawable_ID: The affected drawable. * @x: x coordinate of initial seed fill point: (image coordinates). * @y: y coordinate of initial seed fill point: (image coordinates). * @threshold: Threshold in intensity levels %%desc%%. * @operation: The selection operation. * @antialias: Antialiasing. * @feather: Feather option for selections. * @feather_radius: Radius for feather operation. * @sample_merged: Use the composite image, not the drawable. * * 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. * * Returns: TRUE on success. */ 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) { GimpParam *return_vals; gint nreturn_vals; gboolean success = TRUE; return_vals = gimp_run_procedure ("gimp_fuzzy_select", &nreturn_vals, GIMP_PDB_DRAWABLE, drawable_ID, GIMP_PDB_FLOAT, x, GIMP_PDB_FLOAT, y, GIMP_PDB_INT32, threshold, GIMP_PDB_INT32, operation, GIMP_PDB_INT32, antialias, GIMP_PDB_INT32, feather, GIMP_PDB_FLOAT, feather_radius, GIMP_PDB_INT32, sample_merged, 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: %%desc%%. * @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, 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, 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, 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_perspective: * @drawable_ID: The affected drawable. * @interpolation: Whether to use interpolation. * @x0: The new x coordinate of upper-left corner of original bounding box. * @y0: The new y coordinate of upper-left corner of original bounding box. * @x1: The new x coordinate of upper-right corner of original bounding box. * @y1: The new y coordinate of upper-right corner of original bounding box. * @x2: The new x coordinate of lower-left corner of original bounding box. * @y2: The new y coordinate of lower-left corner of original bounding box. * @x3: The new x coordinate of lower-right corner of original bounding box. * @y3: The new y coordinate of lower-right corner of original bounding box. * * Perform a possibly non-affine transformation on the specified * drawable. * * This tool performs a possibly non-affine transformation on the * specified drawable by allowing the corners of the original bounding * box to be arbitrarily remapped to any values. The specified drawable * is remapped if no selection exists. However, if a selection exists, * the portion of the drawable which lies under the selection is cut * from the drawable and made into a floating selection which is then * remapped as specified. The interpolation parameter can be set to * TRUE to indicate that either linear or cubic interpolation should be * used to smooth the resulting remapped drawable. The return value is * the ID of the remapped drawable. If there was no selection, this * will be equal to the drawable ID supplied as input. Otherwise, this * will be the newly created and remapped drawable. The 4 coordinates * specify the new locations of each corner of the original bounding * box. By specifying these values, any affine transformation * (rotation, scaling, translation) can be affected. Additionally, * these values can be specified such that the resulting transformed * drawable will appear to have been projected via a perspective * transform. * * Returns: The newly mapped drawable. */ gint32 gimp_perspective (gint32 drawable_ID, gboolean interpolation, gdouble x0, gdouble y0, gdouble x1, gdouble y1, gdouble x2, gdouble y2, gdouble x3, gdouble y3) { GimpParam *return_vals; gint nreturn_vals; gint32 ret_drawable_ID = -1; return_vals = gimp_run_procedure ("gimp_perspective", &nreturn_vals, GIMP_PDB_DRAWABLE, drawable_ID, GIMP_PDB_INT32, interpolation, GIMP_PDB_FLOAT, x0, GIMP_PDB_FLOAT, y0, GIMP_PDB_FLOAT, x1, GIMP_PDB_FLOAT, y1, GIMP_PDB_FLOAT, x2, GIMP_PDB_FLOAT, y2, GIMP_PDB_FLOAT, x3, GIMP_PDB_FLOAT, y3, GIMP_PDB_END); if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) ret_drawable_ID = return_vals[1].data.d_drawable; gimp_destroy_params (return_vals, nreturn_vals); return ret_drawable_ID; } /** * gimp_rect_select: * @image_ID: The image. * @x: x coordinate of upper-left corner of rectangle. * @y: y coordinate of upper-left corner of rectangle. * @width: The width of the rectangle. * @height: The height of the rectangle. * @operation: The selection operation. * @feather: Feather option for selections. * @feather_radius: Radius for feather operation. * * 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. * * Returns: TRUE on success. */ gboolean gimp_rect_select (gint32 image_ID, gdouble x, gdouble y, gdouble width, gdouble height, GimpChannelOps operation, gboolean feather, gdouble feather_radius) { GimpParam *return_vals; gint nreturn_vals; gboolean success = TRUE; return_vals = gimp_run_procedure ("gimp_rect_select", &nreturn_vals, GIMP_PDB_IMAGE, image_ID, GIMP_PDB_FLOAT, x, GIMP_PDB_FLOAT, y, GIMP_PDB_FLOAT, width, GIMP_PDB_FLOAT, height, GIMP_PDB_INT32, operation, GIMP_PDB_INT32, feather, GIMP_PDB_FLOAT, feather_radius, GIMP_PDB_END); success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS; gimp_destroy_params (return_vals, nreturn_vals); return success; } /** * gimp_rotate: * @drawable_ID: The affected drawable. * @interpolation: Whether to use interpolation. * @angle: The angle of rotation (radians). * * Rotate the specified drawable about its center through the specified * angle. * * This tool rotates the specified drawable if no selection exists. If * a selection exists, the portion of the drawable which lies under the * selection is cut from the drawable and made into a floating * selection which is then rotated by the specified amount. The * interpolation parameter can be set to TRUE to indicate that either * linear or cubic interpolation should be used to smooth the resulting * rotated drawable. The return value is the ID of the rotated * drawable. If there was no selection, this will be equal to the * drawable ID supplied as input. Otherwise, this will be the newly * created and rotated drawable. * * Returns: The rotated drawable. */ gint32 gimp_rotate (gint32 drawable_ID, gboolean interpolation, gdouble angle) { GimpParam *return_vals; gint nreturn_vals; gint32 ret_drawable_ID = -1; return_vals = gimp_run_procedure ("gimp_rotate", &nreturn_vals, GIMP_PDB_DRAWABLE, drawable_ID, GIMP_PDB_INT32, interpolation, GIMP_PDB_FLOAT, angle, GIMP_PDB_END); if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) ret_drawable_ID = return_vals[1].data.d_drawable; gimp_destroy_params (return_vals, nreturn_vals); return ret_drawable_ID; } /** * gimp_scale: * @drawable_ID: The affected drawable. * @interpolation: Whether to use interpolation. * @x0: The new x coordinate of upper-left corner of newly scaled region. * @y0: The new y coordinate of upper-left corner of newly scaled region. * @x1: The new x coordinate of lower-right corner of newly scaled region. * @y1: The new y coordinate of lower-right corner of newly scaled region. * * Scale the specified drawable. * * This tool scales the specified drawable if no selection exists. If a * selection exists, the portion of the drawable which lies under the * selection is cut from the drawable and made into a floating * selection which is then scaled by the specified amount. The * interpolation parameter can be set to TRUE to indicate that either * linear or cubic interpolation should be used to smooth the resulting * scaled drawable. The return value is the ID of the scaled drawable. * If there was no selection, this will be equal to the drawable ID * supplied as input. Otherwise, this will be the newly created and * scaled drawable. * * Returns: The scaled drawable. */ gint32 gimp_scale (gint32 drawable_ID, gboolean interpolation, gdouble x0, gdouble y0, gdouble x1, gdouble y1) { GimpParam *return_vals; gint nreturn_vals; gint32 ret_drawable_ID = -1; return_vals = gimp_run_procedure ("gimp_scale", &nreturn_vals, GIMP_PDB_DRAWABLE, drawable_ID, GIMP_PDB_INT32, interpolation, GIMP_PDB_FLOAT, x0, GIMP_PDB_FLOAT, y0, GIMP_PDB_FLOAT, x1, GIMP_PDB_FLOAT, y1, GIMP_PDB_END); if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) ret_drawable_ID = return_vals[1].data.d_drawable; gimp_destroy_params (return_vals, nreturn_vals); return ret_drawable_ID; } /** * gimp_shear: * @drawable_ID: The affected drawable. * @interpolation: Whether to use interpolation. * @shear_type: Type of shear. * @magnitude: The magnitude of the shear. * * Shear the specified drawable about its center by the specified * magnitude. * * This tool shears the specified drawable if no selection exists. If a * selection exists, the portion of the drawable which lies under the * selection is cut from the drawable and made into a floating * selection which is then sheard by the specified amount. The * interpolation parameter can be set to TRUE to indicate that either * linear or cubic interpolation should be used to smooth the resulting * sheared drawable. The return value is the ID of the sheard drawable. * If there was no selection, this will be equal to the drawable ID * supplied as input. Otherwise, this will be the newly created and * sheard drawable. The shear type parameter indicates whether the * shear will be applied horizontally or vertically. The magnitude can * be either positive or negative and indicates the extent (in pixels) * to shear by. * * Returns: The sheared drawable. */ gint32 gimp_shear (gint32 drawable_ID, gboolean interpolation, GimpOrientationType shear_type, gdouble magnitude) { GimpParam *return_vals; gint nreturn_vals; gint32 ret_drawable_ID = -1; return_vals = gimp_run_procedure ("gimp_shear", &nreturn_vals, GIMP_PDB_DRAWABLE, drawable_ID, GIMP_PDB_INT32, interpolation, GIMP_PDB_INT32, shear_type, GIMP_PDB_FLOAT, magnitude, GIMP_PDB_END); if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) ret_drawable_ID = return_vals[1].data.d_drawable; gimp_destroy_params (return_vals, nreturn_vals); return ret_drawable_ID; } /** * 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, 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, 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; } /** * gimp_transform_2d: * @drawable_ID: The affected drawable. * @interpolation: Whether to use interpolation. * @source_x: X coordinate of the transformation center. * @source_y: Y coordinate of the transformation center. * @scale_x: Amount to scale in x direction. * @scale_y: Amount to scale in y direction. * @angle: The angle of rotation (radians). * @dest_x: X coordinate of where the centre goes. * @dest_y: Y coordinate of where the centre goes. * * Transform the specified drawable in 2d. * * This tool transforms the specified drawable if no selection exists. * If a selection exists, the portion of the drawable which lies under * the selection is cut from the drawable and made into a floating * selection which is then transformed. The interpolation parameter can * be set to TRUE to indicate that either linear or cubic interpolation * should be used to smooth the resulting drawable. The transformation * is done by scaling the image by the x and y scale factors about the * point (source_x, source_y), then rotating around the same point, * then translating that point to the new position (dest_x, dest_y). * The return value is the ID of the rotated drawable. If there was no * selection, this will be equal to the drawable ID supplied as input. * Otherwise, this will be the newly created and transformed drawable. * * Returns: The transformed drawable. */ 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) { GimpParam *return_vals; gint nreturn_vals; gint32 ret_drawable_ID = -1; return_vals = gimp_run_procedure ("gimp_transform_2d", &nreturn_vals, GIMP_PDB_DRAWABLE, drawable_ID, GIMP_PDB_INT32, interpolation, GIMP_PDB_FLOAT, source_x, GIMP_PDB_FLOAT, source_y, GIMP_PDB_FLOAT, scale_x, GIMP_PDB_FLOAT, scale_y, GIMP_PDB_FLOAT, angle, GIMP_PDB_FLOAT, dest_x, GIMP_PDB_FLOAT, dest_y, GIMP_PDB_END); if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS) ret_drawable_ID = return_vals[1].data.d_drawable; gimp_destroy_params (return_vals, nreturn_vals); return ret_drawable_ID; }