1.4.0 is a major update for both the Fusion and Nuke side.
The Fusion plugin has been overhauled by Cédric Duriau. Importantly this fixes a key memory issue causing glitches (#117). It uses less memory in general and is 10-30% faster both interactively and in render times. The user interface has been improved and fine tuned for Resolve. On the development side, it now features a test suite written in Lua.
The Nuke plugin is also updated with a major new feature, Wildcard support. This is based largely on work done by Veronica Tello during her time at Method Studios. See Nuke Documentation for more information on wildcards.
Also in Nuke news, Foundry's Nuke 13 now has a native Cryptomatte integration, which leads to obvious questions about the future of this Nuke integration and the purpose of this release. This release is likely the last major release for this Nuke plugin. While this is sad for me to write, it's also worth celebrating. "The goal of releasing Cryptomatte is to turn it into an ecosystem around an open standard", as we say on the front page of the repo, and there is now a robust ecosystem of Cryptomatte readers and writers. This repository still hosts the Cryptomatte standard as well, which is the central part, and not any one implementation.
This release of the Nuke plug-in gets features released that have sat in beta for a long time, is tested in the newest versions of Nuke, and provides an off-ramp for Nuke users to make the transition. It also remains available for users who rely on the current functionality or need their existing Nuke scripts to continue working.
Thank you to all our users for taking this journey with us, to Psyop for supporting this project, and everyone who contributed with everything from code contributions to bug fixes to encouragement.
Nuke:
- Official release of wildcards (Thanks @vtello, @maxnbk, and others!) See documentation.
- Fixed unload manifest with special characters in names
Fusion:
- Fixed memory issue (#46, #117)
- Fixed hex to float decoding bug for Cycles (#120)
- Improved performance (cedricduriau#11)
- Implemented multi-level logging (cedricduriau#11)
- Improved error management & logging (#100, #101, #116)
- Simplified GUI (#136, cedricduriau#29, cedricduriau#33)
- Added test suite (cedricduriau#12)
- Allow animatable controls (cedricduriau#25, cedricduriau#35)
Nuke:
- Updated to support both Python 3 and Python 2.7 with the same code (#134, thanks @PumpingPixels).
- Python 2.6 is no longer supported. This means Nuke 6 and Nuke 7 are no longer supported.
- Fixed #138- load metadata for this view only
Nuke:
Fixed a bug with copy and pasting with "Lock Layer Selection" on (#128)
Nuke:
- Fixed issue where decryptomatte doesn't work inside groups (#127, contributed by Johannes Hezer)
Nuke:
- Fixed issue where a missing manifest would prevent keying (#124)
- Fixed issue where nuke-unfriendly Cryptomatte names (crypto.material, 123_crypto) would cause issues and noise in tests
- Fixed layer options not being available on Cryptomatte gizmos after scene open
Nuke:
- Added a version number display for users and scripts to test what version is used (#106)
- Better support for Blender layer names (#114, thanks @aliasguru)
- Scalable Cryptomatte logo (#119, thanks JF Panisset)
- Fixed a callback error when tab-creating gizmos with an input selected (#109)
- Fixed troubleshooting button when callbacks are not installed. (#112)
- Tests pass in Nuke 12.0v3
Nuke:
- Performance improvement when keying by caching metadata. (#90)
- Fixed for stereo renders by using nuke.thisView() (#103)
- Fixed errors on open with more than 16 layers of Cryptomatte (#95)
- Fixed gizmo for Blender channel names containing "." which get converted to underscores in Nuke, also fixed for Encryptomatte. (#104)
Nuke:
- Fixed bug with hierarchical names (contributed by Jens Lindgren)
Fusion (by Cédric Duriau):
- Support for EXR images with a data window smaller than display window (builtin DoD)
- Updated README install documentation #62
- Minimum Fusion version is now 9.0.2
- Changed repo structure to match Fusion directory structure
- Added Fuse registry information (help, company, version, ...)
- Added dosctrings
- Cleaned up code
A reorganization of this repo, and a minor update to the Nuke plugins.
- Reorganized Fusion and Nuke documentation into separate files.
- Added some tiny test images showing different cases of Cryptomatte usage.
Nuke:
- Added troubleshooting button to Cryptomatte gizmo
- Fixed Encryptomatte issue where it couldn't start a new Cryptomatte with no inputs
- Added test for Encryptomatte with no inputs
- Do not allow keying IDs with zero coverage
- Fixed some test issues in Nuke 11.3
- Cleaner decryptomatte results, with maximum of 3 nodes in sequence, no dots, and better naming
This is a major update to both the Nuke plugins and Fusion plugins, and a minor update to the Cryptomatte specification.
Specification:
- Changed specification regarding sidecar manifests, such that they are always sidecars with relative paths.
- Support for UTF-8 Characters in Nuke plugin and specification
- Deprecated preview channels
Nuke:
- Encryptomatte
- Added Encryptomatte - allows modifying or creating Cryptomattes in Nuke
- Added support for sidecar manifests
- Added layer selection pulldown
- New Eyedropper "picker" knobs which use picker position and not sampled values
- No longer use Color knob's built in picker
- Fixed keying problems sometimes caused by GPU-enabled viewers
- Can pick mattes while viewing downstream node (or looking at the RGB/beauty)
- Enables new "Preview" (AKA: "Keyable Surface") options
- "Preview" option provides 3 modes of visual feedback
- "Colors" is an improved version of the old style random colors
- "Edges" allows viewing input RGBA with borders around keyable regions
- "None" allows viewing of input RGBA without borders, but with a visible highlight on selected areas
- Colors now generated dynamically, removing need for preview channels
- Enhancements for multi-channel inline workflow
- "Matte Output" knob enables output to a custom channel
- "Remove Channels" now defaults to false
- "Matte only" now causes mattes to be written to R, G, B, A in addition to specified output
- "Unpremultiply" option to unpremult output matte by input alpha
- Support for special characters and UTF-8
- Support for non-ascii unicode
- Added support names containing spaces, commas, and angle brackets
- Switched matte lists to be YAML-style (names with special characters are enclosed in quotes)
- Added test suite
- Added failfast with cleanup skipping to Nuke tests, to allow inspecting what went wrong
- Bug fixes
- Mixed selections of names and raw IDs now work correctly for all cases
- Gizmo now works when read nodes have "do not attach prefix" enabled
- Fixed rare issue where connections were lost on script load and copy and paste when used with channelmerge
- Fixed (Beta only) bug Encryptomatte retains its layer selection properly
- Fixed (Beta only) bug with PickerAdd and PickerRemove values stored in files
- Fixed (Beta only) bug with errors on load with invalid Cryptomatte
Fusion (by Cédric Duriau)
- Minimum Fusion version is now 9.0.1.
- Redesigned around new Fusion 9.0.1 features
- Fuse now loads EXRs directly via the EXRIO module
- For older versions, please use an older release (see GitHub releases)
- Added support for sidecar manifests
- Added layer selection slider with layer name display
- Added "Preview" (AKA "Keyable Surface") options
- Colors now generated dynamically, removing need for preview channels
- Added shortcut configuration file ("cryptomatte_shortcut.fu")
- Added "Toggle" button acting as a Add/Remove switch (Shift+T)
- Added support special characters in selection lists
- Known limitation: Commas in names are not yet supported
- Performance Improvements
- Optimized multi threaded functions
- Added Support for mixed depth EXR images
- Added Support for proxy mode
- Using EXRIO module
- Removed loader channel slots workaround
- Removed "Update Loader" button
- No longer limited to 8 cryptomatte ranks
- Bug fixes
- Improved "matte only" previewing
- Keyable surface feature disabled when in matte only mode
- Code improvements
- Added version to file headers
- Added "cryptomatte_utilities.lua" module
- Added docstrings
- Removed simplejson.lua module, using builtin dkjson module
- Removed "struct.lua" dependency
- Fixes Fusion crash when rendering with FusionRenderConsole
- Adds beta version of Fusion support, also by Cédric Duriau and Kristof Indeherberge at Grid.
- Major tool connection workflow improvement. No longer requires multiple loaders to work, instead populates single loader channel slots when viewed.
- Adds alpha version of Fusion support, created by Cédric Duriau and Kristof Indeherberge at Grid.
- Store channels on hidden knobs on Cryptomatte gizmo and decryptomatte expression nodes
- Fixes expression node errors in batch mode
- No longer prompts users on "decryptomatte selected"
- Allow API users to use decryptomatte without prompt
- Fixed error when loading gizmo in Nuke 7
- Changes to specification regarding storage of metadata
- Enabled Nuke code to read this metadata
- (1.1.0 Nuke plugin is compatible with older Cryptomattes)
- No longer raises errors if no metadata is available (would happen in batch mode)
- No longer raises errors if picker in is in single value mode rather than RGB
- Updated pymmh3 to output signed ints, in compliance with mmh3
- Added layer selection to gizmo and utilities (backwards compatible)
- Added menu.py
- Added
__version__to cryptomatte_utilities.py - Bug fix - invalid manifest broke keying
- Initial release of Nuke plugins, specification, and sample images.