## gimpbrushmenu

gimpbrushmenu — A widget for selecting brushes.

## Synopsis

    GtkWidget*  gimp_brush_select_widget_new    (const gchar *title,
                                                 const gchar *brush_name,
                                                 gdouble opacity,
                                                 gint spacing,
                                                 GimpLayerModeEffects paint_mode,
                                                 GimpRunBrushCallback callback,
                                                 gpointer data);
    void        gimp_brush_select_widget_close  (GtkWidget *widget);
    void        gimp_brush_select_widget_set    (GtkWidget *widget,
                                                 const gchar *brush_name,
                                                 gdouble opacity,
                                                 gint spacing,
                                                 GimpLayerModeEffects paint_mode);

## Description

A widget for selecting brushes.

## Details

### gimp_brush_select_widget_new ()

    GtkWidget*  gimp_brush_select_widget_new    (const gchar *title,
                                                 const gchar *brush_name,
                                                 gdouble opacity,
                                                 gint spacing,
                                                 GimpLayerModeEffects paint_mode,
                                                 GimpRunBrushCallback callback,
                                                 gpointer data);

Creates a new GtkWidget that completely controls the selection of a GimpBrush. This widget is suitable for placement in a table in a plug-in dialog.

`title` : | Title of the dialog to use or `NULL` to use the default title.
`brush_name` : | Initial brush name or `NULL` to use current selection.
`opacity` : | Initial opacity. -1 means to use current opacity.
`spacing` : | Initial spacing. -1 means to use current spacing.
`paint_mode` : | Initial paint mode. -1 means to use current paint mode.
`callback` : | A function to call when the selected brush changes.
`data` : | A pointer to arbitary data to be used in the call to `callback`.
Returns : | A GtkWidget that you can use in your UI.

### gimp_brush_select_widget_close ()

    void        gimp_brush_select_widget_close  (GtkWidget *widget);

Closes the popup window associated with `widget`.

`widget` : | A brush select widget.

### gimp_brush_select_widget_set ()

    void        gimp_brush_select_widget_set    (GtkWidget *widget,
                                                 const gchar *brush_name,
                                                 gdouble opacity,
                                                 gint spacing,
                                                 GimpLayerModeEffects paint_mode);

Sets the current brush and other values for the brush select widget. Calls the callback function if one was supplied in the call to `gimp_brush_select_widget_new()`.

`widget` : | A brush select widget.
`brush_name` : | Brush name to set; `NULL` means no change.
`opacity` : | Opacity to set. -1 means no change.
`spacing` : | Spacing to set. -1 means no change.
`paint_mode` : | Paint mode to set. -1 means no change.