gimpbrushselect

gimpbrushselect — Functions providing a brush selection dialog.

Functions

Description

Functions providing a brush selection dialog.

Functions

GimpRunBrushCallback ()

void
(*GimpRunBrushCallback) (const gchar *brush_name,
                         gdouble opacity,
                         gint spacing,
                         GimpLayerMode paint_mode,
                         gint width,
                         gint height,
                         const guchar *mask_data,
                         gboolean dialog_closing,
                         gpointer user_data);

Parameters

brush_name

Name of the brush

 

opacity

Opacity

 

spacing

Spacing

 

paint_mode

Paint mode

 

width

width

 

height

height

 

mask_data

Mask data.

[array]

dialog_closing

Dialog closing?

 

user_data

user data.

[closure]

gimp_brush_select_new ()

const gchar *
gimp_brush_select_new (const gchar *title,
                       const gchar *brush_name,
                       gdouble opacity,
                       gint spacing,
                       GimpLayerMode paint_mode,
                       GimpRunBrushCallback callback,
                       gpointer data,
                       GDestroyNotify data_destroy);

Invokes a brush selection dialog then run callback with the selected brush, various settings and user's data .

Parameters

title

Title of the brush selection dialog.

 

brush_name

The name of the brush to set as the first selected.

 

opacity

The initial opacity of the brush.

 

spacing

The initial spacing of the brush (if < 0 then use brush default spacing).

 

paint_mode

The initial paint mode.

 

callback

The callback function to call each time a settings change.

[scope notified]

data

the run_data given to callback .

[closure callback]

data_destroy

the destroy function for data .

[destroy data]

Returns

the name of a temporary PDB procedure. The string belongs to the brush selection dialog and will be freed automatically when the dialog is closed.

[transfer none]


gimp_brush_select_destroy ()

void
gimp_brush_select_destroy (const gchar *brush_callback);

gimp_brushes_popup ()

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

Invokes the Gimp brush selection.

This procedure opens the brush selection dialog.

Parameters

brush_callback

The callback PDB proc to call when brush selection is made.

 

popup_title

Title of the brush selection dialog.

 

initial_brush

The name of the brush to set as the first selected.

 

opacity

The initial opacity of the brush.

 

spacing

The initial spacing of the brush (if < 0 then use brush default spacing).

 

paint_mode

The initial paint mode.

 

Returns

TRUE on success.


gimp_brushes_close_popup ()

gboolean
gimp_brushes_close_popup (const gchar *brush_callback);

Close the brush selection dialog.

This procedure closes an opened brush selection dialog.

Parameters

brush_callback

The name of the callback registered for this pop-up.

 

Returns

TRUE on success.


gimp_brushes_set_popup ()

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

Sets the current brush in a brush selection dialog.

Sets the current brush in a brush selection dialog.

Parameters

brush_callback

The name of the callback registered for this pop-up.

 

brush_name

The name of the brush to set as selected.

 

opacity

The initial opacity of the brush.

 

spacing

The initial spacing of the brush (if < 0 then use brush default spacing).

 

paint_mode

The initial paint mode.

 

Returns

TRUE on success.