的词汇Katana条款

本词汇表简要介绍了整个文档中使用的最重要的术语Katana应用程序和文档。

这些核心术语的知识可帮助您理解方式Katana更清楚地工作和处理数据,并使您能够充分利用Katana文档。

Katana核心条款

节点数

Nodes是在Katana界面来构建Recipe为一个Katana项目。Nodes特征参量可以用来控制他们的行为。Nodes可以创建并连接到Katana节点图用户界面中的标签,也可以使用以下命令通过Python脚本进行修改 NodegraphAPI

Katana附带很多内置类型的节点,但是自定义节点类型也可以通过Python脚本创建。随带两类主要的节点类型Katana

  • 3D nodes产生可以在其中检查的场景图Katana场景图标签。
  • 2D nodes产生可以在Katana监控标签。

Nodes和它们的参数有效地表示和控制相应的行动形成由Katana的几何库可生成可在以下位置查看和检查的场景数据Katana的场景图和属性标签。

注意:  有关使用中的节点的更多信息Katana用户界面,请参阅编辑节点图。有关通过Python脚本处理节点的信息,请参阅相关内容使用节点的部分Katana开发人员指南。

节点图

Node GraphsKatana菜谱属于Katana项目。中的节点node graphs可以创建并连接到KatanaNode Graph用户界面中的标签,也可以使用以下功能通过Python脚本进行修改NodegraphAPI Python包。

参量

Parameters属于节点,并通常控制它们各自节点的行为。Parameters的节点数可以在Katana参数标签在用户界面中,通过在节点图标签,也可以使用部分内容通过Python脚本进行编辑 NodegraphAPI。参数的值可以是常数,取决于Python表达式,或由动画曲线驱动。

食谱

RecipesKatana节点图的连接nodes属于Katana项目。Recipes通常表示为在场景图中创建3D场景数据而执行的步骤或执行的操作,或为创建可在其中查看的2D图像而执行的图像操作Katana监控标签并写到文件中。

注意:  有关更多信息RecipesKatana,请参阅创建一个Katana项目

项目

一种KatanaProject是所有的总和节点和他们的参数形成了在项目的节点图中表示的配方。Projects保存在Katana具有的项目文件.katana文件扩展名。

注意:  有关使用项目的更多信息,请参见创建一个项目

行动

Ops是在其中创建和操作3D场景数据的操作的基本组成部分Katana,并产生场景图可以随时检查Katana节点图通过在特定节点上设置视图标志。Ops是Op类型的实例,它们是用C ++编写的,使用特定Katana用于定义其内部工作原理的API: Op API。C ++ Ops可用的一些功能记录在Katana开发人员指南

与各种节点类型相似, Katana附带许多内置类型的Ops,但也可以通过C ++编程并使用Op API创建自定义Op类型。设置节点上的查看标志后,将查询该节点的对应名称Ops。就3D场景数据的创建或修改而言,节点的行为可以由单个Op,但也可以由多个Ops按操作链或操作图排列。

运算论据

Op Arguments控制行为Ops定义了nodes在一个Katana食谱。它们大致对应于parameters在3D节点上。更改节点的参数时,将更新相应的操作参数。如果正在查看该节点或下游的任何节点,则场景将被重新拍摄。

烹饪

Cooking是执行 Ops对应于Katana食谱,以便创建场景图地点和他们的属性,然后可以在Scene GraphAttributes标签。当在节点在里面节点图,对应于该节点及其上方所有节点的Ops将被执行/评估/烹饪,以在节点图中的该点生成场景图。从技术上讲, cook()调用每个对应的Op类型插件的函数来创建或修改结果场景图中的位置。

筛选器

Filters是旧的等价物Katana 1.X版本,共行动Katana 2.X及更高版本。它们代表了操作的基本组成部分,这些操作可在其中创建和操作3D场景数据Katana 1.X版本。

懒惰评估

的关键方面之一Katana的处理范例是仅在需要结果时才对操作进行评估。

