hou.parmTuple function

Given a path string, return a ParmTuple object. Return None if the path does not refer to a parameter tuple.

If the path starts with a /, Houdini will look for a parameter tuple with that exact path. Otherwise, the Houdini searches relative to the current node path. For each occurrence of .. in the path, Houdini will move up one node from the current node location.

When a parameter is evaluating, hou.pwd returns the node containing that parameter, so hou.parmTuple() can be used inside expressions to perform relative parameter references.

>>> node = hou.node("/obj").createNode("geo")
>>> node.path()
'/obj/geo1'
>>> hou.parmTuple("/obj/geo1/t")
<hou.ParmTuple t in /obj/geo1>
>>> hou.setPwd(node)
>>> hou.parmTuple("tx")
<hou.ParmTuple t in /obj/geo1>

Raises hou.NotAvailable if you call it from MPlay.

Replaces

• ch expression function
• chexist expression function
• chramp expression function
• chs expression function

Related topics

• hou.ParmTuple class

• hou.evalParmTuple function

• hou.parm_ function