通用运算

GenericOp节点允许您运行命名的特定Op。这对于在开发过程中运行以插件形式编写的自定义Ops以及在SuperTools和宏中使用特别有用。有关更多信息,请参阅Op API。

连接类型

连接名称

功能

输入值

按下即可添加编号的输入端口(i0,i1,i2) 在节点中。

您要为节点图的不同部分设置的输入端口。

 

控制(UI)

默认值

功能

opType

不适用

指定要运行的Op的类型,例如AttributeSet。

opArgs

不适用

从中添加新的opArgs参数Add下拉列表。有关可用选项的详细说明,请参见添加用户参数。

• 数

• 串

• 组

• 数字数组

• 字符串数组

• 浮点向量

• 颜色,RGB

• 颜色,RGBA

• 纽扣

• 工具列

• 远程参数

• 节点删除代理

addSystemOpArgs

没有

如果启用,则添加一个“系统” opArg,其中包含来自图形状态时间片的信息,例如帧和快门时序。这仅对于某些操作是必需的。

执行模式

即时

确定运行Op的时间:

• immediate -该脚本在以下位置中指定的位置运行applyWhere参数,因为它是在节点图中此节点处评估的。

• deferred -该脚本是由该节点设置的,但实际上不会运行,直到节点图中的更高节点(如applyWhen参数。

executionMode: immediate

适用于

在符合CEL的位置

确定脚本的运行位置:

• at all locations -在节点图中的所有位置。

• at specific location -仅在指定的位置location参数。如果此位置不存在,则会自动创建。

• at locations matching CEL -仅在节点图中与CEL语句匹配的那些位置。

resolveIds

不适用

什么时候executionMode设定为 immediate,请指定一个以空格分隔的字符串列表,以指示此脚本仅应由包含至少一个匹配“ resolveId”的Op解析器解析。这是一项高级功能,可以更好地控制评估顺序。

一个有用的resolveIds是hidden_prepocess,它在第一个隐式解析器上运行,然后运行其他隐式解析器(例如MaterialResolve和ConstraintResolve)。

输入行为

按索引

控制节点上的输入端口如何映射到基础Op的输入。仅当节点具有一个或多个节点时,此参数才有意义invalid input ports -未连接到输出端口或连接到不提供数据的输出端口的端口。

设置为only valid,当确定哪些输入传递给基础Op时,将跳过该节点的任何有效输入端口。

设置为by index,节点的所有输入端口都显示在Op看到的输入列表中;无效的输入表示为类型的Op no-op。

适用位置:特定位置

位置

/ root / world / location

要创建的位置(如果尚不存在)。否则,将运行脚本的场景图位置。

有关位置窗口小部件参数的更多信息,请参见通用参数小部件。

applyWhere: at locations matching CEL

CEL

不适用

使用集合表达语言(CEL)指定场景图的位置。的CEL通过单击可使用参数选项Add Statements。

有关更多信息,请参阅文档HTML页面上的CEL参考文档(可通过以下网址访问救命 > 文献资料)或CEL语句小部件类型通用参数小部件。

executionMode: deferred

适用时间

在解决过程中

确定何时运行脚本:

• during op resolve -脚本及其参数作为属性添加,稍后由OpResolve节点执行。如果Op不是由放置在节点图中的显式OpResolve节点运行的,则由渲染器在渲染时自动运行implicit resolvers。

• during material resolve -脚本及其参数作为属性添加到material.scenegraphLocationModifers组属性。这主要用于物料场景图位置,从而允许物料指定在分配了物料的每个位置处运行的过程过程。该脚本将作为材质解析过程的一部分运行,并在该位置创建材质着色器的初始值后立即执行。它的使用示例包括对着色器参数进行随机化或构建程序控制。

• during katana look file resolve -脚本及其参数作为属性添加到Scene GraphLocationModifers组属性下,并由LookFileResolve节点或第一个隐式解析器(如果不存在LookFileResolve节点)进行评估。

CEL

不适用

使用集合表达语言(CEL)指定场景图的位置。的CEL通过单击可使用参数选项Add Statements。

有关更多信息,请参阅文档HTML页面上的CEL参考文档(可通过以下网址访问救命 > 文献资料)或CEL语句小部件类型通用参数小部件。

名称

通用运算

用于存储Op类型和args的属性组的名称。

输入行为

按索引

控制节点上的输入端口如何映射到基础Op的输入。仅当节点具有一个或多个节点时,此参数才有意义invalid input ports -未连接到输出端口或连接到不提供数据的输出端口的端口。

设置为only valid,当确定哪些输入传递给基础Op时,将跳过该节点的任何有效输入端口。

设置为by index,节点的所有输入端口都显示在Op看到的输入列表中;无效的输入表示为类型的Op no-op。

applyWhen: during op resolve

递归启用

没有

在非立即状态下应用时,启用此选项将导致Op在指定位置下方的每个位置运行。通常,这比使用等效的递归CEL语句更有效。

您也可以覆盖ops.*.recursiveEnable在树中更深的任何地方赋予属性,以排除那些位置的评估。这类似于可见或光链接属性的行为。

recursiveEnable: yes

disableAt

不适用

对于此CEL语句或以下的位置,将禁用执行。对于大型场景层次结构,这通常比在较大的叶子位置进行评估以避免将其应用于较小的子集便宜。

为场景指定场景图位置disableAt通过单击参数选项Add Statements。

有关更多信息,请参阅文档HTML页面上的CEL参考文档(可通过以下网址访问救命 > 文献资料)或CEL语句小部件类型通用参数小部件。

resolveIds

不适用

什么时候applyWhen设定为during op resolve,您可以指定以空格分隔的字符串列表,以指示此Op应该仅由包含至少一个匹配的“ resolveId”的Op解析器解析。这是一项高级功能,可以更好地控制评估顺序。

一个有用的resolveIds是hidden_prepocess,它在第一个隐式解析器上运行,然后运行其他隐式解析器(例如MaterialResolve和ConstraintResolve)。

applyWhen:在katana中查找文件解析

递归启用

没有

在非立即状态下应用时,启用此选项将导致Op在指定位置下方的每个位置运行。通常,这比使用等效的递归CEL语句更有效。

您也可以覆盖ops.*.recursiveEnable在树中更深的任何地方赋予属性,以排除那些位置的评估。这类似于可见或光链接属性的行为。

recursiveEnable: yes

disableAt

不适用

对于此CEL语句或以下的位置,将禁用执行。对于大型场景层次结构,这通常比在较大的叶子位置进行评估以避免将其应用于较小的子集便宜。

为场景指定场景图位置disableAt通过单击参数选项Add Statements。

有关更多信息,请参阅文档HTML页面上的CEL参考文档(可通过以下网址访问救命 > 文献资料)或CEL语句小部件类型通用参数小部件。