Search Tips

Search is based on keyword.

`Ex: "Procedures"`

Do not search with natural language

`Ex: "How do I write a new procedure?"`

Give Feedback Support Portal

# Katana 3.5v3 Release Notes

# Release Date

22 April 2020

# Previous Releases

- Katana 3.5v2 Release Notes

# System Requirements

## Officially Supported Operating Systems

- Windows 7 64-bit or higher
- Linux 64-bit operating system (CentOS/RHEL 6)

## Hardware Requirements

| Minimum | Recommended
--- | --- | ---
CPU | Dual-core processor
Storage | 1+ GB available for installation
System RAM | 1+ GB available
Graphics RAM | 1+ GB available | 2+ GB available
Display | 800 x 600 | 1920 x 1080
OpenGL | OpenGL 4.3+

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

## Tested Workstation Hardware

The configurations listed below are those that Foundry have tested with Katana. 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.

- NVIDIA Quadro M4000

- NVIDIA Quadro P4000

- NVIDIA Quadro K4000

- NVIDIA Quadro K6000

Please download and install the latest graphics driver from the NVIDIA website.

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

# What's New in Katana 3.5

These release notes describe changes from Katana 3.5v2 to 3.5v3.

For a high-level overview of important changes in the Katana 3.5 line, please see the accompanying What's New in Katana 3.5 document.

# Feature Enhancements

## Configuration

