mirror of
https://gitlab.gnome.org/GNOME/gimp
synced 2024-10-20 11:37:14 +00:00
99e78c7074
2001-10-22 Michael Natterer <mitch@gimp.org> General cleanup of the selection tools and their PDB wrappers: * app/core/Makefile.am * app/core/gimpimage-contiguous-region.[ch] * app/core/gimpimage-mask-select.[ch]: new files providing a clean, uniform API for the selection functionalities. Changed order of parameters to be consistent, removed code duplication. The region returned by the "by_color" function is not really contiguous but the API is so similar to "by_seed" and it's used in the same context so it's fair enough to put them together. Also, I'm not sure if the two is_pixel_sufficiently_different() I've optimized away were meant to do *exactly* the same. Added a comment there to remember the former difference. * app/core/gimpchannel.[ch] (gimp_channel_feather): removed the "output" channel parameter and made it optionally push an undo (like the other channel operations do). * app/core/gimpimage-mask.c: call gimp_channel_feather() with "push_undo == TRUE", removed some useless comments. * app/tools/gimpbycolorselecttool.[ch] * app/tools/gimpellipseselecttool.[ch] * app/tools/gimpfreeselecttool.[ch] * app/tools/gimpfuzzyselecttool.[ch] * app/tools/gimprectselecttool.[ch]: removed all the actual selection functionality and call the new gimp_image_mask_select_*() and gimp_image_contiguous_region_*() functions instead. * app/tools/gimpbezierselecttool.c * app/tools/gimpiscissorstool.c: use new function gimp_image_mask_select_channel() instead of doing the same manually. * app/tools/gimpbucketfilltool.c: find_contiguous_region() -> gimp_image_contiguous_region_by_seed(). * tools/pdbgen/Makefile.am * tools/pdbgen/groups.pl * tools/pdbgen/pdb/selection_tools.pdb: added new group "Selection Tools" which depends only on "core/" stuff (not on "tools/" any more, brrrr). * tools/pdbgen/pdb/text_tool.pdb: don't include "appenv.h" * tools/pdbgen/pdb/tools.pdb: removed the selection tools. * app/pdb/Makefile.am * app/pdb/selection_tools_cmds.c: new file. * app/pdb/internal_procs.c * app/pdb/text_tool_cmds.c * app/pdb/tools_cmds.c: regenerated. * libgimp/Makefile.am * libgimp/gimp_pdb.h * libgimp/gimpselectiontools_pdb.[ch]: new files. * libgimp/gimptools_pdb.[ch]: regenerated Misc cleanups: * app/app_procs.c: call splash_create() with "no_splash_image" as parameter. * app/display/gimpdisplay-render.c * app/display/gximage.c: don't include "appenv.h". * app/gui/gui.c: call session_restore() only if "restore_session" is TRUE. * app/gui/session.c: don't "if(restore_session)" here and don't include "appenv.h" * app/gui/splash.[ch]: added "gboolean show_image" parameter to splash_create(), don't include "appenv.h" * app/tools/gimppainttool.[ch]: added a "GimpGradient" parameter to gimp_paint_tool_get_color_from_gradient(). * app/tools/gimppaintbrushtool.c: pass the gradient. * app/tools/gimpselectiontool.c * app/tools/gimptransformtool.c * app/tools/tool_manager.c: s/GDisplay/GimpDisplay/. * app/widgets/gimpcontainergridview.[ch]: removed the "white_style" class variable and don't fiddle around with colors and styles... * themes/Default/gtkrc: ...do the same here with a simple rc style.
332 lines
11 KiB
C
332 lines
11 KiB
C
/* LIBGIMP - The GIMP Library
|
|
* Copyright (C) 1995-2000 Peter Mattis and Spencer Kimball
|
|
*
|
|
* gimpselectiontools_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_by_color_select:
|
|
* @drawable_ID: The affected drawable.
|
|
* @color: 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,
|
|
GimpRGB *color,
|
|
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_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_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_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_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;
|
|
}
|