Released by Jens Kafitz, 2022 - www.MariExtensionPack.org   | Join us on ,or




Download Online Help





RELEASED ON:   August 17, 2022

LAST PATCH ON: May 3rd, 2023 - 5R9.v8


BACKWARDS COMPATIBLE TO: Extension Pack 5 + 5 R2 - 5 R8  


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

MINIMUM REQUIREMENT (for Mari 5.x):  MARI 5.0v3


RECOMMENDED (for Mari 4.x):  Mari 4.7v7 or Mari 4.8v3 or higher

RECOMMENDED (for Mari 5.x):  Mari 5.0v3 or higher





Mari Non-Commercial  is not supported due to restrictions by the Foundry

Mari 6.x  is not supported due to changes in Python Versions



               



Introduction

New Features

Bugfixes


Patch Notes

5R9.v2

5R9.v3

5R9.v4

5R9.v5

5R9.v6

5R9.v7

5R9.v8

5R9.v9


Studio Deployment Updates


ICONLEGEND


New Feature       Feature Update       Feature available in Nodegraph only    


Mari 4.7 or higher Mari 4.8 or higher   Mari 5.0 or higher   


EXTENSION PACK 5 R9

Welcome to Mari Extension Pack 5 R9, the 10th free update of the 5-Series and biggest R-Releases ever in the 5-Series.

Extension Pack 5 R9 is a major rewrite, updating the Plugin to Python 3.7.7 and QT 5.12.

This version is compatible with both Mari 4.x and Mari 5.x via separate installers


Dozens of new features aimed at improving the User Experience and nearly 60 bugfixes round of this big release - and despite its massive size,

it remains a free upgrade to existing Mari Extension Pack 5 Customers !


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


Extension Pack 5 R8 Release Notes

Extension Pack 5 R7 Release Notes

Extension Pack 5 R6.v2 Release Notes

Extension Pack 5 R6 Release Notes

Extension Pack 5 R5 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





NEW FEATURES

Click on a feature for more information

Extension Pack 5 R9 has been rewritten to support Python 3.7.7 and QT 5.12, making it compatible with Mari 5.x versions.

Extension Pack 5 R9 now ships in a Mari 4.x and a Mari 5.x version

By removing legacy compatibility checks for the Mari 5.x Version of Extension Pack 5 R9, multiple tools and nodes will now run faster




A new sub-menu 'Open with' has been added to the Image Manager Right Mouse Click Menu.
It allows you to open an image in 

Your File Browser

The OS default application associated to the File Format

Up to 10 freely configurable applications


By default, if found on your System, Photoshop and Krita will be added to the Application list.


Example of using Open in App in combination with Reload to quickly edit Tileable Textures in Photoshop



Auto Reloading changed images from Disc now runs up to 2x faster



 Drag & Dropping an image from Image Manager to the Nodegraph and selecting a Node Type will now auto rename the new node with the format

IMAGE_NAME [NODETYPE]


Example of an automatically named node on creation


Drag & Dropping an image containing a UDIM Number in its name/path to Layerstack or Nodegraph, then selecting the 'Image' Node Type, will now
create an image node that is pre-configured to place the image only in the one UDIM.

Example of Automatic placement of an 'Image' Node in UDIMs, when the dragged Image contained a UDIM Number


Extension Pack's Drag & Drop Handling can now be adjusted, activated and deactivated with more granularity via the Preferences / Misc  Tab




In Mari 4.8 or higher, creating more than one Node via a drag and drop action now auto aligns the nodes and sets the port list mode to collapsed


In Mari 4.8 or higher, dragging more than 3 images into the Nodegraph or Layerstack, now also allows you to directly create and ingest into Extension pack Material Templates or any material you yourself added to the Shelf.




A total of 6 new procedural nodes have been added


Hexagon 2D & Hexagon Triplanar allows you to create hexagonal textures


Some Examples produced with the Hexagon Node



Polygon Soft 2D & Polygon Soft Triplanar creates simple soft shaped polygons .. or one if that's what you want


Some Examples produced with the Polygon Soft Node



Polygon 2D & Polygon Triplanar. Multifunctional Polygon Node with many look options


