Extension Pack for MARI

Released by Jens Kafitz, 2021 - www.MariExtensionPack.org   | Join us on  &

---

• Download Online Help

---

RELEASE: January 5th, 2021

BACKWARDS COMPATIBLE TO: Extension Pack 5 + 5 R2 | R3 | R4

MINIMUM REQUIREMENT (for Mari 4.x):  MARI 4.1v2

RECOMMENDED:  MARI 4.7v1 or higher

               

---

• Introduction
• New Features
• Feature Changes
• Feature Deprecations
• Bugfixes

• Studio Deployment Updates

ICONLEGEND

New Feature       Feature Update       Feature available in Nodegraph only       Feature requires Mari 4.7 or higher  

• The focus of 5 R5 is making use of additional functionality added in Mari 4.7 as well as fixing a large number of reported bugs

 For a full overview of the features released in Extension Pack 5 see each dedicated release notes.

• Extension Pack 5 R4 Release Notes
• Extension Pack 5 R3 Release Notes
• Extension Pack 5 R2 Release Notes
• Extension Pack 5 R1 Release Notes

• You can now easily align Nodes or Backdrops with each other (Left, Right, Top, Bottom) using the Right Mouse Click Menu or the Hotkeys

CTRL + ALT + Left/Right/Up/Down

• Dragging an Image from the Image Manager into the Layerstack or Nodegraph will now let you choose which node to use the image in.

To make it a quick process for common nodes, the most used ones are mapped to quick access Hotkeys (1-6)

• To make it easier to set up a Height Blend system between Nodegraph nodes or materials, a new 'Smart Height Blend' Option has been added.

 Smart Height Blend will ...

• with two nodes selected, auto connect the nodes to the FG/BG Ports of the Height Blend and connect the result to a Mask slot of

a already connected node (e.g. Merge, Mix etc.)

• with two materials selected,  auto connect the materials 'Displacement' Ports to the FG/BG Ports of the Height Blend and connect the result

 to a Mask slot of a already connected node  (e.g. Multi-Channel Merge, Mix etc.)

• If no node is selected or only one node is selected, the standard Mari behavior is maintained.

The Smart Height Blend Option is mapped to the default Nodegraph Shortcut CTRL+ALT+H and is also available from the Create Nodes Marking Menu

• In a recent version the 'Smart Merge Node' Functionality was introduced. Depending on selection type pressing for example 'M' in the Nodegraph

creates either a standard Merge Node or a Multi-Channel Merge Node (for material blending).

In this version the Smart Merge got ... smarter.

• MultiChannel Merge Nodes will now be properly hooked up to the selected material nodes. Same as you are used to with 

standard Merge Nodes

• Selecting 2 Nodes (Materials or other nodes) and creating a Merge Node now auto-connects the two material nodes to the Base and

Over Port(s) of the Merge or MultiChannel Merge Node.

The 'Smart Merge' Functionality is mapped to Hotkey 'M' in the Nodegraph and now also available via the  Create Nodes Marking Menu

• Additional Grunge Textures have been added to the Grunge Library in the Shelf

• For Users developing their own Python Scripts, new Helper Dialogs have been added to the Python Tools:

• Mari Node Paths
• MIME Type Inspector

• The Post Process Dialog now warns you if you are using Variables that are reserved for 'per file' post processes, in 'per channel' mode

• The Post Process Dialog now checks if an executable path on an active command line exists before closing the dialog

• The Post Process Dialog now shows examples of commands, if you have not set your own commands previously. Standard examples are

• Arnold TXMake
• Vray img2tiledExr
• OpenExr exrmaketiled

• 'Export only modified Textures' now is aware of the different node streams within a MultiChannel Node 

(e.g. Materials, Multi Channel Bake Points, Group Nodes with multiple Outputs).

While previously for example a material would trigger an export of all associated channels when even a single stream changed, the Exporter will

now correctly identify what part of the material has changed and only mark the relevant node stream for export.

• The Colorspace dropdown in the Add Packed Channel Dialog has been reworked to have better separation between pre-defined

colorspace roles and colorspaces

With the introduction of the new shelf in Mari 4.7, some Extension Pack Tools have been changed to make use of the new shelf features.

