加夫三

GafferThree节点类型使您可以在任意的钻机层次结构下创建灯光。材质,变换和约束可以应用于GafferThree的内部光源Parameters接口。该节点还支持:

创建主材料并将其应用于灯光。

静音和独奏灯光,或装备下的所有灯光。

将灯光链接到特定对象。

编辑来自传入场景的灯光,并一次编辑多个灯光。

向灯光添加瞄准约束。

注意:  GafferThree节点是对传统Gaffer节点的改进Katana 1.x。Gaffer节点的显着改进如下:

处理大量灯光时的性能提高Katana项目。

场景图形处理库Geolib3的全部优点。

允许编辑来自传入场景的现有灯光。

来自的旧Gaffer节点类型Katana 1.x仍然存在,并且当前场景应该继续工作,但是建议尽可能使用新的GafferThree节点类型。

连接类型

连接名称

功能

输入值

节点图中要创建GafferThree以便一起创建多个灯光的位置。

 

控制(UI)

功能

>在场景图中选择

将场景图路径设置为要创建的位置。

有关更多信息,请参见通用参数小部件

>显示传入场景

显示来自上游Gaffer型节点的所有传入的灯光,装备和主材质。

同步选择

启用后,请在参量标签选择其在场景图标签:

off -不执行同步(默认)。

out -在GafferThree节点中选择光源是在Scene Graph标签,但并非相反。

in/out -在Scene Graph标签或GafferThree节点会导致另一个中的相应条目也被选中。

[Gaffer对象表]

显示此GafferThree节点控制的所有对象的列表。对象表包含以下信息:

名称 -对象的名称。在此列中双击以更改项目的名称。

中号 -单击以使对象静音,以便在渲染中将其省略。

小号 -单击以独占对象,以便从交互式渲染中忽略所有未独占的内容。

着色器 -显示与对象关联的着色器。您也可以右键单击此列以选择着色器。添加着色器后,双击此列即可随时进行分配或更改。

颜色 -指定灯光的颜色。双击色板以激活颜色选择器。如果没有色板,则需要在Material标签,然后才能在此列中对其进行更改。

诠释 -设置光强度。

经验值 -设置曝光量。

连结中 -表示项目是否已链接。条目中的星号表示有例外。

右键单击[Gaffer对象表项目]

添加> 母材

将主材料添加到gaffer表。主材质分配给灯光,为多个灯光提供相同的材质。每盏灯还能够覆盖此主材质设置的默认值。

添加>

向对象表添加灯光。

添加> 钻机

将多个灯光的装备添加到对象表。

添加> 滤光片参考

添加引用另一个滤光器包的滤光器。

添加> 滤光片

添加一个滤光器,该滤光器可以根据您使用的渲染器修改灯光的行为。

添加> 天穹

添加天顶灯,用于为场景提供环境照明。

添加>导入装备...

将先前导出的装备添加到对象表。

删除

删除对象表中的选定实体。

重复

创建当前所选实体的副本。

接受编辑

允许您对从传入场景(可以是任何上游Gaffer型节点)显示的灯光,装备或主材质进行编辑。

删除编辑包

如果您采用光源,装备或主材质进行编辑,则可以还原为只读状态并撤消应用的更改。

切换选定项目的锁定状态

切换对象表中所选实体的锁定状态。

在钻机下将选定的兄弟姐妹分组

在新创建的装备下将选定的兄弟姐妹分组。

出口装备

将当前选择的项目导出为.rig文件。

创建共享的滤光器

在引用场景图中另一个位置已存在的滤光器的灯光上创建滤光器。

展开全部

展开对象表中的选定分支以显示所有子项。如果所选分支没有任何子级,则尝试扩展时不会发生任何事情。

注意:  在菜单中, Expand All变成Expand Branch只要Gaffer对象表中有多个项目,就可以。

全部展开到

将分支扩展为特定类型,即装配体,零件或详细级别组。这种扩展方法专门适用于场景图,并且对GafferThree的使用受到限制。