例如, 行动对应于特定的节点只是熟的当正在查看节点本身或其下游节点时,意味着已设置其查看标志。在上下文中Scene Graph选项卡,场景图数据地点仅当场景图层次结构展开以在树视图小部件中显示它们时才生成。

使用时Katana的API, lazy evaluation可能会对某些函数调用的结果产生影响。

注意:  有关此示例,请参见知识库文章。 如何使用Geolib3客户端通过Python查询场景图位置的属性

Lazy evaluation也适用于Katana的用户界面,其中一个名为冻融确保仅在必要时响应用户交互而更新UI。

图状态

Katana维持Graph State遍历时的数据结构节点图。它包含当前帧和快门定时等信息,并传递给Ops 表示为节点什么时候烹饪场景图。节点可以读取和写入Graph State作为识别他们的投入的一部分。

例如,一个TimeOffset节点读取当前时间,并根据其inputFrame参数的控制对其进行递增或递减。修改后的Graph State然后将其传递到上面的节点以烹饪其操作。重要的是要意识到Graph State与场景数据不同,信息沿节点图向上流动,而场景数据则沿图向下流动。

一些Python函数Graph State记录在Katana开发人员指南

图状态变量

Graph State Variables (有时缩写为GSV)本质上允许用户在图状态,并且可以在项目要么节点水平。然后可以由其他节点引用和操纵它们,从而实现功能强大的工作流,其中节点组和整个节点节点图可以轻松启用和禁用分支。

注意:  有关更多信息,请参见图状态变量

专案层级GSV被称为Global Graph State Variables和节点级别GSV被称为Local Graph State Variables。以下类型的节点可用于处理和/或修改本地GSV

通用分配

GenericAssign是一个先进而强大的概念Katana,其中参数节点与特定属性地点在里面场景图。这样的参数有效地控制了它们相应属性的值。他们的小部件在Parameters选项卡能够显示传入场景中的属性值,从而允许用户检查和修改这些属性值。

使用以下示例的节点类型GenericAssign基于参数是渲染设置节点类型。参数RenderSettings节点对应于中的属性renderSettings上的组属性/root场景图中的位置。设置参数的值时RenderSettings节点中的相应属性renderSettings组已设置。当连接一个RenderSettings传入节点节点图,节点参数的小部件将显示它们所对应的属性的值。

作为参数窗口小部件一部分的状态标记显示相应参数的值状态,指示相应属性是由正在编辑的节点上游的节点(传入值)还是由节点本身设置为特定值(本地值),或者属性是否未设置为特定值,在这种情况下,它们将使用默认值。

场景图

属于的3D节点Katana食谱产生一组层次化的数据,称为Scene Graph,可以在其中进行交互式检查KatanaScene GraphAttributes用户界面中的“标签”,并且可以呈现给渲染器或任何输出过程。

可以保存在场景图中的数据示例包括:

  • 几何
  • 粒子数据
  • 灯火
  • 着色器实例
  • 渲染器的全局选项设置。

注意:  有关的更多信息Scene Graph,请参阅使用场景图

地点

Locations是组成Scene Graph层次结构。许多其他3D应用程序将它们称为节点,但是在Katana它们被称为位置,以避免与节点用于节点图Locations可以使用它们的名称以及场景图中其所有祖先位置的名称来唯一标识,这些名称构成场景图的位置路径,例如:
/ root / world / geo / pony

注意:  有关如何使用的更多示例locations在“场景图”中,请参阅使用场景图操作场景图

属性

Attributes是存放数据的容器地点在里面场景图。存储在属性中的数据示例为:

  • 3D转换,例如4x4矩阵
  • 几何的顶点位置,
  • 着色器实例的值设置。

Attributes可以交互地检查选定场景图位置的位置KatanaAttributes标签,但未编辑,因为它们的值由节点参数Katana项目

注意:  有关位置可以具有的常见属性的示例,请参见属性约定在里面Katana开发人员指南。
有关创建,操作或删除属性的更多详细信息,请参见使用属性

属性类型

