Search is based on keyword.
Ex: "Procedures"
Do not search with natural language
Ex: "How do I write a new procedure?"
Material Ingest Tool Dialog
The Material Ingest Tool 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
The Material Ingest Tool dialog lets you ingest texture files and create material presets.
Note: To find out how to create material presets using the Material Ingest Tool dialog, refer to Creating Materials with the Material Ingest Tool.
How to Access It
• Menubar | Tools > Material Ingest Tool
Material ingest Tool Dialog Fields
Control |
Type |
What it does |
Notes |
Presets |
dropdown |
Specifies the material preset to use. Once a preset is selected, Mari updates the current values in the Material Ingest Tool dialog. The Presets dropdown list contains the names of all preset files found in Note: To load custom presets from another directory, use the MARI_MATERIAL_INGEST_PRESETS_SEARCHPATHS environment variable. See Environment Variables That Mari Recognizes. |
|
Save Presets |
button |
Saves all the values in the Material Ingest Tool dialog as an .mip preset file.
|
|
Load Presets |
button |
Loads a preset (.mip file). Once loaded, the preset name is added to the Presets dropdown menu and set as the current preset.
|
|
Clear Presets |
|
Clears the preset values (Shader Model patterns, case sensitive and the file template) and resets them to their default.
|
|
Stream Configuration |
|||
Shader Model |
dropdown |
Lists the shader models of the shaders loaded in your project. This updates the table containing the streams. This table is used to match the texture files' naming patterns to the shader input or stream they are targeted for. Note: You can access this list through Python using the following method: mari.shader_models.list() |
|
Case Sensitive |
dropdown |
Evaluates whether the stream patterns are case sensitive, in case texture files follow different capitalization conventions, for example: if set to Yes the pattern 'ao' would not match a file with 'AO' as the stream name. Note: Case Sensitive default to Yes. |
|
Stream Name |
checkbox |
Indicates each stream name of the current shader model set in the Shader Model dropdown. Toggles whether or not the stream should build a procedural image node when creating a material. |
|
Color |
color swatch |
Opens the Select Color dialog to set a color for the streams in case a matching texture file cannot be found. Double-click the color swatch to open the Select Color dialog. Note: If the stream type is Scalar, indicated by the icon, and if no texture file can be found, a Constant node is added if the color is gray, otherwise a Vector node is added. |
|
Naming Patterns |
entry box |
Specifies a list of naming patterns separated by a comma ',' in the order of importance, to identify an appropriate texture file for this stream. Note: Double-click the row to change the naming patterns. |
|
Ingestion Options | |||
Filename Template |
entry box |
Specifies the naming pattern for texture files using the following templates: Required: • $NAME - specifies the name of your material. You can use any set of alphanumeric characters including underscores, spaces, dashes, and periods. • $STREAM - indicates where in the file name the pattern specified per stream should be matched. Optional: • $EXT - specifies any supported image extensions. • $CHAR - ignores any arbitrary characters. • $NUM - ignores any numbers. • $ANY - ignores any alphanumeric characters including underscores, spaces, dashes, and periods. • $SEP - specifies the system's path separator, forward slash / or backslash \. • $NUM$CHAR can be used together to match against textures with their resolution in the filename, for example: myMaterial_color_4k Note: The default value is $NAME_$STREAM.$EXT |
|
Search Root Path |
dropdown, button |
Sets the root path that the Material Ingest Tool searches for collections of files matching the specified naming patterns. Either enter the path or browse to the path using the folder button. Note: The default value is mari.resourses.DEFAULT_IMAGE |
|
Ingest Method |
dropdown |
Specifies the ingestion method: • Export Materials to Disk - this exports materials in .mma files to the specified location set in Material Export Path. • Build Materials in Project - this adds materials as Tiled or Tri Planar Projection nodes in the Node Graph. |
|
Material Export Path |
dropdown, button |
Sets the path to where the Material Ingest Tool saves the generated materials. Either enter the path or browse to the path using the folder button. Note: The default value should be mari.resourses.DEFAULT_EXPORT |
|
Procedural Type |
dropdown |
Specifies which image based procedural node to generate materials with: • Tiled - uses one image to tile across the model. • Tri Planar Projection - projects the texture map on your model from three different directions (Top, Front, and Right). |
|
Add To Shelf |
dropdown |
Specifies in which shelf to add the generated materials. You can add them to the Menu, Personal, or Project shelves or you can create a new shelf. Select Do Not Add to Shelf, if you don't require to add them to a shelf. |
|
New Shelf |
entry box |
Specifies the name of the new shelf to which generated materials are added. In the Add to Shelf dropdown, select Add to New Shelf to enable the New Shelf field. |
|
Create Materials |
button |
Creates the materials using the information you provided in the Material Ingest Tool dialog.
|
|
Close |
button |
Closes the Material Ingest Tool dialog. Note: The Material Ingest Tool dialog remembers the last settings used. |
Sorry you didn't find this helpful
Why wasn't this helpful? (check all that apply)
Thanks for your feedback.
If you can't find what you're looking for or you have a workflow question, please try Foundry Support.
If you have any thoughts on how we can improve our learning content, please email the Documentation team using the button below.
Thanks for taking time to give us feedback.