Foundry VERSION 2.0V1 User manual

REFERENCE GUIDE
VERSION 2.0V1

Mari 2.0v1The Foundry
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

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

Mari 2.0v1
4
The Foundry
HELP FUNCTIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
TOOLBARS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
STATUS BAR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
CHANNELS PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
LAYERS PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
PATCHES PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100
OBJECTS PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
SHADERS PALETTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
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

Mari 2.0v1
5
The Foundry
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
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

Mari 2.0v1
6
The Foundry
CREATE SHADER DIALOG BOX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
MASK CHANNEL TOALPHA DIALOG BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205
SELECT PATCHES BYRANGE 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
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

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 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
Getting Started Guide . For full instructions on
using Mari, read the
User Guide .
The first part of this document describes all the functions within Mari,
broken up by functional area.
Contact
customer
support
Should questions arise that this manual fails to address, you can contact
Customer Support directly via e-mail at [email protected] or via
telephone to our London office on [phone] or to our Los
Angeles office on [phone] during office hours.

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 prop-
erty.
Click the icon, and fill
in the Add User
Attribute dialog box.
For more information, see the
Extending Mari chapter in the
Mari User Guide.
Buttons , Lets you select a
function.
Click it. May show an icon or a word.
Checkbox unselected, selected Lets you select an
option.
Click to select. An “x” displays when selected.
Control
sphere
Lets you move a light
around the scene.
Click and drag to pull
the light around.
Curve editor Maps between input
and output values
(45° = the same). Bar
along the bottom
displays the effect at
each point.
Drag to move points
on the graph. Add
points by clicking on
the curve or bar. Edit
a point by right-click-
ing it.
You can also remove a
point by clicking on it
while holding Ctrl.
Dropdown
list
Lets you select from
a list of valid values.
Click the down arrow
on the right, then click
to select an option.
Entry box Lets you type an
entry.
Click inside the box
and type a valid entry.
Often combined with a slider and
reset button.
Horizontal
slider
Slides along a range
of valid values.
Click and drag left
(more) or right (less).
Often combined with an entry box
(that shows the value) and reset
button.
Incrementers Lets you increment a
value up or down.
Click up or down
arrows to increment
up or down.

TYPES OF CONTROLS
Mari 2.0v1
9
The Foundry
List Lets you select from
a list of valid values.
Click to select an
option.
On/Off Indi-
cator on, off Shows whether an
option is on or off
Look at it. Often combined with a switch.
Option 
buttons
Lets you select
mutually exclusive
options.
Click to select which
option you want.
Circle is filled when selected.
Sometimes called “radio buttons”.
Remove 
attribute
Lets you remove an
attribute from a
property.
Click the icon, then
click Remove to con-
firm.
Reset button Reset to the default. Click the icon. Often combined with an entry box
and slider.
Swatch Displays the
currently selected
color, and lets you
select a different
color.
Click to select a color
from the 
Colors Palette.
Switch Turns an option on
or off.
Click and drag right
(on) or left (off).
Often combined with an On/Off
indicator.
Control What it looks like What it does How to use it Notes

TYPES OF CONTROLS
Mari 2.0v1
10
The Foundry
Tabs Displays several
groups of the same
kind of information,
such as different
categories of brush
tips in the 
Brush Editor Palette.
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
Thumbnail Displays a thumbnail
preview of a selected
feature or function.
Look at it.
Control What it looks like What it does How to use it Notes

