hou.parmTuple function

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

See also: hou.ParmTuple, hou.evalParmTuple, hou.parm_

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.