注意:  在菜单中, Expand All To变成Expand Branch To只要Gaffer对象表中有多个项目,就可以。

收起全部

将分支折叠为特定类型,即装配,零件或详细级别组。这种折叠方法特别适用于场景图,并且对GafferThree的使用受到限制。

注意:  在菜单中, Collapse All To变成Collapse Branch To只要Gaffer对象表中有多个项目,就可以。

全部收缩

折叠对象表中的选定分支以隐藏所有子项。如果所选分支没有任何子代,则尝试折叠时不会发生任何事情。

注意:  在菜单中, Collapse All变成Collapse Branch只要Gaffer对象表中有多个项目,就可以。

扩大位置

将所选位置扩展到仅子级,并在层次结构中直接位于其下方。

收合位置

折叠所选位置及其所有子代,并直接在其下方离开,但不折叠高于该层次结构中位置的任何实体。

的显示参数ObjectMaterialLinking选项卡取决于在Gaffer对象表中选择的内容。如果未列出对象类型的特定选项卡,则该选项卡中没有参数。

控制(UI)

默认值

功能

Object list: master material

材料标签

useLookFileMaterial

残障人士

启用后,将使用关联的外观文件中的材质。

添加明暗器

不适用

单击以从下拉列表中添加特定于渲染器的着色器。的材料 “选项卡”中填充了适合所选着色器的控件,并且取决于安装的渲染器。

 

控制(UI)

默认值

功能

Object list: light

Object tab > geometry

投影

透视

设置光投射模式:

透视-扭曲的投影,其中远处的物体/特征看起来比近处的物体/特征小。

正字法-三维对象的二维表示。

半径

1

设置灯光的半径。

70

以度为单位控制视野角。

orthographicWidth

30

设置正交投影的宽度。

兴趣中心

20

设置兴趣中心。

0.1

设置接近裁剪平面的距离。

100000

设置远剪裁平面距离。

screenWindow

-1.0、1.0,-1.0、1.0

控制屏幕窗口在成像平面上的放置。他们是leftrightbottomtop屏幕窗口的边界。

Object tab > transform

转变

不适用

根据SRT或矩阵控件变换光。

有关更多信息,请参阅通用参数小部件

转换>工具

不适用

调整光以匹配下拉菜单中的选定场景图选择选项。

有关更多信息,请参考通用参数小部件

enable aim constraint: enabled; aim constraint options

targetPath

不适用

指定要约束到的对象。如果要瞄准光源以指向目标,则为目标。如果设置多个目标,则约束将瞄准对象的平均中心。的targetPath参数选项在场景图小部件或参数右侧的下拉菜单。

有关更多信息,请参考以下内容中的“场景图位置”窗口小部件类型。 通用参数小部件

addToConstraintList

指定是否将光源的基本路径添加到位于以下位置的globals.constraintList /root/world在里面Attributes标签。

targetOrigin

宾语

设置如何计算目标对象的中心:

Object -使用对象的本地原点作为目标。

Bounding Box -使用对象边界框的中心作为目标。

Face Center Average -使用对象的面部中心平均作为目标。

Face Bounding Box -使用对象边界框的面部中心平均作为目标。

baseAimAxis

0.0、0.0,-1.0

指向目标的基础对象的轴。调整这些值会更改对象对准目标的侧面。

baseUpAxis

0.0、1.0、0.0

相对于目标指向上方的基础对象的轴。调整这些值可更改基础对象的旋转,同时保持目标恒定。

targetUpAxis

0.0、1.0、0.0

相对于基础对象指向上方的目标对象的轴。调整这些值可更改目标对象的旋转,同时保持目标恒定。

setRelativeTargets

没有

将场景图形约束定义中的目标路径存储为相对于基本路径的路径。

在该节点的参数中,仍应将目标指定为绝对路径。

Object tab > annotation

文本

不适用

在查看器中放置一个标签,其中包含在文本字段中输入的字符串。

PreviewColor

1.0、1.0、1.0

指定查看器中灯光注释的颜色。该值不影响光源的颜色值。

有关更多信息,请参阅通用参数小部件

