Mari 6.0v2 Release Notes

Release Date

11 April 2023

Previous Release

Mari 6.0v1 Release Notes

New Features

API/SDK Changes

  • Two new convenience functions have been added to the Python API Broadcast and Receiver Teleport nodes to return nodes connected to them via the teleport system:
    mari.ReceiverTeleportNode.connectedBroadcastNode()
    mari.BroadcastTeleportNode.connectedReceiverNodes()

API/SDK Documentation

  • Python API documentation now lists the tree based menus for easier navigation of classes and modules

Roller Brush

  • The Outline brush tip now rotates to match the draw direction of the Roller Brush and of the Standard Brush when Align to Stroke is enabled.

  • Added the ability to drag and drop an image from the Shelf or Image Manager onto the brush tip filepath text field in the Brush palette, rather than having to manually browse to the file or enter a path.

  • The Roller Brush has been improved to provide smoother interpolation of the drawn curve. As such, the Segment Count property has been removed as it is no longer required.

  • The option to "trim" fully transparent borders of the image used as the Roller Brush tiling image has been added. This will trim top/bottom in Horizontal tiling mode and left/right in Vertical tiling mode.

Feature Enhancements

Performance

  • The MARI_MAX_WRITE_PENDING_SIZE_FACTOR environment variable is now exposed as a new preference item under Mari Preferences > Project > "Max Write Memory Factor". The setting controls up to how much of the Max Memory is used to temporarily hold the data to be written to disks.

    The experimental environment variable has been removed and replaced by the new environment variable MARI_PROJECTMANAGER_MAXWRITEPENDINGSIZEFACTOR.

Teleport Node

  • When renaming the channel that a Teleport Broadcast node is broadcasting on, an option has been added to update any Receiver nodes that were previously listening in order to use the new channel name.

  • Artists can now attach a Viewer node to a selected Teleport Broadcast node via the numeric shortcuts.

UI Improvements

  • Artists can now modify LocatorList's Translate and Scale fields by using the arrow keys.

  • A UI border around color properties of Nodes and Layers has been added for better visibility.

Bug Fixes

API/SDK Changes

  • ID 494346 - mari.FileList values were not properly sent to Mari via the Python API, which prevented them from being set correctly for properties.

API/SDK Documentation

  • ID 508410 - Property members for the ResourceInfo class would not be listed in the Python API documentation.

  • ID 508421 - Certain Python modules were missing from the Python API documentation. In addition, the Python API documentation now has an improved layout with tree structure.

Bake Points

  • ID 521723 - Bake Point Nodes would miss baking extra UDIMs which were added by a new Geo Version.

  • ID 527974 - Changing an attribute on a Node inside a Group Node would not invalidate Bake Point nodes connected to that Group Node.

Color

  • ID 507824 - Loading a custom OCIO config with an empty fallback look entry was resulting in error messages.

  • ID 509282 - Drag and dropping a color swatch from the Color Picker to Shelf would incorrectly display the swatch as grey in the Shelf Palette until project reopen.

  • ID 509544 - The Scalar checkbox inside the Add Channel window would be disregarded when creating a custom channel preset.

  • ID 511745 - The View Transform's Luminance component mode was displaying RGB information instead of the expected greyscale result.

  • ID 511747 - Using the View Transform's Luminance/R/G/B/A component mode was causing the Canvas background to display black.

  • ID 522932 - Color slider positions would not get updated in certain conditions when changing the color/scalar picking modes.

Geo-Channel

  • ID 525545 - Geo-Channel nodes would ignore Background Color if imported images with different bit depth and no alpha channel would cause untouched patches to lose their alpha channel.

Layerstack

  • ID 525692 - Right-clicking a Paint layer in a pop-out Layer palette would not select that layer as the current paint target.

Lights

  • ID 501413 - Switching the environment light when a palette is maximized, was causing Mari to crash when the maximized palette is minimized to bring up the Canvas.

Node Graph

  • ID 522414 - When copy-pasting Material nodes, the new material would get converted to a Group node if any node in the top level of the node graph was named the same as one of the nodes inside the Material.

  • ID 524244 - Resizing a Backdrop node while Snap to Grid is enabled would snap the position of the Backdrop's corners.

Performance

  • ID 514433 - Changing the Virtual Texture Gather Scale via preferences caused the UI to display as black.

  • ID 514801 - Resizing the nodegraph palette would incorrectly cause the focal point to drift.

  • ID 521621 - Mari would intermittently crash when Triplanar Projection properties are open in the Layers palette.

  • ID 525625 - The Export Manager would crash if a Shader node was using an unrecognised Shader Model.

  • ID 532693 - The Export Manager would take a significantly longer time to export textures comparing to previous Mari versions. In result, full patch bleed has been disabled by default to avoid slowness during exports

  • ID 533263 - 'Take Screenshot' functionality would produce a black image when View Transform was disabled.

  • ID 535496 - Node Graph related preferences were not correctly loaded if some preferences are set via the Python API.

  • ID 536118 - The "Incremental" setting in the Screenshot functionality would not work with paths containing multiple dots.

  • ID 536366 - Many stock actions were not available at the time of user start-up scripts were run.

