Gimp.brush_select_new
Description: Reference for Gimp.brush_select_new

### Function

# Gimpbrush_select_new

#### Declaration [src]

    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
    )

#### Description [src]

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

#### Parameters

`title`

  Type: `const gchar*`

  Title of the brush selection dialog.

  The data is owned by the caller of the function.
  The value is a NUL terminated UTF-8 string.

`brush_name`

  Type: `const gchar*`

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

  The data is owned by the caller of the function.
  The value is a NUL terminated UTF-8 string.

`opacity`

  Type: `gdouble`

  The initial opacity of the brush.

`spacing`

  Type: `gint`

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

`paint_mode`

  Type: `GimpLayerMode`

  The initial paint mode.

`callback`

  Type: `GimpRunBrushCallback`

  The callback function to call each time a settings change.

  The argument can be `NULL`.

`data`

  Type: `gpointer`

  The run_data given to `callback`.

  The argument can be `NULL`.
  The data is owned by the caller of the function.

`data_destroy`

  Type: `GDestroyNotify`

  The destroy function for `data`.

#### Return value

Type: `const gchar*`

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.

The data is owned by the called function.
The value is a NUL terminated UTF-8 string.