Some Examples produced with the Polygon Node



Example Looks for Polygon and Hexagon Nodes have been added to the Procedural Tab of the Preset Browser.






A new Node Tiled Infinity was added in Mari 4.6v2 or higher.

Infinity Tiling will apply a texture to the UVs based on a Hex Grid, with each Cell having a different sample point of the
original texture, hiding any repeating pattern when tiled.

The node will work best with input textures that have a chaotic appearance and does not work well with geometric shapes.




Comparison of the same Texture applied via a standard Tiled Node vs the new Tiled Infinity Node




Infinity Tiling Mode can also be ticked on, on Axis Projection Nodes, Image Nodes and Tiled (Extended) Nodes



Triplanar (3D) and UV based  Material Templates can now be switched to Infinity Tiling


Example of toggling a material template to use infinity tiling



Selecting more than 3 nodes and pressing the 'M' Hotkey to execute a Smart Merge Command will now layer the nodes together using MultiMixer Nodes





A new 'Reload Paint' Option has been added. Reload Paint is capable of

Reloading Paint Node Image Data from their Path on Disc

Reloading Image Manager Files for Nodes with Images

Reloading Bake Point Data fed into a Node via a 'Bake Point Image' Port

Reloading Geo Channels of selected Geo Channel Nodes





Paint Node 'Import' and 'Export' Options have been renamed to 'Import Paint' and 'Export Paint'



A number of small Improvements have been made to the Set Project Paths Tool:


The currently set path for each Variable is now more clearly visible in a separate 'Currently Set' field

Quick Tips have been added to the bottom of the UI





Python Scripts associated to Hotbox Buttons in Mari 5.x, now require a 

import mari

line in their python code, if calling the Mari Python API from within the script, since the parenting of the processes has changed.

Mari 4.x behavior of Python invoking Hotbox Buttons remains unchanged.



Export Custom Channel Selection, Export Geometry,  Export UV Masks and Export Images now allow you to open the export location in your file browser after export

Clicking on the "Open' Button after an export will open the export location in a file browser





The Substance Baker Bridge now supports using Adobe Substance Designer instead of Substance Automation Toolkit for Baking (requires Substance Designer 12.1 or later)

You can now use either "Substance Automation Toolkit" or "Adobe Substance 3D Designer" (12.1 or higher)
 with the Mari/Substance Baker Bridge !



The Substance Baker Bridge now supports the 'Transferred Texture From Mesh' Baker.


The 'Transferred Texture from Mesh' Baker currently does not support UDIM Sequences as a Baking Source due to limitations on the Substance Side







Extension Pack enables the user to easily change the Environment Image by dragging an EXR or HDR file to the Canvas. 

To facilitate this workflow. a series of HDRIs are now automatically added to the Mari Shelf in a folder 'Enviornments' in Mari 4.7 or higher.

Extension Pack will now auto create HDRI Shelves for you.


Mari's own HDRIs from its installation Folder are automatically loaded into a sorted shelf on startup (can be disabled via Environment Variables)

HDRIs from other applications, if found on your computer, are automatically loaded into a sorted shelf on startup (can be disabled via Environment Variables)


Any Folder specified in the Paths / Environments Section of the Mari preference will be automatically loaded into shelves under the 'Environments' Group






Projection Modes (Front / Through) and Projection Target (All / Selected) are now exposed as UI Buttons. 
Which Projection Modes to show and which Toolbar to add them to, is configurable in the Mari Preferences / Painting Tab





Toggling between 'Project: Front' and 'Project: Through' is now mapped to [CTRL+F] by default, unless that hotkey is already in use or the action has
already a user shortcut





Mari Extension Pack allowed previously to link the Paint Buffers Bit Depth to the current channel selection. 
This has now been extended to work with your active Paint Target, meaning it will work even with Paint Nodes in the Nodegraph.

As was the case previously the option can be found on the Toolbar Properties of the Transform Paint tool but has been renamed to 'Link Depth to Paint Target'





'Focus Channel Content' if run on a channel containing Materials (shared by multiple channels), will now filter the node selection to only include
nodes that contribute to the selected channel


