GafferThree

Sets the scene graph path to the location to be created.

For more information, see Common Parameter Widgets.

Displays all incoming lights, rigs, and Template Materials from upstream Gaffer-type nodes.

When enabled, selecting a Gaffer light within the Parameters tab selects its location within the Scene Graph tab:

• off - no syncing is performed (the default).

• out - selection of a light in the GafferThree node is mirrored in the Scene Graph tab, but not the other way around.

• in/out - selecting in either the Scene Graph tab or GafferThree node results in the corresponding entry in the other also being selected.

Displays a list of all objects controlled by this GafferThree node. The object table contains the following information:

• Name - the name of the object. Double-click in this column to change the name of the item.

• M - click to mute the object so that it is omitted from renders.

• S - click to solo the object so that everything not solo-ed is omitted from interactive renders.

• Shader - displays the shader associated with the object. You can also right-click in this column to select a shader. Once you've added a shader, double-click in this column to assign or change it at any time.

• Color - specifies the color of a light. Double-click the swatch to activate the color picker. If there isn't a swatch, you need to add a color in the Material tab before you can change it in this column.

• Int - sets the light intensity.

• Exp - sets the light exposure.

• Linking - indicates whether or not the item is linked. A star in the entry indicates there are exceptions.

Adds a Template Material to the gaffer table. The Template Material is assigned to lights, providing the same material for multiple lights. Each light is also capable of overriding the defaults set by this Template Material.

Adds a light to the object table.

Adds a rig for multiple lights to the object table.

Adds a light filter that references another light filter package.

Adds a light filter that modifies the behavior of a light, depending on the renderer you're using.

Adds a sky dome light, used to provide environment lighting to your scene.

Adds a previously exported rig to the object table.

Deletes the selected entity in the object table.

Creates a copy of the currently selected entity.

Allow you to make edits on a light, rig, or Template Material that has been shown from an incoming scene, which can be any upstream Gaffer-type node.

If you adopted a light, rig, or Template Material for editing, you can revert back to a read-only state and reverse the changes that you applied.

Toggles the lock state of the selected entity in the object table.

Groups the selected siblings under a newly created rig.

Exports the currently selected item as a .rig file.

Creates a light filter on a light that references a light filter that already exists in another location in the scenegraph.

Expands the selected branch in the object table to reveal all children. If the selected branch does not have any children, nothing happens when attempting to expand.

Note:  In the menu, Expand All becomes Expand Branch whenever there is more than one item in the Gaffer object table.

Expand the branch to a specific type, either assembly, component, or level-of-detail group. This method of expansion applies specifically to the scene graph, and has limited use for the GafferThree.

Note:  In the menu, Expand All To becomes Expand Branch To whenever there is more than one item in the Gaffer object table.

Collapse the branch to a specific type, either assembly, component, or level-of-detail group. This method of collapse applies specifically to the scene graph, and has limited use for the GafferThree.

Note:  In the menu, Collapse All To becomes Collapse Branch To whenever there is more than one item in the Gaffer object table.

Collapses the selected branch in the object table to hide all children. If the selected branch does not have any children, nothing happens when attempting to collapse.

Note:  In the menu, Collapse All becomes Collapse Branch whenever there is more than one item in the Gaffer object table.

Expands the selected location to only the children and leaves directly below it in the hierarchy.

When enabled, the material from an associated Look File is used.

Sets the light projection mode:

• perspective - a warped projection where distant objects/features appear smaller than those nearer the camera.

• orthographic - a two-dimensional representation of a three-dimensional object.

Sets the light's radius.

Controls the field of view angle in degrees.

Sets the orthographic projection width.

Sets the center of interest.

Sets the near clipping plane distance.

Sets the far clipping plane distance.

Controls the screen window placement on the imaging plane. They are the left, right, bottom, and top bounds of the screen window.

Transforms the light according to the SRT or matrix controls.

For more information, refer to the Transform Controls Widget Type in the Common Parameter Widgets.

Adjusts the light to match selected scene graph selection options in the dropdown menu.

For more information, refer to the Transform Tools Widget Type in the Common Parameter Widgets.

Specifies the object(s) to constrain to. If you want to aim a light to point at a target, this is the target. If you set multiple targets, then the constraint aims at the average center of the objects. The targetPath parameter options are available in either a scene graph widget or dropdown menu to the right of the parameter.

