Common Parameter Widgets

These widget groups are common to many nodes in Katana and are outlined here. For more information regarding the addition of user parameters and specific widget types, refer to Widget Types and Adding User Parameters.

Asset and File Path Widget Types

The Asset (assetIdInput) and File Path (fileInput) widget types allow you to navigate to assets and files on your file system. Several node types that ship with Katana use the Asset and File Path widget types for parameters of various names, for example: abcAsset, file, filePath, lookfile, procedural, saveTo, and source.

Parameters that use the Asset and File Path widget types can be found on the following types of nodes:

• Alembic_In	• LookFileGlobalsAssign
• AttributeFile_In	• LookFileMaterialsIn
• CameraImagePlaneCreate	• LookFileMaterialsOut
• GafferThree	• LookFileMultiBake
• ImageCoordinate	• LookFileOverrideEnable
• ImageRead	• Material
• LiveGroup	• RendererProceduralArgs
• LookFileAssign	• RenderOutputDefine
• LookFileBake

Menu Command	Description

Browse...	Brings up the file browser or your studio's asset management browser and enables you to select the asset to use.
Set Node Name From Path	Changes the name of the node to match the filename but without the path or extension.

Attribute Name Widget Type

The Attribute Name (attributeName) widget type allows you to type, or drag and drop attributes from the Attributes tab, onto parameters of type String in the user parameters. When dropping a dragged attribute, the target parameter's value is set to the name of the dropped attribute instead of the value of the dropped attribute. Names of ancestor group attributes are separated by dots, for example, xform.translate.

Parameters that use the AttributeName widget type can be found on the following types of nodes:

• AttributeSet

Menu Command	Description
Text field
newParameter	Type, or drag and drop attributes from the Attributes tab to set the parameter's value to the name of the attribute.

Attribute Type Widget Type

The Attribute Type (attributeType) widget type allows you to select from a drop-down menu, or drag and drop attributes from the Attributes tab, onto parameters of type String in the user parameters. When dropping a dragged attribute, the target parameter's value is set to the name of the dropped attribute's type, for example, float.

Parameters that use the AttributeType widget type can be found on the following types of nodes:

• AttributeSet

Menu Command	Description
Text field
newParameter	Select an attribute type from the drop-down menu, or drag and drop attributes from the Attributes tab, to set the parameter's value to the attribute type.

CEL Statement Widget Type

The CEL Statement (cel) widget type allows you to build and edit CEL statements that are stored in string parameters on nodes. Several node types that ship with Katana use the CEL Statement widget type for parameters of various names, for example: CEL, cel, toCel, fromCel, celSelection, disableAt, exclusivity, lights, objects, off, and on.

Parameters that use the CEL Statement widget type can be found on the following types of nodes:

• AttributeCopy	• LightLinkEdit	• Prune
• AttributeEditor	• LightLinkSetup	• RendererProceduralArgs
• AttributeFile_In	• LocationGenerate	• RendererProceduralAssign
• AttributeSet	• LodSelect	• ReverseNormals
• CollectionCreate	• LodValuesAssign	• ScenegraphObjectSettings
• GafferThree	• LookFileAssign	• VelocityApply
• GenericOp	• Material	• ViewerObjectSettings
• LightLink	• OpScript	• VisibilityAssign

Menu Command	Description
Add Statements	• Paths - Adds a Paths list to this CEL parameter. • Collections - Adds a Collections list to this CEL parameter. • Custom - Adds a Custom parameter to this CEL parameter. • Append Scene Graph Selection - Adds a Paths list to this CEL parameter and places selected scene graph locations in the new list. • Replace With Scene Graph Selection - Removes any parameters within this CEL parameter and creates a new Paths list and populates it with any selected scene graph locations. • Copy CEL Statement As Text - Copies this CEL statement to the clipboard. • Paste CEL Statement - Removes any parameters within this CEL parameter and pastes the CEL statement in the clipboard to this parameter. • Replace With Parameter Expression - Converts the current CEL parameter into an expression.
Paths > Action
Add Scenegraph Selection	Adds the currently selected scene graph location to this list.
Remove Scenegraph Selection	Removes the currently selected scene graph location from this list.
Remove Selected Paths	Removes the path(s), selected in this Paths list, from this list.
Select All	Selects all the paths in this list.
Select Selected Paths In Scenegraph	Selects the scene graph locations of the selected paths in this list.
Copy Selected Paths to Clipboard	Copies the selected paths from this list to the clipboard.
Show Extended View...	Brings up a dialog with the contents of this Paths list.
Collections > Action
Add Collections From Scenegraph Selection...	Brings up a dialog box with a list of the collections from the currently selected scene graph locations. You can then select from these collections to add them to this list.
Add Scene Root Collections...	Brings up a dialog box populated with the collections currently on /root. You can then select from these collections to add them to this list.
Remove Selected Paths	Removes the selected collection(s) from this list.
Select All	Selects all the collections in this list.
Copy Selected Paths to Clipboard	Copies all the selected collections and their paths to the clipboard.
"Find And Select" Selected Items...
Union dropdown	• Union • Difference • Intersect Does not occur in all nodes with CEL widgets. Only occurs on additional statements added to the widget after an initial statement.