Roller Brush

  • ID 524625 - When using the Roller Brush tool while Mirror Painting is enabled, using undo did not fully undo the mirrored strokes and the X /Y mirrors would sometimes display incorrectly.

  • ID 525818 - When using the Roller Brush tool, Shift+LMB would result in previous stroke to still be repeated and present in the Paint Buffer.

  • ID 533970 - Roller Brush's "Repeat Direction" parameter would not be updated in the UI when loading a brush from the shelf.

Shortcuts

  • ID 498473 - Assigning a custom shortcut for Open Group Node Subgraph had no effect on the action.

Teleport Node

  • ID 517765 - Chaining a Teleport Broadcast node would cause the dot insertion to be incorrectly placed at the end of a noodle instead of its center.

UI

  • ID 527874 - Certain actions listed under the Tool Help Status Bar would show a redundant ampersand character.

  • ID 528080 - Renaming Shader nodes would not update their names in the Shaders palette

USD Export

  • ID 535468 - USD Look Files containing a material, in which two shader inputs have the exact same names across multiple different shaders, can result in incorrectly connected material node networks.
  • ID 528307 - Exporting USD Materials when using USD files with different than st UV set name, would result in the Look files to have incorrect texture mapping.
  • ID 528355 - Exporting USD Materials with Bump and Normal inputs would not be exported and assigned in the look files of Standard Surface, Principled BRDF and PxrSurface shaders.
  • ID 538461 - Exported USD Materials were incorrectly rendering in the DCC of choice with heavier than expected Bump Weight.

Known Issues

Performance

  • ID 500649 - Due to a known issue with OCIO, Mari crashes when using a non-C locale on Linux. By launching Mari with the numeric format set to a locale that uses full-stops for decimal points, such as English, this issue can be circumvented.
    To achieve this, run the following command in the terminal, amending the path to your Mari installation:

    LC\_NUMERIC=en\_EN.UTF-8 /path/to/installation/mari

  • ID 471286 - Mari crashes when a project is created or opened while using Nvidia GPU driver version 461.92, 462.31 and 462.59.

Painting Engine

  • ID 366737 - Importing .abr Photoshop brushes returns an error if the brush in larger than 2500*2500 pixels.

UI

  • ID 483855 - When Mari is launched with Administrator Privileges, you are unable to Drag and Drop items from Windows Explorer into Mari.

Roller Brush

  • ID 524361 - Using the Roller Brush in conjunction with the Jittering Brush system set to Jitter per Tip, will create a gradient effect instead of using different colors for each tip that has been rolled.

System Requirements

Note:  Mari increases its level of performance with newer, more advanced hardware configurations. However, Mari is tested and capable of operating on many older, prior-generation systems. For this reason we are listing below-minimum requirements, which are recommended, and on which tests have been performed. Your particular needs may vary from that of other users.

Officially Supported Operating Systems

  • Windows 10 64-bit

  • Linux CentOS/RHEL 7.6 to 7.9 (64-bit)

Note:  Linux Desktop Managers: Mari is officially tested on GNOME and MATE. While it generally performs well on other desktop managers like KDE, most of our bug fixes will target those specified above. Some desktop managers like XFCE have not been tested with Mari and therefore will not be supported.

Minimum Hardware Requirements

  • Quad-core processor
  • 10+GB disk space available for caching and temporary files
  • At least 4GB RAM
  • Display with 1680 x 1050 pixel resolution
  • An NVIDIA or AMD* graphics card with the latest drivers
  • 1GB of graphics memory
  • OpenGL 3.2* or higher

*Displacement preview is currently only available on the cards and drivers that support OpenGL 4.0 or newer.

Recommended System Requirements

  • 2.5+Ghz Quad-core processor
  • 250+GB disk space available for caching and temporary files. SSD is preferable.
  • 16GB RAM with additional virtual memory*
  • Display with 1920 x 1080 pixel resolution
  • An NVIDIA or AMD* graphics card with the latest drivers
  • 2+GB of graphics memory
  • OpenGL 4.4 or higher support

*The use of virtual memory improves stability and helps prevent data loss on large projects.

'Recommended' does not guarantee that it meets your particular needs.

Tested Hardware

The configurations listed below are those that Foundry have tested with Mari. Due to the constantly changing nature and wide variety of computer hardware available in the market, Foundry is unable to officially certify hardware. The list below can be used as a recommendation and does not guarantee that it meets your particular needs.

Please download and install the latest graphics driver from the NVIDIA or AMD websites, and ensure that you are using 8.982.1 drivers or higher for AMD cards.

If you encounter any issues, please contact Customer Support directly through the Support Portal at the following address: https://support.foundry.com.

Tested Workstation Hardware

HP
  • HP XW6600
  • HP Z600
  • HP Z620
  • HP Z640
  • HP Z8 G4 Workstation

Tested GPU Hardware

Vendor Tested GPUs
AMD Prosumer Graphics Cards Radeon Pro 560
Radeon Pro 5500M
NVIDIA Prosumer Graphics Cards NVIDIA Geforce GTX 1080 Ti
NVIDIA Geforce RTX A2000
NVIDIA Geforce RTX 3080
NVIDIA Geforce RTX 3090
NVIDIA Enterprise Graphics Cards NVIDIA Quadro P2000
NVIDIA Quadro P4000
NVIDIA Quadro P5000
NVIDIA Quadro RTX 8000