Channel Presets Dialog
The Channel Presets 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
Allows you to set up preferences for quickly creating channels through the Channels palette or menu. These presets include options such as the color depth size, patch size, file space, and colorspace. This gives you the opportunity to quickly set up a channel template for channel types you know are going to be created numerous times. You can also choose from a few Mari channel presets.
How to Access It
• Menubar | Channels > Channel Presets
• Right-click | in Channels Palette > Channel Presets
Channel Presets Dialog Fields
Control |
Type |
What it does |
Opens this dialog box |
Notes |
Root Path |
text field, dropdown, button |
Specify the file path for the creation of new channel templates. |
Choose Base Path dialog |
The browse and scan |
Scan |
button |
Scans the Root Path for any existing texture files. |
|
After scanning the Root Path, you should always set the Size of the texture files manually. The default values Mari sets may not be correct as channels can contain many different patch sizes. |
Import |
dropdown |
Select which patches to import if a channel is being imported for the creation of the template. Options are: All Patches. |
|
|
Resize |
dropdown |
Select which files should be resized when patches are being imported for channel template creation. Options are: Patches to fit images or Images to fit patches. |
|
|
Category |
dropdown |
Selects a Mari channel preset template from the list of available shaders. |
|
3Delight Principled - Metallic - VFX, 3Delight Principled - Non-Metallic - VFX, General, Principled BRDF - Metallic - Games, Principled BRDF - Metallic - VFX, Principled BRDF - Non Metallic - Games, Principled BRDF - Non Metallic - VFX, Unreal - Metallic - Games, Unreal - Metallic - VFX, Unreal - Non-Metallic - Games, Unreal - Non-Metallic - VFX, VRayMtl - VFX |
Template |
dropdown |
Specifies a channel template to control the format of the filenames when Mari looks for existing textures on disk. |
|
For more information about channel templates, see Defining Custom Channel Templates, Reviewing the Custom Channel Template File Format, and Example File: DefaultTemplates.mtt. |
Prefix |
text field |
Specifies the filename prefix for existing texture files, if applicable. |
|
|
Create |
checkbox |
When enabled, creates a shader and connects channels to the shader on project creation. |
|
Most presets contain enabled channels by default. |
Import |
checkbox |
Imports existing textures into the channel after creating it. Import settings were selected from the earlier option in the |
|
|
Name |
information |
Specifies the name of the channel to create. Mari sets a default value, but you can change this. |
|
For example, color, specRough, dispFine, dispBroad, colorDetail, colorDetailMask. |
Size |
dropdown |
Specifies the patch size for the new channel, from the options: 256x256, 512x512, 1024x1024, 2048x2048, 4096x4096, 8192x8192, 16384x16384, 32768x32768. Mari sets a default value, but you can change this. |
|
Channels can be resized later from the |
Colorspace |
dropdown |
The colorspace in which the colors within your project are interpreted. Either select from the shipped configuration files or allow Mari to set an Automatic colorspace. |
|
|
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. |
||||
Scalar |
checkbox |
When Colorspace is set to Automatic, checking Scalar converts the resolved colorspace to scalar data. Scalar data in Mari is used to define the properties of a texture such as bumpiness, roughness, or shininess. See Color Data and Scalar Data for more information. Note: Automatically resolved 32-bit channels cannot be converted to scalar data. Only 8- and 16-bit channels are supported. |
|
Scalar is disabled by default. |
File Space |
dropdown |
Specifies the file space used when generating vectors. Mari sets a default but you can change this. |
|
Normal, Vector, Vector (flipped Y), or Normal (flipped Y) |
Fill |
swatch |
Specifies the color to fill the new channel. Click the swatch to change the color. Mari sets a default value, but you can change this. |
|
|
Depth |
dropdown |
Select a color depth size for the created channel template. Options are: 8bit (Byte), 16bit (Half), 32bit (Float). |
|
Mari sets a default value, but you can change this. The color depth size for channels can also be resized later from the |
Files |
text field |
Specifies the filename template used to pick existing textures to import into the channel. Mari sets a default value, but you can change this, or you can use the button to open a dialog allowing you to manually pick the files. |
|
This option is ignored if the Import checkbox is disabled. |
|
button |
Opens a dialog box allowing you to pick the textures for Mari to import into the new channel. This corresponds to the File text field above. |
|
|
|
icon |
Indicates that Mari has not found any textures to import. |
If there are textures to import, Mari displays the number of patches available. |