mirror of
https://gitlab.gnome.org/GNOME/gimp.git
synced 2025-07-03 17:33:25 +00:00
8005eea835
because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
461 lines
17 KiB
C
461 lines
17 KiB
C
/* LIBGIMP - The GIMP Library
|
|
* Copyright (C) 1995-2003 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 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
|
|
* <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
/* NOTE: This file is auto-generated by pdbgen.pl */
|
|
|
|
#include "config.h"
|
|
|
|
#include "gimp.h"
|
|
|
|
|
|
/**
|
|
* SECTION: gimpselectiontools
|
|
* @title: gimpselectiontools
|
|
* @short_description: Access to toolbox selection tools.
|
|
*
|
|
* Functions giving access to toolbox selection tools.
|
|
**/
|
|
|
|
|
|
/**
|
|
* gimp_by_color_select:
|
|
* @drawable_ID: The affected drawable.
|
|
* @color: The color to select.
|
|
* @threshold: Threshold in intensity levels.
|
|
* @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.
|
|
*
|
|
* Deprecated: Use gimp_image_select_color() instead.
|
|
*
|
|
* Returns: TRUE on success.
|
|
**/
|
|
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)
|
|
{
|
|
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_by_color_select_full:
|
|
* @drawable_ID: The affected drawable.
|
|
* @color: The color to select.
|
|
* @threshold: Threshold in intensity levels.
|
|
* @operation: The selection operation.
|
|
* @antialias: Antialiasing.
|
|
* @feather: Feather option for selections.
|
|
* @feather_radius_x: Radius for feather operation in X direction.
|
|
* @feather_radius_y: Radius for feather operation in Y direction.
|
|
* @sample_merged: Use the composite image, not the drawable.
|
|
* @select_transparent: Whether to consider transparent pixels for selection. If TRUE, transparency is considered as a unique selectable color.
|
|
* @select_criterion: The criterion used to determine color similarity. SELECT_CRITERION_COMPOSITE is the standard choice.
|
|
*
|
|
* Deprecated: Use gimp_image_select_color() instead.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_by_color_select_full (gint32 drawable_ID,
|
|
const GimpRGB *color,
|
|
gint threshold,
|
|
GimpChannelOps operation,
|
|
gboolean antialias,
|
|
gboolean feather,
|
|
gdouble feather_radius_x,
|
|
gdouble feather_radius_y,
|
|
gboolean sample_merged,
|
|
gboolean select_transparent,
|
|
GimpSelectCriterion select_criterion)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp-by-color-select-full",
|
|
&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_x,
|
|
GIMP_PDB_FLOAT, feather_radius_y,
|
|
GIMP_PDB_INT32, sample_merged,
|
|
GIMP_PDB_INT32, select_transparent,
|
|
GIMP_PDB_INT32, select_criterion,
|
|
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.
|
|
*
|
|
* Deprecated: Use gimp_image_select_ellipse() instead.
|
|
*
|
|
* 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.
|
|
*
|
|
* Deprecated: Use gimp_image_select_polygon() instead.
|
|
*
|
|
* Returns: TRUE on success.
|
|
**/
|
|
gboolean
|
|
gimp_free_select (gint32 image_ID,
|
|
gint num_segs,
|
|
const 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.
|
|
* @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.
|
|
*
|
|
* Deprecated: Use gimp_image_select_contiguous_color() instead.
|
|
*
|
|
* 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_fuzzy_select_full:
|
|
* @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.
|
|
* @operation: The selection operation.
|
|
* @antialias: Antialiasing.
|
|
* @feather: Feather option for selections.
|
|
* @feather_radius_x: Radius for feather operation in X direction.
|
|
* @feather_radius_y: Radius for feather operation in Y direction.
|
|
* @sample_merged: Use the composite image, not the drawable.
|
|
* @select_transparent: Whether to consider transparent pixels for selection. If TRUE, transparency is considered as a unique selectable color.
|
|
* @select_criterion: The criterion used to determine color similarity. SELECT_CRITERION_COMPOSITE is the standard choice.
|
|
*
|
|
* Deprecated: Use gimp_image_select_contiguous_color() instead.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_fuzzy_select_full (gint32 drawable_ID,
|
|
gdouble x,
|
|
gdouble y,
|
|
gint threshold,
|
|
GimpChannelOps operation,
|
|
gboolean antialias,
|
|
gboolean feather,
|
|
gdouble feather_radius_x,
|
|
gdouble feather_radius_y,
|
|
gboolean sample_merged,
|
|
gboolean select_transparent,
|
|
GimpSelectCriterion select_criterion)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp-fuzzy-select-full",
|
|
&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_x,
|
|
GIMP_PDB_FLOAT, feather_radius_y,
|
|
GIMP_PDB_INT32, sample_merged,
|
|
GIMP_PDB_INT32, select_transparent,
|
|
GIMP_PDB_INT32, select_criterion,
|
|
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.
|
|
*
|
|
* Deprecated: Use gimp_image_select_rectangle() instead.
|
|
*
|
|
* 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_round_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.
|
|
* @corner_radius_x: The corner radius in X direction.
|
|
* @corner_radius_y: The corner radius in Y direction.
|
|
* @operation: The selection operation.
|
|
* @antialias: Antialiasing.
|
|
* @feather: Feather option for selections.
|
|
* @feather_radius_x: Radius for feather operation in X direction.
|
|
* @feather_radius_y: Radius for feather operation in Y direction.
|
|
*
|
|
* Deprecated: Use gimp_image_select_round_rectangle() instead.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_round_rect_select (gint32 image_ID,
|
|
gdouble x,
|
|
gdouble y,
|
|
gdouble width,
|
|
gdouble height,
|
|
gdouble corner_radius_x,
|
|
gdouble corner_radius_y,
|
|
GimpChannelOps operation,
|
|
gboolean antialias,
|
|
gboolean feather,
|
|
gdouble feather_radius_x,
|
|
gdouble feather_radius_y)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp-round-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_FLOAT, corner_radius_x,
|
|
GIMP_PDB_FLOAT, corner_radius_y,
|
|
GIMP_PDB_INT32, operation,
|
|
GIMP_PDB_INT32, antialias,
|
|
GIMP_PDB_INT32, feather,
|
|
GIMP_PDB_FLOAT, feather_radius_x,
|
|
GIMP_PDB_FLOAT, feather_radius_y,
|
|
GIMP_PDB_END);
|
|
|
|
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_destroy_params (return_vals, nreturn_vals);
|
|
|
|
return success;
|
|
}
|