## 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.