- TP 426435 - The following environment variables were added, which when set to 1 disable the addition of their respective Filename Resolve Ops (in the Implicit Resolver Op chain, the MaterialResolve node's Op chain, and in the SceneGraphView terminal Op chain):

  - KATANA_DISABLE_MATERIALFILENAMERESOLVE
  - KATANA_DISABLE_RENDERERPROCEDURALFILENAMERESOLVE
  As part of this work, we removed the FilenameResolve entry from the Implicit Resolvers Active dialog.

## Performance

- The performance of the WorkingSet and ScenegraphTabPolish Ops has been improved by reducing the number of std::string allocations they perform. These improvements will be noticeable only for large, wide scene graphs.

# Bug Fixes

## API/SDK Changes

- TP 426880 - When setting values of parameters via NodegraphAPI scripting, multiple value policy events were generated instead of a single one, possibly leading to unnecessary updates of UI elements in response to value policy event handlers being called.

- TP 428285 - When calling GroupAttribute:getChildName() with an index out of range, nil would be returned. This was contrary to behavior in Katana 3.2 and before, where an empty string was returned. The previous behavior is now reinstated and documented in the Katana Developer Guide.

- TP 428839 - When GroupAttribte::getChildByIndex() and GroupAttribute::getChildName() were called with a negative index, they would exhibit unexpected behavior or cause Katana to crash.

## Command Line

- TP 243617 - When attempting to use the --tile-cleanup command-line option when batch rendering on Windows, a Python exception was raised.

- TP 430009 - When the Katana executable was launched from within the bin subdirectory, the program would fail to find all its dependencies, failing to launch.

## Documentation

- TP 430114 - The contents of the Improving OpScript Performance page in the Katana Developer Guide have been slightly revised.

## Gaffer

- TP 426892 - When changing the value of a parameter of a light package of a GafferThree node whose parameters are edited in the Parameters tab, the shader type of the light in the Shader column wrongly changed color from yellow to dark gray. (This issue affected shaders for the Redshift and V-Ray render plug-ins only.)

## Geolib

- TP 427011 - Some Op tree configurations, in which the same Op is connected as input multiple times to a downstream Op, could cause incorrect scene graph results.

## Hydra Viewer

- TP 385305 - TP 393055 - When flushing caches while using a layout with a Viewer (Hydra) tab, or other Viewer API-based viewer tab, Katana crashed. This was due to a combination of synchronization and data validation issues.

  The BaseViewerTab class now flushes ViewerDelegate caches as part of a CacheManager flush callback, rather than in response to the posted event. BaseViewerTab now provides a flushCaches() class method. BaseViewerTab._on_cacheManager_flush() remains, but now does nothing in this base class implementation.

  Invalid data in the form of out-of-order location events is now handled by the Viewer API as an error.

- TP 425701 - When an uncooked location was set as the look-through camera in a viewer (e.g. the Viewer (Hydra) tab), and one of the location's ancestors was given a rotation transformation, manipulating the active camera's view (e.g. via panning, zooming, tumbling, or framing) would result in an erratic behavior.

- TP 426590 - When a location was selected programmatically, the manipulators in the Viewer (Hydra) tab could, on occasion, deselect all the other locations except the just-selected location.

## Network Materials

- TP 422651 - When moving a Backdrop containing shading nodes in the NetworkMaterialCreate node graph, the shading nodes within the Backdrop could become disconnected from the rest of the network. (This issue was a regression in Katana 3.2v2.)

- TP 424322 - When setting the name parameter of a shading node in the NetworkMaterialCreate context to an empty value and then attempting to undo the action, an exception was raised, and the undo history cleared.

- TP 427018 - Shader parameters that were defined as enumerations by renderer plug-ins (kFnRendererObjectValueTypeEnum) did not show correct default values in the Parameters tab.

- TP 428361 - When ShadingNodeBase.checkDynamicParameters() was called after a node name change, it would occasionally fail to (re-)populate its dynamic parameters, due to the node name change not being yet reflected in the Op Args of the internal Ops in the Op chain of the node. (This was a long-standing issue in Katana that was exacerbated in Katana 3.2v1.)

## Node Graph

- TP 427465 - When panning the view while dragging nodes in the Node Graph tab, the nodes were wrongly dropped. (This issue was a regression in Katana 3.2v1.)

- TP 430188 - When the deletion of a Macro node was undone, the node's shape attributes (e.g. background color) were not restored correctly. (This issue was a regression in Katana 3.2v1.)

## Performance

- TP 425645 - The Scene Graph tab could cause previously expanded scene graph to be cooked prematurely.

## Python

- TP 426888 - When running Katana in script mode as a child process from within Katana, the KATANA_*_MODE variables set in the Configuration module, which indicate in which mode Katana was launched, were passed through to the child process without being modified, resulting in a Python exception being raised and the process being aborted.

## Rendering

- TP 365566 - When rendering high-resolution 2D images that are loaded using ImageRead nodes, rendering artifacts could occur due to cache key strings not being unique across all rendered tiles of the image.

- TP 424374 - 2D renders of images with no alpha channel were displayed and processed as having zero opacity, rather than full opacity. This also affected images generated or processed with an explicit 1-filled alpha channel. (This issue was a regression in Katana 3.1v3.)

- TP 427535 - When rendering a scene with a large number of render outputs (/AOVs), ID buffers in Katana's Catalog were wrongly created for every render output, rather than just the primary render output. This resulted in the corresponding Catalog Item consuming significantly more memory than necessary.

## SDK

- TP 429852 - When building C++ Asset Plug-ins, integer type conversion warnings (C4244) were issued.

## Scene Graph

- TP 416898 - When cooking DAPs, for example by calling InterfaceUtils.CookDaps() in an OpScript node, a provided attribute root was not respected by the OutputChannelDefine DAP, resulting in attributes such as widget hints being lost in certain circumstances, for example when used in GenericAssign-powered parameters on custom node types.

## UI

- TP 426413 - When a light location was selected in a viewer, and the parameters of the light were visible in a Parameters tab, the mouse cursor would occasionally change to the I-beam cursor.

- TP 426569 - When setting up a TeleParameter to show the outputs parameter of a Render node in the parameter interface of a Group node (e.g. a custom SuperTool node), the list of render outputs in the Parameters tab was not always updated correctly.

- TP 429456 - When attempting to drag the child parameter of an array parameter by pressing the Ctrl+B keyboard shortcut (key-based drag & drop), a Python exception was raised. (This issue was a regression in Katana 3.1v1.)

# Known Issues

## Hydra Viewer

- TP 420882 - Changing between the Viewer (Hydra) tab's multipane layout options quickly can cause a crash or many error messages to be written to the terminal/console.

## Live Groups

- TP 85118 / BZ 41152 - When editing parameters of a node that is part of a LiveGroup node and reloading the parent LiveGroup node, the UI state of the Parameters tab is reset. This includes scroll bar positions, selections of items, and selections of nested tabs (for example Object, Material and Linking tabs for a Gaffer node).

- TP 84998 / BZ 41092 - When reloading a LiveGroup node's parameter interface and contents from its source, parameters of child nodes that are edited in floating panes disappear from those panes.

- TP 84020 / BZ 40598 - Reverting a LiveGroup node does not revert its user parameters.

- TP 84019 / BZ 40599 - Parameters that are added to LiveGroup nodes are wrongly discarded when performing a reload from source, leading to loss of data.

- TP 84018 / BZ 40600 - Undoing a revert of an unpublished LiveGroup node does not restore the LiveGroup's editable and modified state.

- TP 83061 / BZ 40237 - Nodes can be dragged into the Group bubble of a non-editable LiveGroup node.

## Materials

- TP 429206 - Parameter expressions when promoted from shading nodes in a NetworkMaterialCreate node are of a constant value, relative to the resolved expression at time of creation.

- TP 410474 - In a NetworkMaterialCreate context, shading nodes appear to shake during view state changes if the node's width is adjusted.

- TP 402064 - In a ShadingGroup node graph, the connection between a Dot node and a shading node port can be wrongly colored in some cases.

- TP 269449 - Choosing Edit Shader Parameters from the main wrench menu of Material nodes does not show wrench buttons next to shader parameters. This can be worked around by toggling the edit flag on the node.

- TP 199304 - The namespace parameter on Material nodes wrongly allows the insertion of Unicode codepoints outside the ASCII range.

- TP 191052 - Katana does not have any support for the texture reference object workflows of V-Ray for Maya.

## Parameter Expressions

- TP 188533 - Expressions linked to non-local parameters on not previously edited Material nodes can't be evaluated.

- TP 105434 / BZ 47520 - Reference Expressions may not refer to dynamic parameters such as shader parameters.

- TP 60457 / BZ 31790 - Setting an array or group parameter to an expression results in an invalid expression. Upon setting a valid expression (for example, an evaluation of an equivalent parameter on another node using getParam), the parameter is not immediately updated. To workaround this issue, close and reopen the parameter, or flush caches while the node is not edited.

## Performance

- TP 429859 - (Windows only) When rendering under Windows, the Monitor and Catalog tabs can exhibit a small delay in displaying pixels received from the renderer, compared to rendering under Linux.

## Qt 5

- TP 356345 - Partially covering the Hydra Viewport with a floating tab will cause it to repaint continuously.

## Rendering

- TP 381284 - The 3Delight renderer plug-in makes use of source material locations rather than resolved material attributes as a means of de-duplication. This can result in material data being lost when excluding material locations from the Render Working Set during a Live Render session.

- TP 344118 - (Windows only) When installing Katana and opting to install the bundled version of 3Delight, the installation of 3Delight is made by modifying system-wide environment variables such as KATANA_RESOURCES. Thereafter, launching any version of Katana will pick up this installation of 3Delight, which may be incompatible with the version of Katana being launched.

  NOTE: This does not affect Linux, where a bundled 3Delight installation is tied to its corresponding Katana installation.

- TP 208802 - Closing the Histogram tab after use leaves the Monitor tab unable to display rendered images.

- TP 176598 - Use of nodes that modify Graph State Variables in Interactive Render Filters is not currently supported.

- TP 114182 / BZ 49288 - When exporting a Catalog item you need to specify the export folder path to an existing folder. If the folder you're trying to export to does not exist on disk Katana will fail to export.

- TP 94052 / BZ 44199 - The Repeat Previous Render menu command only works on renders started from a 3D node's context menu.

- TP 74799 / BZ 36926 - The rendererSettings > displayOptions parameter of a RenderOutputDefine node for the PRMan renderer, shown when its type parameter is set to 'raw', cannot be set using the Parameters tab.

- TP 70016 / BZ 36137 - Rendering repeatedly with a large number of AOVs consumes more and more memory, possibly leading to a crash when running out of memory.

- TP 12517 / BZ 16168 - Only one Monitor tab may display the results of a Preview Render. The use of multiple Monitor tabs is not currently supported.

## Widgets

- TP 373702 - Clicking in the Viewport and pressing a shortcut whilst the mouse is hovered in another widget will still send the event back to the 'focused' Viewport widget, for shortcuts where the widget hovered over does not handle the shortcut.

- TP 123558 / BZ 50911 - When changing an array parameter's tuple count/size, any corresponding attributes are not properly updated in the Attributes tab.

- TP 65347 / BZ 34949 - Using Compiz can lead to text fields not receiving focus events correctly due to an incompatibility between Compiz and Qt. Depending on your configuration, disabling Compiz "desktop effects" may resolve the problem.

## Miscellaneous

- TP 381692 - (Windows only) When logging out and logging back in again, the colors in the UI are incorrect. For example, certain parts of certain types of tabs may appear with a white background color.

- TP 337653 - Katana logs deprecation warnings when loading the PyMockAsset, PyMultiMockAsset and PyMockFileSeq shipping example Asset API plug-ins.

- TP 218742 - (Windows only) Katana must be installed to a path no longer than ~140 characters. Attempting to install to a longer path results in an unintuitive error: "The system cannot find the path specified."

- TP 112544 / BZ 49051 - The Viewer tab may lose sync with the Scene Graph tab when changes to expansion state are interrupted.

- TP 107038 / BZ 47853 - Indication of attribute source nodes (such as the yellow 'glow' in the Node Graph tab) is unavailable as of Katana 2.0v1.

- TP 84326 / BZ 40709 - The Alembic library does not support multiple process or thread access to an Alembic file. This means that a crash occurs when modifying an Alembic file outside Katana, while it's loaded in an open Katana scene. To avoid this, you must Flush Caches before attempting to update any modified Alembic files.

- TP 80738 / BZ 39261 - Operations that lock and unlock nodes do not currently create entries in the Undo History, which can lead to an incorrect node graph state when undoing and redoing operations.

- TP 71965 / BZ 36691 - State badges are currently shown for attribute values of dynamic array child parameters, even though only their parent array parameter should appear with a state badge.

- TP 70217 / BZ 36176 - The 2D node Disk Render Upstream Render Outputs option does not use the batch render method, batchRender, for upstream render nodes, instead using diskRender.

- TP 70196 / BZ 36170 - Control keys (notably arrow keys) do not function as expected in shell mode.