Image Manager Palette

The Image Manager palette and the controls that can be found on it are described in the table below. When controls also bring up additional dialogs, these are referenced for more information.

What It Does

The Image Manager lets you store and work with images in your project, including using them for brushes and painting through them onto your model. For organization purposes, you can also add custom tabs to the palette by clicking the add tab button.

Image Manager Palette Fields

Control

Type

What it does

Opens this dialog box

Image Info > Info

Depth

information

The color depth of the currently selected image in bytes.

 

Channels

information

The color components of the currently selected image.

 

File Space

dropdown

File space of the currently selected image from the options:

NORMAL

VECTOR

VECTOR_Y_FLIP

NORMAL_Y_FLIP

 

Tiled Image

information

Whether the image is tiled - true or false.

 

Height

information

The height of the currently selected image in pixels.

 

Width

information

The width of the currently selected image in pixels.

 

Path

information

The file path to the image that Mari is accessing. If the original image was saved to another location this is the file path shown, not the path to the original file.

 

Image Info > User Attributes

Comment

text field

Assign a user-defined comment to the image.

 

MriImportFilePath

information

The file path to the original image.

 

MriLastImportDateTime

information

The date and time that the file was first loaded into Mari.

 

Colorspace

Colorspace

dropdown

The colorspace to which the output values are converted. Automatic is determined by the file name, size, and type of data in the image.

 

Tip:  You can limit the number of colorspaces available to artists using the Python API registerConfigUiAllowlist() function or the MARI_COLORSPACE_OCIO_UI_ALLOWLIST environment variable. See Help > SDK > Python > Documentation from Mari's UI menus or Environment Variables That Mari Recognizes for more details.

 

Raw Data

checkbox

If this is enabled, the image data is not converted.

Note:  As the raw colorspace nullifies the corresponding colorspace transform when either used as the input or output, there is a discrepancy between what is shown in the Image Manage palette thumbnail and the image viewer. This is the expected behavior.

button

Adds an image to the Image Manager.

Open an Image Dialog

button

Removes the selected image from the Image
Manager.

 

button

Opens the selected image in another window, where you can crop it.

<image>

button

Saves the selected image to a file.

Save As Dialog

<image> window

button

Crops the current image. Mari copies the cropped area as a separate image in the Image Manager. The cropped image is part of the project, but won't be saved as a separate image file unless you use the Save As option.

Select one of the following crop modes:

Arbitrary - click-and-drag on an arbitrary area of the image.

Fixed - enter a fixed size for the crop box (in pixels) and drag it to the area you want to crop.

Aspect - enter a fixed aspect ratio for the crop box (in pixels) and drag it over the area you want to crop.

Once you have selected the crop area, click the mouse button to crop.

 

Colorspace

dropdown

The colorspace to which the output values are converted. Automatic is determined by the file name, size, and type of data in the image.

 

Raw Data

checkbox

If this is enabled, the image data is not converted.

Note:  As the raw colorspace nullifies the corresponding colorspace transform when either used as the input or output, there is a discrepancy between what is shown in the Image Manage palette thumbnail and the image viewer. This is the expected behavior.