Project Settings Dialog

The Project Settings dialog box lets you change the colorspace options for your Mari project after project creation. These colorspace options are all presented in the New Project dialog when first setting up a project, however, you may wish to change it at a later stage. This dialog provides all the same options and makes the changes on a project-wide basis.

Accessing the Project Settings

Menubar | File > Settings

Project Settings: About

Description text box

text box

Specifies a description for the project.

Created

string

Specifies the date the project was created.

Created By

date and time

Specifies the name of the artist who created the project.

Modified

string

Specifies the date the project was modified.

Modified By

string

Specifies the name of the artist who modified the project.

UUID

string

Specifies the Universally Unique Identifier (UUID) of the project.

Project Settings: Colorspace

Most of the Colorspace settings have a reset button to revert to the default. The defaults are specified in the OCIO config file. For more information on roles in the OCIO, see Color Management.

Color Management Enabled

checkbox

Toggles colorspace conversions. When switched off all data will be treated as raw, similar to how it was treated prior to Mari 3.0.

OCIO Config

dropdown

The OpenColorIO config file to use. You can choose between the config files packaged with Mari, or select Custom to specify a specific config.

If the OCIO environment variable is set, that config takes priority and this control will be disabled.

Custom OCIO Config

text field, button

If you chose Custom for the OCIO Config file choice, specify the filepath to the configuration file.

Color Monitor

dropdown

The default colorspace for all user interface elements which are displaying color managed swatches, pickers and thumbnails.

This preference does not affect the canvas and image viewers, however it is recommended to set this so that it matches the View Transform. (The active selection can be changed using the View Transform Toolbar .)

Scalar Monitor dropdown

The default colorspace for all user interface elements which are displaying non-color managed (i.e. scalar) swatches, pickers, and thumbnails. (To understand the difference between color and scalar data in Mari, see Color Data and Scalar Data).

This preference does not affect the canvas and image viewers, however it is recommended to set this to match the scalar View Transform. (The active selection can be changed using the View Transform Toolbar .)

Color Picking (advanced and intermediate color management modes only)

dropdown

Default colorspace for all color pickers, swatches, and image viewers.

Typically, you'll want to select the same colorspace that your 8-bit color channels default to, in order to achieve perceptually consistent picked colors when switching between channels of different bit depths and colorspaces.

Working (advanced color management mode only) dropdown

Default for painting, lighting, applying filters, and similar operations.

Typically, you'll want to select the same linear-based colorspace as your 16/32-bit float channels to get accurate results.

Blending (advanced color management mode only)

dropdown

Default for applying blending operations such as: a comp of the paint buffer and the current paint target, blending between layers, and combining inputs in a merge node.

Typically, you'll want to set this to Same as 8 bit Data to get the same results as painting prior to Mari 3.0, and to get less banding artifacts when painting 8-bit channels and images.

8-bit Color

dropdown

Default colorspace for 8-bit channels, and reading and writing image files encoded with 8-bit data like JPGs, PNGs or TIFFs.

16-bit Integer Data

dropdown

The default colorspace for reading and writing image files which are encoded with 16-bit integer data such as 16-bit TIFFs.

8/16-bit Scalar

dropdown

Default colorspace for masks, heights, normals, depths and, generally any non-color image or channel with 8-bit or 16-bit scalar data.

16/32-bit Float Data

dropdown

Default colorspace for 16-bit or 32-bit channels, and reading and writing image files encoded with 16-bit or 32-bit floating point data like EXRs.