Color Widget Type

The Color (color) widget type allows you to pick a color by specifying RGB or RGBA component values directly in the Parameters tab, or through a color picker dialog. Several node types that ship with Katana use the Color widget type for parameters of various names, for example: bottomLeft, bottomRight, color, constantColor, fadeToColor, gamma, and previewColor.

Parameters that use the Color widget type can be found on the following types of nodes:

• GafferThree	• ImageColor	• ImageRamp
• ImageBackgroundColor	• ImageClamp	• ImageText
• ImageChannels	• ImageContrast	• ImageThreshold
• ImageCheckerboard	• ImageFade	• LightCreate
	• ImageGamma	• ViewerObjectSettings
	• ImageInvert
	• ImageLevels

Menu Command	Description
color	The color (RGBA values) for the given parameter.
	Picks the color (RGBA) values of the selection.
>
Average	Sets the color picker to use the average values.
Min	Sets the color picker to use the minimum values.
Max	Sets the color picker to use the maximum values.
Front	Sets the color picker to use the front values.
Back	Sets the color picker to use the back values.
Auto-Disable Upon Release	Toggle the ability to automatically disable the picker on mouse-button release.
color > RGB
red	Sets the red value of the pixels.
green	Sets the green value of the pixels.
blue	Sets the blue value of the pixels.
alpha	Sets the alpha value of the pixels.
color > HSL
hue	Sets the hue of the pixels.
saturation	Sets the saturation of the pixels.
lightness	Sets the lightness of the pixels.
alpha	Sets the alpha value of the pixels.
color > HSV
hue	Sets the hue of the pixels.
saturation	Sets the saturation of the pixels.
value	Sets the value of the pixels.
alpha	Sets the alpha value of the pixels.
color options continued
Enable Display Transform	Toggles gamma correction in the color picker, which is especially useful when working with OCIO.
Restrict RGBA Components	Restricts the alpha to 0,1 and the color channels to 0,a.

Common 2D Node Widget Type

The Common 2D Node (node2d) widget type allows you to pick channels that are affected by a particular 2D node and specify masking parameters. This widget type is not exposed for use as a custom user parameter.

The Common 2D Node widget type can be found in each Image node, except for Image BackgroundColor, ImageChannels, ImageCheckerboard, ImageColor, ImageCoordinate, ImageCrop, ImageRamp, ImageRead, ImageText, and ImageWrite.

Note: Not all of the Image nodes have the Mask parameter.

Menu Command	Description
[view]	Specify whether the controls are set for the main, left, or right views, or set the controls to Enable All.
	When a specific component (R, G, B, or A) is enabled, the controls affect only that component.
mix	Dissolves between the bg image at 0 and the full merge effect at 1.
Mask
channel	The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the merge is limited to the non-black areas of the mask.
invert	Inverts the use of the mask channel so that the merge is limited to the non-white areas of the mask.
fringe	When enabled, the mask is modified so that, by default, the merge is limited to the fringe (semi-transparent areas). This is common alpha treatment, which modifies a normal mask such that it only affects the fringe (semi-transparent) areas.

New Scene Graph Location Widget Type

The newScenegraphLocation (newScenegraphLocation) widget type allows you to specify the path of a scene graph location that is to be created by the respective node. It is used, for example, for the name parameter of CameraCreate nodes.

This widget type is not exposed for use as a custom user parameter, but can be accessed by setting the widget type hint to newScenegraphLocation. Several node types that ship with Katana use the newScenegraphLocation widget type for parameters of various names, for example: location, locations, and name.

Parameters that use the newScenegraphLocation widget type can be found on the following types of nodes:

• Alembic_In	• PonyStack
• CameraCreate	• PrimitiveCreate
• ImageCoordinate	• TeapotCreate
• LightCreate

