summaryrefslogtreecommitdiffstats
path: root/libgimp/gimpbrush_pdb.c
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 18:30:19 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 18:30:19 +0000
commit5c1676dfe6d2f3c837a5e074117b45613fd29a72 (patch)
treecbffb45144febf451e54061db2b21395faf94bfe /libgimp/gimpbrush_pdb.c
parentInitial commit. (diff)
downloadgimp-5c1676dfe6d2f3c837a5e074117b45613fd29a72.tar.xz
gimp-5c1676dfe6d2f3c837a5e074117b45613fd29a72.zip
Adding upstream version 2.10.34.upstream/2.10.34upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
-rw-r--r--libgimp/gimpbrush_pdb.c864
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;
+}