Material tab > material

useLookFileMaterial

残障人士

启用后,将使用关联的外观文件中的材质。

添加明暗器

不适用

单击以从下拉列表中添加特定于渲染器的着色器。的材料 “选项卡”中填充了适合所选着色器的控件,并且取决于安装的渲染器。

useLookFileMaterial:已启用

参考>资产

不适用

将路径设置为场景中所需的资产。

有关更多信息,请参阅通用参数小部件

参考> materialPath

不适用

根据您已在列表中列出的资产,从下拉列表中选择物料路径asset上面的字段。

如果您没有asset列在资产字段中,则下拉列表中没有任何内容materialPath

Linking tab > light linking

对灯光链接的支持取决于您的渲染器。

行动

附加链接信息

确定在此节点中设置的链接选项是否覆盖传入的场景选项,或者是否将新设置附加到传入的选项。如果传入的场景中不存在此灯光,则此选项无效。

initialState

(或将现有值用于采用的灯光)

确定新添加的灯光位置最初是否为onoff , 要么use existing value

注意:  use existing value该选项仅适用于采用的灯。

clearUnmatched

残障人士

解决链接后, clearUnmatched参数确定是否从与以下位置不匹配的位置中删除此灯光的现有灯光链接属性。 on要么off表达式。

此参数的效果仅在Attributes链接已解决时(即在LightLinkResolve节点之后或隐式解析器处于活动状态时)的“ Tab”选项卡。

检查lightList属性以确保已正确设置属性。如果已禁用该参数,则enable子属性lightList您的灯光的属性是0;否则,默认启用的设置是1

不适用

CEL语句,通过该语句可以将场景图位置链接到选定的灯光,从而将灯光转向on对于那些位置。

使用集合表达语言(CEL)指定场景图的位置。有关更多信息,请参阅文档HTML页面上的CEL参考文档(可通过以下网址访问救命 > 文献资料)。

使用CEL语句小部件编辑CEL语句。有关CEL语句窗口小部件类型的更多信息,请参阅《 CEL语句窗口小部件类型》。 通用参数小部件

不适用

CEL语句,通过该语句可以将场景图位置链接到选定的灯光,从而将灯光转向off对于那些位置。

使用集合表达语言(CEL)指定场景图的位置。有关更多信息,请参阅文档HTML页面上的CEL参考文档(可通过以下网址访问救命 > 文献资料)。

使用CEL语句小部件编辑CEL语句。有关CEL语句窗口小部件类型的更多信息,请参阅《 CEL语句窗口小部件类型》。 通用参数小部件

Linking tab > shadow linking

对阴影链接的支持取决于您的渲染器。

行动

附加链接信息

确定在此节点中设置的链接选项是否覆盖传入的场景选项,或者是否将新设置附加到传入的选项。如果传入的场景中不存在此灯光,则此选项无效。

initialState

不要设定值

(或将现有值用于采用的灯光)

确定阴影可见性的初始值lightList新添加的灯光条目: onoffdon't set value , 要么use existing value

注意:  use existing value该选项仅适用于采用的灯。

clearUnmatched

残障人士

解决链接后, clearUnmatched参数确定是否从与以下位置不匹配的位置中删除此灯光的现有灯光链接属性。 on要么off表达式。

此参数的效果仅在Attributes链接已解决时(即在LightLinkResolve节点之后或隐式解析器处于活动状态时)的“ Tab”选项卡。

检查lightList属性以确保已正确设置属性。如果已禁用该参数,则enable子属性lightList您的灯光的属性是0;否则,默认启用的设置是1

不适用

CEL语句,通过该语句可以将场景图位置链接到选定的灯光,从而从该灯光转向阴影投射on对于那些位置。

使用集合表达语言(CEL)指定场景图的位置。有关更多信息,请参阅文档HTML页面上的CEL参考文档(可通过以下网址访问救命 > 文献资料)。

使用CEL语句小部件编辑CEL语句。有关CEL语句窗口小部件类型的更多信息,请参阅中的CEL语句窗口小部件类型。 通用参数小部件