These changes only apply when using Mari 4.7 or above. Shelf functionality for previous Mari Versions remains unchanged.

• Extension Pack Items added to the standard Mari Shelf are now grouped under 'Extension Pack'

• Extension Pack Material Templates added to the standard Mari Shelf, are now receiving searchable Tags

• Create Shelf from Folder Icon now appears in the new Mari 4.7 Shelf as well, available directly after Mari startup (as opposed to within a project only)

• Create Shelf from Folder now supports loading of custom procedurals

• Create Shelf from Folder now supports Grouping of loaded Shelves

• Create Shelf from Folder now lets the user choose to resolve shelf name conflicts when importing instead of importing items into existing shelves always

• Dragging a Color from the Shelf to the Layerstack will now automatically create a Color Node/Layer for you. Mari 4.7 already allows for dragging a color from Shelf to the Nodegraph

• When using Mari 4.7 or higher, the Extension Pack Mask Shelf now supports drag & drop into both Nodegraph and Layerstack

(previously only Nodegraph drag and drop was supported)

• When using one of the Extension Pack custom Tools Toolbars , the new 'Current Material' Shader Mode introduced in Mari 4.7 is now included.

The Toolbar gets dynamically upgraded/downgraded when switching from e.g. Mari 4.6 to Mari 4.7 or vice versa.

• Changing the Paint Buffer Bitdepth via the Toolbar now automatically clamps or unclamps the Paintbuffer based on selected bitDepth

• The Rename Nodes Dialog now does not block the user from interacting with the main Mari Window

• Text Fields are now reset to empty once Apply is clicked

• The new Node Selection Options introduced in Mari 4.7 have been added to the existing Extension Pack options in the

Nodegraph/Selection Menu (in case you forget all the hotkeys)

• Jump to Node Input (Nodegraph Hotkey '[' ) will now list the name of connected nodes next to the input port they are connected to

• Added a warning dialog to Ingest from Image Manager, when attempting to delete the auto-generated 'My Favourites' Preset

• Isolate Select now works in Selection Mode: Object  as well 

• Several Extension Pack Nodegraph Tools will execute up to 40% faster due to a refactoring for Mari 4.7+. 

Most notable speed improvements are in 

• Swap Node Type
• Duplicate with Connections
• importing Presets from Mask Shelf via Drag & Drop
• parts of the Smart Mask Setup Process

• Added more informative Error Messages to Licensing Dialog when Licensing failed due to an invalid Operating System SSL Certificate.

• Added more informative Error Messages to Licensing Dialog when Licensing failed due to a Write Permission Error

• Added a Internet Connectivity Check to the Licensing Dialog

• A new Environment Variable  MARI_EP_CONNECTION_TIMEOUT has been exposed. This Environment Variable can be used to set the number of seconds

Extension Pack should wait for a license server response and can be useful to reduce Mari Startup Time or handle slow Internet Connections

• The Action Finder Dialog now allows you to trigger actions for testing

Due to overlapping features with core functionality introduced in Mari 4.7, the following Extension Pack Features have been removed when

using Mari 4.7 or higher:

• The Merge Node Set Colorspace Enabled Preference has been removed for Mari 4.7 or higher, since newer Mari Versions now handle

Merge Nodes 'Set Colorspace Enabled' Node Property correctly by default in the Nodegraph

• When using Mari 4.7+, all Extension Pack Bake Point Functionality has been removed, since Mari 4.7 and higher provides sufficient

      Bake Point Management by default.

• Create Channel from custom Resolution Template has been removed (it only existed in the Extension Pack Menu and was under-developed)

• If installation of default Hotboxes failed for whatever reason (e.g. permissions), Mari Extension Pack would not continue loading

• Extension Pack tried & failed with an Error to look for the Renderman for Mari Shader if launched on Mari Versions below 4.5v1

• Running a manual 'Smart Mask Setup' Process via the Nodegraph / Masks Submenu would create the necessary bakes in your project

but not hook them up to a selected Smart Mask. 

As originally intended, the Option will now setup any selected Smart Mask Nodes and if none is selected, run a generic setup to prepare