Menu Command	Description
Parent to Scenegraph Selection	Sets the parent location of the object created to be the current scene graph selection.
Parent to /root/world/geo/...	Sets the parent location of the object created to be /root/world/geo/.
Parent to /root/world/lgt/...	Sets the parent location of the object created to be /root/world/lgt/.
Parent to /root/world/cam/...	Sets the parent location of the object created to be /root/world/cam/.
Select In Scene Graph	Selects the location specified by this parameter in the Scene Graph tab. Note: This option may be included in both the dropdown menu and as an icon to the right of the parameter name, or may only be present in one of these locations.

Locations Widget Type

The Locations (locations) widget type allows you to select scene graph locations by paths or expressions. It is not an exposed widget type for use as a custom user parameter. Out of all node types that ship with Katana, only Isolate nodes use the Locations widget type, namely for their isolateLocation parameter.

Menu Command	Description
Path	Adds another path to this parameter's list of paths.
Expressions
Append Scene Graph Selection	For each selected scene graph location, a new path is added to this parameter's list of paths and populated with the location.
Replace with Scene Graph Selection	Removes all existing paths and replaces them with paths populated with the currently selected Scene Graph tab locations.
Append Node Graph Node Locations	For each selected Node Graph node, a new path is added to this parameter's list of paths and an expression that links the scene graph location created by that node to the path.
Replace with Node Graph Node Locations	Removes all existing paths and replaces them with a path for each selected Node Graph node and links the scene graph location created by that node to the path.
Append Node Graph Locations as Parameter Expressions
Replace Node Graph Locations as Parameter Expressions
Clear All	Removes all paths from this parameter.

Look File Pass Name Widget Type

The Look File Pass Name (lookfilePassname) widget type allows you to set the pass name to use from a chosen Look File. This widget type is not exposed for use as a custom user parameter, but can be accessed by setting the widget type hint to lookfilePassname. Node types that ship with Katana use the Look File Pass Name widget type for the passName parameter.

Parameters that use the Look File Pass Name widget type can be found on the following types of nodes:

• LookFileMaterialsIn

• LookFileOverrideEnable

• LookFileResolve

Menu Command	Description
Choose Look File Pass from Selection...

Rectangle Widget Type

The Rectangle (rectangle) widget type allows you to specify rectangular bounds to use by a node. This widget type is not exposed for use as a custom user parameter. Several node types that ship with Katana use the Rectangle widget type for parameters of various names, for example: bounds, resolution, or rect.

Parameters that use the Rectangle widget type can be found on the following types of nodes:

Menu Command	Description
bounds or rect >
Copy from Monitor ROI
Copy to Monitor ROI

Scene Graph Location Widget Type

The Scene Graph Location (scenegraphLocation) widget type allows you to specify the path of an existing scene graph location that a node is meant to work with. Several node types that ship with Katana use the Scene Graph Location widget type for parameters of various names, for example: baseLocation, cameraLocation, location, locations, path, paths, sourceLocation, and targetPath.

Parameters that use the Scene Graph Location widget type can be found on the following types of nodes:

• AimConstraint	• GafferThree	• OpScript
• AttributeCopy	• HierarchyCopy	• OrientConstraint
• AttributeSet	• InfoCreate	• ParentChildConstraint
• BillboardConstraint	• Isolate	• PointConstraint
• BoundsAdjust	• LightLink	• ReflectionConstraint
• CameraClippingPlaneEdit	• LightLinkEdit	• Rename
• CameraImagePlaneCreate	• LightLinkSetup	• RendererProceduralArgs
• CameraScreenWindowConstraint	• LightLinkEdit	• RendererProceduralAssign
• ClippingConstraint	• LocationCreate	• RenderOutputDefine
• CollectionCreate	• LookFileBake	• RenderSettings
• ConstraintCache	• LookFileMultiBake	• ScreenCoordinateConstraint
• CoordinateSystemDefine	• Material	• Transform3D
• DollyConstraint	• NetworkMaterialInterfaceControls	• TransformEdit
• FaceSetCreate	• NetworkMaterialParameterEdit
• FOVConstraint	• NetworkMaterialSplice

Menu Command	Description
Adopt Scenegraph Selection	The currently selected Scene Graph tab location is used to populate the parameter.
Adopt Selected Nodegraph Node	Creates an expression from the currently selected Node Graph node linking the scene graph location created by that node to this parameter.
Select In Scenegraph	Selects the location specified by this parameter in the Scene Graph tab. Note: This option may be included in both the dropdown menu and as an icon to the right of the parameter name, or may only be present in one of these locations.
Adjust Path Relative To 'basePath'	Converts the current targetPath to a path relative to the basePath. If the targetPath is an expression, it is converted to a constant. Note: This option does not appear in all instances and may only be available when both the basePath and targetPath parameters exist for a node.