不适用

CEL语句,通过该语句可以将场景图位置链接到选定的灯光,从而从该灯光转向阴影投射off对于那些位置。

使用集合表达语言(CEL)指定场景图的位置。有关更多信息,请参阅文档HTML页面上的CEL参考文档(可通过以下网址访问救命 > 文献资料)。

使用CEL语句小部件编辑CEL语句。有关CEL语句窗口小部件类型的更多信息,请参阅中的CEL语句窗口小部件类型。 通用参数小部件

 

控制(UI)

默认值

功能

Object list: rig

Object tab > transform

转变

不适用

根据SRT或矩阵控件变换装备。

有关更多信息,请参阅通用参数小部件

转换>工具

不适用

调整装备以匹配下拉菜单中的选定场景图选择选项。

有关更多信息,请参考通用参数小部件

对象选项卡参数续

启用点约束

残障人士

启用后,指定点约束选项

启用定向约束

残障人士

启用后,指定定向约束选项

当启用点约束时:启用;点约束选项

targetPath

不适用

指定要约束到的对象。如果要以钻机为目标,则为目标。如果设置多个目标,则约束将瞄准对象的平均中心。的targetPath参数选项在场景图小部件或参数右侧的下拉菜单。

有关更多信息,请参考以下内容中的“场景图位置”窗口小部件类型。 通用参数小部件

addToConstraintList

指定是否将装备的基本路径添加到位于以下位置的globals.constraintList /root/world在里面Attributes标签。

allowMissingTargets

没有

设置为,如果其目标不在场景图中,则静默忽略该约束。设置为没有如果缺少目标,则会在约束解析上产生错误。

baseOrigin

宾语

设置如何计算基础对象的中心:

宾语 -使用对象的本地原点作为原点。

界线 -使用对象边界框的中心作为基本原点。

targetOrigin

宾语

设置如何计算目标对象的中心:

宾语 -使用对象的本地原点作为目标原点。

界线 -使用对象边界框的中心作为目标原点。

面对中央平均 -使用对象的面部中心平均作为目标原点。

面对界线 -使用对象边界框的脸中心平均作为目标原点。

setRelativeTargets

没有

将场景图形约束定义中的目标路径存储为相对于基本路径的路径。

在该节点的参数中,仍应将目标指定为绝对路径。

when enable orient constraint: enabled; orient constraint options

targetPath

不适用

指定要约束到的对象。如果要以钻机为目标,则为目标。如果设置多个目标,则约束将瞄准对象的平均中心。的targetPath参数选项在场景图小部件或参数右侧的下拉菜单。

有关更多信息,请参考以下内容中的“场景图位置”窗口小部件类型。 通用参数小部件

addToConstraintList

指定是否将装备的基本路径添加到位于以下位置的globals.constraintList /root/world在里面Attributes标签。

targetOrientation

宾语

设置如何计算目标对象的方向:

Object -使用对象的本地原点作为目标。

Face -使用面部的本地原点作为目标。

allowMissingTargets

没有

设置为,如果其目标不在场景图中,则静默忽略该约束。设置为没有如果缺少目标,则会在约束解析上产生错误。

x轴

已启用

启用后,方向将限制在x轴上。

y轴

已启用

启用后,方向将限制在y轴上。

z轴

已启用

启用后,方向将限制在z轴上。

setRelativeTargets

没有

将场景图形约束定义中的目标路径存储为相对于基本路径的路径。

在该节点的参数中,仍应将目标指定为绝对路径。

 

控制(UI)

默认值

功能

Object list: light filter reference

对象标签

referencePath

不适用

要作为此滤光器一部分引用的滤光器包的路径。

 

控制(UI)

默认值

功能

Object list: light filter

Object tab

继承

不适用

您要继承的另一个滤光器包的路径。

Object tab > viewer

固体

滤光片在查看器中的显示方式: points, 一种wireframesolid填。

Object tab > transform

翻译

0.0、0.0、0.0

