Parameter Hints
Parameter hints are arbitrary metadata, most commonly used to tell the user interface what a parameter contains. For example, add a string parameter to represent a file path to an asset, and use a hint to tell Katana to use the asset browser widget for that parameter:
# Get root level
rootNode = NodegraphAPI.GetRootNode()
# Create a PrimitiveCreate node at root level
primNode = NodegraphAPI.CreateNode('PrimitiveCreate', rootNode)
# Get the root parameter of the PrimitiveCreate node
rootParam = primNode.getParameters()
# Add a new parameter of type string
pathParam = rootParam.createChildString("yourFilePath", "yourFile.txt")
# Tell Katana to use the assetIdInput widget to represent this parameter
hints = {'widget': 'assetIdInput'}
pathParam.setHintString(repr(hints))
Or, to add a string parameter as a dropdown menu:
# Add a new parameter of type string
dropdownParam = rootParam.createChildString("yourDropdown", "yourDefaultValue")
# Tell Katana to use the pop-up widget
# and fill out the menu values
hints = {'widget': 'popup', 'options': ['a', 'b', 'c']}
dropdownParam.setHintString(repr(hints))
- Parameter.getHintString() str
Returns the optional hint string for this parameter, which may be empty.
- Parameter.setHintString(hint: str) None
Sets this parameter’s hint string.