A new option 'Focus Channel Content (stop after Radios)' has been added to the Right Mouse Click / Nodegraph Menu in the Channels Palette.
It will only select and frame channel contents in the Nodegraph, up to and including radio nodes, but not include input connections of radio nodes.



Saving and reapplying of UDIM Layout Resolution Templates is now available in all Patch Resize Menus (e.g. Patches / Resize Patches, Channel / Resize etc.).
It now supports both channels and nodes (paint nodes, bake points etc.) for storing and reapplying custom UDIM Resolution Layouts



While Mari by default requires you to double-click a node to open its Attributes, you can now change this to a single click
via a new setting in the Nodegraph Tab of the Mari Preferences.


Single Click Node Properties are off by default and you need to activate it yourself in the preferences






In Mari 4.7 or higher, Radio Transmitter Nodes now auto inherit the Name of the Node they are connected to, unless the transmitter has been manually renamed

Whenever a Radio Transmitter Input is updated, the connected Radio Node Names are now updated to prevent Radio Node Names from going out of date





A number of improvements have been made to the Swap Node / Swap Layer Tool in Mari 5.x


Swap Node or Swap Layer with any Material selected, now shows all Materials from the Shelf, as options to swap to.


Swap Node or Swap Layer with a standard Nodetype selected, now shows Custom Procedurals from your shelf as well, as options to swap to.


Swap Node Type / Layer Type has many special behaviors, depending on the selected node type.
Please refer to the dedicated help for Swap Node Type / Swap Layer Type to learn more.





Patch Bake to Image Manager now supports both Layerstack and Nodegraph Patch Extraction. If your current selection is inconclusive, you will
be prompted to specify what to Bake


Patch Bake to Image Manager now automatically places the extracted Images into a 'Patch Bake' Tab in the Image Manager



If you ever worked with an ACES Colorspace Configuration file, you know how long the list of available configurations is.


All Extension Pack Tools allowing color space selection now use a filtered dropdown box, giving you quicker access to the desired colorspace


No more browsing through long lists of colorspaces 




Extension Pack already allows you to change the Light Rotation via Hotkeys without having to go to the Lights Palette. 

With Extension Pack 5 R9 a new default Hotbox is added to the F4 Hotkey , allowing you to 


oRotate Lights

oChange Light Intensity

oToggle the Background and change its Blurring

oToggle Shadows





Material IDs from Selection Group now supports leaving the Channel Name empty. If this is the case, the resulting Geo Channels will be baked
1:1 with the Selection Group Names. It also now defaults again to create Standard Mari Channels instead of Geo Channels.

Export Custom Channel Selection now provides more details in the Export Summary

Convert to Paintable can now be run on a Material Layer


A new Sync Channel Selection Option has been added to the Channels Palette, which will sync your current channel selection across all objects.

Screenshot all Channels now has its own settings dialog and syncs the channel selection across all objects in your scene.

You can now mark multiple image manager images as reference images so they are excluded from the Remove Unused Images Tool


Smart Rename when run on Bake Points with Filters, now applies the Filter Name to the Bake Point


Channel Component Selection has been added to the gl_cross Node

Added a mask port to the  Grade+ Node, to mask out the grading effect without the need for extra nodes


The 'Use as Environment Light / Use as Paint Through Image' pop up when dragging an EXR into the Viewport, will now only appear if the
current tool is not the Paint Through Tool.


A Fabric geometry has been added to the Default Objects


In Mari 5, Extension Pack now saves and restores the current Root Nodegraph Position and Zoomlevel per Project

In Mari 5, Extension Pack now manages the Nodegraph Tabs on a per Object Level. Open Nodegraph Tabs that do not belong to the current Object
are closed and previously open Tabs belonging to the active object are reopened


A progress bar has been added to Export UV Mask


Windows TDR Checks on Mari Startup can now be permanently disabled via the Environment Variable MARI_EP_PREVENT_TDR_CHECK

Python Tools are now available in the Main WIndow / Python Menu.


The following Node types have been added to the list of nodes, accepted by the Mari Material Ingest Tool, when ingesting into a Material Template.
This in in addition to all other Node types already supported by Mari itself as well as Extension Pack.


