### 3.3. MyPaint Brushes Dialog

Figure 15.29. The MyPaint Brushes dialog

The “MyPaint Brushes” dialog is used to select a MyPaint brush, for use with painting tools: see the MyPaint Brush tool section for more information on MyPaint brushes and how they are used in GIMP. The dialog also gives you access to several functions for manipulating brushes. You can select a brush by clicking on it in the list: it will then be shown in the Tool Options area of the Toolbox when the MyPaint Brush is the active tool.

#### 3.3.1. Activating the Dialog

This dialog is a dockable dialog; see the section Section 2.3, “Dialogs and Docking” for help on manipulating it.

You can access it:

- From the main menu: Windows → Dockable Dialogs → MyPaint Brushes.

- From the Tab menu in any dockable dialog by clicking on and selecting Add Tab → MyPaint Brushes.

- From the Tool Options dialog for any of the paint tools, by clicking on the MyPaint Brush icon button, you get a popup with similar functionality that permits you to quickly choose a brush from the list; if you click on the button present on the right bottom of the popup, you open the real MyPaint brush dialog.

  The simplified “Brushes” dialog

  The button bar at the bottom offers the following functionality:

  - Smaller previews

  - Larger previews

  - View as list

  - View as grid

  - Open the MyPaint brush selection dialog

  Note that, depending on your Preferences, a brush selected with the popup may only apply to the currently active tool, not to other paint tools. See the Tool Option Preferences section for more information.

#### 3.3.2. Using the “MyPaint Brushes” dialog

##### 3.3.2.1. Grid/List mode

In the Tab menu, you can choose between View as Grid and View as List. In Grid mode, the brush shapes are laid out in a rectangular array, making it easy to see many at once and find the one you are looking for. In List mode, the shapes are lined up in a list, with the names beside them.

In the Tab menu, the option Preview Size allows you to adapt the size of brush previews to your liking.

Grid mode

  At the top of the dialog appears a filter box where you can filter the MyPaint brushes shown based on their tags; and the name of the currently selected brush.

  In the center a grid view of all available brushes is shown, with the currently selected one outlined. Below the grid is a box that shows the tags assigned to the currently selected brush.

List mode

  For the most part, the dialog works the same way in List mode as in Grid mode, with the following exception: the name of the current brush isn't shown at the top.

##### 3.3.2.2. MyPaint Brush previews

When you click on a brush preview, it becomes the current brush and it gets selected in the MyPaint Brush Tool Options. You can also click on buttons at the bottom of the dialog to perform various actions.

##### 3.3.2.3. Tagging

You can use tags to reorganize the MyPaint brushes display. See Section 3.7, “Tagging”.

##### 3.3.2.4. Buttons at the bottom

The button bar at the bottom offers the following functionality:

Edit MyPaint Brush

  This button is always disabled since GIMP does not support editing MyPaint brushes. This is also the reason why there is no create new brush button.

Duplicate Brush

  This button is always disabled.

Delete Brush

  This button is always disabled.

Refresh Brushes

  If you add brushes to your personal Brushes Folder or any other folder in your MyPaint brushes search path, this button causes the list to be reloaded, so that the new entries will be available in the dialog.

Some of functions performed by these buttons can also be accessed from the dialog pop-up menu, activated by right-clicking anywhere in the brush grid/list, or by choosing the top item, MyPaint Brushes menu, from the dialog Tab menu.

##### 3.3.2.5. The “MyPaint Brushes” context menu

Right clicking on a brush preview opens a context menu. Most of the commands of this submenu are described with the Buttons, except for the following.

Copy MyPaint Brush Location

  Copy MyPaint Brush Location allows you to copy the MyPaint brush path to the clipboard.

Show in File Manager

  Show in File Manager opens the location of the MyPaint brush in the default File Manager on your system.

3.2. Brushes Dialog |  | 3.4. Patterns Dialog

Report a bug in GIMP Report a documentation error