For more information, refer to the Scene Graph Location Widget Type in the Common Parameter Widgets.

Specifies whether or not to add the base path for the light to the globals.constraintList at /root/world in the Attributes tab.

Sets how the center of the target object is calculated:

• Object - uses the local origin of the object as the target.

• Bounding Box - uses the center of the object’s bounding box as the target.

• Face Center Average - uses the face center average of the object as the target.

• Face Bounding Box - uses the face center average of the object’s bounding box as the target.

The axis of the base object that is pointed at the target. Adjusting these values changes the side of the object that is aimed at the target.

The axis of the base object that is pointed upwards relative to the target. Adjusting these values changes the rotation of the base object, while keeping the aim constant.

The axis of the target object that is pointed upwards relative to the base object. Adjusting these values changes the rotation of the target object, while maintaining the aim constant.

Stores target paths in the scene graph constraint definition as paths relative to the base path.

Targets should still be specified as absolute paths in this node's parameters.

Places a label in the Viewer containing the string entered in the text field.

Specifies the color of the light annotation in the Viewer. This value does not affect the color value of the light.

For more information, refer to the Color Widget Type in the Common Parameter Widgets.

When enabled, the material from an associated Look File is used.

Click to add a renderer-specific shader from the dropdown list. The Material tab is populated with controls appropriate to the shader selected, and are dependent on the renderers installed.

Set the path to the asset you want in your scene.

For more information, refer to the Asset and File Path Widget Types in the Common Parameter Widgets.

Choose the material path from the dropdown list, based on the asset you have listed in the asset field above.

If you do not have an asset listed in the asset field, nothing appears in the dropdown list for materialPath.

Determines whether the linking options set in this node override the incoming scene options or if the new settings are appended to the incoming options. If this light doesn't exist in the incoming scene, this option has no effect.

Determines whether the newly-added light location is initially on, off, or use existing value.

Note:  The use existing value option is only available for adopted lights.

When linking is resolved, the clearUnmatched parameter determines whether or not existing light linking attributes for this light are removed from locations that do not match the on or off expressions.

The effect of this parameter is only visible in the Attributes tab when linking has been resolved, which means after a LightLinkResolve node or when Implicit Resolvers are active.

Examines the lightList attribute on your linked objects to ensure that the attributes have been set correctly. If the parameter has been disabled, the value of the enable child attribute in the lightList attribute for your light is 0; otherwise, the default enabled setting is 1.

A CEL Statement through which scene graph locations can be linked to the selected light, thereby turning the light on for those locations.

The scene graph locations are specified using the Collection Expression Language (CEL). For more information, refer to the CEL Reference document found on the documentation HTML page (accessed through Help > Documentation).

CEL Statements are edited using CEL Statement Widgets. For more information on the CEL Statement Widget type, refer to CEL Statement Widget Type in Common Parameter Widgets.

A CEL Statement through which scene graph locations can be linked to the selected light, thereby turning the light off for those locations.

The scene graph locations are specified using the Collection Expression Language (CEL). For more information, refer to the CEL Reference document found on the documentation HTML page (accessed through Help > Documentation).

CEL Statements are edited using the CEL Statement Widgets. For more information on the CEL Statement Widget type, refer to CEL Statement Widget Type in Common Parameter Widgets.

Determines whether the linking options set in this node override the incoming scene options or if the new settings are appended to the incoming options. If this light doesn't exist in the incoming scene, this option has no effect.

Determines the initial value for shadow visibility in the lightList entry for the newly-added light: on, off, don't set value, or use existing value.

Note:  The use existing value option is only available for adopted lights.

When linking is resolved, the clearUnmatched parameter determines whether or not existing light linking attributes for this light are removed from locations that do not match the on or off expressions.

The effect of this parameter is only visible in the Attributes tab when linking has been resolved, which means after a LightLinkResolve node or when Implicit Resolvers are active.

Examines the lightList attribute on your linked objects to ensure that the attributes have been set correctly. If the parameter has been disabled, the value of the enable child attribute in the lightList attribute for your light is 0; otherwise, the default enabled setting is 1.

A CEL Statement through which scene graph locations can be linked to the selected light, thereby turning shadow casting from this light on for those locations.

