发布日期

2019年8月29日

先前版本

• Katana 3.1v7发行说明

系统要求

官方支持的操作系统

• Windows 7 64位或更高版本
• Linux 64位操作系统（CentOS / RHEL 6）

硬体需求

	最低要求	推荐的
中央处理器	双核处理器
存储	1+ GB可用于安装
系统RAM	1 GB以上可用
图形RAM	1 GB以上可用	2 GB以上可用
显示	800 x 600	1920 x 1080
的OpenGL	OpenGL 4.3+

“推荐”并不能保证它满足您的特定需求

经测试的工作站硬件

下面列出的配置是Foundry经过测试的配置Katana。由于市场上不断变化的性质和种类繁多的计算机硬件，Foundry无法正式认证硬件。以下列表可以作为建议，并不保证它可以满足您的特定需求。

• NVIDIA Quadro M4000

• NVIDIA Quadro P4000

• NVIDIA Quadro K4000

• NVIDIA Quadro K6000

请从NVIDIA网站下载并安装最新的图形驱动程序。

如果您遇到任何问题，请直接通过以下地址的支持门户网站与客户支持联系： https://support.foundry.com。

新增功能Katana 3.2

这些发行说明描述了与Katana 3.1v5至3.2v1。

要全面了解Katana 3.2行，请参阅随附新增功能Katana 3.2文献。

功能增强

• TP 81998 / BZ 39875-以前是Katana，按住Ctrl键并选择一个“背景”节点将选择所有接触该“背景”的节点。这与在Nuke中处理此交互方式相反。

  现在，此交互已被反向，因此选择一个背景将选择触摸它并保持的节点Ctrl现在将仅选择背景节点本身。此外，单击并拖动背景的单个动作现在将拖动背景及其内部的所有节点，类似于Nuke。

• TP 129274 / BZ 51768-The Katana已完成，更正并扩展了包含代表网络材料的材料组属性的材料位置属性约定的开发人员指南文档，以涵盖为NetworkMaterialGroup节点创建的网络材料存储的其他布局信息。

• TP 356529-通过双击工具栏中的树项目，支持打开示例项目示例项目标签的树小部件。

• Hydra Viewer关于不支持“点”范围UV的错误现在仅记录一次。

• 的PyUtilModule.CatalogManager Python模块已重命名为 PyUtilModule.CatalogAPI。

• 现在可以通过以下命令控制背景节点的Z顺序[和]键盘快捷键，分别将Backdrop节点置于前后。作为此功能的一部分， 发送回复选框已从编辑背景节点对话。

• 网络材料的属性约定已扩展到涵盖有关阴影节点网络布局的信息，同时考虑到其他节点（例如Backdrop，Dot，Switch和VariableSwitch节点），每个节点都有其位置和颜色。存储这些附加信息将使我们能够构建工具来重新创建下游网络材料的可视表示，即使这些属性是通过Look Files或其他方式导入的。（另请参阅TP129274。）

• 关于的部分编写渲染器插件在里面Katana开发人员指南已得到扩展，以包含有关在浏览器中查看NetworkMaterialGroup节点的内容时自定义渲染器插件的分层菜单的详细信息。 节点图标签。

• 的FnAttribute API已扩展了getSize（）属性的函数，该函数返回创建属性时分配的总内存（以字节为单位）。C API，C ++包装程序，Python绑定和OpScript / Lua API中提供了此新功能。

• 现在，我们发布了Boost 1.61.0的共享库。这是能够使用共享的USD Python库和模块的要求。

• Katana 3.2现在为TBB使用Foundry命名空间和重命名的共享库（libtbb2017_Foundry.so在Linux上）和TBB内存分配器（ libtbbmalloc2017_Foundry.so 在Linux上）基于TBB 2017 Update 8，以减少一次会话中拥有多个TBB竞技场的冲突。

• Hydra Viewer已升级到使用共享USD库构建的USD 19.05，该库现已提供Katana。

• TP 394745-在属性选项卡已扩展为包括内存中给定属性的大小（以字节为单位）。

