Table Of ContentGetting Started Guide
VERSION 2.6 1
V
Mari™GettingStartedGuide.Copyright©2014TheFoundryVisionmongersLtd.AllRightsReserved.UseofthisGettingStartedGuide
andtheMarisoftwareissubjecttoanEndUserLicenseAgreement(the"EULA"),thetermsofwhichareincorporatedhereinby
reference.ThisGettingStartedGuideandtheMarisoftwaremaybeusedorcopiedonlyinaccordancewiththetermsoftheEULA.This
GettingStartedGuide,theMarisoftwareandallintellectualpropertyrightsrelatingtheretoareandshallremainthesolepropertyof
TheFoundryVisionmongersLtd.("TheFoundry")and/orTheFoundry'slicensors.
TheEULAcanbereadintheMariUserGuideAppendices.
TheFoundryassumesnoresponsibilityorliabilityforanyerrorsorinaccuraciesthatmayappearinthisGettingStartedGuideandthis
GettingStartedGuideissubjecttochangewithoutnotice.ThecontentofthisGettingStartedGuideisfurnishedforinformationaluse
only.
ExceptaspermittedbytheEULA,nopartofthisGettingStartedGuidemaybereproduced,storedinaretrievalsystemortransmitted,in
anyformorbyanymeans,electronic,mechanical,recordingorotherwise,withoutthepriorwrittenpermissionofTheFoundry.Tothe
extentthattheEULAauthorizesthemakingofcopiesofthisGettingStartedGuide,suchcopiesshallbereproducedwithallcopyright,
trademarkandotherproprietaryrightsnoticesincludedherein.TheEULAexpresslyprohibitsanyactionthatcouldadverselyaffectthe
propertyrightsofTheFoundryand/orTheFoundry'slicensors,including,butnotlimitedto,theremovalofthefollowing(oranyother
copyright,trademarkorotherproprietaryrightsnoticeincludedherein):
Mari™software©2014TheFoundryVisionmongersLtd.AllRightsReserved.
Mari™isatrademarkofTheFoundryVisionmongersLtd.
Weta™DigitalisatrademarkofWetaDigitalLtd.
Inadditiontothosenamessetforthonthispage,thenamesofotheractualcompaniesandproductsmentionedinthisGettingStarted
Guide(including,butnotlimitedto,thosesetforthbelow)maybethetrademarksorservicemarks,orregisteredtrademarksorservice
marks,oftheirrespectiveownersintheUnitedStatesand/orothercountries.Noassociationwithanycompanyorproductisintendedor
inferredbythementionofitsnameinthisGettingStartedGuide.
Linux®isaregisteredtrademarkofLinusTorvalds.
Windows®istheregisteredtrademarkofMicrosoftCorporation.
MacandMacOSXaretrademarksofApple,Inc.,registeredintheU.S.andothercountries.
Adobe®andPhotoshop®areeitherregisteredtrademarksortrademarksofAdobeSystemsIncorporatedintheUnitedStatesand/or
othercountries.
Maya®isaregisteredtrademarkofAutodesk,Inc.,intheUSAandothercountries.
Marisoftwareengineering:JackGreasley,KiyoyukiNakagaki,MarcusShoo,KevinAtkinson,TimEbling,JedSoane,DanielLond,Robert
Fanner,DuncanHopkins,MarkFinal,ChrisBevan,CarlRand,PhilHunter,TimSmith,andRajivPerseedoss
Producttesting:MichaelZannetou,MarkTitchener,RobertElphick,AntoniKujawa,ChrisHiess,JorelLatraille,andJohnCrowe
Writingandlayoutdesign:JackElder,JonHertzig,EijaNärvänen,CharlesQuinn,andEricaCargle
Proofreading:JackElder,EijaNärvänen,JoelByrne,CharlesQuinn,EricaCargle,SimonPicard,andEmeliaFiell
MariincludesDisneytechnologylicensedfromWaltDisneyAnimationStudios.
TheFoundry
5GoldenSquare,
London,W1F9HT
Rev:26March2014
Contents
1 Preface
AboutThisGuide 8
ContactCustomerSupport 8
2 Installation and Licensing
SystemRequirements 9
Windows 10
InstallationonWindows 11
LaunchingonWindows 11
LicensingonWindows 12
Linux 17
InstallationonLinux 17
LaunchingonLinux 18
LicensingonLinux 19
MacOSX 24
InstallationonMac 24
LaunchingonMac 25
LicensingonMac 26
3 Mari Model Requirements
ModelRequirements 31
4 The Mari Workspace
WhatItLooksLike 33
5 Managing Projects
CreatingaNewProject 34
OpeningExistingProjects 37
UsingtheCommandLine 37
SavingYourProject 38
6 Configuring Your Workspace
Palettes 39
Shelves 40
CustomizingShelves 40
7 Channels
AddingaChanneltoaProject 41
AddingaSetofChannels 42
8 Layers
AddaLayertoaLayerStack 43
AddaMasktoaLayer 43
AddanAdjustmenttoaLayerStack 44
AddaProceduraltoaLayerStack 44
GroupLayers 44
9 Shaders
CreateaShader 46
10 Changing the View
3DNavigation 48
Lighting 49
11 Painting
PaintTools 51
PaintingaConstantColor 51
CustomizingYourBrush 52
“PaintingThrough”anImage 52
CloneStamping 53
MovingandWarpingPaint 54
BakingPaintontotheModel 55
BlurringBakedPaint 55
12 Exporting and Importing
ExportingChannels 56
ExportingLayers 58
ImportingChannels 58
ImportingLayers 60
13 About the Tutorials
DownloadSampleFiles 62
TutorialFormat 62
Tutorial 1: Setting up a Project
WhatYouShouldKnowBeforeStartingThisLesson 63
ResourcesYouNeedtoCompleteThisLesson 63
HowLongShouldItTake? 63
AboutMariProjects 63
StepsforCreatingMariProjects 64
OpenaNewProject 64
SpecifyProjectOptions 65
LoadGeometry 66
SaveYourProject 67
WhereDoYouGofromHere? 67
Tutorial 2: Setting the View
WhatYouShouldKnowBeforeStartingThisLesson 69
ResourcesYouNeedtoCompleteThisLesson 69
HowLongShouldItTake? 69
AboutMariViewandLighting 70
StepsforSettingtheCameraandLighting 71
OpenYourProject 71
AdjusttheView 72
AdjusttheLighting 75
WhereDoYouGofromHere? 77
Tutorial 3: Painting!
WhatYouShouldKnowBeforeStartingThisLesson 78
ResourcesYouNeedtoCompleteThisLesson 78
HowLongShouldItTake? 78
AboutPaintinginMari 78
StepsforPaintinginMari 79
OpenYourProject 79
OpentheColorsandShelfPalettes 80
SelectaColor 82
SelectaBrush 83
Paint! 85
BakeYourPainting 86
WhereDoYouGofromHere? 87
Tutorial 4: Painting Through and Clone Stamping
WhatYouShouldKnowBeforeStartingThisLesson 88
ResourcesYouNeedtoCompleteThisLesson 88
HowLongShouldItTake? 88
AboutPaintingfromImagesinMari 88
StepsforPaintingThroughandCloneStamping 89
OpenYourProject 89
LoadanImage 90
PaintThrough 91
CloneStamp 95
WhereDoYouGofromHere? 96
Tutorial 5: Exporting and Importing
WhatYouShouldKnowBeforeStartingThisLesson 98
ResourcesYouNeedtoCompleteThisLesson 98
HowLongShouldItTake? 98
AboutMariExports 98
StepsforExportingandImporting 99
OpenYourProject 99
ExportaChannel 99
ExportaLayer 101
ImportaChannel 102
ImportaLayer 104
WhereDoYouGofromHere? 105
1 Preface
Mariisacreativetexture-paintingtoolthatcanhandleextremelycomplexortextureheavyprojects.Itwas
developedatWetaDigitalandhasbeenusedonfilmssuchasTheAdventuresofTintin:TheSecretoftheUnicorn,
District9,TheDaytheEarthStoodStill,TheLovelyBonesandAvatar.
ThenameMaricomesfromtheSwahili'Maridadi',meaning'beautiful'andcarryingconnotationsof'usefulness'.
About This Guide
ThisguideprovidesyouwiththebasicinformationyouneedtostartpaintingwithMari.
Thefirstpartofthemanual,InstallationandLicensing,describeshowtoinstall,license,andlaunchMari.
TherestofthemanualconsistsofafewshortchaptersdescribingMari’sbasicfunctionalityandfivetutorials,which
teachyouthebasicsofcreatingaMariprojectandpaintingtextures.Thetutorialsprovideaseriesofcomprehensive
walk-throughs,completewithgeometriesandassociatedtextures.Asyoufollowthestepsinthesetutorials,you'll
gainagoodfeelforMari'suserinterfaceandworkflow.This,inturn,providesagoodworkingknowledgeforcreating
morecomplexproductionprojects.
FormoredetailedinformationonMarianditsfunctions,seetheaccompanyingMariUserGuideandMariReference
Guide.
Contact Customer Support
Shouldquestionsarisethatthismanualfailstoaddress,youcancontactCustomerSupportdirectlyviae-mailatsup-
port@thefoundry.co.ukorviatelephonetoourLondonofficeon+44(0)2074794350ortoourLosAngelesoffice
on(310)399-4555duringofficehours.
2 Installation and Licensing
Tomaketheinstructionseasiertonavigate,specificinstructionsforhowtoinstall,launch,andlicenseMariare
groupedtogetherbyoperatingsystemsoyoucanquicklyfindeverythinginoneplace.
TheoperatingsystemssupportedbyMariare:
•Windows,
•Linux,and
•MacOSX.
System Requirements
EachoperatingsystemhasitsownsystemrequirementsforMari,andthisincludesapprovedgraphicscardrequire-
ments.Tochecktheindividualsystemrequirementsforeachoperatingsystem,see:
•WindowsSystemRequirements
•LinuxSystemRequirements
•MacSystemRequirements
Duetothenumberofcardsavailableinthemarket,weareunabletotesteverycardand,therefore,cannotofficially
qualifyallofthemindividually.However,ifyourmachine/GPUspecificationsmeettherequirementsmentioned,the-
oreticallyMarishouldworkfineforyou.Ifyouencounteranyissues,pleasecontactsupport@thefoundry.co.uk.
BelowisalistofapprovedgraphicscardsthathavebeentestedforusewithMari.
Mac OSXTestedGraphics Cards
•NVIDIAGeForceGT650M
•NVIDIAQuadro(FermiSeries)4000
Windows andLinuxTestedGraphics Cards
•NVIDIAGeForceGTX480
•NVIDIAGeForceGTX580
•NVIDIAGeForceGTX680
•NVIDIAQuadro(FermiSeries)4000
2INSTALLATIONANDLICENSING|WINDOWS
•NVIDIAQuadro(FermiSeries)5000
•NVIDIAQuadro(FermiSeries)6000
•NVIDIAQuadroK2000
•NVIDIAQuadroK4000
•NVIDIAQuadroK5000
•AMDFireProW7000
•AMDFireProW8000
•AMDFireProW9000
•AMDRadeonHD7850
•AMDRadeonHD7950
PleasedownloadandinstallthelatestgraphicsdriverforyourcardfromtheNVIDIAorAMDwebsites.
NOTE: Ensurethatyouareusing8.982.8.1(AMDCatalyst12.10)driversorhigherforAMDcards.
VirtualMemory Requirements
ItisrecommendedthatthesystemrunningMarihasplentyofvirtualmemoryavailabletouse,especiallywhenhand-
linglargeprojects.Theuseofvirtualmemoryimprovesstability,helpingtopreventdatalossonlargeprojects.
Windows
Windows SystemRequirements
•Windows764-bit.
•Quad-corex86-basedprocessor.
•250GBdiskspaceavailableforcachingandtemporaryfiles(oraminimumof50GBifyou'reworkingonasmallpro-
ject).
•Atleast4GBRAM.
•Displaywith1680x1050pixelresolution.
•AnNVIDIAorAMDgraphicscardwithatleast1GBofRAMandOpenGL3.2support(seeWindowsandLinuxTes-
tedGraphicsCards).
NOTE: DisplacementpreviewiscurrentlyonlyavailableonthecardsanddriversthatsupportOpenGL4.0
ornewer.
10
Description:Mar 26, 2014 Below is a list of approved graphics cards that have been tested for use Mari
2.6 is available to download from our web site at Python API.