通过在x,y或z轴上移动来过滤滤光器。使用“平移”操纵器在查看器中修改滤光器也会更新这些参数值。

旋转

0.0、0.0、0.0

通过绕x,y或z轴旋转来过滤滤光器。使用“旋转”操纵器在查看器中修改滤光器也会更新这些参数值。

规模

1.0、1.0、1.0

通过沿x,y或z轴缩放缩放滤镜。使用“缩放”操纵器在查看器中修改滤光器也会更新这些参数值。

Material tab

useLookFileMaterial

残障人士

启用后,将使用关联的外观文件中的材质。

添加明暗器

不适用

单击以从下拉列表中添加特定于渲染器的着色器。的材料 “选项卡”中填充了适合所选着色器的控件,并且取决于安装的渲染器。

useLookFileMaterial: enabled

参考>资产

不适用

将路径设置为场景中所需的资产。

有关更多信息,请参阅通用参数小部件

参考> materialPath

不适用

根据您已在列表中列出的资产,从下拉列表中选择物料路径asset上面的字段。

如果您没有asset列在资产字段中,则下拉列表中没有任何内容materialPath

Linking tab > light linking

行动

附加链接信息

确定在此节点中设置的链接选项是否覆盖传入的场景选项,或者是否将新设置附加到传入的选项。如果传入的场景中不存在此灯光,则此选项无效。

initialState 不要设定值

确定新添加的灯光位置最初是否为onoff ,或者没有设置值。

clearUnmatched 残障人士

解决链接后, clearUnmatched参数确定是否从与以下位置不匹配的位置中删除此灯光的现有灯光链接属性。 on要么off表达式。

此参数的效果仅在Attributes链接已解决时(即在LightLinkResolve节点之后或隐式解析器处于活动状态时)的“ Tab”选项卡。

检查lightList属性以确保已正确设置属性。如果已禁用该参数,则enable子属性lightList您的灯光的属性是0;否则,默认启用的设置是1

不适用

CEL语句,通过该语句可以将场景图位置链接到选定的灯光,从而将灯光转向on对于那些位置。

使用集合表达语言(CEL)指定场景图的位置。有关更多信息,请参阅文档HTML页面上的CEL参考文档(可通过以下网址访问救命 > 文献资料)。

使用CEL语句小部件编辑CEL语句。有关CEL语句窗口小部件类型的更多信息,请参阅《 CEL语句窗口小部件类型》。 通用参数小部件

不适用

CEL语句,通过该语句可以将场景图位置链接到选定的灯光,从而将灯光转向off对于那些位置。

使用集合表达语言(CEL)指定场景图的位置。有关更多信息,请参阅文档HTML页面上的CEL参考文档(可通过以下网址访问救命 > 文献资料)。

使用CEL语句小部件编辑CEL语句。有关CEL语句窗口小部件类型的更多信息,请参阅《 CEL语句窗口小部件类型》。 通用参数小部件

 

控制(UI)

默认值

功能

Object list: sky dome

Object tab > transform

翻译

0.0、0.0、0.0

通过在x,y或z轴上移动天顶灯光来变换它。使用“平移”操纵器在查看器中修改天空穹顶也会更新这些参数值。

旋转

0.0、0.0、0.0

通过绕x,y或z轴旋转来改变天顶灯光。使用“旋转”操纵器在查看器中修改天空穹顶也会更新这些参数值。

规模

1000.0、1000.0、1000.0

通过沿x,y或z轴缩放天空穹顶光来对其进行变换。使用缩放操纵器在查看器中修改天空穹顶也会更新这些参数值。

Material tab > material

useLookFileMaterial

已启用

启用后,将使用关联的外观文件中的材质,并且其他参数包含在参考下拉列表中。

添加明暗器

不适用

单击以从下拉列表中添加特定于渲染器的着色器。的材料 “选项卡”中填充了适合所选着色器的控件,并且取决于安装的渲染器。

useLookFileMaterial: enabled

参考>资产

/tmp/hdriSkyDomeLight.klf

将路径设置为已写入磁盘的外观文件。

有关更多信息,请参阅通用参数小部件

