mirror of https://github.com/GNOME/gimp.git
409 lines
15 KiB
C
409 lines
15 KiB
C
/* LIBGIMP - The GIMP Library
|
|
* Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball
|
|
*
|
|
* gimpimageselect_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: gimpimageselect
|
|
* @title: gimpimageselect
|
|
* @short_description: Modify the image's selection.
|
|
*
|
|
* Functions to modify the image's selection.
|
|
**/
|
|
|
|
|
|
/**
|
|
* gimp_image_select_color:
|
|
* @image_ID: The affected image.
|
|
* @drawable_ID: The affected drawable.
|
|
* @color: The color to select.
|
|
* @threshold: Threshold in intensity levels.
|
|
* @operation: The selection operation.
|
|
* @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.
|
|
*
|
|
* 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. To select transparent regions, the color specified must
|
|
* also have minimum alpha. If the 'sample-merged' parameter is TRUE,
|
|
* 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.
|
|
*
|
|
* Since: GIMP 2.8
|
|
**/
|
|
gboolean
|
|
gimp_image_select_color (gint32 image_ID,
|
|
gint32 drawable_ID,
|
|
const GimpRGB *color,
|
|
gint threshold,
|
|
GimpChannelOps operation,
|
|
gboolean sample_merged,
|
|
gboolean select_transparent,
|
|
GimpSelectCriterion select_criterion)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp-image-select-color",
|
|
&nreturn_vals,
|
|
GIMP_PDB_IMAGE, image_ID,
|
|
GIMP_PDB_DRAWABLE, drawable_ID,
|
|
GIMP_PDB_COLOR, color,
|
|
GIMP_PDB_INT32, threshold,
|
|
GIMP_PDB_INT32, operation,
|
|
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_image_select_ellipse:
|
|
* @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.
|
|
*
|
|
* 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.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: GIMP 2.8
|
|
**/
|
|
gboolean
|
|
gimp_image_select_ellipse (gint32 image_ID,
|
|
gdouble x,
|
|
gdouble y,
|
|
gdouble width,
|
|
gdouble height,
|
|
GimpChannelOps operation)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp-image-select-ellipse",
|
|
&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_END);
|
|
|
|
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_destroy_params (return_vals, nreturn_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_image_select_polygon:
|
|
* @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.
|
|
*
|
|
* 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.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: GIMP 2.8
|
|
**/
|
|
gboolean
|
|
gimp_image_select_polygon (gint32 image_ID,
|
|
gint num_segs,
|
|
const gdouble *segs,
|
|
GimpChannelOps operation)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp-image-select-polygon",
|
|
&nreturn_vals,
|
|
GIMP_PDB_IMAGE, image_ID,
|
|
GIMP_PDB_INT32, num_segs,
|
|
GIMP_PDB_FLOATARRAY, segs,
|
|
GIMP_PDB_INT32, operation,
|
|
GIMP_PDB_END);
|
|
|
|
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_destroy_params (return_vals, nreturn_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_image_select_fuzzy:
|
|
* @image_ID: The affected image.
|
|
* @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.
|
|
* @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.
|
|
*
|
|
* 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. If
|
|
* antialiasing is turned on, the final selection mask will contain
|
|
* intermediate values based on close misses to the threshold bar at
|
|
* pixels along the seed fill boundary. If the 'sample-merged'
|
|
* parameter is TRUE, 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.
|
|
*
|
|
* Since: GIMP 2.8
|
|
**/
|
|
gboolean
|
|
gimp_image_select_fuzzy (gint32 image_ID,
|
|
gint32 drawable_ID,
|
|
gdouble x,
|
|
gdouble y,
|
|
gint threshold,
|
|
GimpChannelOps operation,
|
|
gboolean sample_merged,
|
|
gboolean select_transparent,
|
|
GimpSelectCriterion select_criterion)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp-image-select-fuzzy",
|
|
&nreturn_vals,
|
|
GIMP_PDB_IMAGE, image_ID,
|
|
GIMP_PDB_DRAWABLE, drawable_ID,
|
|
GIMP_PDB_FLOAT, x,
|
|
GIMP_PDB_FLOAT, y,
|
|
GIMP_PDB_INT32, threshold,
|
|
GIMP_PDB_INT32, operation,
|
|
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_image_select_rectangle:
|
|
* @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.
|
|
*
|
|
* 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.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: GIMP 2.8
|
|
**/
|
|
gboolean
|
|
gimp_image_select_rectangle (gint32 image_ID,
|
|
gdouble x,
|
|
gdouble y,
|
|
gdouble width,
|
|
gdouble height,
|
|
GimpChannelOps operation)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp-image-select-rectangle",
|
|
&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_END);
|
|
|
|
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_destroy_params (return_vals, nreturn_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_image_select_round_rectangle:
|
|
* @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.
|
|
*
|
|
* Create a rectangular selection with round corners over the specified
|
|
* image;
|
|
*
|
|
* This tool creates a rectangular selection with round corners over
|
|
* the specified image. The rectangular region can be either added to,
|
|
* subtracted from, or replace the contents of the previous selection
|
|
* mask.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: GIMP 2.8
|
|
**/
|
|
gboolean
|
|
gimp_image_select_round_rectangle (gint32 image_ID,
|
|
gdouble x,
|
|
gdouble y,
|
|
gdouble width,
|
|
gdouble height,
|
|
gdouble corner_radius_x,
|
|
gdouble corner_radius_y,
|
|
GimpChannelOps operation)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp-image-select-round-rectangle",
|
|
&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_END);
|
|
|
|
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_destroy_params (return_vals, nreturn_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_image_select_item:
|
|
* @image_ID: The image.
|
|
* @item_ID: The item to render to the selection.
|
|
* @operation: The desired operation with current selection.
|
|
*
|
|
* Transforms the specified item into a selection
|
|
*
|
|
* This procedure renders the item's outline into the current selection
|
|
* of the image the item belongs to. What exactly the item's outline is
|
|
* depends on the item type: for layers, it's the layer's alpha
|
|
* channel, for vectors the vector's shape.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: GIMP 2.8
|
|
**/
|
|
gboolean
|
|
gimp_image_select_item (gint32 image_ID,
|
|
gint32 item_ID,
|
|
GimpChannelOps operation)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp-image-select-item",
|
|
&nreturn_vals,
|
|
GIMP_PDB_IMAGE, image_ID,
|
|
GIMP_PDB_ITEM, item_ID,
|
|
GIMP_PDB_INT32, operation,
|
|
GIMP_PDB_END);
|
|
|
|
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_destroy_params (return_vals, nreturn_vals);
|
|
|
|
return success;
|
|
}
|