有不同类型的属性针对不同的基本数据类型:

  • 整数
  • 浮点数字
  • 双精度数
  • 弦乐

除了这些类型的数据属性外,还可以使用组属性在层次结构中对属性进行分组。

一种特殊类型的属性null attribute用于特定情况,例如将某个属性声明为未设置,因此将使用该属性的默认值。

Katana用户界面条款

价值政策

Value PoliciesKatana提供数据以显示在Katana的用户界面。Value policies在基础数据源之间提供一层,例如参数节点在里面节点图文档和选项卡中的UI小部件,例如Parameters标签。有不同类型的value policies,专门针对特定数据源和特定用例。

的Python基类value policiesQT4FormWidgets.AbstractValuePolicyValue policies请注意将基础数据源中的事件转换为Qt小部件事件,例如,使用a更改参数值后重新绘制小部件NodegraphAPI呼叫。

参数策略

Parameter PoliciesKatana价值政策在两者之间提供一层参数节点在里面节点图文档和小部件Parameters标签。这些小部件显示参数的值,并且可用于编辑这些参数值。

Parameter policies例如,为自定义类型的节点开发参数UI时最相关SuperTools,使用Python脚本API。

注意:  有关如何在SuperTools中使用它的示例,请参见相应的内容。 Editor.py示例文件SuperTools与一起运送Katana下:
$KATANA_ROOT/plugins/Src/Resources/Examples/SuperTools

参数策略的Python基类是UI4.FormMaster.BaseParameterPolicy。它源自AbstractValuePolicy类。通常,通过传递参数来为特定节点的特定参数创建参数策略。 NodegraphAPI.Parameter代表相应参数的实例UI4.FormMaster.CreateParameterPolicy()功能。这将返回派生自的类的实例。 BaseParameterPolicy类。

属性政策

Attribute PoliciesKatana在两者之间提供一层属性地点在里面场景图和中的小部件Attributes标签,显示这些属性的值。

Attribute policies由内部创建Katana提供属性数据以显示在Attributes标签,当Scene Graph标签被选中。很少需要手动创建属性策略。

基于Geolib3的属性策略的Python基类为UI4.FormMaster.FnAttributePolicy.AttributePolicy。它源自AbstractValuePolicy类。

GenericAssignParameterPolicy

GenericAssignParameter PoliciesGAPP)在Katana参数策略在两者之间提供一层GenericAssign供电参数节点在里面节点图文档和小部件Parameters标签。它们可以看作是参数策略与属性政策

  • GenericAssign aspectGAPP收到的结果烹饪场景图由各自上游的节点产生GenericAssign通过内置的Geolib3客户端来驱动节点,该客户端从Geolib3运行时接收事件。这类似于属性策略如何从场景图位置的属性提供数据以显示在Attributes标签。
  • Parameter policy aspectGAPP会提供煮熟的属性数据,以供在Parameters标签。这类似于参数策略如何从节点的参数提供数据以显示在Parameters标签。

冻结和解冻

Freezing意思是Katana底层数据更改时通常处理的特定于事件的事件被暂时忽略。适用于价值政策,然后转到Katana应用程序窗口。这样可以确保在更改节点图文件或何时场景图位置数据是熟的,例如在小部件或标签对用户实际上不可见的情况下。

Thawingvalue policies或制表符是冻结的相反过程: Katana-特定事件已被暂时暂停或从未启动过,解冻意味着恢复或启动此类事件的处理以及作为结果更新UI组件。

Freezingthawing通过注册和注销特定的处理程序来实现Katana事件类型,具体取决于相应的价值策略或标签是否冻结。

注意:  有关注册回调和事件处理程序的信息,请参阅回调和事件在开发人员指南中。

通常,当用户从一个标签页的内部窗格中的一个标签页切换到下一个标签页时Katana窗口中,先前可见的选项卡被冻结,而新可见的选项卡被解冻。因此,现在隐藏的选项卡中的任何小部件都不会响应Katana事件,但是新显示的标签中的小部件是。使用时参数策略例如,在参数UI的上下文中用于自定义类型的节点SuperTools,请务必注意,需要将Python回调函数添加到此类value policy以便在政策的基本价值发生变化时得到通知。如果没有将此类回调添加到价值策略,则该价值策略被视为冻结。

