Katana在微软 Windows

Katana现在在Microsoft上受支持 Windows 7

网上帮助

Katana的用户， 技术和参考指南已合并为一个帮助系统- Katana网上帮助。的网上帮助以HTML格式显示，并且都可用在网上并且作为Katana安装。

的Katana网上帮助使您可以在一个位置搜索以前包含在各个指南中的内容。除了进行重组之外，它现在还包含新功能的简短摘要以及在何处查找有关这些功能的信息。它还提供了上下文相关性，允许您从内部打开节点引用Katana。

Katana开发人员指南

一个新的Katana开发人员指南汇集了有关Katana的插件API和脚本接口，包括C ++，Python，OpScript，AttributeScript，CEL和参数表达式。的开发人员指南完全可以搜索，并且都可用在网上并且作为Katana安装。它替代了以前的基于Epydoc和Doxygen的文档。

Python参考按主题排列，使较大的模块更易于理解。以前在不存在的“ python”模块下记录的功能现在已正确命名。我们计划扩展Python参考，并且欢迎您反馈最需要文档的模块或任务。

现在，OpScript和参数表达式引用对其各自的API具有几乎完整的覆盖范围。但是，大多数OpScript参考仅包含签名。我们希望在将来的版本中对此进行更正。

此功能解决了以下错误和功能增强请求：

• TP 17706 / BZ 19825-没有用于连接和断开节点的API文档。

• TP 103438 / BZ 47208- Katana的C ++ API文档列出了标头的文件系统路径，这些标头与Katana安装目录。

• TP 119958 / BZ 50344-有关的文档Katana的Python API将许多模块内容归类为虚假的“ python”模块。

• TP 126302 / BZ 51350- NodeTypeBuilder没有记录。

其他文件变更

一个新的文档/来源偏好控制在哪里Katana寻找文件：

• 远程 （默认）：从加载文档help.thefoundry.co.uk。该文档可能比本地副本最新。
• 本地：从中加载文档Katana安装目录。如果您的计算机无法访问互联网，请选择此项。

的节点文档Katana现在可以在外部网络浏览器中打开的内置节点。插件作者可以指定一个helpURL提示为自己的节点类型提供基于Web浏览器的帮助。

斜坡小部件

色阶和浮动坡道小部件类型现在可用于着色器参数和用作用户参数类型。

色阶小部件允许用户通过以下方式定义颜色渐变：放置位置在0到1（包括0到1）之间的结，并使用Katana的颜色选择器对话框。窗口小部件提示可用于指定的渐变部分的高度色阶小部件，以及打开或关闭Filmlook可视化效果，并在选择结点颜色时在颜色选择器对话框中限制RGB（A）组件。

浮动坡道小部件允许用户通过将节点的位置和值放置在可以通过小部件提示指定的范围内来定义曲线。

用户可以从许多预设中进行选择色阶和浮动坡道小部件。

这完成了一个长期的功能要求：TP 60262 / BZ 31564-支持坡道小部件

Gaffer三滤光片

滤光器是可以添加到光源中的任意着色器，以修改光源在渲染场景上的效果。滤光器的示例有：

• 仓门
• 阻滞剂
• 过滤器控制灯光的衰减效果
• 戈博斯

此版本Katana通过添加新的GafferThree程序包类型，将滤光器添加到GafferThree SuperTool节点类型。

可以通过以下两种方式之一将“滤光器”添加到GafferThree节点的对象表中的灯光：

• 从光源的上下文菜单中，选择加 > 滤光片， 要么
• 选择一个灯，然后按F键。

您可以使用Light Filter References（在GafferThree中封装的一种独特类型）在多个光源之间重用Light Filters。要基于灯光下的现有灯光滤镜创建灯光滤镜参考，请执行以下操作：

• 从“滤光器”的上下文菜单中，选择创建共享的滤光器， 要么
• 选择滤光器，然后按转移+F。

的连结中 GafferThree的界面中的“选项卡”选项卡提供用于配置“滤光器”的链接选项的参数。此选项卡中的参数类似于用于控制灯光的照明链接的参数。

有关滤光片的预期属性约定的详细信息，请参见Katana联机帮助，附录H：标准属性。

Op Cook分析

分析模式已添加到Katana。以剖析模式启动时， Katana可以在性能分析会话中生成关于操作时间的报告。烹调时间是根据每个Op实例，每个位置汇总的。这些报告可以帮助查明Op树和场景图的慢速区域。

Katana可以使用- 轮廓命令行选项：

./katana --profile 

在分析模式下， Katana加载实现剖析的特殊版本的Geolib3 Runtime。该配置文件的开销很低，可以最大程度地减少对烹饪性能的影响；在性能分析会话结束时执行的计算量要求更高的数据聚合。

剖析会话特定于以剖析模式启动的Geolib3 Runtime实例，并且在每个剖析会话结束时都会生成一个报告，因此可能为每个进程生成多个报告（卡塔纳宾和渲染启动， 例如）。渲染称为Katana多线程上的过程，例如，每个线程实例化一个运行时。每个报告包含两个文件：

• 一种。点在分析会话结束时包含带有Op树的图形的文件。
• 一种.csv以表格格式包含记录的烹饪时间的文件。

的。点可以使用Graphviz将文件转换为PDF文档。

的.csv （以逗号分隔的值）文件包含汇总的烹饪时间和烹饪次数。可以将其直接读取到电子表格应用程序或其他报告工具中。

查看器绘图呼叫批处理

Viewer Modifier插件API公开了针对的新静态回调onFrameBegin（）和 onFrameEnd（）。这些使用户能够实现批处理调用： onFrameBegin（）每种VMP类型都会在回调之前引发一次回调画（） 在所有活动和可见的VMP实例上调用方法，并且 onFrameEnd（） 绘制完成后调用。

添加了一个名为“ BatchViewerModifier”的示例插件，以演示如何使用新的API函数在Viewer Modifier插件中批量绘制调用。可以在以下位置找到此插件$ KATANA_ROOT /插件/ Src / ViewerModifiers / BatchViewerModifier。该插件不适用于生产环境，但提供了一个示例，说明了如何onFrameBegin（）和 onFrameEnd（） 调用可用于将批处理调用一起批处理。使用此VMP的示例项目是在线可用。

此更改将VMP API版本增加到2.0；见随附Katana 2.5v1：API更改和兼容性有关更多详细信息的文档。

改进的崩溃处理

Katana有一个新的系统来处理崩溃，并允许用户向The Foundry提交崩溃报告。崩溃报告将保存在我们的服务器上，并与类似的报告进行交叉引用，以识别导致服务器不稳定的常见原因。 Katana。

默认情况下，崩溃报告在UI模式下启用，而在所有其他模式下禁用。可以使用以下环境变量来控制此行为：

• FN_CRASH_DUMP_PATH：允许您指定默认情况下Issue Reporter转储的保存位置。
• KATANA_CRASH_HANDLING：默认情况下，崩溃处理在GUI模式下启用，而在终端模式下禁用。
  • 什么时候KATANA_CRASH_HANDLING 设置为1，在GUI和终端模式下均启用崩溃报告。
  • 什么时候KATANA_CRASH_HANDLING设置为0，则在GUI和终端模式下均禁用崩溃报告。
• KATANA_NO_CRASH_PROMPT：在GUI模式下启用崩溃处理后，默认情况下，崩溃报告对话框将在提交崩溃报告之前显示。
  • 什么时候KATANA_NO_CRASH_PROMPT设置为1，系统会自动提交崩溃报告，而不会显示崩溃报告程序对话框。