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






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


               





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.





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





  • 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



Some Examples produced with the Hexagon Node




Some Examples produced with the Polygon Soft Node




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







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.







  • 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 '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

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




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 


    • Rotate Lights
    • Change Light Intensity
    • Toggle the Background and change its Blurring
    • Toggle Shadows






  • 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




  • 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



  • 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





  • 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





  • 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



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.






  • 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



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















  • 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





  • 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.




  • 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