Rigging Utilities

artv2.utilities.rigging_utilities

author:Jeremy Ernst description:This module contains utilities for working with joints.

attr_is_settable(attribute)

Determines in the pymel Attribute object can be set (It may have keyframes, but cannot be connected or constrained).

Parameters:attribute – pymel.core.general.Attribute() Returns:bool, True if attribute is settable, False if not.

build_skeleton()

Builds a deformation skeleton based on the joint mover guide joints. :return: root joint of newly created skeleton.

divide_joint(number, joint, name)

Given a joint, divide the segment below that joint by the given number.

Parameters:

• number – Number of divisions to divide a joint segment.
• joint – The top end joint of the joint segment to divide.
• name (str) – The base name of the component.

remove_joints(number, joint)

Given a joint, remove the given number of joints above that joint.

Parameters:

• number – The number of parents to remove.
• joint – The joint to remove parents from.

reset_joint_to_initial(joint)

Resets the given joint to its initial creation position and orientation (defined by the rigging guide file).

Parameters:joint – The joint to reset position and orientation on.

toggle_local_axis(state)

Toggles the visibility of the local rotation axis of all driven component joints with the given state.

Parameters:state – Whether or not the local rotation axis should be visible (bool)