Exporting Textures from Layers

Instead of exporting work on whole channels, you may wish to export only a selection of layers by selecting them from the list in the Layers palette. As with channels, you can export multiple layers as they are in your layer stack or flattened into a single file.

From the Layers menu, select Export or Export Flattened.

To export layers without flattening them:

• from the Layers menu, select Export > Export Selected Layers to export the currently selected layers, or

• from the Layers menu, select Export > Export All Layers to export all layers in the layer stack.

To flatten the layers before exporting them:

• from the Layers menu, select Export Flattened > Export Selected Layers Flattened to flatten and export the currently selected layers, or

• from the Layers menu, select Export Flattened > Export All Layers Flattened to flatten and export all layers in the layer stack.

Tip: The Export Flattened menu options are also available from the right-click dropdown menu on the main canvas and in the Layers palette.

The Export dialog displays.

Note: Since exporting all the layers in a layer stack would be the equivalent of exporting an entire channel, the Export All Layers and Export All Layers Flattened options in the Layers menu exports the same result as the Export Current Channel and Export Current Channel Flattened options in the Channels menu.

Exporting Individual Files

Exporting individual files lets you individually pick the patches to export, and where to export them.

Note: By default the Named Files tab doesn't display if you have more than 20 patches in your object.
To change this number, set the Patch Cutoff preference to a number greater than the number of patches in the file. Alternatively, you can use the MARI_NAMEDFILEIMPORT_SEQUENCELIMIT environment variable to override the preference setting. Please see the section on Environment Variables That Mari Recognizes for more information on environment variables.

Click the Named Files tab.

The tab shows all the patches on the object.

For each patch, set the file to export it to.

You can either:

• type the file path and name directly, or

• use the open button to open a navigation window to create a new file in a directory, or select an existing one to overwrite.

Select whether to enable Small Textures.

With the small textures dropdown set to enabled, Mari exports any patches filled with a constant color as 8x8 pixel textures, no matter what resolution the patches are in Mari.

• Enabling Small Textures saves disk space if you're exporting a channel that hasn't been fully painted.

• Disabling Small Textures lets Mari always export patches at their full size (even if they haven't been painted).

Click Export All Patches to export the textures.

Mari exports your textures to disk in the background.

To check the progress of the export click the

icon at the bottom right of the main window.

Mari shows the export progress.

Exporting a Sequence of Files

If your patches have a consistent naming/numbering system, you can import them as a sequence.

Click the Sequence tab.

Enter the location to export the files to in the Path field. You can either:

• enter the full path to the directory (or pick from the dropdown), or

• use the navigation controls to navigate to the directory.

Tip: Make sure you check the path and name carefully, especially if you have been swapping between assets - Mari defaults to the last place you've exported. Don't risk overwriting your textures!

When you've selected the path, the file area shows all the existing image sequences under that path.

If you are looking for a specific folder or file, you can use the Filter field to specify a name or file format to search for.

Either use the default filename template or set a Template for Mari to use when generating the names of images in the selected sequence.

You can either:

• Edit this line manually. As you edit, the File Example updates with the name of an example file in the sequence.

• Click on an existing set of images in the main list. The Template automatically populates with the corresponding values.

If you edit the line manually, you can use any of the following variables, which Mari replaces with the appropriate values when it exports the images:

• $ENTITY - the name of the object exported.

• $CHANNEL - the name of the channel exported.

• $LAYER - the name of the layer exported.

• $NODE - the name of the node.

• $UDIM - the UDIM patch value.

• $FRAME - the animation frame number.

• $NUMBER - the number of the file within the batch (for example, “$NUMBER of $COUNT” gives strings like “22 of 28”).

• $COUNT - the total number of files in the channel.

• $COLORSPACE - the chosen colorspace for the selected images.

• $[METADATA VALUE] - any user-defined variables (for example, if a patch has a user attribute called “PROJECT”, with a value of “Project1”, Mari replaces the variable “$PROJECT” with “Project1”).

Note: If you want to create a layered .psd file from your layer stack for an individual channel in your scene, set the template to $CHANNEL.$UDIM.psd.

Set the Use Template For field to determine if the template above is used for Only this layer (the selected layer in the channel’s layer stack) or Everything (to include all layers in the stack).

Set the Colorspace in which you want to export the data. By default, Mari selects Automatic, which is determined by the file name, size, and type of data in the channel.

Decide whether Small Textures is enabled or disabled.

• Enabling Small Textures saves disk space and exports any patches that you haven't painted yet, or have painted as a single color, as 8x8-pixel textures.

• Disabling Small Textures lets Mari always export patches at their full size (even if they haven't been painted).

In the Alpha Channels field, choose to either Keep or Remove the alpha when importing channels. This can help decrease the resulting file size when exporting.

10.

Click Export All Patches to export the textures.

Mari exports your textures to disk in the background.

11.

To check the progress of the export click the

icon at the bottom right of the main window.

Mari shows the export progress.

Note: The steps above assume you are exporting a sequence of patches with the udim number (1001, 1002, etc.) in the file names. For more information on how UDIM numbers are allocated to patches, please see Using UDIM Values.