Adding upstream version 2.10.22.upstream/2.10.22upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 864 insertions, 0 deletions

diff --git a/libgimp/gimpbrush_pdb.c b/libgimp/gimpbrush_pdb.c
new file mode 100644
index 0000000..6cb5bc7
--- /dev/null
+++ b/libgimp/gimpbrush_pdb.c
@@ -0,0 +1,864 @@
+/* LIBGIMP - The GIMP Library
+ * Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball
+ *
+ * gimpbrush_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
+ * <https://www.gnu.org/licenses/>.
+ */
+
+/* NOTE: This file is auto-generated by pdbgen.pl */
+
+#include "config.h"
+
+#include <string.h>
+
+#include "gimp.h"
+
+
+/**
+ * SECTION: gimpbrush
+ * @title: gimpbrush
+ * @short_description: Functions operating on a single brush.
+ *
+ * Functions operating on a single brush.
+ **/
+
+
+/**
+ * gimp_brush_new:
+ * @name: The requested name of the new brush.
+ *
+ * Creates a new brush.
+ *
+ * This procedure creates a new, uninitialized brush.
+ *
+ * Returns: The actual new brush name. The returned value must be freed
+ * with g_free().
+ *
+ * Since: 2.2
+ **/
+gchar *
+gimp_brush_new (const gchar *name)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gchar *actual_name = NULL;
+
+  return_vals = gimp_run_procedure ("gimp-brush-new",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    actual_name = g_strdup (return_vals[1].data.d_string);
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return actual_name;
+}
+
+/**
+ * gimp_brush_duplicate:
+ * @name: The brush name.
+ *
+ * Duplicates a brush.
+ *
+ * This procedure creates an identical brush by a different name.
+ *
+ * Returns: The name of the brush's copy. The returned value must be
+ * freed with g_free().
+ *
+ * Since: 2.2
+ **/
+gchar *
+gimp_brush_duplicate (const gchar *name)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gchar *copy_name = NULL;
+
+  return_vals = gimp_run_procedure ("gimp-brush-duplicate",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    copy_name = g_strdup (return_vals[1].data.d_string);
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return copy_name;
+}
+
+/**
+ * gimp_brush_is_generated:
+ * @name: The brush name.
+ *
+ * Tests if brush is generated.
+ *
+ * Returns TRUE if this brush is parametric, FALSE for other types.
+ *
+ * Returns: TRUE if the brush is generated.
+ *
+ * Since: 2.4
+ **/
+gboolean
+gimp_brush_is_generated (const gchar *name)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gboolean generated = FALSE;
+
+  return_vals = gimp_run_procedure ("gimp-brush-is-generated",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    generated = return_vals[1].data.d_int32;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return generated;
+}
+
+/**
+ * gimp_brush_rename:
+ * @name: The brush name.
+ * @new_name: The new name of the brush.
+ *
+ * Renames a brush.
+ *
+ * This procedure renames a brush.
+ *
+ * Returns: The actual new name of the brush. The returned value must
+ * be freed with g_free().
+ *
+ * Since: 2.2
+ **/
+gchar *
+gimp_brush_rename (const gchar *name,
+                   const gchar *new_name)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gchar *actual_name = NULL;
+
+  return_vals = gimp_run_procedure ("gimp-brush-rename",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_STRING, new_name,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    actual_name = g_strdup (return_vals[1].data.d_string);
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return actual_name;
+}
+
+/**
+ * gimp_brush_delete:
+ * @name: The brush name.
+ *
+ * Deletes a brush.
+ *
+ * This procedure deletes a brush.
+ *
+ * Returns: TRUE on success.
+ *
+ * Since: 2.2
+ **/
+gboolean
+gimp_brush_delete (const gchar *name)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gboolean success = TRUE;
+
+  return_vals = gimp_run_procedure ("gimp-brush-delete",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_END);
+
+  success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return success;
+}
+
+/**
+ * gimp_brush_is_editable:
+ * @name: The brush name.
+ *
+ * Tests if brush can be edited.
+ *
+ * Returns TRUE if you have permission to change the brush.
+ *
+ * Returns: TRUE if the brush can be edited.
+ *
+ * Since: 2.4
+ **/
+gboolean
+gimp_brush_is_editable (const gchar *name)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gboolean editable = FALSE;
+
+  return_vals = gimp_run_procedure ("gimp-brush-is-editable",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    editable = return_vals[1].data.d_int32;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return editable;
+}
+
+/**
+ * gimp_brush_get_info:
+ * @name: The brush name.
+ * @width: The brush width.
+ * @height: The brush height.
+ * @mask_bpp: The brush mask bpp.
+ * @color_bpp: The brush color bpp.
+ *
+ * Retrieves information about the specified brush.
+ *
+ * This procedure retrieves information about the specified brush:
+ * brush extents (width and height), color depth and mask depth.
+ *
+ * Returns: TRUE on success.
+ *
+ * Since: 2.2
+ **/
+gboolean
+gimp_brush_get_info (const gchar *name,
+                     gint        *width,
+                     gint        *height,
+                     gint        *mask_bpp,
+                     gint        *color_bpp)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gboolean success = TRUE;
+
+  return_vals = gimp_run_procedure ("gimp-brush-get-info",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_END);
+
+  *width = 0;
+  *height = 0;
+  *mask_bpp = 0;
+  *color_bpp = 0;
+
+  success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
+
+  if (success)
+    {
+      *width = return_vals[1].data.d_int32;
+      *height = return_vals[2].data.d_int32;
+      *mask_bpp = return_vals[3].data.d_int32;
+      *color_bpp = return_vals[4].data.d_int32;
+    }
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return success;
+}
+
+/**
+ * gimp_brush_get_pixels:
+ * @name: The brush name.
+ * @width: The brush width.
+ * @height: The brush height.
+ * @mask_bpp: The brush mask bpp.
+ * @num_mask_bytes: Length of brush mask data.
+ * @mask_bytes: The brush mask data.
+ * @color_bpp: The brush color bpp.
+ * @num_color_bytes: Length of brush color data.
+ * @color_bytes: The brush color data.
+ *
+ * Retrieves information about the specified brush.
+ *
+ * This procedure retrieves information about the specified brush. This
+ * includes the brush extents (width and height) and its pixels data.
+ *
+ * Returns: TRUE on success.
+ *
+ * Since: 2.2
+ **/
+gboolean
+gimp_brush_get_pixels (const gchar  *name,
+                       gint         *width,
+                       gint         *height,
+                       gint         *mask_bpp,
+                       gint         *num_mask_bytes,
+                       guint8      **mask_bytes,
+                       gint         *color_bpp,
+                       gint         *num_color_bytes,
+                       guint8      **color_bytes)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gboolean success = TRUE;
+
+  return_vals = gimp_run_procedure ("gimp-brush-get-pixels",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_END);
+
+  *width = 0;
+  *height = 0;
+  *mask_bpp = 0;
+  *num_mask_bytes = 0;
+  *mask_bytes = NULL;
+  *color_bpp = 0;
+  *num_color_bytes = 0;
+  *color_bytes = NULL;
+
+  success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
+
+  if (success)
+    {
+      *width = return_vals[1].data.d_int32;
+      *height = return_vals[2].data.d_int32;
+      *mask_bpp = return_vals[3].data.d_int32;
+      *num_mask_bytes = return_vals[4].data.d_int32;
+      *mask_bytes = g_new (guint8, *num_mask_bytes);
+      memcpy (*mask_bytes,
+              return_vals[5].data.d_int8array,
+              *num_mask_bytes * sizeof (guint8));
+      *color_bpp = return_vals[6].data.d_int32;
+      *num_color_bytes = return_vals[7].data.d_int32;
+      *color_bytes = g_new (guint8, *num_color_bytes);
+      memcpy (*color_bytes,
+              return_vals[8].data.d_int8array,
+              *num_color_bytes * sizeof (guint8));
+    }
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return success;
+}
+
+/**
+ * gimp_brush_get_spacing:
+ * @name: The brush name.
+ * @spacing: The brush spacing.
+ *
+ * Gets the brush spacing.
+ *
+ * This procedure returns the spacing setting for the specified brush.
+ * The return value is an integer between 0 and 1000 which represents
+ * percentage of the maximum of the width and height of the mask.
+ *
+ * Returns: TRUE on success.
+ *
+ * Since: 2.2
+ **/
+gboolean
+gimp_brush_get_spacing (const gchar *name,
+                        gint        *spacing)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gboolean success = TRUE;
+
+  return_vals = gimp_run_procedure ("gimp-brush-get-spacing",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_END);
+
+  *spacing = 0;
+
+  success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
+
+  if (success)
+    *spacing = return_vals[1].data.d_int32;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return success;
+}
+
+/**
+ * gimp_brush_set_spacing:
+ * @name: The brush name.
+ * @spacing: The brush spacing.
+ *
+ * Sets the brush spacing.
+ *
+ * This procedure modifies the spacing setting for the specified brush.
+ * The value should be a integer between 0 and 1000.
+ *
+ * Returns: TRUE on success.
+ *
+ * Since: 2.4
+ **/
+gboolean
+gimp_brush_set_spacing (const gchar *name,
+                        gint         spacing)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gboolean success = TRUE;
+
+  return_vals = gimp_run_procedure ("gimp-brush-set-spacing",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_INT32, spacing,
+                                    GIMP_PDB_END);
+
+  success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return success;
+}
+
+/**
+ * gimp_brush_get_shape:
+ * @name: The brush name.
+ *
+ * Gets the shape of a generated brush.
+ *
+ * This procedure gets the shape value for a generated brush. If called
+ * for any other type of brush, it does not succeed. The current
+ * possibilities are Circle (GIMP_BRUSH_GENERATED_CIRCLE), Square
+ * (GIMP_BRUSH_GENERATED_SQUARE), and Diamond
+ * (GIMP_BRUSH_GENERATED_DIAMOND). Other shapes are likely to be added
+ * in the future.
+ *
+ * Returns: The brush shape.
+ *
+ * Since: 2.4
+ **/
+GimpBrushGeneratedShape
+gimp_brush_get_shape (const gchar *name)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  GimpBrushGeneratedShape shape = 0;
+
+  return_vals = gimp_run_procedure ("gimp-brush-get-shape",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    shape = return_vals[1].data.d_int32;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return shape;
+}
+
+/**
+ * gimp_brush_set_shape:
+ * @name: The brush name.
+ * @shape_in: The brush shape.
+ *
+ * Sets the shape of a generated brush.
+ *
+ * This procedure sets the shape value for a generated brush. If called
+ * for any other type of brush, it does not succeed. The current
+ * possibilities are Circle (GIMP_BRUSH_GENERATED_CIRCLE), Square
+ * (GIMP_BRUSH_GENERATED_SQUARE), and Diamond
+ * (GIMP_BRUSH_GENERATED_DIAMOND). Other shapes are likely to be added
+ * in the future.
+ *
+ * Returns: The brush shape actually assigned.
+ *
+ * Since: 2.4
+ **/
+GimpBrushGeneratedShape
+gimp_brush_set_shape (const gchar             *name,
+                      GimpBrushGeneratedShape  shape_in)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  GimpBrushGeneratedShape shape_out = 0;
+
+  return_vals = gimp_run_procedure ("gimp-brush-set-shape",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_INT32, shape_in,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    shape_out = return_vals[1].data.d_int32;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return shape_out;
+}
+
+/**
+ * gimp_brush_get_radius:
+ * @name: The brush name.
+ *
+ * Gets the radius of a generated brush.
+ *
+ * This procedure gets the radius value for a generated brush. If
+ * called for any other type of brush, it does not succeed.
+ *
+ * Returns: The radius of the brush in pixels.
+ *
+ * Since: 2.4
+ **/
+gdouble
+gimp_brush_get_radius (const gchar *name)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gdouble radius = 0.0;
+
+  return_vals = gimp_run_procedure ("gimp-brush-get-radius",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    radius = return_vals[1].data.d_float;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return radius;
+}
+
+/**
+ * gimp_brush_set_radius:
+ * @name: The brush name.
+ * @radius_in: The desired brush radius in pixel.
+ *
+ * Sets the radius of a generated brush.
+ *
+ * This procedure sets the radius for a generated brush. If called for
+ * any other type of brush, it does not succeed.
+ *
+ * Returns: The brush radius actually assigned.
+ *
+ * Since: 2.4
+ **/
+gdouble
+gimp_brush_set_radius (const gchar *name,
+                       gdouble      radius_in)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gdouble radius_out = 0.0;
+
+  return_vals = gimp_run_procedure ("gimp-brush-set-radius",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_FLOAT, radius_in,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    radius_out = return_vals[1].data.d_float;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return radius_out;
+}
+
+/**
+ * gimp_brush_get_spikes:
+ * @name: The brush name.
+ *
+ * Gets the number of spikes for a generated brush.
+ *
+ * This procedure gets the number of spikes for a generated brush. If
+ * called for any other type of brush, it does not succeed.
+ *
+ * Returns: The number of spikes on the brush.
+ *
+ * Since: 2.4
+ **/
+gint
+gimp_brush_get_spikes (const gchar *name)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gint spikes = 0;
+
+  return_vals = gimp_run_procedure ("gimp-brush-get-spikes",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    spikes = return_vals[1].data.d_int32;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return spikes;
+}
+
+/**
+ * gimp_brush_set_spikes:
+ * @name: The brush name.
+ * @spikes_in: The desired number of spikes.
+ *
+ * Sets the number of spikes for a generated brush.
+ *
+ * This procedure sets the number of spikes for a generated brush. If
+ * called for any other type of brush, it does not succeed.
+ *
+ * Returns: The number of spikes actually assigned.
+ *
+ * Since: 2.4
+ **/
+gint
+gimp_brush_set_spikes (const gchar *name,
+                       gint         spikes_in)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gint spikes_out = 0;
+
+  return_vals = gimp_run_procedure ("gimp-brush-set-spikes",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_INT32, spikes_in,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    spikes_out = return_vals[1].data.d_int32;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return spikes_out;
+}
+
+/**
+ * gimp_brush_get_hardness:
+ * @name: The brush name.
+ *
+ * Gets the hardness of a generated brush.
+ *
+ * This procedure gets the hardness of a generated brush. The hardness
+ * of a brush is the amount its intensity fades at the outside edge, as
+ * a float between 0.0 and 1.0. If called for any other type of brush,
+ * the function does not succeed.
+ *
+ * Returns: The hardness of the brush.
+ *
+ * Since: 2.4
+ **/
+gdouble
+gimp_brush_get_hardness (const gchar *name)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gdouble hardness = 0.0;
+
+  return_vals = gimp_run_procedure ("gimp-brush-get-hardness",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    hardness = return_vals[1].data.d_float;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return hardness;
+}
+
+/**
+ * gimp_brush_set_hardness:
+ * @name: The brush name.
+ * @hardness_in: The desired brush hardness.
+ *
+ * Sets the hardness of a generated brush.
+ *
+ * This procedure sets the hardness for a generated brush. If called
+ * for any other type of brush, it does not succeed. The value should
+ * be a float between 0.0 and 1.0.
+ *
+ * Returns: The brush hardness actually assigned.
+ *
+ * Since: 2.4
+ **/
+gdouble
+gimp_brush_set_hardness (const gchar *name,
+                         gdouble      hardness_in)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gdouble hardness_out = 0.0;
+
+  return_vals = gimp_run_procedure ("gimp-brush-set-hardness",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_FLOAT, hardness_in,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    hardness_out = return_vals[1].data.d_float;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return hardness_out;
+}
+
+/**
+ * gimp_brush_get_aspect_ratio:
+ * @name: The brush name.
+ *
+ * Gets the aspect ratio of a generated brush.
+ *
+ * This procedure gets the aspect ratio of a generated brush. If called
+ * for any other type of brush, it does not succeed. The return value
+ * is a float between 0.0 and 1000.0.
+ *
+ * Returns: The aspect ratio of the brush.
+ *
+ * Since: 2.4
+ **/
+gdouble
+gimp_brush_get_aspect_ratio (const gchar *name)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gdouble aspect_ratio = 0.0;
+
+  return_vals = gimp_run_procedure ("gimp-brush-get-aspect-ratio",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    aspect_ratio = return_vals[1].data.d_float;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return aspect_ratio;
+}
+
+/**
+ * gimp_brush_set_aspect_ratio:
+ * @name: The brush name.
+ * @aspect_ratio_in: The desired brush aspect ratio.
+ *
+ * Sets the aspect ratio of a generated brush.
+ *
+ * This procedure sets the aspect ratio for a generated brush. If
+ * called for any other type of brush, it does not succeed. The value
+ * should be a float between 0.0 and 1000.0.
+ *
+ * Returns: The brush aspect ratio actually assigned.
+ *
+ * Since: 2.4
+ **/
+gdouble
+gimp_brush_set_aspect_ratio (const gchar *name,
+                             gdouble      aspect_ratio_in)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gdouble aspect_ratio_out = 0.0;
+
+  return_vals = gimp_run_procedure ("gimp-brush-set-aspect-ratio",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_FLOAT, aspect_ratio_in,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    aspect_ratio_out = return_vals[1].data.d_float;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return aspect_ratio_out;
+}
+
+/**
+ * gimp_brush_get_angle:
+ * @name: The brush name.
+ *
+ * Gets the rotation angle of a generated brush.
+ *
+ * This procedure gets the angle of rotation for a generated brush. If
+ * called for any other type of brush, it does not succeed.
+ *
+ * Returns: The rotation angle of the brush in degree.
+ *
+ * Since: 2.4
+ **/
+gdouble
+gimp_brush_get_angle (const gchar *name)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gdouble angle = 0.0;
+
+  return_vals = gimp_run_procedure ("gimp-brush-get-angle",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    angle = return_vals[1].data.d_float;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return angle;
+}
+
+/**
+ * gimp_brush_set_angle:
+ * @name: The brush name.
+ * @angle_in: The desired brush rotation angle in degree.
+ *
+ * Sets the rotation angle of a generated brush.
+ *
+ * This procedure sets the rotation angle for a generated brush. If
+ * called for any other type of brush, it does not succeed.
+ *
+ * Returns: The brush rotation angle actually assigned.
+ *
+ * Since: 2.4
+ **/
+gdouble
+gimp_brush_set_angle (const gchar *name,
+                      gdouble      angle_in)
+{
+  GimpParam *return_vals;
+  gint nreturn_vals;
+  gdouble angle_out = 0.0;
+
+  return_vals = gimp_run_procedure ("gimp-brush-set-angle",
+                                    &nreturn_vals,
+                                    GIMP_PDB_STRING, name,
+                                    GIMP_PDB_FLOAT, angle_in,
+                                    GIMP_PDB_END);
+
+  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
+    angle_out = return_vals[1].data.d_float;
+
+  gimp_destroy_params (return_vals, nreturn_vals);
+
+  return angle_out;
+}