[gimp] pdb: add new selection API which has less parameters than the old one



commit 457a46a04c338f71db6dcc0f43bc0afdcde30353
Author: Michael Natterer <mitch gimp org>
Date:   Sat Oct 30 22:06:20 2010 +0200

    pdb: add new selection API which has less parameters than the old one
    
    and uses the new context properties instead. This is work in progress
    and subject to change. Don't use it in plug-ins/scripts yet!

 app/pdb/Makefile.am               |    1 +
 app/pdb/image-select-cmds.c       |  759 +++++++++++++++++++++++++++++++++++++
 app/pdb/internal-procs.c          |    3 +-
 app/pdb/internal-procs.h          |    1 +
 libgimp/Makefile.am               |    2 +
 libgimp/gimp.def                  |    7 +
 libgimp/gimp_pdb.h                |    1 +
 libgimp/gimpimageselect_pdb.c     |  408 ++++++++++++++++++++
 libgimp/gimpimageselect_pdb.h     |   79 ++++
 tools/pdbgen/Makefile.am          |    1 +
 tools/pdbgen/groups.pl            |    1 +
 tools/pdbgen/pdb/image_select.pdb |  433 +++++++++++++++++++++
 12 files changed, 1695 insertions(+), 1 deletions(-)
---
diff --git a/app/pdb/Makefile.am b/app/pdb/Makefile.am
index 5e2a42b..e06479c 100644
--- a/app/pdb/Makefile.am
+++ b/app/pdb/Makefile.am
@@ -59,6 +59,7 @@ libappinternal_procs_a_SOURCES = \
 	guides-cmds.c			\
 	help-cmds.c			\
 	image-cmds.c			\
+	image-select-cmds.c		\
 	item-cmds.c			\
 	item-transform-cmds.c		\
 	layer-cmds.c			\
