gimpbrushes

Name

gimpbrushes -- 

Synopsis



gboolean    gimp_brushes_refresh            (void);
gchar**     gimp_brushes_get_list           (gint *num_brushes);
gchar*      gimp_brushes_get_brush          (gint *width,
                                             gint *height,
                                             gint *spacing);
gboolean    gimp_brushes_set_brush          (gchar *name);
gdouble     gimp_brushes_get_opacity        (void);
gboolean    gimp_brushes_set_opacity        (gdouble opacity);
GimpLayerModeEffects gimp_brushes_get_paint_mode
                                            (void);
gboolean    gimp_brushes_set_paint_mode     (GimpLayerModeEffects paint_mode);
gint        gimp_brushes_get_spacing        (void);
gboolean    gimp_brushes_set_spacing        (gint spacing);
gchar*      gimp_brushes_get_brush_data     (gchar *name,
                                             gdouble *opacity,
                                             gint *spacing,
                                             GimpLayerModeEffects *paint_mode,
                                             gint *width,
                                             gint *height,
                                             gint *length,
                                             guint8 **mask_data);
gboolean    gimp_brushes_popup              (gchar *brush_callback,
                                             gchar *popup_title,
                                             gchar *initial_brush,
                                             gdouble opacity,
                                             gint spacing,
                                             GimpLayerModeEffects paint_mode);
gboolean    gimp_brushes_close_popup        (gchar *brush_callback);
gboolean    gimp_brushes_set_popup          (gchar *brush_callback,
                                             gchar *brush_name,
                                             gdouble opacity,
                                             gint spacing,
                                             GimpLayerModeEffects paint_mode);

Description

Details

gimp_brushes_refresh ()

gboolean    gimp_brushes_refresh            (void);

Refresh current brushes.

This procedure retrieves all brushes currently in the user's brush path and updates the brush dialog accordingly.


gimp_brushes_get_list ()

gchar**     gimp_brushes_get_list           (gint *num_brushes);

Retrieve a complete listing of the available brushes.

This procedure returns a complete listing of available GIMP brushes. Each name returned can be used as input to the 'gimp_brushes_set_brush'.


gimp_brushes_get_brush ()

gchar*      gimp_brushes_get_brush          (gint *width,
                                             gint *height,
                                             gint *spacing);

Retrieve information about the currently active brush mask.

This procedure retrieves information about the currently active brush mask. This includes the brush name, the width and height, and the brush spacing paramter. All paint operations and stroke operations use this mask to control the application of paint to the image.


gimp_brushes_set_brush ()

gboolean    gimp_brushes_set_brush          (gchar *name);

Set the specified brush as the active brush.

This procedure allows the active brush mask to be set by specifying its name. The name is simply a string which corresponds to one of the names of the installed brushes. If there is no matching brush found, this procedure will return an error. Otherwise, the specified brush becomes active and will be used in all subsequent paint operations.


gimp_brushes_get_opacity ()

gdouble     gimp_brushes_get_opacity        (void);

Get the brush opacity.

This procedure returns the opacity setting for brushes. This value is set globally and will remain the same even if the brush mask is changed. The return value is a floating point number between 0 and 100.


gimp_brushes_set_opacity ()

gboolean    gimp_brushes_set_opacity        (gdouble opacity);

Set the brush opacity.

This procedure modifies the opacity setting for brushes. This value is set globally and will remain the same even if the brush mask is changed. The value should be a floating point number between 0 and 100.


gimp_brushes_get_paint_mode ()

GimpLayerModeEffects gimp_brushes_get_paint_mode
                                            (void);

Get the brush paint mode.

This procedure returns the paint-mode setting for brushes. This value is set globally and will not change if a different brush is selected. The return value is an integer which corresponds to the values listed in the argument description.


gimp_brushes_set_paint_mode ()

gboolean    gimp_brushes_set_paint_mode     (GimpLayerModeEffects paint_mode);

Set the brush paint mode.

This procedure modifies the paint_mode setting for the current brush. This value is set globally and will not change if a different brush mask is selected.


gimp_brushes_get_spacing ()

gint        gimp_brushes_get_spacing        (void);

Get the brush spacing.

This procedure returns the spacing setting for brushes. This value is set per brush and will change if a different brush is selected. The return value is an integer between 0 and 1000 which represents percentage of the maximum of the width and height of the mask.


gimp_brushes_set_spacing ()

gboolean    gimp_brushes_set_spacing        (gint spacing);

Set the brush spacing.

This procedure modifies the spacing setting for the current brush. This value is set on a per-brush basis and will change if a different brush mask is selected. The value should be a integer between 0 and 1000.


gimp_brushes_get_brush_data ()

gchar*      gimp_brushes_get_brush_data     (gchar *name,
                                             gdouble *opacity,
                                             gint *spacing,
                                             GimpLayerModeEffects *paint_mode,
                                             gint *width,
                                             gint *height,
                                             gint *length,
                                             guint8 **mask_data);

Retrieve information about the currently active brush (including data).

This procedure retrieves information about the currently active brush. This includes the brush name, and the brush extents (width and height). It also returns the brush data.


gimp_brushes_popup ()

gboolean    gimp_brushes_popup              (gchar *brush_callback,
                                             gchar *popup_title,
                                             gchar *initial_brush,
                                             gdouble opacity,
                                             gint spacing,
                                             GimpLayerModeEffects paint_mode);

Invokes the Gimp brush selection.

This procedure popups the brush selection dialog.


gimp_brushes_close_popup ()

gboolean    gimp_brushes_close_popup        (gchar *brush_callback);

Popdown the Gimp brush selection.

This procedure closes an opened brush selection dialog.


gimp_brushes_set_popup ()

gboolean    gimp_brushes_set_popup          (gchar *brush_callback,
                                             gchar *brush_name,
                                             gdouble opacity,
                                             gint spacing,
                                             GimpLayerModeEffects paint_mode);

Sets the current brush selection in a popup.

Sets the current brush selection in a popup.