hou.ObjNode.setWorldTransform method

Adjust this object’s parameters to achieve the desired world tranformation.

setWorldTransform(self, matrix, fail_on_locked_parms=False)

This method will adjust the translate, rotate, and scale values of this object to achieve the desired final world transformation. It accounts for the transformations of containing networks, parent transforms, and pre-transforms.

If fail_on_locked_parms is True, and any of the translate, rotate, or scale parameters of the object are locked, this method will raise hou.OperationFailed. If it is False and any of those parameters are locked, this method will change their values but leave them locked.

node.setWorldTransform(matrix, fail_on_locked_parms) is equivalent to:

node.setParmTransform(matrix * node.worldTransform().inverted() * node.parmTransform(), fail_on_locked_parms)