diff --git a/app/pdb/image-select-cmds.c b/app/pdb/image-select-cmds.c
new file mode 100644
index 0000000..4481913
--- /dev/null
+++ b/app/pdb/image-select-cmds.c
@@ -0,0 +1,759 @@
+/* GIMP - The GNU Image Manipulation Program
+ * Copyright (C) 1995-2003 Spencer Kimball and Peter Mattis
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+/* NOTE: This file is auto-generated by pdbgen.pl. */
+
+#include "config.h"
+
+#include <gegl.h>
+
+#include "libgimpbase/gimpbase.h"
+#include "libgimpcolor/gimpcolor.h"
+
+#include "pdb-types.h"
+
+#include "core/gimpchannel-select.h"
+#include "core/gimpdrawable.h"
+#include "core/gimpimage.h"
+#include "core/gimpitem.h"
+#include "core/gimpparamspecs.h"
+
+#include "gimppdb.h"
+#include "gimppdb-utils.h"
+#include "gimppdbcontext.h"
+#include "gimpprocedure.h"
+#include "internal-procs.h"
+
+#include "gimp-intl.h"
+
+
+static GValueArray *
+image_select_color_invoker (GimpProcedure      *procedure,
+                            Gimp               *gimp,
+                            GimpContext        *context,
+                            GimpProgress       *progress,
+                            const GValueArray  *args,
+                            GError            **error)
+{
+  gboolean success = TRUE;
+  GimpImage *image;
+  GimpDrawable *drawable;
+  GimpRGB color;
+  gint32 threshold;
+  gint32 operation;
+  gboolean sample_merged;
+  gboolean select_transparent;
+  gint32 select_criterion;
+
+  image = gimp_value_get_image (&args->values[0], gimp);
+  drawable = gimp_value_get_drawable (&args->values[1], gimp);
+  gimp_value_get_rgb (&args->values[2], &color);
+  threshold = g_value_get_int (&args->values[3]);
+  operation = g_value_get_enum (&args->values[4]);
+  sample_merged = g_value_get_boolean (&args->values[5]);
+  select_transparent = g_value_get_boolean (&args->values[6]);
+  select_criterion = g_value_get_enum (&args->values[7]);
+
+  if (success)
+    {
+      if (sample_merged ||
+          gimp_pdb_item_is_attached (GIMP_ITEM (drawable), image, FALSE, error))
+        {
+          GimpPDBContext *pdb_context = GIMP_PDB_CONTEXT (context);
+
+          gimp_channel_select_by_color (gimp_image_get_mask (image), drawable,
+                                        sample_merged,
+                                        &color,
+                                        threshold,
+                                        select_transparent,
+                                        select_criterion,
+                                        operation,
+                                        pdb_context->antialias,
+                                        pdb_context->feather,
+                                        pdb_context->feather_radius_x,
+                                        pdb_context->feather_radius_y);
+        }
+      else
+        success = FALSE;
+    }
+
+  return gimp_procedure_get_return_values (procedure, success,
+                                           error ? *error : NULL);
+}
+
+static GValueArray *
+image_select_ellipse_invoker (GimpProcedure      *procedure,
+                              Gimp               *gimp,
+                              GimpContext        *context,
+                              GimpProgress       *progress,
+                              const GValueArray  *args,
+                              GError            **error)
+{
+  gboolean success = TRUE;
+  GimpImage *image;
+  gdouble x;
+  gdouble y;
+  gdouble width;
+  gdouble height;
+  gint32 operation;
+
+  image = gimp_value_get_image (&args->values[0], gimp);
+  x = g_value_get_double (&args->values[1]);
+  y = g_value_get_double (&args->values[2]);
+  width = g_value_get_double (&args->values[3]);
+  height = g_value_get_double (&args->values[4]);
+  operation = g_value_get_enum (&args->values[5]);
+
+  if (success)
+    {
+      GimpPDBContext *pdb_context = GIMP_PDB_CONTEXT (context);
+
+      gimp_channel_select_ellipse (gimp_image_get_mask (image),
+                                   (gint) x, (gint) y,
+                                   (gint) width, (gint) height,
+                                   operation,
+                                   pdb_context->antialias,
+                                   pdb_context->feather,
+                                   pdb_context->feather_radius_x,
+                                   pdb_context->feather_radius_y,
+                                   TRUE);
+    }
+
+  return gimp_procedure_get_return_values (procedure, success,
+                                           error ? *error : NULL);
+}
+
+static GValueArray *
+image_select_polygon_invoker (GimpProcedure      *procedure,
+                              Gimp               *gimp,
+                              GimpContext        *context,
+                              GimpProgress       *progress,
+                              const GValueArray  *args,
+                              GError            **error)
+{
+  gboolean success = TRUE;
+  GimpImage *image;
+  gint32 num_segs;
+  const gdouble *segs;
+  gint32 operation;
+
+  image = gimp_value_get_image (&args->values[0], gimp);
+  num_segs = g_value_get_int (&args->values[1]);
+  segs = gimp_value_get_floatarray (&args->values[2]);
+  operation = g_value_get_enum (&args->values[3]);
+
+  if (success)
+    {
+      GimpPDBContext *pdb_context = GIMP_PDB_CONTEXT (context);
+
+      gimp_channel_select_polygon (gimp_image_get_mask (image),
+                                   _("Free Select"),
+                                   num_segs / 2,
+                                   (GimpVector2 *) segs,
+                                   operation,
+                                   pdb_context->antialias,
+                                   pdb_context->feather,
+                                   pdb_context->feather_radius_x,
+                                   pdb_context->feather_radius_y,
+                                   TRUE);
+    }
+
+  return gimp_procedure_get_return_values (procedure, success,
+                                           error ? *error : NULL);
+}
+
+static GValueArray *
+image_select_fuzzy_invoker (GimpProcedure      *procedure,
+                            Gimp               *gimp,
+                            GimpContext        *context,
+                            GimpProgress       *progress,
+                            const GValueArray  *args,
+                            GError            **error)
+{
+  gboolean success = TRUE;
+  GimpImage *image;
+  GimpDrawable *drawable;
+  gdouble x;
+  gdouble y;
+  gint32 threshold;
+  gint32 operation;
+  gboolean sample_merged;
+  gboolean select_transparent;
+  gint32 select_criterion;
+
+  image = gimp_value_get_image (&args->values[0], gimp);
+  drawable = gimp_value_get_drawable (&args->values[1], gimp);
+  x = g_value_get_double (&args->values[2]);
+  y = g_value_get_double (&args->values[3]);
+  threshold = g_value_get_int (&args->values[4]);
+  operation = g_value_get_enum (&args->values[5]);
+  sample_merged = g_value_get_boolean (&args->values[6]);
+  select_transparent = g_value_get_boolean (&args->values[7]);
+  select_criterion = g_value_get_enum (&args->values[8]);
+
+  if (success)
+    {
+      if (sample_merged ||
+          gimp_pdb_item_is_attached (GIMP_ITEM (drawable), image, FALSE, error))
+        {
+          GimpPDBContext *pdb_context = GIMP_PDB_CONTEXT (context);
+
+          gimp_channel_select_fuzzy (gimp_image_get_mask (image),
+                                     drawable,
+                                     sample_merged,
+                                     x, y,
+                                     threshold,
+                                     select_transparent,
+                                     select_criterion,
+                                     operation,
+                                     pdb_context->antialias,
+                                     pdb_context->feather,
+                                     pdb_context->feather_radius_x,
+                                     pdb_context->feather_radius_y);
+        }
+      else
+        success = FALSE;
+    }
+
+  return gimp_procedure_get_return_values (procedure, success,
+                                           error ? *error : NULL);
+}
+
+static GValueArray *
+image_select_rectangle_invoker (GimpProcedure      *procedure,
+                                Gimp               *gimp,
+                                GimpContext        *context,
+                                GimpProgress       *progress,
+                                const GValueArray  *args,
+                                GError            **error)
+{
+  gboolean success = TRUE;
+  GimpImage *image;
+  gdouble x;
+  gdouble y;
+  gdouble width;
+  gdouble height;
+  gint32 operation;
+
+  image = gimp_value_get_image (&args->values[0], gimp);
+  x = g_value_get_double (&args->values[1]);
+  y = g_value_get_double (&args->values[2]);
+  width = g_value_get_double (&args->values[3]);
+  height = g_value_get_double (&args->values[4]);
+  operation = g_value_get_enum (&args->values[5]);
+
+  if (success)
+    {
+      GimpPDBContext *pdb_context = GIMP_PDB_CONTEXT (context);
+
+      gimp_channel_select_rectangle (gimp_image_get_mask (image),
+                                     (gint) x, (gint) y,
+                                     (gint) width, (gint) height,
+                                     operation,
+                                     pdb_context->feather,
+                                     pdb_context->feather_radius_x,
+                                     pdb_context->feather_radius_y,
+                                     TRUE);
+    }
+
+  return gimp_procedure_get_return_values (procedure, success,
+                                           error ? *error : NULL);
+}
+
+static GValueArray *
+image_select_round_rectangle_invoker (GimpProcedure      *procedure,
+                                      Gimp               *gimp,
+                                      GimpContext        *context,
+                                      GimpProgress       *progress,
+                                      const GValueArray  *args,
+                                      GError            **error)
+{
+  gboolean success = TRUE;
+  GimpImage *image;
+  gdouble x;
+  gdouble y;
+  gdouble width;
+  gdouble height;
+  gdouble corner_radius_x;
+  gdouble corner_radius_y;
+  gint32 operation;
+
+  image = gimp_value_get_image (&args->values[0], gimp);
+  x = g_value_get_double (&args->values[1]);
+  y = g_value_get_double (&args->values[2]);
+  width = g_value_get_double (&args->values[3]);
+  height = g_value_get_double (&args->values[4]);
+  corner_radius_x = g_value_get_double (&args->values[5]);
+  corner_radius_y = g_value_get_double (&args->values[6]);
+  operation = g_value_get_enum (&args->values[7]);
+
+  if (success)
+    {
+      GimpPDBContext *pdb_context = GIMP_PDB_CONTEXT (context);
+
+      gimp_channel_select_round_rect (gimp_image_get_mask (image),
+                                      (gint) x, (gint) y,
+                                      (gint) width, (gint) height,
+                                      corner_radius_x,
+                                      corner_radius_y,
+                                      operation,
+                                      pdb_context->antialias,
+                                      pdb_context->feather,
+                                      pdb_context->feather_radius_x,
+                                      pdb_context->feather_radius_y,
+                                      TRUE);
+    }
+
+  return gimp_procedure_get_return_values (procedure, success,
+                                           error ? *error : NULL);
+}
+
+static GValueArray *
+image_select_item_invoker (GimpProcedure      *procedure,
+                           Gimp               *gimp,
+                           GimpContext        *context,
+                           GimpProgress       *progress,
+                           const GValueArray  *args,
+                           GError            **error)
+{
+  gboolean success = TRUE;
+  GimpImage *image;
+  GimpItem *item;
+  gint32 operation;
+
+  image = gimp_value_get_image (&args->values[0], gimp);
+  item = gimp_value_get_item (&args->values[1], gimp);
+  operation = g_value_get_enum (&args->values[2]);
+
+  if (success)
+    {
+      if (gimp_pdb_item_is_attached (item, image, FALSE, error))
+        {
+          GimpPDBContext *pdb_context = GIMP_PDB_CONTEXT (context);
+
+          gimp_item_to_selection (item, operation,
+                                  pdb_context->antialias,
+                                  pdb_context->feather,
+                                  pdb_context->feather_radius_x,
+                                  pdb_context->feather_radius_y);
+        }
+      else
+        success = FALSE;
+    }
+
+  return gimp_procedure_get_return_values (procedure, success,
+                                           error ? *error : NULL);
+}
+
+void
+register_image_select_procs (GimpPDB *pdb)
+{
+  GimpProcedure *procedure;
+
+  /*
+   * gimp-image-select-color
+   */
+  procedure = gimp_procedure_new (image_select_color_invoker);
+  gimp_object_set_static_name (GIMP_OBJECT (procedure),
+                               "gimp-image-select-color");
+  gimp_procedure_set_static_strings (procedure,
+                                     "gimp-image-select-color",
+                                     "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.",
+                                     "David Gowers",
+                                     "David Gowers",
+                                     "2010",
+                                     NULL);
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_image_id ("image",
+                                                         "image",
+                                                         "The affected image",
+                                                         pdb->gimp, FALSE,
+                                                         GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_drawable_id ("drawable",
+                                                            "drawable",
+                                                            "The affected drawable",
+                                                            pdb->gimp, FALSE,
+                                                            GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_rgb ("color",
+                                                    "color",
+                                                    "The color to select",
+                                                    FALSE,
+                                                    NULL,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_int32 ("threshold",
+                                                      "threshold",
+                                                      "Threshold in intensity levels",
+                                                      0, 255, 0,
+                                                      GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_enum ("operation",
+                                                  "operation",
+                                                  "The selection operation",
+                                                  GIMP_TYPE_CHANNEL_OPS,
+                                                  GIMP_CHANNEL_OP_ADD,
+                                                  GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_boolean ("sample-merged",
+                                                     "sample merged",
+                                                     "Use the composite image, not the drawable",
+                                                     FALSE,
+                                                     GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_boolean ("select-transparent",
+                                                     "select transparent",
+                                                     "Whether to consider transparent pixels for selection. If TRUE, transparency is considered as a unique selectable color.",
+                                                     FALSE,
+                                                     GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_enum ("select-criterion",
+                                                  "select criterion",
+                                                  "The criterion used to determine color similarity. SELECT_CRITERION_COMPOSITE is the standard choice.",
+                                                  GIMP_TYPE_SELECT_CRITERION,
+                                                  GIMP_SELECT_CRITERION_COMPOSITE,
+                                                  GIMP_PARAM_READWRITE));
+  gimp_pdb_register_procedure (pdb, procedure);
+  g_object_unref (procedure);
+
+  /*
+   * gimp-image-select-ellipse
+   */
+  procedure = gimp_procedure_new (image_select_ellipse_invoker);
+  gimp_object_set_static_name (GIMP_OBJECT (procedure),
+                               "gimp-image-select-ellipse");
+  gimp_procedure_set_static_strings (procedure,
+                                     "gimp-image-select-ellipse",
+                                     "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.",
+                                     "Michael Natterer <mitch gimp org>",
+                                     "Michael Natterer",
+                                     "2010",
+                                     NULL);
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_image_id ("image",
+                                                         "image",
+                                                         "The image",
+                                                         pdb->gimp, FALSE,
+                                                         GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("x",
+                                                    "x",
+                                                    "x coordinate of upper-left corner of ellipse bounding box",
+                                                    -G_MAXDOUBLE, G_MAXDOUBLE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("y",
+                                                    "y",
+                                                    "y coordinate of upper-left corner of ellipse bounding box",
+                                                    -G_MAXDOUBLE, G_MAXDOUBLE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("width",
+                                                    "width",
+                                                    "The width of the ellipse",
+                                                    0, G_MAXDOUBLE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("height",
+                                                    "height",
+                                                    "The height of the ellipse",
+                                                    0, G_MAXDOUBLE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_enum ("operation",
+                                                  "operation",
+                                                  "The selection operation",
+                                                  GIMP_TYPE_CHANNEL_OPS,
+                                                  GIMP_CHANNEL_OP_ADD,
+                                                  GIMP_PARAM_READWRITE));
+  gimp_pdb_register_procedure (pdb, procedure);
+  g_object_unref (procedure);
+
+  /*
+   * gimp-image-select-polygon
+   */
+  procedure = gimp_procedure_new (image_select_polygon_invoker);
+  gimp_object_set_static_name (GIMP_OBJECT (procedure),
+                               "gimp-image-select-polygon");
+  gimp_procedure_set_static_strings (procedure,
+                                     "gimp-image-select-polygon",
+                                     "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.",
+                                     "Michael Natterer <mitch gimp org>",
+                                     "Michael Natterer",
+                                     "2010",
+                                     NULL);
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_image_id ("image",
+                                                         "image",
+                                                         "The image",
+                                                         pdb->gimp, FALSE,
+                                                         GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_int32 ("num-segs",
+                                                      "num segs",
+                                                      "Number of points (count 1 coordinate as two points)",
+                                                      2, G_MAXINT32, 2,
+                                                      GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_float_array ("segs",
+                                                            "segs",
+                                                            "Array of points: { p1.x, p1.y, p2.x, p2.y, ..., pn.x, pn.y}",
+                                                            GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_enum ("operation",
+                                                  "operation",
+                                                  "The selection operation",
+                                                  GIMP_TYPE_CHANNEL_OPS,
+                                                  GIMP_CHANNEL_OP_ADD,
+                                                  GIMP_PARAM_READWRITE));
+  gimp_pdb_register_procedure (pdb, procedure);
+  g_object_unref (procedure);
+
+  /*
+   * gimp-image-select-fuzzy
+   */
+  procedure = gimp_procedure_new (image_select_fuzzy_invoker);
+  gimp_object_set_static_name (GIMP_OBJECT (procedure),
+                               "gimp-image-select-fuzzy");
+  gimp_procedure_set_static_strings (procedure,
+                                     "gimp-image-select-fuzzy",
+                                     "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 a
 re relative to the image origin; otherwise,"
+  "they are relative to the drawable's origin.",
+                                     "David Gowers",
+                                     "David Gowers",
+                                     "2010",
+                                     NULL);
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_image_id ("image",
+                                                         "image",
+                                                         "The affected image",
+                                                         pdb->gimp, FALSE,
+                                                         GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_drawable_id ("drawable",
+                                                            "drawable",
+                                                            "The affected drawable",
+                                                            pdb->gimp, FALSE,
+                                                            GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("x",
+                                                    "x",
+                                                    "x coordinate of initial seed fill point: (image coordinates)",
+                                                    -G_MAXDOUBLE, G_MAXDOUBLE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("y",
+                                                    "y",
+                                                    "y coordinate of initial seed fill point: (image coordinates)",
+                                                    -G_MAXDOUBLE, G_MAXDOUBLE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_int32 ("threshold",
+                                                      "threshold",
+                                                      "Threshold in intensity levels",
+                                                      0, 255, 0,
+                                                      GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_enum ("operation",
+                                                  "operation",
+                                                  "The selection operation",
+                                                  GIMP_TYPE_CHANNEL_OPS,
+                                                  GIMP_CHANNEL_OP_ADD,
+                                                  GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_boolean ("sample-merged",
+                                                     "sample merged",
+                                                     "Use the composite image, not the drawable",
+                                                     FALSE,
+                                                     GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_boolean ("select-transparent",
+                                                     "select transparent",
+                                                     "Whether to consider transparent pixels for selection. If TRUE, transparency is considered as a unique selectable color.",
+                                                     FALSE,
+                                                     GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_enum ("select-criterion",
+                                                  "select criterion",
+                                                  "The criterion used to determine color similarity. SELECT_CRITERION_COMPOSITE is the standard choice.",
+                                                  GIMP_TYPE_SELECT_CRITERION,
+                                                  GIMP_SELECT_CRITERION_COMPOSITE,
+                                                  GIMP_PARAM_READWRITE));
+  gimp_pdb_register_procedure (pdb, procedure);
+  g_object_unref (procedure);
+
+  /*
+   * gimp-image-select-rectangle
+   */
+  procedure = gimp_procedure_new (image_select_rectangle_invoker);
+  gimp_object_set_static_name (GIMP_OBJECT (procedure),
+                               "gimp-image-select-rectangle");
+  gimp_procedure_set_static_strings (procedure,
+                                     "gimp-image-select-rectangle",
+                                     "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.",
+                                     "Michael Natterer <mitch gimp org>",
+                                     "Michael Natterer",
+                                     "2010",
+                                     NULL);
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_image_id ("image",
+                                                         "image",
+                                                         "The image",
+                                                         pdb->gimp, FALSE,
+                                                         GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("x",
+                                                    "x",
+                                                    "x coordinate of upper-left corner of rectangle",
+                                                    -G_MAXDOUBLE, G_MAXDOUBLE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("y",
+                                                    "y",
+                                                    "y coordinate of upper-left corner of rectangle",
+                                                    -G_MAXDOUBLE, G_MAXDOUBLE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("width",
+                                                    "width",
+                                                    "The width of the rectangle",
+                                                    0, G_MAXDOUBLE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("height",
+                                                    "height",
+                                                    "The height of the rectangle",
+                                                    0, G_MAXDOUBLE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_enum ("operation",
+                                                  "operation",
+                                                  "The selection operation",
+                                                  GIMP_TYPE_CHANNEL_OPS,
+                                                  GIMP_CHANNEL_OP_ADD,
+                                                  GIMP_PARAM_READWRITE));
+  gimp_pdb_register_procedure (pdb, procedure);
+  g_object_unref (procedure);
+
+  /*
+   * gimp-image-select-round-rectangle
+   */
+  procedure = gimp_procedure_new (image_select_round_rectangle_invoker);
+  gimp_object_set_static_name (GIMP_OBJECT (procedure),
+                               "gimp-image-select-round-rectangle");
+  gimp_procedure_set_static_strings (procedure,
+                                     "gimp-image-select-round-rectangle",
+                                     "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.",
+                                     "Martin Nordholts",
+                                     "Martin Nordholts",
+                                     "2010",
+                                     NULL);
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_image_id ("image",
+                                                         "image",
+                                                         "The image",
+                                                         pdb->gimp, FALSE,
+                                                         GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("x",
+                                                    "x",
+                                                    "x coordinate of upper-left corner of rectangle",
+                                                    -G_MAXDOUBLE, G_MAXDOUBLE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("y",
+                                                    "y",
+                                                    "y coordinate of upper-left corner of rectangle",
+                                                    -G_MAXDOUBLE, G_MAXDOUBLE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("width",
+                                                    "width",
+                                                    "The width of the rectangle",
+                                                    0, G_MAXDOUBLE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("height",
+                                                    "height",
+                                                    "The height of the rectangle",
+                                                    0, G_MAXDOUBLE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("corner-radius-x",
+                                                    "corner radius x",
+                                                    "The corner radius in X direction",
+                                                    0, GIMP_MAX_IMAGE_SIZE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_double ("corner-radius-y",
+                                                    "corner radius y",
+                                                    "The corner radius in Y direction",
+                                                    0, GIMP_MAX_IMAGE_SIZE, 0,
+                                                    GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_enum ("operation",
+                                                  "operation",
+                                                  "The selection operation",
+                                                  GIMP_TYPE_CHANNEL_OPS,
+                                                  GIMP_CHANNEL_OP_ADD,
+                                                  GIMP_PARAM_READWRITE));
+  gimp_pdb_register_procedure (pdb, procedure);
+  g_object_unref (procedure);
+
+  /*
+   * gimp-image-select-item
+   */
+  procedure = gimp_procedure_new (image_select_item_invoker);
+  gimp_object_set_static_name (GIMP_OBJECT (procedure),
+                               "gimp-image-select-item");
+  gimp_procedure_set_static_strings (procedure,
+                                     "gimp-image-select-item",
+                                     "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.",
+                                     "Michael Natterer <mitch gimp org>",
+                                     "Michael Natterer",
+                                     "2010",
+                                     NULL);
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_image_id ("image",
+                                                         "image",
+                                                         "The image",
+                                                         pdb->gimp, FALSE,
+                                                         GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               gimp_param_spec_item_id ("item",
+                                                        "item",
+                                                        "The item to render to the selection",
+                                                        pdb->gimp, FALSE,
+                                                        GIMP_PARAM_READWRITE));
+  gimp_procedure_add_argument (procedure,
+                               g_param_spec_enum ("operation",
+                                                  "operation",
+                                                  "The desired operation with current selection",
+                                                  GIMP_TYPE_CHANNEL_OPS,
+                                                  GIMP_CHANNEL_OP_ADD,
+                                                  GIMP_PARAM_READWRITE));
+  gimp_pdb_register_procedure (pdb, procedure);
+  g_object_unref (procedure);
+}
diff --git a/app/pdb/internal-procs.c b/app/pdb/internal-procs.c
index 915332f..48ea8c4 100644
--- a/app/pdb/internal-procs.c
+++ b/app/pdb/internal-procs.c
@@ -28,7 +28,7 @@
 #include "internal-procs.h"
 
 
-/* 634 procedures registered total */
+/* 641 procedures registered total */
 
 void
 internal_procs_init (GimpPDB *pdb)
@@ -59,6 +59,7 @@ internal_procs_init (GimpPDB *pdb)
   register_guides_procs (pdb);
   register_help_procs (pdb);
   register_image_procs (pdb);
+  register_image_select_procs (pdb);
   register_item_procs (pdb);
   register_item_transform_procs (pdb);
   register_layer_procs (pdb);
diff --git a/app/pdb/internal-procs.h b/app/pdb/internal-procs.h
index b256f9d..1bdfba2 100644
--- a/app/pdb/internal-procs.h
+++ b/app/pdb/internal-procs.h
@@ -48,6 +48,7 @@ void   register_grid_procs               (GimpPDB *pdb);
 void   register_guides_procs             (GimpPDB *pdb);
 void   register_help_procs               (GimpPDB *pdb);
 void   register_image_procs              (GimpPDB *pdb);
+void   register_image_select_procs       (GimpPDB *pdb);
 void   register_item_procs               (GimpPDB *pdb);
 void   register_item_transform_procs     (GimpPDB *pdb);
 void   register_layer_procs              (GimpPDB *pdb);
diff --git a/libgimp/Makefile.am b/libgimp/Makefile.am
index ee0da46..0b06e40 100644
--- a/libgimp/Makefile.am
+++ b/libgimp/Makefile.am
@@ -92,6 +92,7 @@ PDB_WRAPPERS_C = \
 	gimpgrid_pdb.c			\
 	gimphelp_pdb.c			\
 	gimpimage_pdb.c			\
+	gimpimageselect_pdb.c		\
 	gimpitem_pdb.c			\
 	gimpitemtransform_pdb.c		\
 	gimplayer_pdb.c			\
@@ -144,6 +145,7 @@ PDB_WRAPPERS_H = \
 	gimpguides_pdb.h		\
 	gimphelp_pdb.h			\
 	gimpimage_pdb.h			\
+	gimpimageselect_pdb.h		\
 	gimpitem_pdb.h			\
 	gimpitemtransform_pdb.h		\
 	gimplayer_pdb.h			\
diff --git a/libgimp/gimp.def b/libgimp/gimp.def
index a868743..2d55323 100644
--- a/libgimp/gimp.def
+++ b/libgimp/gimp.def
@@ -407,6 +407,13 @@ EXPORTS
 	gimp_image_rotate
 	gimp_image_scale
 	gimp_image_scale_full
+	gimp_image_select_color
+	gimp_image_select_ellipse
+	gimp_image_select_fuzzy
+	gimp_image_select_item
+	gimp_image_select_polygon
+	gimp_image_select_rectangle
+	gimp_image_select_round_rectangle
 	gimp_image_set_active_channel
 	gimp_image_set_active_layer
 	gimp_image_set_active_vectors
diff --git a/libgimp/gimp_pdb.h b/libgimp/gimp_pdb.h
index d7b7d18..4cfd27b 100644
--- a/libgimp/gimp_pdb.h
+++ b/libgimp/gimp_pdb.h
@@ -47,6 +47,7 @@
 #include <libgimp/gimpguides_pdb.h>
 #include <libgimp/gimphelp_pdb.h>
 #include <libgimp/gimpimage_pdb.h>
+#include <libgimp/gimpimageselect_pdb.h>
 #include <libgimp/gimpitem_pdb.h>
 #include <libgimp/gimpitemtransform_pdb.h>
 #include <libgimp/gimplayer_pdb.h>
diff --git a/libgimp/gimpimageselect_pdb.c b/libgimp/gimpimageselect_pdb.c
new file mode 100644
index 0000000..5fc3dda
--- /dev/null
+++ b/libgimp/gimpimageselect_pdb.c
@@ -0,0 +1,408 @@
+/* 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;
+}
diff --git a/libgimp/gimpimageselect_pdb.h b/libgimp/gimpimageselect_pdb.h
new file mode 100644
index 0000000..623099b
--- /dev/null
+++ b/libgimp/gimpimageselect_pdb.h
@@ -0,0 +1,79 @@
+/* LIBGIMP - The GIMP Library
+ * Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball
+ *
+ * gimpimageselect_pdb.h
+ *
+ * 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 */
+
+#ifndef __GIMP_IMAGE_SELECT_PDB_H__
+#define __GIMP_IMAGE_SELECT_PDB_H__
+
+G_BEGIN_DECLS
+
+/* For information look into the C source or the html documentation */
+
+
+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);
+gboolean gimp_image_select_ellipse         (gint32               image_ID,
+                                            gdouble              x,
+                                            gdouble              y,
+                                            gdouble              width,
+                                            gdouble              height,
+                                            GimpChannelOps       operation);
+gboolean gimp_image_select_polygon         (gint32               image_ID,
+                                            gint                 num_segs,
+                                            const gdouble       *segs,
+                                            GimpChannelOps       operation);
+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);
+gboolean gimp_image_select_rectangle       (gint32               image_ID,
+                                            gdouble              x,
+                                            gdouble              y,
+                                            gdouble              width,
+                                            gdouble              height,
+                                            GimpChannelOps       operation);
+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);
+gboolean gimp_image_select_item            (gint32               image_ID,
+                                            gint32               item_ID,
+                                            GimpChannelOps       operation);
+
+
+G_END_DECLS
+
+#endif /* __GIMP_IMAGE_SELECT_PDB_H__ */
diff --git a/tools/pdbgen/Makefile.am b/tools/pdbgen/Makefile.am
index b17b93c..ea4695b 100644
--- a/tools/pdbgen/Makefile.am
+++ b/tools/pdbgen/Makefile.am
@@ -26,6 +26,7 @@ pdb_sources = \
 	pdb/guides.pdb			\
 	pdb/help.pdb			\
 	pdb/image.pdb			\
+	pdb/image_select.pdb		\
 	pdb/item.pdb			\
 	pdb/item_transform.pdb		\
 	pdb/layer.pdb			\
diff --git a/tools/pdbgen/groups.pl b/tools/pdbgen/groups.pl
index 9938405..aab9717 100644
--- a/tools/pdbgen/groups.pl
+++ b/tools/pdbgen/groups.pl
@@ -24,6 +24,7 @@
     guides
     help
     image
+    image_select
     item
     item_transform
     layer
diff --git a/tools/pdbgen/pdb/image_select.pdb b/tools/pdbgen/pdb/image_select.pdb
new file mode 100644
index 0000000..f86915c
--- /dev/null
+++ b/tools/pdbgen/pdb/image_select.pdb
@@ -0,0 +1,433 @@
+# GIMP - The GNU Image Manipulation Program
+# Copyright (C) 1995 Spencer Kimball and Peter Mattis
+
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+
+# This program 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 General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+# "Perlized" from C source by Manish Singh <yosh gimp org>
+
+sub image_select_color {
+    $blurb = <<'BLURB';
+Create a selection by selecting all pixels (in the specified drawable)
+with the same (or similar) color to that specified.
+BLURB
+
+    $help = <<'HELP';
+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.
+HELP
+
+    &david_pdb_misc('2010', '2.8');
+
+    @inargs = (
+	{ name => 'image', type => 'image',
+	  desc => 'The affected image' },
+	{ name => 'drawable', type => 'drawable',
+	  desc => 'The affected drawable' },
+	{ name => 'color', type => 'color',
+	  desc => 'The color to select' },
+	{ name => 'threshold', type => '0 <= int32 <= 255',
+	  desc => 'Threshold in intensity levels' },
+	{ name => 'operation', type => 'enum GimpChannelOps',
+	  desc => 'The selection operation' },
+	{ name => 'sample_merged', type => 'boolean',
+	  desc => 'Use the composite image, not the drawable' },
+        { name => 'select_transparent', type => 'boolean',
+          desc => "Whether to consider transparent pixels for selection.
+                   If TRUE, transparency is considered as a unique selectable
+                   color." },
+        { name => 'select_criterion', type => 'enum GimpSelectCriterion',
+          desc => "The criterion used to determine color similarity.
+                   SELECT_CRITERION_COMPOSITE is the standard choice.
+		   " },
+    );
+
+    %invoke = (
+	code => <<'CODE'
+{
+  if (sample_merged ||
+      gimp_pdb_item_is_attached (GIMP_ITEM (drawable), image, FALSE, error))
+    {
+      GimpPDBContext *pdb_context = GIMP_PDB_CONTEXT (context);
+
+      gimp_channel_select_by_color (gimp_image_get_mask (image), drawable,
+                                    sample_merged,
+                                    &color,
+                                    threshold,
+                                    select_transparent,
+                                    select_criterion,
+                                    operation,
+                                    pdb_context->antialias,
+                                    pdb_context->feather,
+                                    pdb_context->feather_radius_x,
+                                    pdb_context->feather_radius_y);
+    }
+  else
+    success = FALSE;
+}
+CODE
+    );
+}
+
+
+sub image_select_ellipse {
+    $blurb = 'Create an elliptical selection over the specified image.';
+
+    $help = <<'HELP';
+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.
+HELP
+
+    &mitch_pdb_misc('2010', '2.8');
+
+    @inargs = (
+	{ name => 'image', type => 'image',
+	  desc => 'The image' },
+	{ name => 'x', type => 'float',
+	  desc => 'x coordinate of upper-left corner of ellipse bounding box' },
+	{ name => 'y', type => 'float',
+	  desc => 'y coordinate of upper-left corner of ellipse bounding box' },
+	{ name => 'width', type => '0 < float',
+	  desc => 'The width of the ellipse' },
+	{ name => 'height', type => '0 < float',
+	  desc => 'The height of the ellipse' },
+	{ name => 'operation', type => 'enum GimpChannelOps',
+	  desc => 'The selection operation' }
+    );
+
+    %invoke = (
+	code => <<'CODE'
+{
+  GimpPDBContext *pdb_context = GIMP_PDB_CONTEXT (context);
+
+  gimp_channel_select_ellipse (gimp_image_get_mask (image),
+                               (gint) x, (gint) y,
+                               (gint) width, (gint) height,
+                               operation,
+                               pdb_context->antialias,
+                               pdb_context->feather,
+                               pdb_context->feather_radius_x,
+                               pdb_context->feather_radius_y,
+                               TRUE);
+}
+CODE
+    );
+}
+
+
+sub image_select_polygon {
+    $blurb = 'Create a polygonal selection over the specified image.';
+
+    $help = <<'HELP';
+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.
+HELP
+
+    &mitch_pdb_misc('2010', '2.8');
+
+    @inargs = (
+	{ name => 'image', type => 'image',
+	  desc => 'The image' },
+        { name => 'segs', type => 'floatarray',
+          desc => 'Array of points: { p1.x, p1.y, p2.x, p2.y, ...,
+                   pn.x, pn.y}',
+          array => { type => '2 <= int32',
+                     desc => 'Number of points (count 1 coordinate as two
+                              points)' } },
+	{ name => 'operation', type => 'enum GimpChannelOps',
+	  desc => 'The selection operation' }
+    );
+
+    %invoke = (
+        code => <<'CODE'
+{
+  GimpPDBContext *pdb_context = GIMP_PDB_CONTEXT (context);
+
+  gimp_channel_select_polygon (gimp_image_get_mask (image),
+                               _("Free Select"),
+                               num_segs / 2,
+                               (GimpVector2 *) segs,
+                               operation,
+                               pdb_context->antialias,
+                               pdb_context->feather,
+                               pdb_context->feather_radius_x,
+                               pdb_context->feather_radius_y,
+                               TRUE);
+}
+CODE
+    );
+}
+
+
+sub image_select_fuzzy {
+    $blurb = <<'BLURB';
+Create a fuzzy selection starting at the specified coordinates on the specified
+drawable.
+BLURB
+
+    $help = <<'HELP';
+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.
+HELP
+
+    &david_pdb_misc('2010', '2.8');
+
+    @inargs = (
+	{ name => 'image', type => 'image',
+	  desc => 'The affected image' },
+	{ name => 'drawable', type => 'drawable',
+	  desc => 'The affected drawable' },
+	{ name => 'x', type => 'float',
+	  desc => 'x coordinate of initial seed fill point: (image
+	  	   coordinates)' },
+	{ name => 'y', type => 'float',
+	  desc => 'y coordinate of initial seed fill point: (image
+	  	   coordinates)' },
+	{ name => 'threshold', type => '0 <= int32 <= 255',
+	  desc => 'Threshold in intensity levels' },
+	{ name => 'operation', type => 'enum GimpChannelOps',
+	  desc => 'The selection operation' },
+	{ name => 'sample_merged', type => 'boolean',
+	  desc => 'Use the composite image, not the drawable' },
+	{ name => 'select_transparent', type => 'boolean',
+          desc => "Whether to consider transparent pixels for selection.
+                   If TRUE, transparency is considered as a unique selectable
+                   color." },
+        { name => 'select_criterion', type => 'enum GimpSelectCriterion',
+          desc => "The criterion used to determine color similarity.
+                   SELECT_CRITERION_COMPOSITE is the standard choice.
+		   " },
+    );
+
+    %invoke = (
+	code => <<'CODE'
+{
+  if (sample_merged ||
+      gimp_pdb_item_is_attached (GIMP_ITEM (drawable), image, FALSE, error))
+    {
+      GimpPDBContext *pdb_context = GIMP_PDB_CONTEXT (context);
+
+      gimp_channel_select_fuzzy (gimp_image_get_mask (image),
+                                 drawable,
+                                 sample_merged,
+                                 x, y,
+                                 threshold,
+                                 select_transparent,
+                                 select_criterion,
+                                 operation,
+                                 pdb_context->antialias,
+                                 pdb_context->feather,
+                                 pdb_context->feather_radius_x,
+                                 pdb_context->feather_radius_y);
+    }
+  else
+    success = FALSE;
+}
+CODE
+    );
+}
+
+
+sub image_select_rectangle {
+    $blurb = 'Create a rectangular selection over the specified image;';
+
+    $help = <<'HELP';
+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.
+HELP
+
+    &mitch_pdb_misc('2010', '2.8');
+
+    @inargs = (
+	{ name => 'image', type => 'image',
+	  desc => 'The image' },
+	{ name => 'x', type => 'float',
+	  desc => 'x coordinate of upper-left corner of rectangle' },
+	{ name => 'y', type => 'float',
+	  desc => 'y coordinate of upper-left corner of rectangle' },
+	{ name => 'width', type => '0 < float',
+	  desc => 'The width of the rectangle' },
+	{ name => 'height', type => '0 < float',
+	  desc => 'The height of the rectangle' },
+	{ name => 'operation', type => 'enum GimpChannelOps',
+	  desc => 'The selection operation' }
+    );
+
+    %invoke = (
+	code => <<'CODE'
+{
+  GimpPDBContext *pdb_context = GIMP_PDB_CONTEXT (context);
+
+  gimp_channel_select_rectangle (gimp_image_get_mask (image),
+                                 (gint) x, (gint) y,
+                                 (gint) width, (gint) height,
+                                 operation,
+                                 pdb_context->feather,
+                                 pdb_context->feather_radius_x,
+                                 pdb_context->feather_radius_y,
+                                 TRUE);
+}
+CODE
+    );
+}
+
+
+sub image_select_round_rectangle {
+    $blurb = 'Create a rectangular selection with round corners over the specified image;';
+
+    $help = <<'HELP';
+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.
+HELP
+
+    &martin_pdb_misc('2010', '2.8');
+
+    @inargs = (
+	{ name => 'image', type => 'image',
+	  desc => 'The image' },
+	{ name => 'x', type => 'float',
+	  desc => 'x coordinate of upper-left corner of rectangle' },
+	{ name => 'y', type => 'float',
+	  desc => 'y coordinate of upper-left corner of rectangle' },
+	{ name => 'width', type => '0 < float',
+	  desc => 'The width of the rectangle' },
+	{ name => 'height', type => '0 < float',
+	  desc => 'The height of the rectangle' },
+        { name => 'corner_radius_x', type => '0 < float < GIMP_MAX_IMAGE_SIZE',
+          desc => 'The corner radius in X direction' },
+        { name => 'corner_radius_y', type => '0 < float < GIMP_MAX_IMAGE_SIZE',
+          desc => 'The corner radius in Y direction' },
+	{ name => 'operation', type => 'enum GimpChannelOps',
+	  desc => 'The selection operation' }
+    );
+
+    %invoke = (
+	code => <<'CODE'
+{
+  GimpPDBContext *pdb_context = GIMP_PDB_CONTEXT (context);
+
+  gimp_channel_select_round_rect (gimp_image_get_mask (image),
+                                  (gint) x, (gint) y,
+                                  (gint) width, (gint) height,
+                                  corner_radius_x,
+                                  corner_radius_y,
+                                  operation,
+                                  pdb_context->antialias,
+                                  pdb_context->feather,
+                                  pdb_context->feather_radius_x,
+                                  pdb_context->feather_radius_y,
+                                  TRUE);
+}
+CODE
+    );
+}
+
+
+sub image_select_item {
+    $blurb = 'Transforms the specified item into a selection';
+
+    $help = <<'HELP';
+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.
+HELP
+
+    &mitch_pdb_misc('2010', '2.8');
+
+    @inargs = (
+	{ name => 'image', type => 'image',
+	  desc => 'The image' },
+        { name => 'item', type => 'item',
+          desc => 'The item to render to the selection' },
+        { name => 'operation', type => 'enum GimpChannelOps',
+          desc => 'The desired operation with current selection' }
+    );
+
+    %invoke = (
+        code => <<'CODE'
+{
+  if (gimp_pdb_item_is_attached (item, image, FALSE, error))
+    {
+      GimpPDBContext *pdb_context = GIMP_PDB_CONTEXT (context);
+
+      gimp_item_to_selection (item, operation,
+                              pdb_context->antialias,
+                              pdb_context->feather,
+                              pdb_context->feather_radius_x,
+                              pdb_context->feather_radius_y);
+    }
+  else
+    success = FALSE;
+}
+CODE
+    );
+
+}
+
+
+ headers = qw("libgimpbase/gimpbase.h"
+              "core/gimpchannel-select.h"
+              "gimppdb-utils.h"
+              "gimppdbcontext.h"
+              "gimp-intl.h");
+
+ procs = qw(image_select_color
+            image_select_ellipse
+            image_select_polygon
+	    image_select_fuzzy
+	    image_select_rectangle
+            image_select_round_rectangle
+            image_select_item);
+
+%exports = (app => [ procs], lib => [ procs]);
+
+$desc = 'Selection procedures';
+$doc_title = 'gimpimageselect';
+$doc_short_desc = "Modify the image's selection.";
+$doc_long_desc = "Functions to modify the image's selection.";
+
+1;



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]