The Material Ingest Tool can dynamically fill nodes with images, if the node name corresponds to the Material Stream Name.
By default Mari only supports nodes of type Triplanar and Tiled.

Extension Pack already added support for other nodes in the past and this version adds additional missing node types


Sphere Map

Sphere Map Projector

Flow

Camera Projection





BUGFIXES

Click on a feature for more information


Fixed a Mari Crash when repeatedly switching back and forth between a dynamic locator and an object



Channels created using the Channels from Node Tool, would crash Mari when exported using the standard Mari Export Manager.
(they would export fine using Extension Pack's Exporter)



A number of smaller fixes have been made to the Substance Baker Bridge:


Reset Buttons on Sliders in some Baker Settings were cut off by the dialog borders and not easily clickable


Setting the 'Ignore Backface' Setting in the 'Ambient Occlusion from Mesh' Baker to 'From High Def Mesh Settings, while simultaneously having
'Self Occlusion' on 'Always', would generate a thicker occlusion than expected.
To avoid this, the 'Self Occlusion' Setting will now be forced to 'From High Def Mesh' as well, if the 'Self Occlusion' Setting is set to 'From High Def Mesh Setting'


Having the 'World Space Normal' Baker as part of a preset (manually created or automatically maintained presets e.g. 'Last Used Settings'), would cause an
error when loading the preset




The Node Multi Rename Tool's Search and Replace Function and Remove Suffix Function no longer worked


Smart Rename Nodes no longer ignored Dot Nodes in Mari 4.7 and higher



Quick Unproject Tools would give a deprecation warning in the python console, due to colorspace handling changes in some Mari Versions

Quick Unproject from View would incorrectly set the resulting Image colorspace to 'Mari Working Color Space'



Default Object 'Cylinder' was missing an icon on Linux

Some dialogs with Preset fields, were not displaying the 'Rename' Icon on Linux

The Preset Browser was missing the 'Reset Filter' Icon on Linux



The 'Invert' option in the Add Channel Layer Mask Dialog caused an error when used



Duplicate Channel would not rebuild all 'Shared Layers' if a Material Layer was present in the duplicated channel



The Gabor Noise, when created in a Layerstack, was incorrectly creating a connection from the Layer beneath to the 'Manifold' Port of the Node



Several Triplanar Versions of Nodes did not allow independent axis scaling via the 'Scale (XYZ)' Node Port, since the X-Value (Red Channel)
was applied to all 3 axis instead. The change has an effect on all existing node versions.



Channels created by Material ID from Selection Groups were not tagged as Scalar by default

It was possible to select 'Geo Channels' as targets, in Mari Versions were Geo Channels not yet existed as a feature



The resulting Image from a Patch Bake to Image Manager Operation did not always have the same color space settings as the source channel
it was baked from




Jump to Node Input printed an error in the Python Console when there was no node connected to any input port




Height Blend did not auto connect to selected Materials when the materials displacement output port was not called 'Disp'


Height Blend did not auto connect to the Mask of a Multi Channel Merge Node, if one of the selected materials to blend, had the 'Current Material' Viewer attached to it



Certain combinations of Rotation and Mirroring in the Tiled (Extended) Node, could break Normal Map Reorientation



Cloning directly from an image no longer worked since Extension Pack was always forcing the Paint Through Tool active when an image was

dragged to the Canvas. The Paint Through Tool will now no longer auto activate, when the current tool is the 'Clone Stamp' Tool.



Using Swap Nodes to swap between Material Templates no longer transferred all attributes

Using Swap Nodes to swap between Material Templates did not always correctly convert between Roughness and Glossiness. 


The resulting Node Name of a Swap Nodes/Layer Operation could be overly long when swapping some standard Mari Nodes


Swapping from an 'Unreal' Material Template to another Shader Model left the 'Unreal' Tag in the Node Name.



Copy/Paste Layer Attributes did not work in the Layerstack, when run on a Material Layer




Inserting a new node between a Radio Transmitter and a connected Radio Node did not update the Radio Node's Label to reflect that the Radio
Connection had changed



Values returned by gl_length, gl_distance and gl_dot product math node were incorrect on some output ports. 

The change only has an effect on newly created versions of the Node.




If Material Templates were located in a non-writable location, Mari would print out several error messages on Mari Startup



Remove Unused Images would not remove an unused image, if another copy of the identical image was in the image manager and in use in a node.


Export Selection did not open the File Browser in the Default Location set for Images/References 


Auto Reloading changed Images from Disc would sometimes load in multiple copies of the image



Duplicate & Flatten would crash if applied to a channel with only one layer




Duplicate & Flatten would not run if a Material Layer was present in the channel



Export Custom Channel Selection would fail on export with certain Nodegraph Configurations

Export Custom Channel Selection  sometimes printed empty lines to the python console

Cancelling Export Custom Channel Selection during Export would not close the Progress Bar anymore

Export Custom Channel Selection when using 'Export Modified Only' could export more than required if multiChannel Nodes were present in the exported channel





Adding a preset in Export Custom Channel Selection no longer worked in Mari 4.8


Cancelling Export Custom Channel Selection during Export could lead to Mari hanging for a long time



Extension Pack was forcing the Nodegraph Grid Width and Height Preferences to 0,  if Mari was launched with factory-settings, causing

a Crash when toggling the Grid on


Extension Pack was forcing the 'Show Grid' option to off on each Mari Restart.



Creating a new Channel Preset in Channels from Node Tool no longer worked in Mari 4.8

There were overlapping UI elements when using an OCIO Colorspace File with very long Colorspace names (e.g. ACES)



Fixed a crash when caching a Node via the Nodegraph



Some Default Hotboxes were installed with read-only permissions on Linux



In Mari 4.8, some sliders and check boxes of the default Hotbox 'Brush Settings' no longer had an effect

With certain Hotbox Settings, typing in a Hotbox Slider Value field would print out errors in the Python Console 



In Mari 4.8, Images imported into a shelf via the 'Import Items' Right Mouse Click Menu, did not work with Extension Pack's Drag and Drop Actions
(e.g. Drag to Nodegraph, drag to Canvas etc.)

In Mari 4.8, dragging more than one Image from the Image Manager to the Nodegraph or Layerstack did not create multiple Node Instances.



Nodes with a 'Bake Point Image' Input Port no longer auto inherited images from connected bake points in Mari 4.8


 


Loading or resetting View Layouts would remove custom Extension Pack UI Buttons like the Substance Baker Bridge.
Fix requires Mari 4.8v3 or higher.




PATCHES

Click on a patch for more information

Loading of custom Environment Map Paths on Mari Startup could fail and hang if Thumbnail or Cache Data was contained in the Folder

In Mari 5, the Light Hotbox kept resetting itself to the default F4 Hotkey on Mari restart, even when changed by the User


Licensing the Mari 4 Version of Extension Pack 5 R9 via Environment Variable no longer worked and could cause Extension Pack 5R9 to not load

Some files on Linux had incorrect permissions when written

In some cases Material Template installation on Mari Startup could get stuck in a loop

Reload Paint can now reload Geo Channels


On Windows Machines, pointing the Environment Variable MARI_EP_LICENSE_FILE_PATH directly to a (unmounted) network location no longer worked

and required network drive mounting as workarounds.


Drag and Drop of Images from Shelf to Layerstack no longer worked in Mari 4.7 Versions


Dragging a manually imported Shelf Image into Layerstack or Nodegraph would print a python error.


Copy/Pasting Node Attributes would clear the clipboard after pasting, allowing only one paste action to be performed


Copy/Pasting Node Attributes would paste Image Attributes in a way, that new image instances would be loaded into the image manager


Some Image Types from the shelf could cause an 'Image not Found' error when applied to a Node via Drag & Drop

Adding more than 7 Applications to the 'Open with ...' Image Manager dialog did not work and would cause Mari to error on start

In some cases using 'Align Nodes' would stop the Undo History Recording


Indie and Freelance Licenses were incorrectly identified as Studio Licenses in the Licensing Dialog.

In Mari 5, the Hotbox 'Aiming' no longer pre-selected a button unless the aiming line was crossing a button or the cursor was over the button.

mari.ExtensionPack.node.getNodeCategory() would error on certain nodes

For Mari 4.8 and higher, a warning has been added when trying to use a Bake Point Image Port while your current geo does not have a UDIM 1001

Additional Log Info and Solutions were added, when the user encountered a SSL Certificate error during licensing


Saved custom Brushes were deleted from the shelf on each Mari restart

The Environment Variables MARI_EP_PREVENT_MARI_HDRI_LOADING and MARI_EP_PREVENT_3RDPARTY_HDRI_LOADING were no longer respected

Node Align Right could give a python error in some cases

Some Extension Pack Dialogs (e.g. Connect to Radio Transmitter) had their contents cut off when setting a larger custom font size via the Mari Preferences 

Patch Bake to Image Manager could fail if the node to bake had characters in its name that the operation system cannot write into a filename

Due to a Mari Bug, some tools were showing already deleted channels (e.g. Channel Exporter). Interacting with those deleted channels could cause Mari to crash.
A workaround for the bug has been implemented to prevent these Channels from appearing in Extension Pack tools.

In Mari 5, Node Align Right sometimes aligned nodes to the 'average center' of the node selection instead of the far right.

In Mari 5, the 'Garbage Collection' command in the Extension Pack / Project Menu gave a python error


The Text Tool registered to the Mari Tools Toolbar caused a segmentation fault crash on Mari Exit. Until a fix is supplied by the Foundry, the Text
Tool has been relocated to the Extension Pack Toolbar. You can also use on the other Tools Toolbar Layouts shipping with Extension Pack ,which still include the Text Tool.

Export Custom Channel Selection could error and hang when no "Raw" or "Utility - Raw" Colorspace was found in your OCIO file.
Extension Pack will now try to resolve this issue on its own, and if unable give you a warning message

Export Custom Channel Selection could error and hang when processing Bake Points containing invalid, non-existent UDIM NUmbers in their Bake Range

[MARI 4.8+] Export Custom Channel Selection would export the wrong channel information, if the the channel to export was connected to a multiChannel Output Node,
and an export mode other than "Full Resolution" and "Default Bit Depth" was chosen

[MARI 4.7] Dragging an Image from the Image Manager to a Layerstack no longer created a new Layer, even after selecting a layer type from the popup dialog

Dragging items from the Mask Shelf into the Nodegraph would sometimes place the preset at the inverted nodegraph position (e.g. Y Coordinate of 1000 would become -1000)

when multiple users were using Mari on one machine, file ownership clashes could prevent Extension Pack from loading

Deleting a single Mari Default HDRI Image from the Shelf would install that previously deleted HDR over and over on each Mari restart, creating duplicates

The "Setting up Extension Pack" Progress Bar got launched with "Installation of Mari HDRIs" even if all Mari HDRIs were already installed (the progress bar went straight to 100% percent completion though). Extension Pack will now check first if showing the progress bar is necessary for default Mari HDRIs

mari.ExtensionPack.bakePoints.smartBakeHierarchy() Python method produced an error

[MARI 5+, LINUX] The SSL_CERT_FILE Environment Variable is now automatically set for the environment, Mari is run in, if the OS SSL Certificate is located at
 /etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem.
This is to avoid licensing issues that have come up in the past, because of Mari's built in, outdated SSL Certificate shipping with its Linux Version.
If you already have set a SSL_CERT_FILE Environment Variable no action is taken.



Right Mouse clicking into the Image Manager would cause a Mari Crash



Extension Pack 5R9.v9 is a limited patch release only available to Users of Mari Extension Pack 6.


The Licensing System has been switched over to accept Mari Extension Pack 6 Licensing Data

Changes to a Hotkey assignment on an action added by third party (e.g. any Extension Pack Action) were "forgotten" after a Mari restart

The Mari Viewport could show a Shader Compile Error on certain AMD Video Card Drivers

The Substance Baker Bridge did not import files correctly if the Importer Mode in the Mari Preferences was set to "Background Importer"

The "Levels" Dropbox was disabled if "Inherit from Source Object" was ticked on in the Subdivision Dialog





STUDIO DEPLOYMENT UPDATES


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