![]() |
![]() |
![]() |
GIMP Library Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
gchar* gimp_brush_new (const gchar *name); gchar* gimp_brush_duplicate (const gchar *name); gchar* gimp_brush_rename (const gchar *name, const gchar *new_name); gboolean gimp_brush_delete (const gchar *name); gboolean gimp_brush_get_info (const gchar *name, gint *width, gint *height, gint *mask_bpp, gint *color_bpp); 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); gboolean gimp_brush_get_spacing (const gchar *name, gint *spacing); gboolean gimp_brush_set_spacing (const gchar *name, gint spacing); GimpBrushGeneratedShape gimp_brush_get_shape (const gchar *name); GimpBrushGeneratedShape gimp_brush_set_shape (const gchar *name, GimpBrushGeneratedShape shape_in); gint gimp_brush_get_spikes (const gchar *name); gint gimp_brush_set_spikes (const gchar *name, gint spikes_in); gdouble gimp_brush_get_angle (const gchar *name); gdouble gimp_brush_set_angle (const gchar *name, gdouble angle_in); gdouble gimp_brush_get_radius (const gchar *name); gdouble gimp_brush_set_radius (const gchar *name, gdouble radius_in); gdouble gimp_brush_get_aspect_ratio (const gchar *name); gdouble gimp_brush_set_aspect_ratio (const gchar *name, gdouble aspect_ratio_in); gdouble gimp_brush_get_hardness (const gchar *name); gdouble gimp_brush_set_hardness (const gchar *name, gdouble hardness_in); gboolean gimp_brush_is_generated (const gchar *name); gboolean gimp_brush_is_editable (const gchar *name);
gchar* gimp_brush_new (const gchar *name);
Creates a new brush
This procedure creates a new, uninitialized brush
|
The requested name of the new brush. |
Returns : |
The actual new brush name. |
Since GIMP 2.2
gchar* gimp_brush_duplicate (const gchar *name);
Duplicates a brush
This procedure creates an identical brush by a different name
|
The brush name. |
Returns : |
The name of the brush's copy. |
Since GIMP 2.2
gchar* gimp_brush_rename (const gchar *name, const gchar *new_name);
Rename a brush
This procedure renames a brush
|
The brush name. |
|
The new name of the brush. |
Returns : |
The actual new name of the brush. |
Since GIMP 2.2
gboolean gimp_brush_delete (const gchar *name);
Deletes a brush
This procedure deletes a brush
|
The brush name. |
Returns : |
TRUE on success. |
Since GIMP 2.2
gboolean gimp_brush_get_info (const gchar *name, gint *width, gint *height, gint *mask_bpp, gint *color_bpp);
Retrieve information about the specified brush.
This procedure retrieves information about the specified brush. This includes the brush name, and the brush extents (width and height).
|
The brush name. |
|
The brush width. |
|
The brush height. |
|
The brush mask bpp. |
|
The brush color bpp. |
Returns : |
TRUE on success. |
Since GIMP 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);
Retrieve 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.
|
The brush name. |
|
The brush width. |
|
The brush height. |
|
The brush mask bpp. |
|
Length of brush mask data. |
|
The brush mask data. |
|
The brush color bpp. |
|
Length of brush color data. |
|
The brush color data. |
Returns : |
TRUE on success. |
Since GIMP 2.2
gboolean gimp_brush_get_spacing (const gchar *name, gint *spacing);
Get 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.
|
The brush name. |
|
The brush spacing. |
Returns : |
TRUE on success. |
Since GIMP 2.2
gboolean gimp_brush_set_spacing (const gchar *name, gint spacing);
Set the brush spacing.
This procedure modifies the spacing setting for the specified brush. The value should be a integer between 0 and 1000.
|
The brush name. |
|
The brush spacing. |
Returns : |
TRUE on success. |
Since GIMP 2.4
GimpBrushGeneratedShape gimp_brush_get_shape (const gchar *name);
Get 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.
|
The brush name. |
Returns : |
The brush shape. |
Since GIMP 2.4
GimpBrushGeneratedShape gimp_brush_set_shape (const gchar *name, GimpBrushGeneratedShape shape_in);
Set 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.
|
The brush name. |
|
The brush shape. |
Returns : |
The brush shape actually assigned. |
Since GIMP 2.4
gint gimp_brush_get_spikes (const gchar *name);
Get 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.
|
The brush name. |
Returns : |
The number of spikes on the brush. |
Since GIMP 2.4
gint gimp_brush_set_spikes (const gchar *name, gint spikes_in);
Set 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.
|
The brush name. |
|
The desired number of spikes. |
Returns : |
The number of spikes actually assigned. |
Since GIMP 2.4
gdouble gimp_brush_get_angle (const gchar *name);
Get 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.
|
The brush name. |
Returns : |
The rotation angle of the brush. |
Since GIMP 2.4
gdouble gimp_brush_set_angle (const gchar *name, gdouble angle_in);
Set 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.
|
The brush name. |
|
The desired brush rotation angle. |
Returns : |
The brush rotation angle actually assigned. |
Since GIMP 2.4
gdouble gimp_brush_get_radius (const gchar *name);
Get 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.
|
The brush name. |
Returns : |
The radius of the brush in pixels. |
Since GIMP 2.4
gdouble gimp_brush_set_radius (const gchar *name, gdouble radius_in);
Set 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.
|
The brush name. |
|
The desired brush radius. |
Returns : |
The brush radius actually assigned. |
Since GIMP 2.4
gdouble gimp_brush_get_aspect_ratio (const gchar *name);
Get 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 brush name. |
Returns : |
The aspect ratio of the brush. |
Since GIMP 2.4
gdouble gimp_brush_set_aspect_ratio (const gchar *name, gdouble aspect_ratio_in);
Set 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 brush name. |
|
The desired brush aspect ratio. |
Returns : |
The brush aspect ratio actually assigned. |
Since GIMP 2.4
gdouble gimp_brush_get_hardness (const gchar *name);
Get 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. If called for any other type of brush, the function does not succeed.
|
The brush name. |
Returns : |
The hardness of the brush. |
Since GIMP 2.4
gdouble gimp_brush_set_hardness (const gchar *name, gdouble hardness_in);
Set 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 brush name. |
|
The desired brush hardness. |
Returns : |
The brush hardness actually assigned. |
Since GIMP 2.4
gboolean gimp_brush_is_generated (const gchar *name);
Tests if brush is generated
Returns TRUE if this brush is parametric, FALSE for other types
|
The brush name. |
Returns : |
TRUE if the brush is generated. |
Since GIMP 2.4