Foundry VERSION 2.0V1, Mari Reference Manual
REFERENCE GUIDE
VERSION 2.0
V1
Mari™ Reference Guide. Copyright © 2013 The Foundry Visionmongers Ltd. All Rights Reserved. Use of this Reference Guide and the Mari
software is subject to an End User License Agreement (the "EULA"), the terms of which are incorporated herein by reference. This Reference Guide
and the Mari software may be used or copied only in accordance with the terms of the EULA. This Reference Guide, the Mari software and all
intellectual property rights relating thereto are and shall remain the sole property of The Foundry Visionmongers Ltd. ("The Foundry") and/or The
Foundry's licensors.
The EULA can be read in the Mari User Guide Appendices.
The Foundry assumes no responsibility or liability for any errors or inaccuracies that may appear in this Reference Guide and this Reference Guide
is subject to change without notice. The content of this Reference Guide is furnished for informational use only.
Except as permitted by the EULA, no part of this Reference Guide may be reproduced, stored in a retrieval system or transmitted, in any form or by
any means, electronic, mechanical, recording or otherwise, without the prior written permission of The Foundry. To the extent that the EULA
authorizes the making of copies of this Reference Guide, such copies shall be reproduced with all copyright, trademark and other proprietary rights
notices included herein. The EULA expressly prohibits any action that could adversely affect the property rights of The Foundry and/or The
Foundry's licensors, including, but not limited to, the removal of the following (or any other copyright, trademark or other proprietary rights notice
included herein):
Mari™ software © 2013 The Foundry Visionmongers Ltd. All Rights Reserved.
Mari™ is a trademark of The Foundry Visionmongers Ltd.
Weta™ Digital is a trademark of Weta Digital Ltd.
In addition to those names set forth on this page, the names of other actual companies and products mentioned in this Reference Guide (including,
but not the to, those set forth below) may be the trademarks or service marks, or registered trademarks or service marks, of their respective
owners in the United States and/or other countries. No association with any company or product is intended or inferred by the mention of its
name in this Reference Guide.
Linux ® is a registered trademark of Linus Torvalds.
Windows ® is the registered trademark of Microsoft Corporation.
Adobe ® and Photoshop ® are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other
countries.
Maya ® is a registered trademark of Autodesk, Inc., in the USA and other countries.
Mari software engineering: Jack Greasley, Kiyoyuki Nakagaki, Marcus Shoo, Kevin Atkinson, Tim Ebling, Jed Soane, Daniel Lond, Robert Fanner,
Duncan Hopkins, Mark Final, Chris Bevan, Carl Rand, Phil Hunter and Tim Smith
Product testing: Michael Zannetou, Mark Titchener, Robert Elphick, Antoni Kujawa and Chris Hiess
Writing and layout design: Jack Elder, Jon Hertzig, Eija Närvänen, Charles Quinn and Erica Cargle
Proof reading: Jack Elder and Eija Närvänen
Mari includes Disney technology licensed from Walt Disney Animation Studios.
The Foundry
6th Floor, Communications Building,
48 Leicester Square,
London
WC2H 7LT
Rev: March 8, 2013
Mari 2.0v1The Foundry
Contents
PREFACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
TYPES OF CONTROLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
PROJECT FUNCTIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
PREFERENCE FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
SELECTION FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
OBJECT FUNCTIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
CHANNEL FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
LAYER FUNCTIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
PTEX FUNCTIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
PATCH FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
SHADING FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
PAINTING FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
FILTER FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
CAMERA FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
VIEW FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
TOOL FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
PYTHON FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
HELP FUNCTIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
TOOLBARS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
STATUS BAR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
CHANNELS PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
LAYERS PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
PATCHES PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100
OBJECTS PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
SHADERS PALETTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
4
LIGHTS PALETTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120
PROJECTORS PALETTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122
SELECTION GROUPS PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
COLOR MANAGER PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133
IMAGE MANAGER PALETTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143
HISTORY VIEW PALETTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145
BRUSH EDITOR PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146
PLAY CONTROLS PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
PYTHON CONSOLE PALETTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
PIXEL ANALYZER PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155
The Foundry
Mari 2.0v1
COLORS PALETTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156
TOOL PROPERTIES PALETTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
PAINTING PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166
PROJECTION PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .168
SHELF PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174
HSV PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
SNAPSHOTS PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
NEW PROJECT DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
5
SELECT COLOR DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .182
ADD CHANNEL DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
ADD MULTIPLE CHANNELS DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .186
CHANNEL PRESETS DIALOG BOX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
CONVERT TYPE DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .190
COPY MULTIPLE TEXTURES DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191
EXPORT DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192
IMPORT DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .196
MARI TO MAYA EXPORT DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200
CREATE SHADER DIALOG BOX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
The Foundry
Mari 2.0v1
CREATE SHADER DIALOG BOX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
MASK CHANNEL TO ALPHA DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205
SELECT PATCHES BY RANGE DIALOG BOX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
LOAD CAMERA DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207
MANAGE TOOLBAR DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .209
MANAGE KEYBOARD SHORTCUTS DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
HUD MANAGER DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
MARI PREFERENCES DIALOG BOX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
6
DISPLAY PROPERTIES DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225
SCREENSHOT SETTINGS DIALOG BOX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
RENDER TURNTABLE DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
DIAGNOSTICS TURNTABLE DIALOG BOX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
QUICK PROJECTION DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233
The Foundry
Mari 2.0v1
1 PREFACE
Mari is a creative texture-painting tool that can handle extremely complex
or texture heavy projects. It was developed at Weta Digital and has been
used on films such as The Adventures of Tintin: The Secret of the Unicorn,
District 9, The Day the Earth Stood Still, The Lovely Bones and Avatar.
The name Mari comes from the Swahili 'Maridadi', meaning 'beautiful' and
carrying connotations of 'usefulness'.
About this guide
Contact
customer
support
This guide provides a complete reference for all the functions and fields
within Mari. It does not give you any instructions on using Mari. For details
on installing Mari, read the
using Mari, read the
The first part of this document describes all the functions within Mari,
broken up by functional area.
Should questions arise that this manual fails to address, you can contact
Customer Support directly via e-mail at support@thefoundry.co.uk or via
telephone to our London office on +44 (0)20 7968 6828 or to our Los
Angeles office on (310) 399 4555 during office hours.
User Guide
Getting Started Guide
.
. For full instructions on
2 TYPES OF CONTROLS
Control What it looks like What it does How to use it Notes
Add attribute Lets you add an
attribute to a property.
Buttons
Checkbox
Control
sphere
Curve editor Maps between input
Dropdown
list
,
unselected, selected
Lets you select a
function.
Lets you select an
option.
Lets you move a light
around the scene.
and output values
(45° = the same). Bar
along the bottom
displays the effect at
each point.
Lets you select from
a list of valid values.
Click the icon, and fill
in the Add User
Attribute dialog box.
Click it. May show an icon or a word.
Click to select. An “x” displays when selected.
Click and drag to pull
the light around.
Drag to move points
on the graph. Add
points by clicking on
the curve or bar. Edit
a point by right-clicking it.
You can also remove a
point by clicking on it
while holding Ctrl.
Click the down arrow
on the right, then click
to select an option.
For more information, see the
Extending Mari chapter in the
Mari User Guide.
Entry box Lets you type an
Horizontal
slider
Incrementers Lets you increment a
entry.
Slides along a range
of valid values.
value up or down.
Click inside the box
and type a valid entry.
Click and drag left
(more) or right (less).
Click up or down
arrows to increment
up or down.
Often combined with a slider and
reset button.
Often combined with an entry box
(that shows the value) and reset
button.
Control What it looks like What it does How to use it Notes
TYPES OF CONTROLS
9
List Lets you select from
a list of valid values.
On/Off Indicator
Option
buttons
Remove
attribute
Reset button Reset to the default. Click the icon. Often combined with an entry box
Swatch
Switch Turns an option on
on, off
Shows whether an
option is on or off
Lets you select
mutually exclusive
options.
Lets you remove an
attribute from a
property.
Displays the
currently selected
color, and lets you
select a different
color.
or off.
Click to select an
option.
Look at it. Often combined with a switch.
Click to select which
option you want.
Click the icon, then
click Remove to confirm.
Click to select a color
from the
Colors Palette
Click and drag right
(on) or left (off).
.
Circle is filled when selected.
Sometimes called “radio buttons”.
and slider.
Often combined with an On/Off
indicator.
The Foundry
Mari 2.0v1
Control What it looks like What it does How to use it Notes
TYPES OF CONTROLS
10
Tabs Displays several
groups of the same
kind of information,
such as different
categories of brush
tips in the
Brush Editor Palette
Thumbnail Displays a thumbnail
preview of a selected
feature or function.
Click:
• a tab to view it
• to view the
previous or next tab
.
• to add a tab
• to delete a
tab
• to open the
current tab in a
separate window
Look at it.
The Foundry
Mari 2.0v1
3 PROJECT FUNCTIONS
Function How to access it What it does
New project •
Menubar
Keyboard
•
Projects tab
•
Projects tab
•
New
Toolbar
•
| File > New
| Ctrl+N
| New button
|
Right-click
|
Creates a new project. New Project Dialog
>
Opens this dialog
box
Box
Notes
Name the project, select
options, and add geometry.
Open a project •
Open recent
project
Save project •
Close project •
Delete project •
Open Archive •
Archive Project •
Copy (Duplicate)
Project
Projects tab
Open
Projects tab
•
•
Menubar
<project name>
Menubar
Keyboard
•
Toolbar
•
Menubar
Keyboard
•
Toolbar
•
| File > Open >
| File > Save
| Ctrl+S
|
| File > Close
| Ctrl+W
|
Projects tab
Projects tab
•
Delete
Projects tab
button
Projects tab
•
Open Archive
Projects tab
button
Projects tab
•
Archive
Projects tab
•
Projects tab
•
Copy
|
Right-click
|
Double-click
| Delete button
|
Right-click
| Open Archive
|
Right-click
| Archive
|
Right-click
| Copy button
|
Right-click
>
>
>
>
>
Opens the selected project
(the project you rightclicked on).
Opens a project, from a list
of the last 10 projects
opened.
Saves the current project.
Closes the current project. Save Changes
Before Closing? (if
unsaved changes)
Deletes the selected project
from disk.
Opens a project from an
archive file.
Saves the selected project to
disk as a Mari archive (.mra)
file.
Creates a copy of the
selected project.
The new copy appears in the
Projects tab.
Import Archive
The archive includes all the
supporting files required for
the project.
4 PREFERENCE FUNCTIONS
Function How to access it What it does
Set preferences
Menubar
| Edit > Preferences Lets you set general prefer-
ences for Mari — cache size,
plug-ins, autosave frequency, and so on.
Opens this dialog
box
Mari Preferences
Dialog Box
Notes
Edit toolbars
Edit shortcuts
Configure
Heads-Up
Display
Menubar
Menubar
Menubar
| Edit > Toolbars Lets you create and edit cus-
tom toolbars.
| Edit > Shortcuts Lets you add or edit keyboard
shortcuts.
| Edit > HUD Manager Lets you set what information
Mari shows in the Heads-Up
Display (HUD) behind the
model on the canvas.
Manage Toolbar
Dialog Box
Manage Keyboard
Shortcuts Dialog Box
HUD Manager Dialog
Box
5 SELECTION FUNCTIONS
Function How to access it What it does
Object selection
mode
• Selection toolbar |
Menubar
•
Object Mode
•Right-click
Object Mode
| Selection >
| canvas >
Sets Mari to select whole
objects.
Opens this
dialog box
Notes
Patch selection
mode
Faces selection
mode
Hide unselected
areas
• Selection toolbar |
Menubar
•
Patch Mode
Right-click
•
Patch Mode
• Selection toolbar |
Menubar
•
Face Mode
Right-click
•
Face Mode
Menubar
•
Hide Unselected
Right-click
•
Visibility > Hide
Unselected
Right-click
•
ette > Hide Unselected
Keyboard
•
•
Mouse
| Selection >
| canvas >
| Selection >
| canvas >
| Selection >
| canvas >
| Patches Pal-
| Shift+H
|
Sets Mari to select patches
on objects.
Sets Mari to select areas on
the objects.
Hides the unselected areas
on the canvas.
For the mouse gesture: press and
hold \, click and drag in the direction indicated. (A thin red line
traces gestures onscreen. Mari
1.2v1
Function How to access it What it does
Hide selected
areas
Menubar
•
Hide Selected
Right-click
•
Visibility > Hide Selected
Right-click
•
ette > Hide Selected
Patches
Keyboard
•
•
Mouse
| Selection >
| canvas >
| Patches Pal-
| H
|
Hides the selected areas on
the canvas.
Opens this
dialog box
SELECTION FUNCTIONS
Notes
For the mouse gesture: press and
hold \, click and drag in the direction indicated. (A thin red line
traces gestures onscreen.
14
Show selected
areas
Show all areas •
Show whole
object
Menubar
•
Show Selected
Right-click
•
Visibility > Show
Selected
Right-click
•
ette > Show Selected
Patches
Menubar
Show All
Right-click
•
Visibility > Show All
Right-click
•
ette > Show All Patches
Keyboard
•
Mouse
•
•
Menubar
Show Entire Object
Right-click
•
Visibility > Show Entire
Object
| Selection >
| canvas >
| Patches Pal-
| Selection >
| canvas >
| Patches Pal-
| Ctrl+Shift+H
|
| Selection >
| canvas >
Shows the selected areas on
the canvas.
Displays all areas, selected
or not, on the canvas.
Shows all area, selected or
not, on only the selected
object.
For the mouse gesture: press and
hold \, click and drag in the direction indicated. (A thin red line
traces gestures onscreen.
The Foundry
Mari 2.0v1
Function How to access it What it does
Select all areas •
Menubar
Select All
Right-click
•
Selection > Select All
Right-click
•
ette > Select All Patches
Button
•
>
| Selection >
| canvas >
| Patches Pal-
| Patches Palette
Selects all areas in the
model, depending on your
current selection mode
(objects, patches, or faces)
Opens this
dialog box
Notes
SELECTION FUNCTIONS
15
De-select all
areas
Invert selection
of areas
Select visible
areas
Lock unselected
areas
Keyboard
•
Menubar
•
Select None
Right-click
•
Selection > Select None
Right-click
•
ette > Select None
Keyboard
•
•
Menubar
Select Invert
Right-click
•
Selection > Select Invert
Right-click
•
ette > Select Invert
Patches
Keyboard
•
Menubar
•
Select Visible
Right-click
•
Selection > Select Visible
Right-click
•
ette > Select Visible
Patches
•Menubar
Lock Unselected
•Right-click
Locking > Lock
Unselected
•Right-click
ette > Lock Unselected
Patches
| Ctrl+A
| Selection >
| canvas >
| Patches Pal-
| Ctrl+E
| Selection >
| canvas >
| Patches Pal-
| Ctrl+I
| Selection >
| canvas >
| Patches Pal-
| Selection >
| canvas >
| Patches Pal-
De-selects all areas on the
model.
De-selects the current
selection and selects everything currently unselected.
Selects only areas that
aren't hidden.
Locks unselected patches so
they cannot be edited.
Depends on your current selection
mode (either objects, patches, or
faces) for the scope of inversion.
For example, in face mode, the
unselected faces become selected
and vice versa.
The Foundry
Mari 2.0v1
Function How to access it What it does
Lock selected
areas
Menubar
•
Lock Selected
Right-click
•
Locking > Lock Selected
Right-click
•
ette > Lock Selected
Patches
Button
•
>
| Selection >
| canvas >
| Patches Pal-
| Patches Palette
Locks selected areas, so
they cannot be painted.
Opens this
dialog box
Notes
SELECTION FUNCTIONS
16
Unlock selected
areas
Lock all areas •
Unlock all areas •
Unlock everything •
Menubar
•
Unlock Selected
Right-click
•
Locking > Unlock
Selected
Right-click
•
ette > Unlock Selected
Patches
Button
•
>
Menubar
Lock All
Right-click
•
Locking > Lock All
Right-click
•
ette > Lock All Patches
Menubar
Unlock All
Right-click
•
Locking > Unlock All
Right-click
•
ette > Unlock All Patches
Menubar
Unlock Entire Object
Right-click
•
Locking > Unlock Entire
Object
| Selection >
| canvas >
| Patches Pal-
| Patches Palette
| Selection >
| canvas >
| Patches Pal-
| Selection >
| canvas >
| Patches Pal-
| Selection >
| canvas >
Unlocks selected locked
areas, so they are again
paintable.
Locks all areas, so they cannot be painted.
Unlocks all locked areas, so
they are again paintable.
Unlocks everything on the
current object, regardless of
whether it’s a face, patch, or
channel.
Create selection
group for patches
The Foundry
Right-click
•
Create Patch Selection
Set
| canvas >
Creates a new selection set
consisting of whichever
patches you currently have
selected.
Creates a new selection set in the
Patches Palette
Mari 2.0v1
Function How to access it What it does
Create selection
group
Right-click
•
Create Selection Group
Button
•
Palette >
| canvas >
| Selection Groups
Creates a new selection
group to save your selection modes.
Opens this
dialog box
SELECTION FUNCTIONS
Notes
You can create selection groups in
any selection mode (objects,
patches, or faces).
17
Reselect
selection group
Lock the selection
group
Unlock the
selection group
Hide the selection
group
Right-click
•
group in Selection
Groups Palette > Select
Selection Group
Button
•
Palette >
Right-click
•
group in Selection
Groups Palette > Lock
Selection Group
Button
•
Palette >
Right-click
•
group in Selection
Groups Palette > Unlock
Selection Group
Button
•
Palette >
Right-click
•
group in Selection
Groups Palette > Hide
Selection Group
Button
•
| selection
| Selection Groups
| selection
| Selection Groups
| selection
| Selection Groups
| selection
| Selection Groups
Reselects the current selection group.
Locks the selection group.
Unlocks the selection group.
Hides the contents of the
selection group.
Palette >
The Foundry
Mari 2.0v1
Function How to access it What it does
Show the
selection group
Right-click
•
group in Selection
Groups Palette > Show
Selection Group
Button
•
Palette >
| selection
| Selection Groups
Shows the contents of the
selection group.
Opens this
dialog box
Notes
SELECTION FUNCTIONS
18
Remove the
selection group
•Right-click
group in Selection
Groups Palette > Remove
Selection Group
• Button
Palette >
| selection
| Selection Groups
The Foundry
Mari 2.0v1
6 OBJECT FUNCTIONS
Function How to access it What it does
Add object •
Menubar
Object
Right-click
•
Add Object
Button
•
| Objects > Add
| Objects Palette >
| Objects Palette >
Adds a new object to the
project.
Opens this
dialog box
Add Objects
Notes
Remove object •
Add object
version
Rename object
version
Remove object
version
Calculate
ambient occlusion
Reset Move
Object - single
object
Reset Move
Object - all
objects
Menubar
Object
Right-click
•
Remove Object
Button
•
•
Right-click
Add Object Version
•
Right-click
Rename Object Version
Right-click
•
Remove Object Version
•
Menubar
Occlusion
Right-click
•
Ambient Occlusion
Mouse | Shift-click
•
object
Keyboard
•
| Objects > Remove
| Objects Palette >
| Objects Palette >
| Objects Palette >
| Objects Palette >
| Objects Palette >
| Objects > Ambient
| Objects Palette >
| ’ Pressing the apostrophe key
on the
Removes the selected object
from the project.
Lets you select a file containing the new object version data.
Renames the current object
version.
Deletes the current object
version.
Calculates the ambient
occlusion for the object. This
is required for any operations that use the ambient
occlusion data (such as
using ambient occlusion
masking).
Shift-click on the object
resets that object to its
original position.
resets all objects back to
their original positions.
Projects must always have at
least one object.
Add Version
Objects must always have at
least one version.
This can take a long time,
depending on the complexity
of the model.
7 CHANNEL FUNCTIONS
Function How to access it What it does
Add channel •
Menubar
Right-click
•
Add Channel
Button
•
| Channels > Add Channel
| in Channels Palette >
| Channels Palette >
Adds a new channel to the
current project.
Opens this
dialog box
Add Channel
Dialog Box
Notes
Create channel
presets
Remove channel •
Convert channel •
Flatten channel
Cut channel
•
Menubar
sets
Right-click
•
Channel Presets
Menubar
Channel
Right-click
•
Remove Channel
Button
•
Menubar
Channel
Right-click
•
Convert Channel
•
Button
•Menubar
Right-click
•
Flatten
•Menubar
Right-click
•
Cut
Keyboard
•
| Channels > Channel Pre-
| Channels > Remove
| Channels Palette >
| Channels > Convert
| Channels Palette >
| Channels > Flatten
| Channels > Cut
| Ctrl+X
| in Channels Palette >
| in Channels Palette >
| in Channels Palette >
| in Channels Palette >
| in Channels Palette >
Allows you to create a new
channel preset to use as a
template for new channels.
Removes the selected channel,
and any layers associated with
it, from the channels list.
Changes the color depth of
the channel to either 8bit
(Byte), 16bit (Half), or 32bit
(Float).
Cuts the channel and all associated layers from the channels list and places it in the
clipboard.
Channel Presets Dialog
Box
Convert Type
Dialog Box
Click the checkbox for
channels you want to
add, and click OK. You
can customize available categories of
channel presets using
an XML file in a folder
specified in your preferences.
Determines number of
pixels per RGB channel.
Copy channel
•Menubar
| Channels > Copy
•Right-click
Copy
•Keyboard
| Ctrl+C
| in Channels Palette >
Copies the channel, and all
associated layers from the
channels list and places it in
the clipboard.
CHANNEL FUNCTIONS
21
Paste channel
Export current
channel
Export all channels
Export everything •
Flatten and
export the current channel
•Menubar
•Right-click
Paste
•Keyboard
•
Menubar
rent Channel
Right-click
•
Export Current Channel
Right-click
•
Export Current Channel
•
Menubar
Export All Channels
Right-click
•
Export All Channels
Right-click
•
Export > Export All Channels
Menubar
Export Everything
Right-click
•
Export Everything
Right-click
•
Export > Export Everything
•
Menubar
tened > Export Current Channel
Flattened
Right-click
•
tened > Export Current Channel
Flattened
•
Right-click
Export Flattened > Export Current
Channel Flattened
| Channels > Paste
| in Channels Palette >
| Ctrl+V
| Channels > Export Cur-
| canvas > Export >
| in Channels Palette >
| Channels > Export >
| canvas > Export >
| in Channels Palette >
| Channels > Export >
| canvas > Export >
| in Channels Palette >
| Channels > Export Flat-
| canvas > Export Flat-
| in Channels Palette >
Pastes any cut or copied
channel and associated layers
from the clipboard to the
channels list.
Exports the current channel to
a series of files.
Exports all the channels in the
channels palette to a series of
files.
Exports the channels for all
the objects in your project to
a series of files.
Flattens the current channel
and exports it to a series of
files.
Export Dialog
Box
Export Dialog
Box
Export Dialog
Box
Export Dialog
Box
Flatten and
export all channels
The Foundry
•
Menubar
tened > Export All Channels Flattened
Right-click
•
tened > Export All Channels Flattened
Right-click
•
Export Flattened > Export All Channels Flattened
| Channels > Export Flat-
| canvas > Export Flat-
| Channels Palette >
Flattens all the channels in the
channels palette and exports
it to a series of files.
Export Dialog
Box
Mari 2.0v1
CHANNEL FUNCTIONS
22
Flatten and
export everything
Import into a
layer stack
Import into a new
channel
Resize channel
Lock channel
•
Menubar
tened > Export Everything Flattened
Right-click
•
tened > Export Everything Flattened
Right-click
•
Export Flattened > Export Everything Flattened
•
Menubar
Import into Layer Stack
•Right-click
Import into Layer Stack
Right-click
•
Import > Import into Layer Stack
•
Menubar
Import into New Channel
Right-click
•
Import into New Channel
Right-click
•
Import > Import into New Channel
•Menubar
Right-click
•
Resize
•Menubar
•Right-click
Palette > Lock Channel
• Button
| Channels > Export Flat-
| canvas > Export Flat-
| Channels Palette >
| Channels > Import >
| canvas > Import >
| in Channels Palette >
| Channels > Import >
| canvas > Import >
| in Channels Palette >
| Channels
| in Channels Palette >
| Channels > Lock Channel
| channel in Channels
| Channels Palette >
>
Resize
Flattens the channels for all
objects in your project and
exports them to a series of
files.
Imports the file as layers into
the layer stack of your current, selected channel.
Import the file as a new channel in the Channels palette.
Resize options are:
• 256x256
• 512x512
• 1024x1024
• 2048x2048
• 4096x4096
• 8192x8192
• 16384x16384
• 32768x32768
•Half Size
•Double Size
Lock the selected channel so
that the channel nor any of
the layers in the associated
layer stack can be edited or
deleted.
Export Dialog
Box
Import Dialog
Box
Import Dialog
Box
Lock icons in the Chan-
nels Palette show the
current state of the
channel.
The Foundry
Mari 2.0v1
CHANNEL FUNCTIONS
23
Unlock channel
Lock all channels
Unlock all channels
View the Next
Channel
•Menubar
nel
•Right-click
Palette > Unlock Channel
• Button
•Menubar
Channels
•Right-click
Lock All Channels
•
Menubar
Channels
Right-click
•
Unlock All Channels
•
Menubar
Right-click
•
Next Channel
Keyboard
•
•
Mouse
| Channels > Unlock Chan-
| channel in Channels
| Channels Palette >
| Channels > Lock All
| Channels Palette >
| Channels > Unlock All
| Channels Palette >
| Channels > Next Channel
| in Channels Palette >
| Page Down
|
Unlocks the selected channel
so that the channel or the layers within the layer stack can
be edited.
Locks all the channels in the
Channels palette, regardless
of what is selected.
Unlock all the channels in the
Channels palette, regardless
of what is selected.
Selects the next channel in the
list.
Lock icons in the Chan-
nels Palette show the
current state of the
channel.
In addition to the
unlock options listed
here, you can also
unlock channels by
selecting Unlock Entire
Object.
View the Previous
Channel
Snapshot all
channels
Snapshot the current channel
•Menubar
Channel
•Right-click
Previous Channel
•Keyboard
•Mouse
•
Menubar
Snapshot All Channels
Right-click
•
Snapshots > Snapshot All Channels
•
Menubar
Snapshot Current Channel
Right-click
•
Snapshots > Snapshot Current
Channel
| Channels > Previous
| in Channels Palette >
| Page Up
|
| Channels > Snapshots >
| in Channels Palette >
| Channels > Snapshots >
| in Channels Palette >
Selects the previous channel
in the list.
Takes snapshots of all the
channels in the channels palette.
Takes snapshots of only the
current selected channel.
The Foundry
Mari 2.0v1
CHANNEL FUNCTIONS
24
Manage snapshots
Delete all snapshots
•
Menubar
Manage Snapshots
Right-click
•
Snapshots > Manage Snapshots
•Menubar
Delete All Snapshots
•Right-click
Snapshots > Delete All Snapshots
| Channels > Snapshots >
| in Channels Palette >
| Channels > Snapshots >
| in Channels Palette >
Opens the Snapshots Palette.
Deletes all the snapshots
taken for the current project.
The Foundry
Mari 2.0v1
8 LAYER FUNCTIONS
Function How to access it What it does
Add new layer
•Menubar
Layer
Right-click
•
Add New Layer
•
Button
| Layers > Add New
| in Layers Palette >
| Layers Palette >
Adds a new layer to the
layers list.
Opens this dialog
box
Notes
Add adjustment layer
Add procedural layer
Cut layer or layer mask
Copy layer or layer
mask
•Menubar
ment Layer
•Right-click
ette > Add Layer Adjustment
•Button
•Menubar
dural Layer
Right-click
•
Add Procedural Layer
Button
•
•Menubar
•Right-click
ette > Cut
•Menubar
> Cut
•Right-click
Palette > Layer Mask > Cut
•Menubar
•Right-click
ette > Copy
•Menubar
> Copy
•Right-click
Palette > Layer Mask > Copy
| Layers > Add Adjust-
| layer in Layers Pal-
| Layers Palette >
| Layers > Add Proce-
| in Layers Palette >
| Layers Palette >
| Layers > Cut
| layer in Layers Pal-
| Layers > Layer Mask
| layer mask in Layers
| Layers > Copy
| layer in Layers Pal-
| Layers > Layer Mask
| layer mask in Layers
Adds the selected filter as
an Adjustment layer to
the layers list.
Adds the selected Basic,
Environment, Geometry,
or Procedural layer to the
layers list.
Cuts the layer from the
layers list to allow you to
paste it elsewhere in the
project or temporarily
remove it.
Copies the layer from the
layers list to allow you to
paste it elsewhere in the
project.
Following the arrows
in the Add Adjustment Layer menu
leads to a choice of
25 adjustment layers.
Following the arrows
in the Add Procedural Layer menu
leads to a choice of
27 procedurals.
Function How to access it What it does
Paste layer or layer
mask
• Menubar
•Right-click
ette > Paste
• Menubar
> Paste
•Right-click
Palette > Layer Mask > Paste
| Layers > Paste
| layer in Layers Pal-
| Layers > Layer Mask
| layer mask in Layers
Pastes a cut or copied
layer into the selected
location in the project’s
Layers Palette. Layers can
be paste as a copy in the
layer list, or as a new
layer in a mask group or
adjustment stack.
Opens this dialog
box
LAYER FUNCTIONS
Notes
26
Duplicate layer
Remove layers •
Merge layers •
Add empty layer group
Group layers •
Flatten layer group
Button
•
•
•Right-click
•Button
•Right-click
| Layers Palette >
Right-click
ette > Remove Layers
Button
Right-click
ette > Merge Layers
Add Layer Group
Right-click
ette > Group Layers
ette > Flatten Layer Group
| layer in Layers Pal-
| Layers Palette >
| layer in Layers Pal-
| in Layers Palette >
| Layers Palette >
| layer in Layers Pal-
| layer in Layers Pal-
Creates an exact copy of
the selected layer.
Removes the selected
layer from the current
project.
Merges two or more layers together into a single
new layer.
Adds an empty layer
group, which allows you
to add layers, masks,
adjustments or procedurals within a single layer
group.
Gathers multiple selected
layers together under a
single group.
Reduces multiple layers
into a single layer, where
all the textures are still
present.
’Copy’ is added to the
layer name to denote
which layer is the
duplicate.
Any masks or layer
groups contained in
the selection will also
be merged into the
layer and are no longer displayed as
masks or groups.
These layer groups
can be flattened to
create a single layer.
Selected layers are
located under a parent layer, which is
given a ‘group’ name.
The Foundry
Mari 2.0v1
Function How to access it What it does
Add mask
• Menubar
> Add Mask
•Right-click
ette > Layer Mask > Add Layer
Mask
| Layers > Layer Mask
| layer in Layers Pal-
Adds a layer mask to the
selected layer. Choose to
Reveal All, Hide All, or to
create From Alpha.
Opens this dialog
box
LAYER FUNCTIONS
Notes
27
Bake mask •
Remove mask •
Make mask group
Flatten mask group
Enable mask
•Button
•
•
• Menubar
•Right-click
• Menubar
•Right-click
• Menubar
•Right-click
| Layers Palette >
Menubar
> Bake Mask
Right-click
ette > Layer Mask > Bake Mask
Menubar
> Remove Mask
Right-click
ette > Layer Mask > Bake Mask
> Make Mask Group
ette > Layer Mask > Make Mask
Group
> Make Mask Group
ette > Flatten Mask Group
> Enable Mask
Layer Mask > Enable Mask
| Layers > Layer Mask
| layer in Layers Pal-
| Layers > Layer Mask
| layer in Layers Pal-
| Layers > Layer Mask
| layer in Layers Pal-
| Layers > Layer Mask
| layer in Layers Pal-
| Layers > Layer Mask
| in Layers Palette >
Bakes the mask into the
layer, essentially flattening it.
Remove the mask from
the layer.
Creates a mask layer
group from a single mask
on a layer. Requires the
selected layer to have a
mask.
Reduces the masks in a
mask group back into a
single mask on the layer.
Enables the mask to be
viewed on the model.
Clicking the mask
group icon
opens an undocked
mask group palette.
Disable mask
Add secondary adjustment
The Foundry
• Menubar
> Disable Mask
•Right-click
Layers Mask > Disable Mask
• Menubar
Adjustment > Add Secondary
Adjustment
•Right-click
Layers Palette
Adjustment
| Layers > Layer Mask
| in Layers Palette >
| Layers > Secondary
| adjustment layer in
> Secondary
Disables the mask from
being viewed on the
model. Disabling the mask
only temporarily removes
it from view.
Allows you to add another
type of adjustment to the
selected adjustment layer.
To remove the mask
entirely, simply
Remove Mask in the
same menu.
This only applies to
adjustment layers.
The option appears
grayed out if the
selected layer isn’t an
adjustment.
Mari 2.0v1
Function How to access it What it does
Remove secondary
adjustment
Add adjustment stack
Bake adjustment stack
• menubar
Adjustment > Remove Secondary Adjustment
•Right-click
Layers Palette > Remove Sec-
ondary Adjustment
• Menubar
Stack > Add Adjustment Stack
•Right-click
ette > Adjustment Stack > Add
Adjustment Stack
• Menubar
Stack > Bake Adjustment Stack
•Right-click
ette > Adjustment Stack > Bake
Adjustment Stack
| Layers > Secondary
| adjustment layer in
| Layers > Adjustment
| layer in Layers Pal-
| Layers > Adjustment
| layer in Layers Pal-
Removes any secondary
adjustment that has been
applied to the selected
adjustment layer
Adds an adjustment stack
to the selected layer. Add
adjustment layer from the
menu of 21 Filter adjustment layers.
Bakes an adjustment
stack down, essentially
flattening the stack into a
single adjustment layer.
Opens this dialog
box
LAYER FUNCTIONS
Notes
This only applies to
adjustment layers.
The option appears
grayed out if the
selected layer isn’t an
adjustment.
This only applies to
layers other than
adjustment layers.
28
Remove adjustment
stack
Enable adjustment
stack
Disable adjustment
stack
Convert to paintable
• Menubar
Stack > Remove Adjustment
Stack
•Right-click
ette > Adjustment Stack >
Remove Adjustment Stack
• Menubar
Stack > Enable Adjustment
Stack
•Right-click
ette > Adjustment Stack >
Enable Adjustment Stack
• Menubar
Stack > Disable Adjustment
Stack
•Right-click
ette > Adjustment Stack > Dis-
able Adjustment Stack
• Menubar
Paintable
•Right-click
ette > Convert to Paintable
| Layers > Adjustment
| layer in Layers Pal-
| Layers > Adjustment
| layer in Layers Pal-
| Layers > Adjustment
| layer in Layers Pal-
| Layers > Convert to
| layer in Layers Pal-
Removes any adjustment
stack that has been
applied to the selected
layer.
If an adjustment stack
has been disabled, this
option re-enables the
adjustment stack.
Disables an adjustment
stack to show the paint
layer result as it is without the stack. Useful for
comparing the model with
and without the adjustment stack.
This only applies to
layers other than
adjustment layers.
This only applies to
adjustment stacks
that have been disabled. If a layer does
not have an adjustment stack, or if the
stack is already
enabled, the option
appears grayed out.
This only applies to
adjustment stacks
that have been added
to a layer. If a layer
does not have an
adjustment stack, the
option appears
grayed out.
The Foundry
Mari 2.0v1
Function How to access it What it does
Share As channel
• Menubar
Share As Channel
•Right-click
ette > Sharing > Share As Chan-
nel
| Layers > Sharing >
| layer in Layers Pal-
Copies the selected layer
into the Channels Palette
as a new Channel. Clicking
on the channel icon opens
a new palette with the
shared layer already
listed.
Opens this dialog
box
LAYER FUNCTIONS
Notes
29
Unshare layer
Make shared channel
current
Cache layer
Cache up to here
Uncache layer
Uncache layer up to
here
• Menubar
Unshare Layer
•Right-click
ette > Sharing > Unshare Layer
• Menubar
Make Shared Channel Current
•Right-click
ette > Sharing > Make Shared
Channel Current
• Menubar
•Right-click
ette > Cache Layer
• Menubar
Here
•Right-click
ette > Cache Up To Here
• Menubar
Layer
•Right-click
ette > Uncache Layer
• Menubar
To Here
•Right-click
ette > Uncache Up To Here
| Layers > Sharing >
| layer in Layers Pal-
| Layers > Sharing >
| layer in Layers Pal-
| Layers > Cache Layer
| layer in Layers Pal-
| Layers > Cache Up To
| layer in Layers Pal-
| Layers > Uncache
| layer in Layers Pal-
| Layers > Uncache Up
| layer in Layers Pal-
If you have shared a layer
as a channel, you can
undo the shared state by
selecting this option.
Bakes the layer to speed
up layer performance.
Caching a layer caches it
to the hard-disk.
Caches up to the current
selected layer in the layer
stack.
Release the cached files
and unlocks the layer
stack, allowing it to be
edited again.
Releases the cached files
and unlocks the layer
stack up to the selected
layer, allowing those layers to be edited again.
Unsharing the layer
to remove the shared
state doesn’t remove
the channel from the
Channels Palette. This
need to be done manually.
Export selected layers
• Menubar
Export Selected Layers
•Right-click
ette > Export > Export Selected
Layers
The Foundry
| Layers > Export >
| layer in Layers Pal-
Exports the selected layer
to an external source.
Export Dialog
Box
Mari 2.0v1
Function How to access it What it does
Export all layers
• Menubar
Export All Layers
•Right-click
ette > Export > Export All Lay-
ers
| Layers > Export >
| layer in Layers Pal-
Exports all the layers in
the layer stack to an
external source.
Opens this dialog
box
Export Dialog
Box
LAYER FUNCTIONS
Notes
30
Export selected layers
flattened
Export all layers flattened
Import into layer
Import into layer stack
Inspect layer properties •
Refresh layer view
• Menubar
tened > Export Selected layers
Flattened
•Right-click
ette > Export > Export Selected
Layers Flattened
• Menubar
tened > Export All Layers Flattened
•Right-click
ette > Export > Export All Lay-
ers Flattened
• Menubar
Import into Layer
•Right-click
ette > Import > Import into
Layer
• Menubar
Layer Stack
•Right-click
ette > Import > Import into
Layer Stack
Right-click
ette > Layer Properties
•Right-click
Refresh Layer View
| Layers > Export Flat-
| layer in Layers Pal-
| Layers > Export Flat-
| layer in Layers Pal-
| Layers > Import >
| layer in Layers Pal-
| Layers > Import into
| layer in Layers Pal-
| layer in Layers Pal-
| in Layers Palette >
Exports the selected layer
or layers flattened into a
single file to an external
source.
Exports all the layers in
the layer stack flattened
into a single file to an
external source.
Selects a file with paint or
mask data to be imported
into the selected layer.
Selects a file with paint or
mask data to be imported
into the current layer
stack.
Opens a separate window to display the properties of the selected
layer.
Refreshes the entire layer
stack.
Export Dialog
Box
Export Dialog
Box
Import Dialog
Box
Import Dialog
Box
The Foundry
Mari 2.0v1
Loading...