3 PROJECT FUNCTIONS
Function How to access it What it does
Opens this dialog
box Notes
New project •
Menubar | File > New
•
Keyboard | Ctrl+N
•
Projects tab | New button
•
Projects tab | Right-click >
New
•
Toolbar |
Creates a new project. New Project Dialog
Box
Name the project, select
options, and add geometry.
Open a project •
Projects tab | Right-click >
Open
•
Projects tab | Double-click
Opens the selected project
(the project you right-
clicked on).
Open recent 
project
• Menubar | File > Open > 
<project name>
Opens a project, from a list
of the last 10 projects
opened.
Save project •
Menubar | File > Save
•
Keyboard | Ctrl+S
•
Toolbar |
Saves the current project.
Close project •
Menubar | File > Close
•
Keyboard | Ctrl+W
•
Toolbar |
Closes the current project. Save Changes
Before Closing? (if
unsaved changes)
Delete project •
Projects tab | Delete button
•
Projects tab | Right-click >
Delete
Deletes the selected project
from disk.
Open Archive •
Projects tab | Open Archive
button
•
Projects tab | Right-click >
Open Archive
Opens a project from an
archive file.
Import Archive
Archive Project •
Projects tab | Archive 
button
•
Projects tab | Right-click >
Archive
Saves the selected project to
disk as a Mari archive (.mra)
file.
The archive includes all the 
supporting files required for
the project.
Copy (Duplicate)
Project
•
Projects tab | Copy button
•
Projects tab | Right-click >
Copy
Creates a copy of the
selected project. 
The new copy appears in the
Projects tab.

4 PREFERENCE FUNCTIONS
Function How to access it What it does
Opens this dialog
box Notes
Set preferences
Menubar | Edit > Preferences Lets you set general prefer-
ences for Mari — cache size,
plug-ins, autosave fre-
quency, and so on.
Mari Preferences
Dialog Box
Edit toolbars Menubar | Edit > Toolbars Lets you create and edit cus-
tom toolbars.
Manage Toolbar
Dialog Box
Edit shortcuts Menubar | Edit > Shortcuts Lets you add or edit keyboard
shortcuts.
Manage Keyboard
Shortcuts Dialog Box
Configure
Heads-Up 
Display
Menubar | Edit > HUD Manager Lets you set what information
Mari shows in the Heads-Up
Display (HUD) behind the
model on the canvas.
HUD Manager Dialog
Box