your scene for future Smart Mask Use.

• Running a 'Smart Mask Setup' Process via the Nodegraph/ Masks Submenu would no longer create a Radio Transmitter on the Ambient 

Occlusion

• Drag'n'Drop of Smart Masks from the Mask Shelf into the Nodegraph no longer automatically opened the 'Smart Mask Setup' Dialog

• Some Smart Masks contained references to old Extension Pack Versions

• While working with Mari on Remote Desktops, some Extension Pack Nodegraph Tools did not work when working inside a Material or Graph Group

• A change introduced in 5 R4 in the way layer selections were detected caused errors if a layerstack had a channel layer. 

A number of Extension Pack Tools operating on the Layerstack were affected.

('Ingest Images into current Layer', 'Convert to Paintable', 'Clone & Merge' etc.)

• Toggle Unselected Visibility & Toggle Unselected Lock no longer worked in Mari 4.5v1 and higher

• Toggle Un+Selected Visibility & Toggle Un+Selected Lock no longer worked in Mari Versions below Mari 4.5v1

• Creating a Pinned Channel from the Channel Palette no longer worked

• Fixed a bug when saving Project Templates, where the saved Light Orientation 'Fixed to Camera/Scene' was not loaded when importing a template

• Project Templates did not save mari preference items containing color information into the Template 

• Images with a certain Alpha encoding would load as transparent inside the Nodes Axis Projection, Image, Tiled Extended and

Cylindrical Projections when using the following OCIO Files 

• ACES
• SPI-anim
• SPI-vfx

• Material ID from Selection Groups would abort with an error when trying to overwrite existing Material ID Channels with the same name

• The line width of the Horizontal/Vertical Line Separator Buttons in custom Hotboxes was set too small, making them no longer visible.

• Clicking on a button in the Hotbox manager preview area would cause the preview to disappear

• Due to a bug in Mari, transform changes to Decals via the Viewport Locator would only be applied permanently if a navigation change 

was made in the viewport before completing the decal transformation.  Extension Pack 5 R5 now ensures the transformation stays permanent regardless.

• Manual Image Reload via Image Manager / Reload / Reload Image no longer worked

• Auto-Image Reloading of updated Images send Mari into an endless loading loop

• When using Swap Node Type / Swap Layer Type to swap between Material Templates with different Specular Workflows

(Roughness vs Glossiness), the Specular Values would only be converted if an Image was mapped to the Roughness/Glossiness

Attribute of the Material Template. After this fix, constant slider settings are now also converted between Roughness <-> Glossiness.

• Swap Node Type / Swap Layer Type allowed the user to select Backdrop nodes as a target.

• Swap Node Type / Swap Layer Type did not copy the Color/Scalar  setting of Color Attributes

• The 'Patches/Resize Selected/Double Size' Action did not work due to a typo in the internal naming

• There was a typo in the 'Patches/Resize Selected/Double Size' UI Name

• Patch to Image Manager had stopped working in a recent 5 R.x Release

• Users were able to delete default Export Presets in Export Custom Channel Selection Dialog

• The  Color/Scalar setting of Color Attributes was not taken into account when using 'Only Modified UDIM' Export Setting.

• Users were able to delete default Presets in the Add Packed Channel Dialog

• When Extension Pack Resources were moved out of the Installation directory using the Resource Relocation system,

the History of Recent Files in the New Project window was getting longer and longer with each Mari restart

• When Extension Pack Resources were moved out of the Installation directory using the Resource Relocation system,

the History of Recent Material Templates in the Mari Material Ingester was getting longer and longer with each Mari restart

• If you have previously downloaded the Help Files for offline usage you should replace it with the new one using the method described here

• A warning dialog has been added on Mari Start, if the Extension Pack Resources currently loaded do not belong to the current Extension Pack Version.

This is to avoid studios forgetting to update moved Extension Pack resources (icons, shelf content etc.)

• A new Environment Variable  MARI_EP_CONNECTION_TIMEOUT has been exposed. This Environment Variable can be used to set the number of seconds

Extension Pack should wait for a license server response and can be useful to reduce Mari Startup Time for air-gapped studios