The scene graph locations are specified using the Collection Expression Language (CEL). For more information, refer to the CEL Reference document found on the documentation HTML page (accessed through Help > Documentation).

CEL Statements are edited using CEL Statement Widgets. For more information on the CEL Statement Widget type, refer to the CEL Statement Widget Type in Common Parameter Widgets.

Transforms the rig according to the SRT or matrix controls.

For more information, refer to the Transform Controls Widget Type in the Common Parameter Widgets.

Adjusts the rig to match selected scene graph selection options in the dropdown menu.

For more information, refer to the Transform Tools Widget Type in the Common Parameter Widgets.

When enabled, specifies the point constraint options.

When enabled, specifies the orient constraint options.

Specifies the object(s) to constrain to. If you want to aim a rig to point at a target, this is the target. If you set multiple targets, then the constraint aims at the average center of the objects. The targetPath parameter options are available in either a scene graph widget or dropdown menu to the right of the parameter.

For more information, refer to the Scene Graph Location Widget Type in the Common Parameter Widgets.

Specifies whether or not to add the base path for the rig to the globals.constraintList at /root/world in the Attributes tab.

When set to Yes, silently ignore the constraint if its target is not in the scene graph. When set to No, produce an error on constraint resolution if the target is missing.

Sets how the center of the base object is calculated:

• Object - uses the local origin of the object as the origin.

• BoundingBox - uses the center of the object’s bounding box as the base origin.

Sets how the center of the target object is calculated:

• Object - uses the local origin of the object as the target origin.

• BoundingBox - uses the center of the object’s bounding box as the target origin.

• FaceCenterAverage - uses the face center average of the object as the target origin.

• FaceBoundingBox - uses the face center average of the object’s bounding box as the target origin.

Stores target paths in the scene graph constraint definition as paths relative to the base path.

Targets should still be specified as absolute paths in this node's parameters.

Specifies the object(s) to constrain to. If you want to aim a rig to point at a target, this is the target. If you set multiple targets, then the constraint aims at the average center of the objects. The targetPath parameter options are available in either a scene graph widget or dropdown menu to the right of the parameter.

For more information, refer to the Scene Graph Location Widget Type in the Common Parameter Widgets.

Specifies whether or not to add the base path for the rig to the globals.constraintList at /root/world in the Attributes tab.

Sets how the orientation of the target object is calculated:

• Object - uses the local origin of the object as the target.

• Face - uses the local origin on the face as the target.

When set to Yes, silently ignore the constraint if its target is not in the scene graph. When set to No, produce an error on constraint resolution if the target is missing.

When enabled, orientation is constrained on the x axis.

When enabled, orientation is constrained on the y axis.

When enabled, orientation is constrained on the z axis.

The path to another light filter package that you want to inherit from.

The manner in which the light filter is displayed in the viewer: as points, a wireframe, or a solid fill.

Transforms the light filter by moving it on the x, y, or z axes. Modifying the light filter in the viewer using the Translate manipulators also updates these parameter values.

Transforms the light filter by rotating it around the x, y, or z axes. Modifying the light filter in the viewer using the Rotate manipulators also updates these parameter values.

Transforms the light filter by scaling it along the x, y, or z axes. Modifying the light filter in the viewer using the Scale manipulators also updates these parameter values.

When enabled, the material from an associated Look File is used.

Click to add a renderer-specific shader from the dropdown list. The Material tab is populated with controls appropriate to the shader selected, and are dependent on the renderers installed.

Set the path to the asset you want in your scene.

For more information, refer to the Asset and File Path Widget Types in the Common Parameter Widgets.

Choose the material path from the dropdown list, based on the asset you have listed in the asset field above.

If you do not have an asset listed in the asset field, nothing appears in the dropdown list for materialPath.

Determines whether the linking options set in this node override the incoming scene options or if the new settings are appended to the incoming options. If this light doesn't exist in the incoming scene, this option has no effect.

Determines whether the newly-added light location is initially on, off, or doesn't have a value set.

When linking is resolved, the clearUnmatched parameter determines whether or not existing light linking attributes for this light are removed from locations that do not match the on or off expressions.

The effect of this parameter is only visible in the Attributes tab when linking has been resolved, which means after a LightLinkResolve node or when Implicit Resolvers are active.

Examines the lightList attribute on your linked objects to ensure that the attributes have been set correctly. If the parameter has been disabled, the value of the enable child attribute in the lightList attribute for your light is 0; otherwise, the default enabled setting is 1.

