Storing Resources Using Shelves

You can store just about anything you can grab from within Mari in Shelves. Most artists like to store their favorite brushes, colors, and images (for clone stamping or painting through). Power users can also add any preset Mari function to a shelf.

By default, the Mari Shelf palette comes with a number of shelves, including a few preset shelves:

• Menu — items that you can select from the F9 pie selection control menu.

• Personal — selected items you use regularly.

• Project — items just for the current project.

• Basic Brushes — a set of predefined basic brushes.

• Brad's New Brushes — a set of predefined brushes.

• Brad's Movie Brushes — another set of predefined brushes by Brad DeCaussin.

• Grunge — a set of high-quality grunge textures created by industry professionals.

• Hard Surface Brushes — a set of predefined hard surface brushes.

• Materials — a set of predefined materials based on the Principled BRDF shader model.

• Organic Brushes — a set of predefined organic brushes.

• Python Examples — predefined python scripts that perform certain useful functions.

• Smart Masks — ready-to-use masks and grunge maps, and a set of utilities to edit them.
Note: this shelf includes items which used to be called Custom Procedurals.

• Color Presets — stores colors that you have saved.

You can also create any number of customized shelves.

Your shelves display in the Shelf palette,see Configuring Brushes. You can also make any shelf into a separate, custom palette. Mari also lets you export and import entire shelves and items within shelves, for example to share with other users.

Tip:  For an overview of all the ready-to-use content in the shelf, see Ready-to-use Shelf Content.

Note:  To load Mari without the Mari Materials, Basic Brushes, Hard Surface Brushes, Organic Brushes, and Brad's New Brushes preset shelves, disable the Edit > Preferences > Misc. > Shelf > Shelves Include Presets preference. See Mari Preferences Dialog.

Video:  To display the Shelf quick palette when painting, press and hold K. See Shelf Palette for more information. Watch the demo.
This video shows the workflow using Mari 3. Even though the Mari 4 workspace is different, the workflow remains the same. To have a look at the main UI differences, see Mari 3.3 vs 4.0.

Tip:  For details on using the pie selection control menu, see Using the Pie Selection Control.

Searching your Shelves

Use the Shelf search box to find specific items across your shelves. You can also use the following operations to filter through results:

• Enter any required search terms and separate them using spaces.

• Terms separated by | (vertical line) will return any results with either term in the name.

• Prefix terms with - (dash) to exclude them from your search.

• For exact matches of terms, enclose terms in quotes (“”).

For example, searching for bricks | plaster -cracked matches any item with bricks OR plaster in the name, but excludes any with cracked in the name.

Searching “bricks plaster” will only return results with the exact term bricks plaster in them. If you search bricks plaster without the quotes, it will return terms with both bricks and plaster anywhere in the result name.

Use # to search for Shelf Items that have been assigned a specific Tag.