## gimpbrushselect

gimpbrushselect — Functions providing a brush selection dialog.

## Synopsis

    void        (*GimpRunBrushCallback)         (const gchar *brush_name,
                                                 gdouble opacity,
                                                 gint spacing,
                                                 GimpLayerModeEffects paint_mode,
                                                 gint width,
                                                 gint height,
                                                 const guchar *mask_data,
                                                 gboolean dialog_closing,
                                                 gpointer user_data);
    const gchar* gimp_brush_select_new          (const gchar *title,
                                                 const gchar *brush_name,
                                                 gdouble opacity,
                                                 gint spacing,
                                                 GimpLayerModeEffects paint_mode,
                                                 GimpRunBrushCallback callback,
                                                 gpointer data);
    void        gimp_brush_select_destroy       (const gchar *brush_callback);
    gboolean    gimp_brushes_popup              (const gchar *brush_callback,
                                                 const gchar *popup_title,
                                                 const gchar *initial_brush,
                                                 gdouble opacity,
                                                 gint spacing,
                                                 GimpLayerModeEffects paint_mode);
    gboolean    gimp_brushes_close_popup        (const gchar *brush_callback);
    gboolean    gimp_brushes_set_popup          (const gchar *brush_callback,
                                                 const gchar *brush_name,
                                                 gdouble opacity,
                                                 gint spacing,
                                                 GimpLayerModeEffects paint_mode);

## Description

Functions providing a brush selection dialog.

## Details

### GimpRunBrushCallback ()

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

`brush_name` : |
`opacity` : |
`spacing` : |
`paint_mode` : |
`width` : |
`height` : |
`mask_data` : |
`dialog_closing` : |
`user_data` : |

### gimp_brush_select_new ()

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

`title` : |
`brush_name` : |
`opacity` : |
`spacing` : |
`paint_mode` : |
`callback` : |
`data` : |
Returns : |

### gimp_brush_select_destroy ()

    void        gimp_brush_select_destroy       (const gchar *brush_callback);

`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,
                                                 GimpLayerModeEffects paint_mode);

Invokes the Gimp brush selection.

This procedure popups the brush selection dialog.

`brush_callback` : | The callback PDB proc to call when brush selection is made.
`popup_title` : | Title to give the brush popup window.
`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);

Popdown the Gimp brush selection.

This procedure closes an opened brush selection dialog.

`brush_callback` : | The name of the callback registered for this popup.
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,
                                                 GimpLayerModeEffects paint_mode);

Sets the current brush selection in a popup.

Sets the current brush selection in a popup.

`brush_callback` : | The name of the callback registered for this popup.
`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.