Scene Graph Locations Widget Type

The Scene Graph Locations (scenegraphLocationArray) widget type allows you to specify a list of paths of existing scene graph locations that a node is meant to work with. Several node types that ship with Katana use the Scene Graph Locations widget type for parameters of various names, for example: destinationLocations, lightPaths, locations, paths, and rootLocations.

Parameters that use the Scene Graph Locations widget type can be found on the following types of nodes:

• AimConstraint	• InfoCreate
• AttributeSet	• LightLink
• BillboardConstraint	• LightListEdit
• ClippingConstraint	• LocationCreate
• ConstraintCache	• LookFileBake
• ConstraintListEdit	• LookFileMultiBake
• DollyConstraint	• PointConstraint
• FOVConstraint	• ScreenCoordinateConstraint
• HierarchyCopy

Menu Command	Description
Path	Adds another path to this parameter's list of paths.
Append Scenegraph Selection	For each selected scene graph location, a new path is added to this parameter's list of paths and populated with the location.
Replace with Scenegraph Selection	Removes all existing paths and replaces them with paths populated with the currently selected Scene Graph tab locations.
Append Nodegraph Node Locations	For each selected Node Graph node, a new path is added to this parameter's list of paths and an expression that links the scene graph location created by that node to the path.
Replace with Nodegraph Node Locations	Removes all existing paths and replaces them with a path for each selected Node Graph node and links the scene graph location created by that node to the path.
Clear All	Removes all paths from this parameter.
Find Instances beneath Scene Graph Selection...	Note: This option is only found on the rootLocations parameter.

Transform Controls Widget Type

The Transform Controls widget type allows you to manipulate the transformation matrix. This widget type is not exposed for use as a custom user parameter. Node types that ship with Katana use the Transform Controls widget type for the transform parameter.

Parameters that use the Transform Controls widget type can be found on the following types of nodes:

• CameraCreate

• GafferThree

• LightCreate

• PonyStack

• PrimitiveCreate

• TeapotCreate

Menu Command	Description
transform
interface	Sets the transform control layout: • SRT Values - exposes the scale, rotation, and translation controls. • Transform Matrix - exposes a matrix to control transformations. Note: If you select Transform Matrix, the translate, rotation, and scale fields are replaced by a matrix field instead.
transformOrder	Sets the order in which transforms are applied: Scale Rotate Translate, Scale Translate Rotate, Rotate Scale Translate, Rotate Translate Scale, Translate Scale Rotate, Translate Rotate Scale.
rotationOrder	Sets the order in which rotation is applied: XYZ, XZY, YXZ, YZX, ZXY, ZYX.
transform > interface: SRT Values
translate	Controls camera translation on the xyz axes.
rotate	Controls camera rotation on the xyz axes.
scale	Controls camera scale on the xyz axes.
transform > interface: Transform Matrix
matrix	Controls transformations using a matrix in place of individual SRT controls. Note: This field is only available if you have selected Transform Matrix in the interface field.

Transform Tools Widget Type

The Transform Tools widget type allows you to manipulate transformation data for scene graph locations. This widget type is not exposed for use as a custom user parameter. Node types that ship with Katana use the Transform Tools widget type for the transform parameter.

Parameters that use the Transform Tools widget type can be found on the following types of nodes:

• CameraCreate

• GafferThree

• LightCreate

• PrimitiveCreate

• TeapotCreate

Menu Command	Description
transform > Tools
Snap to Position of Scene Graph Selection	Moves the position of the light to the position of the item selected in the Scene Graph tab.
Copy Scene Graph Selection World Transform	Copies the world SRT values of the item selected in the Scene Graph tab into the translate, rotate, and scale parameters under Object tab > transform.
Copy Scene Graph Selection Local Transform	Copies the local SRT values of the item selected in the Scene Graph tab into the translate, rotate, and scale parameters under Object tab > transform.
Fit to Bounds of Scene Graph Selection	Fits the light to the bounds set by the item selected in the Scene Graph tab.
Register to Scene Graph Camera	Places an object at a specified distance from a camera that is selected in the Scene Graph tab, oriented to face the camera, and scaled to fit the camera's screen window exactly. This is designed for use with primitive planes and may set unexpected transforms on other object types. This option is only available if a camera or light is selected in the Scene Graph tab.
Reset Transform	Resets any previous transforms, bringing the light back to the origin (0,0,0).