5 SELECTION FUNCTIONS
Function How to access it What it does
Opens this
dialog box Notes
Object selection
mode •Selection toolbar |
•
Menubar | Selection >
Object Mode
•Right-click | canvas >
Object Mode
Sets Mari to select whole
objects.
Patch selection
mode •Selection toolbar |
•
Menubar | Selection >
Patch Mode
•
Right-click | canvas >
Patch Mode
Sets Mari to select patches
on objects.
Faces selection
mode •Selection toolbar |
•
Menubar | Selection >
Face Mode
•
Right-click | canvas >
Face Mode
Sets Mari to select areas on
the objects.
Hide unselected
areas
•
Menubar | Selection >
Hide Unselected
•
Right-click | canvas >
Visibility > Hide
Unselected
•
Right-click | Patches Pal-
ette > Hide Unselected
•
Keyboard | Shift+H
• Mouse |
Hides the unselected areas
on the canvas.
For the mouse gesture: press and
hold \, click and drag in the direc-
tion indicated. (A thin red line
traces gestures onscreen. Mari
1.2v1

SELECTION FUNCTIONS
Mari 2.0v1
14
The Foundry
Hide selected
areas
•
Menubar | Selection >
Hide Selected
•
Right-click | canvas >
Visibility > Hide Selected
•
Right-click | Patches Pal-
ette > Hide Selected
Patches
•
Keyboard | H
• Mouse |
Hides the selected areas on
the canvas.
For the mouse gesture: press and
hold \, click and drag in the direc-
tion indicated. (A thin red line
traces gestures onscreen.
Show selected
areas
•
Menubar | Selection >
Show Selected
•
Right-click | canvas >
Visibility > Show
Selected
•
Right-click | Patches Pal-
ette > Show Selected
Patches
Shows the selected areas on
the canvas.
Show all areas •
Menubar | Selection >
Show All
•
Right-click | canvas >
Visibility > Show All
•
Right-click | Patches Pal-
ette > Show All Patches
•
Keyboard | Ctrl+Shift+H
•
Mouse |
Displays all areas, selected
or not, on the canvas.
For the mouse gesture: press and
hold \, click and drag in the direc-
tion indicated. (A thin red line
traces gestures onscreen.
Show whole
object
• Menubar | Selection >
Show Entire Object
•
Right-click | canvas >
Visibility > Show Entire
Object
Shows all area, selected or
not, on only the selected
object.
Function How to access it What it does
Opens this
dialog box Notes

SELECTION FUNCTIONS
Mari 2.0v1
15
The Foundry
Select all areas •
Menubar | Selection >
Select All
•
Right-click | canvas >
Selection > Select All
•
Right-click | Patches Pal-
ette > Select All Patches
•
Button | Patches Palette
>
•
Keyboard | Ctrl+A
Selects all areas in the
model, depending on your
current selection mode
(objects, patches, or faces)
De-select all
areas
•
Menubar | Selection >
Select None
•
Right-click | canvas >
Selection > Select None
•
Right-click | Patches Pal-
ette > Select None
•
Keyboard | Ctrl+E
De-selects all areas on the
model.
Invert selection
of areas
•
Menubar | Selection >
Select Invert
•
Right-click | canvas >
Selection > Select Invert
•
Right-click | Patches Pal-
ette > Select Invert
Patches
•
Keyboard | Ctrl+I
De-selects the current
selection and selects every-
thing currently unselected.
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.
Select visible
areas
•
Menubar | Selection >
Select Visible
•
Right-click | canvas >
Selection > Select Visible
•
Right-click | Patches Pal-
ette > Select Visible
Patches
Selects only areas that
aren't hidden.
Lock unselected
areas
•Menubar | Selection >
Lock Unselected
•Right-click | canvas >
Locking > Lock
Unselected
•Right-click | Patches Pal-
ette > Lock Unselected
Patches
Locks unselected patches so
they cannot be edited.
Function How to access it What it does
Opens this
dialog box Notes

SELECTION FUNCTIONS
Mari 2.0v1
16
The Foundry
Lock selected
areas
•
Menubar | Selection >
Lock Selected
•
Right-click | canvas >
Locking > Lock Selected
•
Right-click | Patches Pal-
ette > Lock Selected
Patches
•
Button | Patches Palette
>
Locks selected areas, so
they cannot be painted.
Unlock selected
areas
•
Menubar | Selection >
Unlock Selected
•
Right-click | canvas >
Locking > Unlock
Selected
•
Right-click | Patches Pal-
ette > Unlock Selected
Patches
•
Button | Patches Palette
>
Unlocks selected locked
areas, so they are again
paintable.
Lock all areas •
Menubar | Selection >
Lock All
•
Right-click | canvas >
Locking > Lock All
•
Right-click | Patches Pal-
ette > Lock All Patches
Locks all areas, so they can-
not be painted.
Unlock all areas •
Menubar | Selection >
Unlock All
•
Right-click | canvas >
Locking > Unlock All
•
Right-click | Patches Pal-
ette > Unlock All Patches
Unlocks all locked areas, so
they are again paintable.
Unlock everything •
Menubar | Selection >
Unlock Entire Object
•
Right-click | canvas >
Locking > Unlock Entire
Object
Unlocks everything on the
current object, regardless of
whether it’s a face, patch, or
channel.
Create selection
group for patches
•
Right-click | canvas >
Create Patch Selection
Set
Creates a new selection set
consisting of whichever
patches you currently have
selected.
Creates a new selection set in the
Patches Palette
Function How to access it What it does
Opens this
dialog box Notes

SELECTION FUNCTIONS
Mari 2.0v1
17
The Foundry
Create selection
group
•
Right-click | canvas >
Create Selection Group
•
Button | Selection Groups
Palette >
Creates a new selection
group to save your selec-
tion modes.
You can create selection groups in
any selection mode (objects,
patches, or faces).
Reselect 
selection group
•
Right-click | selection
group in Selection
Groups Palette > Select
Selection Group
•
Button | Selection Groups
Palette >
Reselects the current selec-
tion group.
Lock the selection
group
•
Right-click | selection
group in Selection
Groups Palette > Lock
Selection Group
•
Button | Selection Groups
Palette >
Locks the selection group.
Unlock the 
selection group
•
Right-click | selection
group in Selection
Groups Palette > Unlock
Selection Group
•
Button | Selection Groups
Palette >
Unlocks the selection group.
Hide the selection
group
•
Right-click | selection
group in Selection
Groups Palette > Hide
Selection Group
•
Button | Selection Groups
Palette >
Hides the contents of the
selection group.
Function How to access it What it does
Opens this
dialog box Notes

SELECTION FUNCTIONS
Mari 2.0v1
18
The Foundry
Show the 
selection group
•
Right-click | selection
group in Selection
Groups Palette > Show
Selection Group
•
Button | Selection Groups
Palette >
Shows the contents of the
selection group.
Remove the
selection group
•Right-click | selection
group in Selection
Groups Palette > Remove
Selection Group
• Button | Selection Groups
Palette >
Function How to access it What it does
Opens this
dialog box Notes

6 OBJECT FUNCTIONS
Function How to access it What it does
Opens this
dialog box Notes
Add object •
Menubar | Objects > Add
Object
•
Right-click | Objects Palette >
Add Object
•
Button | Objects Palette >
Adds a new object to the
project.
Add Objects
Remove object • Menubar | Objects > Remove
Object
•
Right-click | Objects Palette >
Remove Object
•
Button | Objects Palette >
Removes the selected object
from the project.
Projects must always have at
least one object.
Add object 
version
• Right-click | Objects Palette >
Add Object Version
Lets you select a file con-
taining the new object ver-
sion data.
Add Version
Rename object
version
•
Right-click | Objects Palette >
Rename Object Version
Renames the current object
version.
Remove object
version
•
Right-click | Objects Palette >
Remove Object Version
Deletes the current object
version.
Objects must always have at
least one version.
Calculate 
ambient occlusion
•
Menubar | Objects > Ambient
Occlusion
•
Right-click | Objects Palette >
Ambient Occlusion
Calculates the ambient
occlusion for the object. This
is required for any opera-
tions that use the ambient
occlusion data (such as
using ambient occlusion
masking).
This can take a long time,
depending on the complexity
of the model.
Reset Move
Object - single
object
•
Mouse | Shift-click on the
object
Shift-click on the object
resets that object to its
original position.
Reset Move
Object - all
objects
•
Keyboard | ’Pressing the apostrophe key
resets all objects back to
their original positions.

7 CHANNEL FUNCTIONS
Function How to access it What it does
Opens this
dialog box Notes
Add channel • Menubar | Channels > Add Channel
•
Right-click | in Channels Palette >
Add Channel
•
Button | Channels Palette >
Adds a new channel to the
current project.
Add Channel
Dialog Box
Create channel
presets
• Menubar | Channels > Channel Pre-
sets
•
Right-click | in Channels Palette >
Channel Presets
Allows you to create a new
channel preset to use as a
template for new channels.
Channel Pre-
sets Dialog
Box
Click the checkbox for
channels you want to
add, and click OK. You
can customize avail-
able categories of
channel presets using
an XML file in a folder
specified in your pref-
erences.
Remove channel • Menubar | Channels > Remove
Channel
•
Right-click | in Channels Palette >
Remove Channel
•
Button | Channels Palette >
Removes the selected channel,
and any layers associated with
it, from the channels list.
Convert channel • Menubar | Channels > Convert
Channel
•
Right-click | in Channels Palette >
Convert Channel
•
Button | Channels Palette >
Changes the color depth of
the channel to either 8bit
(Byte), 16bit (Half), or 32bit
(Float).
Convert Type
Dialog Box
Determines number of
pixels per RGB channel.
Flatten channel •Menubar | Channels > Flatten
•
Right-click | in Channels Palette >
Flatten
Cut channel •Menubar | Channels > Cut
•
Right-click | in Channels Palette >
Cut
•
Keyboard | Ctrl+X
Cuts the channel and all asso-
ciated layers from the chan-
nels list and places it in the
clipboard.
Copy channel •Menubar | Channels > Copy
•Right-click | in Channels Palette >
Copy
•Keyboard | Ctrl+C
Copies the channel, and all
associated layers from the
channels list and places it in
the clipboard.