参考> materialPath

/ root / materials / hdriSkyDomeLight

根据您已在列表中列出的资产,从下拉列表中选择物料路径asset上面的字段。

如果您没有asset列在资产字段中,则下拉列表中没有任何内容materialPath

Linking tab > light linking

行动

附加链接信息

确定在此节点中设置的链接选项是否覆盖传入的场景选项,或者是否将新设置附加到传入的选项。如果传入的场景中不存在此灯光,则此选项无效。

initialState 不要设定值

确定新添加的灯光位置最初是否为onoff ,或者没有设置值。

clearUnmatched 残障人士

解决链接后, clearUnmatched参数确定是否从与以下位置不匹配的位置中删除此灯光的现有灯光链接属性。 on要么off表达式。

此参数的效果仅在Attributes链接已解决时(即在LightLinkResolve节点之后或隐式解析器处于活动状态时)的“ Tab”选项卡。

检查lightList属性以确保已正确设置属性。如果已禁用该参数,则enable子属性lightList您的灯光的属性是0;否则,默认启用的设置是1

不适用

CEL语句,通过该语句可以将场景图位置链接到选定的灯光,从而将灯光转向on对于那些位置。

使用集合表达语言(CEL)指定场景图的位置。有关更多信息,请参阅文档HTML页面上的CEL参考文档(可通过以下网址访问救命 > 文献资料)。

使用CEL语句小部件编辑CEL语句。有关CEL语句窗口小部件类型的更多信息,请参阅《 CEL语句窗口小部件类型》。 通用参数小部件

不适用

CEL语句,通过该语句可以将场景图位置链接到选定的灯光,从而将灯光转向off对于那些位置。

使用集合表达语言(CEL)指定场景图的位置。有关更多信息,请参阅文档HTML页面上的CEL参考文档(可通过以下网址访问救命 > 文献资料)。

使用CEL语句小部件编辑CEL语句。有关CEL语句窗口小部件类型的更多信息,请参阅《 CEL语句窗口小部件类型》。 通用参数小部件

Linking tab > shadow linking

对阴影链接的支持取决于您的渲染器。

行动

附加链接信息

确定在此节点中设置的链接选项是否覆盖传入的场景选项,或者是否将新设置附加到传入的选项。如果传入的场景中不存在此灯光,则此选项无效。

initialState

不要设定值

(或将现有值用于采用的灯光)

确定阴影可见性的初始值lightList新添加的灯光条目: onoffdon't set value , 要么use existing value

注意:  use existing value该选项仅适用于采用的灯。

clearUnmatched

残障人士

解决链接后, clearUnmatched参数确定是否从与以下位置不匹配的位置中删除此灯光的现有灯光链接属性。 on要么off表达式。

此参数的效果仅在Attributes链接已解决时(即在LightLinkResolve节点之后或隐式解析器处于活动状态时)的“ Tab”选项卡。

检查lightList属性以确保已正确设置属性。如果已禁用该参数,则enable子属性lightList您的灯光的属性是0;否则,默认启用的设置是1

不适用

CEL语句,通过该语句可以将场景图位置链接到选定的灯光,从而从该灯光转向阴影投射on对于那些位置。

使用集合表达语言(CEL)指定场景图的位置。有关更多信息,请参阅文档HTML页面上的CEL参考文档(可通过以下网址访问救命 > 文献资料)。

使用CEL语句小部件编辑CEL语句。有关CEL语句窗口小部件类型的更多信息,请参阅中的CEL语句窗口小部件类型。 通用参数小部件

不适用

CEL语句,通过该语句可以将场景图位置链接到选定的灯光,从而从该灯光转向阴影投射off对于那些位置。

使用集合表达语言(CEL)指定场景图的位置。有关更多信息,请参阅文档HTML页面上的CEL参考文档(可通过以下网址访问救命 > 文献资料)。

使用CEL语句小部件编辑CEL语句。有关CEL语句窗口小部件类型的更多信息,请参阅中的CEL语句窗口小部件类型。 通用参数小部件