• TP 394987-目录项目的ID现在发送到渲染启动作为可执行文件的一部分渲染启动命令行：

  -sequenceID <sequenceID> 
  

  通过使用的Python函数，可以使用序列ID获取相应的目录项。 CatalogAPI模块：

  CatalogAPI.FindCatalogItemBySequenceID(<sequenceID: int>) --> CatalogAPI.CatalogItem.CatalogItem 
  

• AttributeUpgrade节点类型，用于解决之间的属性约定更改Katana 1.x和2.x现在已弃用，并已从节点创建菜单中隐藏节点图标签。

• 有关构建，安装和使用定制的开发人员文档九头蛇渲染代表作为插件Katana的Hydra Viewer已添加到编写插件的部分Katana开发人员指南。

• NetworkMaterialGroup节点类型已重命名为NetworkMaterialCreate。文档和NodegraphAPI提示已更新以反映更改。提供了一个升级脚本来升级现有脚本Katana在Alpha和Beta周期内创建的项目Katana 3.2v1为新名称。

• 我们附带的3Delight版本Katana已升级到1.5.9版。有关更多信息，请参阅3Delight Cloud更新日志。

• 我们在其中使用的USD库的版本Katana的Hydra Viewer现在显示在关于Katana对话框，可通过访问帮助>关于Katana。

Bug修复

Katana开发人员指南

• TP 85230 / BZ 41203-源代码示例文件中的一些不正确的文件系统位置路径Katana开发人员指南已得到纠正。

• TP 323246-Python类的内部成员，例如__dict__，被错误地暴露在Katana开发人员指南。

• TP 381467-在某些情况下，与UI相关的术语（如选项卡的标题）的粗体格式未正确应用，从而导致出现双星号。

• TP 381468-一些已记录的功能被错误地显示为“未记录”，特别是UI4.Widgets.SceneGraphView.ViewLink.ViewLink.getUpdateSuppressor（）和PackageSuperToolAPI.BaseEditor.BaseEditor.getSceneGraphViewTerminalOps（）。

• TP 398999- Nodes3DAPI.PortOpClient.NodeTraversalEndpointsSpec类被错误地显示为“未记录”。

• TP 399000-错误地丢失了所有标题的文档SceneGraphView小部件类，很难理解所提供的信息。

• TP 399002-在某些情况下未正确应用代码格式设置，从而导致逐字显示格式语法，或导致链接中断。

• TP 399003-的文档getInputPortAndGraphState（）实例缺少功能Nodes3DAPI.Node3D类，也未包含在Katana开发人员指南。

• TP 399012- 属性（C ++）页面与相应的OpScript / Lua和Python页面的层次结构不一致。

• TP 399013-下列问题Katana开发人员指南已修复：

  • 节点相关功能使用节点>连接节点页面被错误地列为属于Nodes3DAPI.Node3D类。它们实际上是在基础上定义的NodegraphAPI.Node类。
  • 的节点属性文档中包含指向 NodegraphAPI.Parameter文档。
  • 的文档NodegraphAPI.Parameter.reorderChild（）和reorderChildren（） 函数被错误地复制。
  • 不推荐使用的函数的签名错误地显示为单个连续的行，从而不必要地扩展了相应页面的宽度，并使参数名称和类型难以阅读。
  • 的文件属性修改器插件，不再应使用的旧版API， Katana开发人员指南。

• TP 399014-Geolib3的一些头文件和Katana的插件API在参数和返回值的文档中包含问题。

• TP 399018-下列问题Katana开发人员指南已修复：

  • 成员变量的说明查看器位置事件文档丢失。
  • FnBaseLocator回调函数指针类型未出现或显示不正确，并且在的签名中未正确链接FnBaseLocatorVDC :: registerLocator（）静态功能。
  • 错误的回调函数指针类型用于覆盖BaseGeometry的参数FnBaseLocatorVDC :: registerLocator（）静态功能。
  • BuilderMode和BuilderBuildMode 的参考GroupBuilder类错误地链接到各自类型定义而不是枚举s。
  • 中的功能FnGeolibCookInterface接受用于删除私有数据的回调函数指针的API未正确解析，并且显示为单行而不中断，超出了页面边界。

