mirror of https://github.com/GNOME/gimp.git
1058 lines
29 KiB
C
1058 lines
29 KiB
C
/* 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 "stamp-pdbgen.h"
|
|
|
|
#include "gimp.h"
|
|
|
|
|
|
/**
|
|
* SECTION: gimpbrush
|
|
* @title: gimpbrush
|
|
* @short_description: Installable object used by painting and stroking tools.
|
|
*
|
|
* Installable object used by painting and stroking tools.
|
|
**/
|
|
|
|
|
|
/**
|
|
* gimp_brush_new:
|
|
* @name: The requested name of the new brush.
|
|
*
|
|
* Create a new generated brush having default parameters.
|
|
*
|
|
* Creates a new, parametric brush.
|
|
*
|
|
* Returns: (transfer full): The brush.
|
|
*
|
|
* Since: 2.2
|
|
**/
|
|
GimpBrush *
|
|
gimp_brush_new (const gchar *name)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
GimpBrush *brush = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
G_TYPE_STRING, name,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-new",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
brush = GIMP_VALUES_GET_BRUSH (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return brush;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_duplicate:
|
|
* @brush: The brush.
|
|
*
|
|
* Duplicates a brush.
|
|
*
|
|
* Returns a copy having a different, unique ID.
|
|
*
|
|
* Returns: (transfer full): A copy of the brush.
|
|
*
|
|
* Since: 2.2
|
|
**/
|
|
GimpBrush *
|
|
gimp_brush_duplicate (GimpBrush *brush)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
GimpBrush *brush_copy = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-duplicate",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
brush_copy = GIMP_VALUES_GET_BRUSH (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return brush_copy;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_is_generated:
|
|
* @brush: The brush.
|
|
*
|
|
* Whether the brush is generated (parametric versus raster).
|
|
*
|
|
* Returns TRUE when brush is parametric.
|
|
*
|
|
* Returns: TRUE if the brush is generated.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_brush_is_generated (GimpBrush *brush)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean generated = FALSE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-is-generated",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
generated = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return generated;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_id_is_valid:
|
|
* @id: The brush ID.
|
|
*
|
|
* Whether the ID is a valid reference to installed brush data.
|
|
*
|
|
* Returns TRUE when ID is valid.
|
|
*
|
|
* Returns: TRUE if the brush ID is valid.
|
|
*
|
|
* Since: 3.0
|
|
**/
|
|
gboolean
|
|
gimp_brush_id_is_valid (const gchar *id)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean valid = FALSE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
G_TYPE_STRING, id,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-id-is-valid",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
valid = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return valid;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_rename:
|
|
* @brush: The brush.
|
|
* @new_name: The proposed new name of the brush.
|
|
*
|
|
* Renames a brush. When the name is in use, renames to a unique name.
|
|
*
|
|
* Renames a brush. The name is the same as the ID. When the proposed
|
|
* name is already used, GIMP generates a unique name, which get_id()
|
|
* will return.
|
|
* Returns a reference to a renamed brush, which you should assign to
|
|
* the original var or a differently named var. Any existing references
|
|
* will be invalid. Resources in plugins are proxies holding an ID,
|
|
* which can be invalid when the resource is renamed.
|
|
*
|
|
* Returns: (transfer full): A reference to the renamed brush.
|
|
*
|
|
* Since: 2.2
|
|
**/
|
|
GimpBrush *
|
|
gimp_brush_rename (GimpBrush *brush,
|
|
const gchar *new_name)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
GimpBrush *brush_renamed = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_STRING, new_name,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-rename",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
brush_renamed = GIMP_VALUES_GET_BRUSH (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return brush_renamed;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_delete:
|
|
* @brush: The brush.
|
|
*
|
|
* Deletes a brush.
|
|
*
|
|
* Deletes a brush. Returns an error if the brush is not deletable.
|
|
* Deletes the brush's data. You should not use the brush afterwards.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.2
|
|
**/
|
|
gboolean
|
|
gimp_brush_delete (GimpBrush *brush)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-delete",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_is_editable:
|
|
* @brush: The brush.
|
|
*
|
|
* Whether the 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 (GimpBrush *brush)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean editable = FALSE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-is-editable",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
editable = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return editable;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_get_info:
|
|
* @brush: The brush.
|
|
* @width: (out): The brush width.
|
|
* @height: (out): The brush height.
|
|
* @mask_bpp: (out): The brush mask bpp.
|
|
* @color_bpp: (out): The brush color bpp.
|
|
*
|
|
* Gets information about the brush.
|
|
*
|
|
* Gets information about the brush: brush extents (width and height),
|
|
* color depth and mask depth (bpp). The color bpp is zero when the
|
|
* brush is parametric versus raster.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.2
|
|
**/
|
|
gboolean
|
|
gimp_brush_get_info (GimpBrush *brush,
|
|
gint *width,
|
|
gint *height,
|
|
gint *mask_bpp,
|
|
gint *color_bpp)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-get-info",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
*width = 0;
|
|
*height = 0;
|
|
*mask_bpp = 0;
|
|
*color_bpp = 0;
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
{
|
|
*width = GIMP_VALUES_GET_INT (return_vals, 1);
|
|
*height = GIMP_VALUES_GET_INT (return_vals, 2);
|
|
*mask_bpp = GIMP_VALUES_GET_INT (return_vals, 3);
|
|
*color_bpp = GIMP_VALUES_GET_INT (return_vals, 4);
|
|
}
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_get_pixels:
|
|
* @brush: The brush.
|
|
* @width: (out): The brush width.
|
|
* @height: (out): The brush height.
|
|
* @mask_bpp: (out): The brush mask bpp.
|
|
* @num_mask_bytes: (out): Length of brush mask data.
|
|
* @mask_bytes: (out) (array length=num_mask_bytes) (element-type guint8) (transfer full): The brush mask data.
|
|
* @color_bpp: (out): The brush color bpp.
|
|
* @num_color_bytes: (out): Length of brush color data.
|
|
* @color_bytes: (out) (array length=num_color_bytes) (element-type guint8) (transfer full): The brush color data.
|
|
*
|
|
* Gets information about the brush.
|
|
*
|
|
* Gets information about the brush: the brush extents (width and
|
|
* height) and its pixels data. The color bpp is zero and pixels empty
|
|
* when the brush is parametric versus raster.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.2
|
|
**/
|
|
gboolean
|
|
gimp_brush_get_pixels (GimpBrush *brush,
|
|
gint *width,
|
|
gint *height,
|
|
gint *mask_bpp,
|
|
gint *num_mask_bytes,
|
|
guint8 **mask_bytes,
|
|
gint *color_bpp,
|
|
gint *num_color_bytes,
|
|
guint8 **color_bytes)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-get-pixels",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
*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 = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
{
|
|
*width = GIMP_VALUES_GET_INT (return_vals, 1);
|
|
*height = GIMP_VALUES_GET_INT (return_vals, 2);
|
|
*mask_bpp = GIMP_VALUES_GET_INT (return_vals, 3);
|
|
*num_mask_bytes = GIMP_VALUES_GET_INT (return_vals, 4);
|
|
*mask_bytes = GIMP_VALUES_DUP_UINT8_ARRAY (return_vals, 5);
|
|
*color_bpp = GIMP_VALUES_GET_INT (return_vals, 6);
|
|
*num_color_bytes = GIMP_VALUES_GET_INT (return_vals, 7);
|
|
*color_bytes = GIMP_VALUES_DUP_UINT8_ARRAY (return_vals, 8);
|
|
}
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_get_spacing:
|
|
* @brush: The brush.
|
|
*
|
|
* Gets the brush spacing, the stamping frequency.
|
|
*
|
|
* Returns the spacing setting for the brush. Spacing is an integer
|
|
* between 0 and 1000 which represents a percentage of the maximum of
|
|
* the width and height of the mask. Both parametric and raster brushes
|
|
* have a spacing.
|
|
*
|
|
* Returns: The brush spacing.
|
|
*
|
|
* Since: 2.2
|
|
**/
|
|
gint
|
|
gimp_brush_get_spacing (GimpBrush *brush)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gint spacing = 0;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-get-spacing",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
spacing = GIMP_VALUES_GET_INT (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return spacing;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_set_spacing:
|
|
* @brush: The brush.
|
|
* @spacing: The brush spacing.
|
|
*
|
|
* Sets the brush spacing.
|
|
*
|
|
* Set the spacing for the brush. The spacing must be an integer
|
|
* between 0 and 1000. Both parametric and raster brushes have a
|
|
* spacing. Returns an error when the brush is not editable. Create a
|
|
* new or copied brush or to get an editable brush.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_brush_set_spacing (GimpBrush *brush,
|
|
gint spacing)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_INT, spacing,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-set-spacing",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_get_shape:
|
|
* @brush: The brush.
|
|
* @shape: (out): The brush shape.
|
|
*
|
|
* Gets the shape of a generated brush.
|
|
*
|
|
* Gets the shape of a generated brush. Returns an error when called
|
|
* for a non-parametric brush. The choices for shape are Circle
|
|
* (GIMP_BRUSH_GENERATED_CIRCLE), Square (GIMP_BRUSH_GENERATED_SQUARE),
|
|
* and Diamond (GIMP_BRUSH_GENERATED_DIAMOND). Other shapes might be
|
|
* added in the future.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_brush_get_shape (GimpBrush *brush,
|
|
GimpBrushGeneratedShape *shape)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-get-shape",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
*shape = 0;
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
*shape = GIMP_VALUES_GET_ENUM (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_set_shape:
|
|
* @brush: The brush.
|
|
* @shape_in: The brush shape.
|
|
* @shape_out: (out): The brush shape actually assigned.
|
|
*
|
|
* Sets the shape of a generated brush.
|
|
*
|
|
* Sets the shape of a generated brush. Returns an error when brush is
|
|
* non-parametric or not editable. The choices for shape are Circle
|
|
* (GIMP_BRUSH_GENERATED_CIRCLE), Square (GIMP_BRUSH_GENERATED_SQUARE),
|
|
* and Diamond (GIMP_BRUSH_GENERATED_DIAMOND).
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_brush_set_shape (GimpBrush *brush,
|
|
GimpBrushGeneratedShape shape_in,
|
|
GimpBrushGeneratedShape *shape_out)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
GIMP_TYPE_BRUSH_GENERATED_SHAPE, shape_in,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-set-shape",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
*shape_out = 0;
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
*shape_out = GIMP_VALUES_GET_ENUM (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_get_radius:
|
|
* @brush: The brush.
|
|
* @radius: (out): The radius of the brush in pixels.
|
|
*
|
|
* Gets the radius of a generated brush.
|
|
*
|
|
* Gets the radius of a generated brush. Returns an error when called
|
|
* for a non-parametric brush.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_brush_get_radius (GimpBrush *brush,
|
|
gdouble *radius)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-get-radius",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
*radius = 0.0;
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
*radius = GIMP_VALUES_GET_DOUBLE (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_set_radius:
|
|
* @brush: The brush.
|
|
* @radius_in: The desired brush radius in pixel.
|
|
* @radius_out: (out): The brush radius actually assigned.
|
|
*
|
|
* Sets the radius of a generated brush.
|
|
*
|
|
* Sets the radius for a generated brush. Clamps radius to [0.0,
|
|
* 32767.0]. Returns the clamped value. Returns an error when brush is
|
|
* non-parametric or not editable.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_brush_set_radius (GimpBrush *brush,
|
|
gdouble radius_in,
|
|
gdouble *radius_out)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_DOUBLE, radius_in,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-set-radius",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
*radius_out = 0.0;
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
*radius_out = GIMP_VALUES_GET_DOUBLE (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_get_spikes:
|
|
* @brush: The brush.
|
|
* @spikes: (out): The number of spikes on the brush.
|
|
*
|
|
* Gets the number of spikes for a generated brush.
|
|
*
|
|
* Gets the number of spikes for a generated brush. Returns an error
|
|
* when called for a non-parametric brush.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_brush_get_spikes (GimpBrush *brush,
|
|
gint *spikes)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-get-spikes",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
*spikes = 0;
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
*spikes = GIMP_VALUES_GET_INT (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_set_spikes:
|
|
* @brush: The brush.
|
|
* @spikes_in: The desired number of spikes.
|
|
* @spikes_out: (out): The number of spikes actually assigned.
|
|
*
|
|
* Sets the number of spikes for a generated brush.
|
|
*
|
|
* Sets the number of spikes for a generated brush. Clamps spikes to
|
|
* [2,20]. Returns the clamped value. Returns an error when brush is
|
|
* non-parametric or not editable.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_brush_set_spikes (GimpBrush *brush,
|
|
gint spikes_in,
|
|
gint *spikes_out)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_INT, spikes_in,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-set-spikes",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
*spikes_out = 0;
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
*spikes_out = GIMP_VALUES_GET_INT (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_get_hardness:
|
|
* @brush: The brush.
|
|
* @hardness: (out): The hardness of the brush.
|
|
*
|
|
* Gets the hardness of a generated brush.
|
|
*
|
|
* 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. Returns an error when called for a
|
|
* non-parametric brush.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_brush_get_hardness (GimpBrush *brush,
|
|
gdouble *hardness)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-get-hardness",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
*hardness = 0.0;
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
*hardness = GIMP_VALUES_GET_DOUBLE (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_set_hardness:
|
|
* @brush: The brush.
|
|
* @hardness_in: The desired brush hardness.
|
|
* @hardness_out: (out): The brush hardness actually assigned.
|
|
*
|
|
* Sets the hardness of a generated brush.
|
|
*
|
|
* Sets the hardness for a generated brush. Clamps hardness to [0.0,
|
|
* 1.0]. Returns the clamped value. Returns an error when brush is
|
|
* non-parametric or not editable.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_brush_set_hardness (GimpBrush *brush,
|
|
gdouble hardness_in,
|
|
gdouble *hardness_out)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_DOUBLE, hardness_in,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-set-hardness",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
*hardness_out = 0.0;
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
*hardness_out = GIMP_VALUES_GET_DOUBLE (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_get_aspect_ratio:
|
|
* @brush: The brush.
|
|
* @aspect_ratio: (out): The aspect ratio of the brush.
|
|
*
|
|
* Gets the aspect ratio of a generated brush.
|
|
*
|
|
* Gets the aspect ratio of a generated brush. Returns an error when
|
|
* called for a non-parametric brush. The aspect ratio is a float
|
|
* between 0.0 and 1000.0.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_brush_get_aspect_ratio (GimpBrush *brush,
|
|
gdouble *aspect_ratio)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-get-aspect-ratio",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
*aspect_ratio = 0.0;
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
*aspect_ratio = GIMP_VALUES_GET_DOUBLE (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_set_aspect_ratio:
|
|
* @brush: The brush.
|
|
* @aspect_ratio_in: The desired brush aspect ratio.
|
|
* @aspect_ratio_out: (out): The brush aspect ratio actually assigned.
|
|
*
|
|
* Sets the aspect ratio of a generated brush.
|
|
*
|
|
* Sets the aspect ratio for a generated brush. Clamps aspect ratio to
|
|
* [0.0, 1000.0]. Returns the clamped value. Returns an error when
|
|
* brush is non-parametric or not editable.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_brush_set_aspect_ratio (GimpBrush *brush,
|
|
gdouble aspect_ratio_in,
|
|
gdouble *aspect_ratio_out)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_DOUBLE, aspect_ratio_in,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-set-aspect-ratio",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
*aspect_ratio_out = 0.0;
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
*aspect_ratio_out = GIMP_VALUES_GET_DOUBLE (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_get_angle:
|
|
* @brush: The brush.
|
|
* @angle: (out): The rotation angle of the brush in degree.
|
|
*
|
|
* Gets the rotation angle of a generated brush.
|
|
*
|
|
* Gets the angle of rotation for a generated brush. Returns an error
|
|
* when called for a non-parametric brush.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_brush_get_angle (GimpBrush *brush,
|
|
gdouble *angle)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-get-angle",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
*angle = 0.0;
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
*angle = GIMP_VALUES_GET_DOUBLE (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_brush_set_angle:
|
|
* @brush: The brush.
|
|
* @angle_in: The desired brush rotation angle in degrees.
|
|
* @angle_out: (out): The brush rotation angle actually assigned.
|
|
*
|
|
* Sets the rotation angle of a generated brush.
|
|
*
|
|
* Sets the rotation angle for a generated brush. Sets the angle modulo
|
|
* 180, in the range [-180.0, 180.0]. Returns the clamped value.
|
|
* Returns an error when brush is non-parametric or not editable.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gimp_brush_set_angle (GimpBrush *brush,
|
|
gdouble angle_in,
|
|
gdouble *angle_out)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean success = TRUE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_BRUSH, brush,
|
|
G_TYPE_DOUBLE, angle_in,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-brush-set-angle",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
*angle_out = 0.0;
|
|
|
|
success = GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS;
|
|
|
|
if (success)
|
|
*angle_out = GIMP_VALUES_GET_DOUBLE (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return success;
|
|
}
|