A CEL Statement through which scene graph locations can be linked to the selected light, thereby turning the light on for those locations.

The scene graph locations are specified using the Collection Expression Language (CEL). For more information, refer to the CEL Reference document found on the documentation HTML page (accessed through Help > Documentation).

CEL Statements are edited using CEL Statement Widgets. For more information on the CEL Statement Widget type, refer to CEL Statement Widget Type in Common Parameter Widgets.

Transforms the sky dome light by moving it on the x, y, or z axes. Modifying the sky dome in the viewer using the Translate manipulators also updates these parameter values.

Transforms the sky dome light by rotating it around the x, y, or z axes. Modifying the sky dome in the viewer using the Rotate manipulators also updates these parameter values.

Transforms the sky dome light by scaling it along the x, y, or z axes. Modifying the sky dome in the viewer using the Scale manipulators also updates these parameter values.

When enabled, the material from an associated Look File is used and the additional parameters are contained in the reference dropdown.

Click to add a renderer-specific shader from the dropdown list. The Material tab is populated with controls appropriate to the shader selected, and are dependent on the renderers installed.

Set the path to the look file you've written to disk.

For more information, refer to the Asset and File Path Widget Types in the Common Parameter Widgets.

Choose the material path from the dropdown list, based on the asset you have listed in the asset field above.

If you do not have an asset listed in the asset field, nothing appears in the dropdown list for materialPath.

Determines whether the linking options set in this node override the incoming scene options or if the new settings are appended to the incoming options. If this light doesn't exist in the incoming scene, this option has no effect.

Determines whether the newly-added light location is initially on, off, or doesn't have a value set.

When linking is resolved, the clearUnmatched parameter determines whether or not existing light linking attributes for this light are removed from locations that do not match the on or off expressions.

The effect of this parameter is only visible in the Attributes tab when linking has been resolved, which means after a LightLinkResolve node or when Implicit Resolvers are active.

Examines the lightList attribute on your linked objects to ensure that the attributes have been set correctly. If the parameter has been disabled, the value of the enable child attribute in the lightList attribute for your light is 0; otherwise, the default enabled setting is 1.

A CEL Statement through which scene graph locations can be linked to the selected light, thereby turning the light on for those locations.

The scene graph locations are specified using the Collection Expression Language (CEL). For more information, refer to the CEL Reference document found on the documentation HTML page (accessed through Help > Documentation).

CEL Statements are edited using CEL Statement Widgets. For more information on the CEL Statement Widget type, refer to CEL Statement Widget Type in Common Parameter Widgets.

A CEL Statement through which scene graph locations can be linked to the selected light, thereby turning the light off for those locations.

The scene graph locations are specified using the Collection Expression Language (CEL). For more information, refer to the CEL Reference document found on the documentation HTML page (accessed through Help > Documentation).

CEL Statements are edited using the CEL Statement Widgets. For more information on the CEL Statement Widget type, refer to CEL Statement Widget Type in Common Parameter Widgets.

Determines whether the linking options set in this node override the incoming scene options or if the new settings are appended to the incoming options. If this light doesn't exist in the incoming scene, this option has no effect.

Determines the initial value for shadow visibility in the lightList entry for the newly-added light: on, off, don't set value, or use existing value.

Note:  The use existing value option is only available for adopted lights.

When linking is resolved, the clearUnmatched parameter determines whether or not existing light linking attributes for this light are removed from locations that do not match the on or off expressions.

The effect of this parameter is only visible in the Attributes tab when linking has been resolved, which means after a LightLinkResolve node or when Implicit Resolvers are active.

Examines the lightList attribute on your linked objects to ensure that the attributes have been set correctly. If the parameter has been disabled, the value of the enable child attribute in the lightList attribute for your light is 0; otherwise, the default enabled setting is 1.

A CEL Statement through which scene graph locations can be linked to the selected light, thereby turning shadow casting from this light on for those locations.

The scene graph locations are specified using the Collection Expression Language (CEL). For more information, refer to the CEL Reference document found on the documentation HTML page (accessed through Help > Documentation).

CEL Statements are edited using CEL Statement Widgets. For more information on the CEL Statement Widget type, refer to the CEL Statement Widget Type in Common Parameter Widgets.