• TP 399981-多个错别字Katana开发人员指南已修复。

• TP 400452-当文件资料偏好设置为本地， API参考>参数表达式和 API参考> C ++ API 中的命令救命的菜单Katana主窗口未链接到Katana开发人员指南。

其他错误修复

• TP 71317 / BZ 36414-当尝试撤消基于SuperTool的节点（例如GafferThree）的创建时，引发了异常。

• TP 216997-通过NetworkMaterialSplice节点创建的材质已弃用遮光网材质，而不是材料类型。

• TP 356705-在实时渲染期间操作位置可能会导致连续实时更新（在操作过程中）停止在所有位置工作。

• TP 386841-当FnGeolibCookInterfaceUtils :: cookDaps（）是从多个线程调用的，有时可能无法正确读取默认属性。这影响了依赖该功能的操作，例如AdjustScreenWindowResolve操作，有时会失败并显示错误消息： 从StringAttribute获取字符串值时出错。GenericAssign DAP现在是线程安全的。

• TP 394990-死者_initKeyboardShortcutCallbacks（） Python函数已从中删除KeyboardShortcutManagerMixin类，以避免对其用法可能造成的混淆。

• TP 396842-刷新树形视图时材料上的组属性材料属性显示在属性标签，则树状视图中的所有项目均已折叠。现在，刷新树视图时，将保留项目的扩展状态。

• TP 397791-渲染时默认属性生产者使用的插件初始化不是线程安全的，并且可能导致渲染进程崩溃。

• TP 400154-加载内部示例项目时，取决于所选的主窗口布局和屏幕分辨率，节点网络的区域不可见。现在，在加载示例项目后， 节点图选项卡将自动构图所有节点。

已知的问题

现场小组

• TP 85118 / BZ 41152-当编辑作为LiveGroup节点一部分的节点的参数并重新加载父LiveGroup节点时，UI的UI状态参量选项卡被重置。这包括滚动条的位置，项目的选择以及嵌套选项卡的选择（例如宾语， 材料和连结中 Gaffer节点的标签）。

• TP 84998 / BZ 41092-从源中重新加载LiveGroup节点的参数接口和内容时，在浮动窗格中编辑的子节点的参数将从这些窗格中消失。

• TP 84020 / BZ 40598-还原LiveGroup节点不会还原其用户参数。

• TP 84019 / BZ 40599-从源执行重载时，错误地丢弃了添加到LiveGroup节点的参数，从而导致数据丢失。

• TP 84018 / BZ 40600-撤消未发布的LiveGroup节点的还原不会恢复LiveGroup的可编辑和修改状态。

• TP 83061 / BZ 40237-可以将节点拖到不可编辑LiveGroup节点的“组”气泡中。

材质

• TP 403364-当在NetworkMaterialCreate或ShadingGroup节点内使用Redshift着色节点时，在参数页面下会创建一个额外的空白页面，当尝试在该页面下展开子页面时，该页面将立即折叠为空白页面。

• TP 402064-在ShadingGroup节点图中，在某些情况下，Dot节点和着色节点端口之间的连接可能被错误地着色。

• TP 269449-选择编辑着色器参数 “材质”节点的主扳手菜单中的“着色器参数”旁边没有显示扳手按钮。可以通过切换节点上的编辑标志来解决此问题。

• TP 199304-The 命名空间 Material节点上的参数错误地允许插入ASCII范围之外的Unicode代码点。

• TP 191052- Katana对V-Ray for Maya的纹理参考对象工作流不提供任何支持。

参数表达式

• TP 188533-无法评估在以前未编辑的“材质”节点上链接到非本地参数的表达式。

• TP 105434 / BZ 47520-参考表达式可能不引用动态参数，例如着色器参数。

