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.

You can also create Image Groups to organize your project’s images.

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
Send Image to 2D Paint	button	Opens your image in the 2D tab. Mari will add a new object and import the image as a Paint Node. The node graph will show Bottom Transparency + Paint node (with the image imported) merged and connected to a channel node.	Using 2D Paint Mode
<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.
Image Group window
Shader Model	dropdown	Defines the available shader models you can assign images to. The available options are: • 3Delight Principled • Arnold Standard Surface • Autodesk Standard Surface (1.0.2.x) • BRDF • Principled BRDF • USD Preview Surface • Unreal • VRayMtl • VRayMtl (V-Ray 6)
Ingest Template	submenu	Apply preset configurations for specific texture vendors to the shader model. There are two options: • Apply to Current Shader Model - matches images to streams based on filenames in the selected preset. This will only apply for the Shader model selected in the dropdown. • Apply to All Shader Models -matches images to streams based on filenames in the selected preset. This will be applied across all shader models. Available texture vendors to apply templates to are: • CCO_Textures Friendlyshade • GameTexture • Poliigon • Quixel • RealDisplacementTextures • Substance • TextureHaven • Textures_Com • TexturingXYZ
Auto-Assign Images	Button	Auto-assigns the images in the Image group to the corresponding shader channels, based on naming conventions of images.
Search	Text input	Search for a specific stream in the shader model.
Lock Stream Unlocked: Locked:	Button	Locks the specific stream. When a stream is locked, it will not be altered when the Auto-assign and Ingest template tools are used. You can still manually change the stream by using the image dropdown and picking a new image
Stream	n/a	The shader stream that the image can be assigned to.
Image	Dropdown	Defines the image assigned to the shader stream.