Export Dialog

The Export dialog is described below with functions for how to access it. A list of the controls on the dialog can be found in the table below.

What It Does

Invoked by the export channel functions, export flattened channel functions, export layer functions, or export flattened layers functions, the Export dialog box lets you specify options for exporting channels or layers from the current Mari project, in either flattened or non-flattened states.

If you export with Small Textures set to Enabled then any patches that are entirely filled with one color (such as gray, before anything else has been painted on the patch,) are exported as small 8x8 images to save space. Mari
supports loading these 8x8 images when importing. These images are scaled up to fill the entire patch.

How to Access It

Menubar | Channels > Export > any of the dropdown options

Menubar | Channels > Export Flattened > any of the dropdown options

Menubar | Layers > Export > any of the dropdown options

Menubar | Layers > Export Flattened > any of the dropdown options

Right-click | in Channels Palette > Export > any of the dropdown options

Right-click | in Channels Palette > Export Flattened > any of the dropdown options

Right-click | in Layers Palette > Export> any of the dropdown options

Right-click | in Layers Palette > Export Flattened> any of the dropdown options

Export Dialog Fields

Control

Type

What it does

Notes

Named Files - The Named files tab does not display if your model contains more than 20 patches.

U

information

Lists the U texture coordinate for the left edge of the patch.

 

V

information

Lists the V texture coordinate for the
bottom edge of the patch.

 

UDIM

information

Lists the UDIM number for the patch.

 

File

text field

Specify the file location to export to.

 

button

Browse to the file location you want to export the texture to.

 

Sequence

Layer

information

The name of the object, channel, and layer being exported.

 

Path

text field, dropdown

The directory to export the files to. Type the directory, select a recent directory from the dropdown, or use the navigation controls below.

 

Reset To Defaults

button

Resets the path to the default location.

 

button

Goes back to the previous directory.

 

button

Goes forward to the next directory that you have browsed.

Only available if you have already browsed back using the back button.

button

Goes up one level in the directory hierarchy.

 

button

Creates a new folder in the current
directory.

 

button

Displays the contents of the directory as icons and names only.

 

button

Displays the contents of the directory as a details view, with a sort option at the top of the listing.

 

Filter

text field, dropdown

Lets you filter the image sequences
displayed in the dialog box. As you enter the filter text, Mari updates the display to only show the image sequences that match your text.

 

Full

Image

Indicates whether the selected image sequence has a full set of images for the
current model. That is, for each patch on the model, there is a corresponding image in the image sequence. Green if a full set of images is present, otherwise the number found vs number required (for example, 4/5) displays.

 

Images

information

Lists the image sequences found in the selected Path.

 

Start

information

First UDIM number in the selected image sequence.

 

End

information

Last UDIM number in the selected image sequence.

 

Patch Count

information

Number of image patches in the image sequence.

 

Frames

Information

How many frames in the image sequence.

 

Modified

information

Last modified date for the images in the sequence.

 

Template

text field, dropdown

Sets the Template for Mari to use when gathering the names of images in the
selected sequence. Variables available are:

$ENTITY - the name of the object

$CHANNEL - the name of the channel

$LAYER - the name of the layer

$NODE - the name of the node

$UDIM - the UDIM patch value

$FRAME - the animation frame number

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

$COUNT - 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”).

Don't use numbers in your texture name - if you do, the Import and Export dialog boxes won't recognize the sequence.

File Example

information

Displays an example of the selected template path and filename.

 

Formats

Information

Displays a list of supported export file formats.

 

Use Template For

dropdown

Specifies whether the template should be used for Only this layer or Everything that is being exported.

 

Export Dialog: General Controls

Colorspace

dropdown

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

In addition to the OCIO roles and colorspace options, there are also Same as Native and Same as Working options available in the dropdown menu.

These allow you to maintain the same colorspace as the one that was native to the data, or as the one you used within Mari when you were working with the data.

 

Small Textures

dropdown

With this option 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).

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

Disable Small Textures if you want Mari to always export patches at their full size (even if they haven't been painted).

Alpha Channels

dropdown

Select Keep or Remove alpha channels when exporting textures. This can help decrease the resulting file size when exporting images that don’t need alpha channels.

 

Export All Patches

button

Exports images from all patches in the
project.

 

Cancel

button

Cancels the export and closes the dialog box.