注意:  有关更多信息,请参见和的描述。 懒惰评估 在里面Katana核心条款词汇表部分,以及GenericAssignParameterPolicy在“用户界面条款”部分中。

场景图管理器

ScenegraphManager Python模块是Nodes3DAPI Python包。它维护一个Scenegraph负责跟踪许多工作集保持位置的打开,关闭,选择和固定状态Katana场景图

有关固定的更多信息,请参见更改查看器中显示的内容

Scenegraph实例可以通过调用来检索ScenegraphManager.getActiveScenegraph()。然后,可以使用该实例来访问当前选定的场景图位置的路径列表:

sg = ScenegraphManager.getActiveScenegraph()

打印(sg.getSelectedLocations())

Scenegraph班级还保留选定的历史场景图位置,使用内部SelectionHistory类,目的是允许用户使用History ForwardHistory Backward中的命令Viewer标签。

Katana渲染条款

预览渲染

一种Preview Render是一种Interactive Render,表示从Katana UI会话,其中显示了渲染的图像和进度条KatanaMonitor标签。在一个Preview Render,当渲染的图像完成时,渲染器进程退出。这不同于Live Render,其中渲染器进程保持活动状态。

Preview Rendering在过去的早期版本中被称为交互式渲染Katana

注意:  有关更多信息Preview Rendering,请参阅执行渲染

实时渲染

一种Live Render是一种Interactive Render,表示从Katana UI会话,其中渲染器进程在显示中的同时保持活动状态KatanaMonitor标签。在更改节点中的参数时Katana项目,则将这些更改通知给渲染器,并在Monitor标签。

可以限制哪个场景图位置更新在以下过程中发送到渲染器Live Render会话,方法是使用Live Render Updates列中KatanaScene Graph标签。通常用于产生非常大的项目场景图

Live Rendering历史上在早期版本中被称为重新渲染Katana

注意:  有关更多信息Live Rendering,请参阅执行渲染

磁盘渲染

一种Disk Render是一种渲染类型,其中将渲染的图像写入磁盘上的文件,然后加载到Monitor渲染完成后单击“选项卡”。进度条在Monitor标签未更新,而Disk Render正在处理。

Disk Rendering在过去的早期版本中一直被称为热渲染Katana

预习实时渲染选项可从任何节点的上下文菜单中获得, Disk Render只能从Render节点。

注意:  有关更多信息Disk Rendering,请参阅渲染类型

互动渲染

一个Interactive Render是从Katana UI会话。有两种类型的交互式渲染Katana

交互式渲染滤镜

Interactive Render Filters (通常缩写为IRF)允许用户设置通用食谱更改 interactive renders,意思预览渲染实时渲染,而无需添加节点在一个不同的点上实现这种改变项目食谱。一个IRF可以包含多个对配方的更改,这等效于将节点追加到开始交互式渲染的节点的末尾。

IRF在中定义InteractiveRenderFilters节点,可以在其中选择性地激活和停用Interactive Render Filters弹出。通过单击Interactive Render Filters纽扣在顶部Katana接口。

注意:  Interactive Render Filters被忽略磁盘渲染

的示例用法IRFs的设置是为了降低交互式渲染的渲染分辨率而不会影响Disk Renders,从而使此类渲染的调试更快。可以设置的其他更改示例IRF可能包括抗锯齿设置,阴影率更改或光反射次数。

注意:  有关设置的更多信息Interactive Render Filters,请参阅设置交互式渲染过滤器
您也可以参考知识库文章使用交互式渲染滤镜提高预览效率

渲染依赖

当从Render在节点上,可以通过具有依赖性的渲染将渲染可能依赖的其他渲染过程自动渲染到磁盘。

从历史上看,此功能用于生成阴影贴图,然后将其用于主要渲染过程。

注意:  有关更多信息,请参见渲染依赖