• TP 60457 / BZ 31790-为表达式设置数组或组参数会导致表达式无效。设置有效表达式后（例如，使用getParam），则不会立即更新参数。要解决此问题，请关闭并重新打开参数，或者在不编辑节点的情况下刷新缓存。

Qt 5

• TP 356345-用浮动选项卡部分覆盖Hydra视口将导致其连续重新绘制。

渲染图

• TP 381284-3Delight渲染器插件将源材料的位置而不是解析的材料属性用作重复数据删除的手段。在实时渲染会话期间从“渲染工作集”中排除材料位置时，这可能导致材料数据丢失。

• TP 344118-（仅Windows）安装时Katana并选择安装捆绑版本的3Delight，则通过修改系统范围的环境变量（例如， KATANA_RESOURCES。之后，发射任何版本Katana将选择此3Delight安装，该安装可能与的版本不兼容。 Katana被发射。

  注意：这不会影响Linux，在Linux中，捆绑的3Delight安装与其对应的捆绑在一起Katana安装。

• TP 208802-关闭直方图使用后的标签离开监控标签无法显示渲染的图像。

• TP 176598-当前不支持在交互式渲染过滤器中使用修改图形状态变量的节点。

• TP 114182 / BZ 49288-导出目录项时，需要指定导出文件夹路径到现有文件夹。如果您要导出到的文件夹在磁盘上不存在Katana将无法导出。

• TP 94052 / BZ 44199-The 重复上一个渲染 menu命令仅适用于从3D节点的上下文菜单启动的渲染。

• TP 74799 / BZ 36926-The rendererSettings > 显示选项 PRMan渲染器的RenderOutputDefine节点的参数，当其类型参数设置为“原始”，无法使用参量标签。

• TP 12517 / BZ 16168-仅一个监控选项卡可能会显示预览渲染的结果。使用多个监控当前不支持标签。

小部件

• TP 373702-在鼠标悬停在另一个窗口小部件中的同时单击视口并按快捷方式仍会将事件发送回“聚焦”视口窗口小部件，因为鼠标悬停在其中的快捷方式无法处理该快捷方式。

• TP 123558 / BZ 50911-更改数组参数的元组数/大小时，相应的属性在属性标签。

• TP 65347 / BZ 34949-由于Compiz与Qt不兼容，使用Compiz可能导致文本字段无法正确接收焦点事件。根据您的配置，禁用Compiz“桌面效果”可以解决该问题。

杂

• TP 381692-（仅限Windows）注销并再次登录时，UI中的颜色不正确。例如，某些类型的选项卡的某些部分可能显示为白色背景色。

• TP 337653- Katana加载时记录弃用警告PyMockAsset， PyMultiMockAsset和 PyMockFileSeq运输示例资产API插件。

• TP 218742-（仅Windows） Katana必须安装在不超过〜140个字符的路径中。尝试安装到更长的路径会导致不直观的错误：“系统找不到指定的路径。”

• TP 112544 / BZ 49051-The 检视器标签可能会与场景图扩展状态的更改被中断时，请单击“取消”。

• TP 107038 / BZ 47853-指示属性源节点（例如，节点中的黄色“发光” 节点图标签）从不可用Katana 2.0版1。

• TP 84326 / BZ 40709-Alembic库不支持对Alembic文件的多进程或线程访问。这意味着在外部修改Alembic文件时发生崩溃Katana，虽然它是空载的Katana现场。为了避免这种情况，您必须刷新缓存在尝试更新任何已修改的Alembic文件之前。

• TP 80738 / BZ 39261-锁定和解锁节点的操作当前未在“撤消历史记录”中创建条目，这在撤消和重做操作时可能导致错误的节点图状态。

• TP 71965 / BZ 36691-当前会显示动态数组子参数的属性值的状态标记，即使只有其父数组参数应该带有状态标记也可以显示。

• TP 70217 / BZ 36176-2D节点磁盘渲染上游渲染输出选项不使用批处理渲染方法， batchRender，用于上游渲染节点，而不是使用diskRender。

• TP 70196 / BZ 36170-在外壳模式下，控制键（尤其是箭头键）无法正常工作。