mgear.rigbits package

Subpackages

• mgear.rigbits.facial_rigger package
  • Submodules
    • mgear.rigbits.facial_rigger.brow_rigger module
    • mgear.rigbits.facial_rigger.constraints module
    • mgear.rigbits.facial_rigger.eye_rigger module
    • mgear.rigbits.facial_rigger.helpers module
    • mgear.rigbits.facial_rigger.lib module
    • mgear.rigbits.facial_rigger.lips_rigger module
  • Module contents
• mgear.rigbits.facial_rigger2 package
  • Submodules
    • mgear.rigbits.facial_rigger2.eye_rigger module
    • mgear.rigbits.facial_rigger2.eye_riggerUI module
    • mgear.rigbits.facial_rigger2.helpers module
    • mgear.rigbits.facial_rigger2.lib module
  • Module contents
• mgear.rigbits.sdk_manager package
  • Submodules
    • mgear.rigbits.sdk_manager.SDK_manager_ui module
    • mgear.rigbits.sdk_manager.SDK_transfer_ui module
    • mgear.rigbits.sdk_manager.core module
      • ctl_from_list()
      • delete_current_value_keys()
      • driver_ctl_from_joint()
      • get_current_SDKs()
      • get_driven_from_attr()
      • get_driver_from_driven()
      • get_driver_keys()
      • get_info()
      • joint_from_driver_ctl()
      • key_at_current_values()
      • mirror_SDK()
      • next_biggest()
      • next_smallest()
      • prune_DK_nodes()
      • reset_to_default()
      • select_all()
      • set_driven_key()
      • set_limits_from_current()
      • set_zero_key()
      • toggle_limits()
  • Module contents

Submodules

• mgear.rigbits.blendShapes module
• mgear.rigbits.channelWrangler module
• mgear.rigbits.channelWranglerUI module
• mgear.rigbits.cycleTweaks module
• mgear.rigbits.ghost module
  • connect_matching_attrs()
  • createDoritoGhostCtl()
  • createGhostCtl()
  • ghostSlider()
• mgear.rigbits.menu module
  • cCtl_sub()
  • connect_submenu()
  • gimmick_submenu()
  • install()
  • install_utils_menu()
  • pCtl_sub()
• mgear.rigbits.mirror_controls module
  • MirrorController
    • MirrorController.copy_and_prepare_source()
    • MirrorController.get_opposite_control()
    • MirrorController.get_specific_side_controls()
    • MirrorController.mirror_left_to_right()
    • MirrorController.mirror_pairs()
    • MirrorController.mirror_right_to_left()
    • MirrorController.mirror_selection()
  • MirrorControlsUi
    • MirrorControlsUi.mirror_button_pressed()
  • show()
• mgear.rigbits.postSpring module
• mgear.rigbits.proxySlicer module
  • slice()
• mgear.rigbits.rbf_io module
• mgear.rigbits.rbf_manager_ui module
• mgear.rigbits.rbf_node module
• mgear.rigbits.rivet module
  • rivet
    • rivet.create()
    • rivet.createConnections()
    • rivet.createNodes()
    • rivet.setAttributes()
• mgear.rigbits.rope module
• mgear.rigbits.sdk_io module
  • SDK_ANIMCURVES_TYPE
  • copySDKsToNode()
  • createSDKFromDict()
  • exportSDKs()
  • getAllSDKInfoFromNode()
  • getBlendNodes()
  • getConnectedSDKs()
  • getMultiDriverSDKs()
  • getPynodes()
  • getSDKDestination()
  • getSDKInfo()
  • importSDKs()
  • invertKeyValues()
  • mirrorSDKkeys()
  • removeSDKs()
  • stripKeys()
• mgear.rigbits.six module
• mgear.rigbits.tweaks module
• mgear.rigbits.utils module
  • createHotkeys()
  • createRunTimeCommand()
• mgear.rigbits.version module
• mgear.rigbits.weightNode_io module
• mgear.rigbits.widgets module

Module contents

mgear.rigbits.addBlendedJoint(oSel=None, compScale=True, blend=0.5, name=None, select=True, *args)

Create and gimmick blended joint

Create a joint that rotate 50% of the selected joint. This operation is done using a pairBlend node.

Parameters:

• oSel (None or joint, optional) – If None will use the selected joints.

• compScale (bool, optional) – Set the compScale option of the blended joint. Default is True.

• blend (float, optional) – blend rotation value

• name (None, optional) – Name for the blended o_node

• *args – Maya’s dummy

Returns:

blended joints list

Return type:

list

mgear.rigbits.addJnt(obj=False, parent=False, noReplace=False, grp=None, jntName=None, *args)

Create one joint for each selected object.

Parameters:

• obj (bool or dagNode, optional) – The object to drive the new joint. If False will use the current selection.

• parent (bool or dagNode, optional) – The parent for the joint. If False will try to parent to jnt_org. If jnt_org doesn’t exist will parent the joint under the obj

• noReplace (bool, optional) – If True will add the extension “_jnt” to the new joint name

• grp (pyNode or None, optional) – The set to add the new joint. If none will use “rig_deformers_grp”

• *args – Maya’s dummy

Returns:

The New created joint.

Return type:

pyNode

mgear.rigbits.addNPO(objs=None, *args)

Add a transform node as a neutral pose

Add a transform node as a parent and in the same pose of each of the selected objects. This way neutralize the local transfromation values. NPO stands for “neutral position” terminology from the all mighty Softimage ;)

mgear.rigbits.addSupportJoint(oSel=None, select=True, *args)

Add an extra joint to the blended joint.

This is meant to be use with SDK for game style deformation.

Parameters:

• oSel (None or blended joint, optional) – If None will use the current selection.

• *args – Mays’s dummy

Returns:

blended joints list

Return type:

list

mgear.rigbits.alignToPointsLoop(points=None, loc=None, name=None, *args)

Create space locator align to the plain define by at less 3 vertex

Parameters:

• points (None or vertex list, optional) – The reference vertex to align the ref locator

• loc (None or dagNode, optional) – If none will create a new locator

• name (None or string, optional) – Name of the new locator

• *args – Description

Returns:

Description

Return type:

TYPE

mgear.rigbits.connectInvertSRT(source, target, srt='srt', axis='xyz')

Connect the locat transformations with inverted values.

Parameters:

• source (dagNode) – The source driver dagNode

• target (dagNode) – The target driven dagNode

• srt (string, optional) – String value for the scale(s), rotate(r), translation(t). Default value is “srt”. Posible values “s”, “r”, “t” or any combination

• axis (string, optional) – String value for the axis. Default value is “xyz”. Posible values “x”, “y”, “z” or any combination

mgear.rigbits.connectLocalTransform(objects=None, s=True, r=True, t=True, *args)

Connect scale, rotatio and translation.

Parameters:

• objects (None or list of dagNode, optional) – If None will use the current selection.

• s (bool, optional) – If True will connect the local scale

• r (bool, optional) – If True will connect the local rotation

• t (bool, optional) – If True will connect the local translation

• *args – Maya’s dummy

mgear.rigbits.connectUserDefinedChannels(source, targets)

Connects the user defined channels

Connects the user defined channels between 2 objects with the same channels. Usually a copy of the same object.

Parameters:

• source (dagNode) – The dagNode with the source user defined channels

• targets (list of dagNode) – The list of dagNodes with the same user defined channels to be connected.

mgear.rigbits.connectWorldTransform(source, target)

Connect the source world transform of one object to another object.

Parameters:

• source (dagNode) – Source dagNode.

• target (dagNode) – target dagNode.

mgear.rigbits.connect_scale_from_world_matrix(driver, driven)

Set up node connections to make the driven object scale based on the driver object’s world scale matrix. Accepts either str or PyNode.

Parameters:

• driver (str or pm.nodetypes.Transform) – Name or PyNode of the driver object.

• driven (str or pm.nodetypes.Transform) – Name or PyNode of the driven object.

Example

>>> connect_scale_from_world_matrix('driver_cube', 'driven_cube')
>>> connect_scale_from_world_matrix(pm.PyNode('driver_cube'),
...                                 pm.PyNode('driven_cube'))

mgear.rigbits.createCTL(type='square', child=False, *args)

Create a control for each selected object.

The newly create control can be parent or child of the object.

Parameters:

• type (str) – The shape of the control.

• child (bool) – if True, the control will be created as a child of the object.

mgear.rigbits.createInterpolateTransform(objects=None, blend=0.5, *args)

Create space locator and apply gear_intmatrix_op, to interpolate the his pose between 2 selected objects.

Parameters:

• objects (None or list of 2 dagNode, optional) – The 2 dagNode to interpolate the transform.

• blend (float, optional) – The interpolation blend factor.

• *args – Maya’s dummy

Returns:

The new transformation witht the interpolate matrix o_node applied.

Return type:

pyNode

mgear.rigbits.duplicateSym(*args)

Duplicate one dag hierarchy to/from X/-X renaming “L” to “R”

mgear.rigbits.hide_shape(obj_list, attr_name, attr_host, val=True, keyable=False)

Hide shapes of given nodes using a host boolean attribute.

Parameters:

• obj_list (list) – Nodes (or names) whose shapes will be hidden.

• attr_name (str) – Attribute name to create/use on the host.

• attr_host (pm.DependNode|str) – Node holding the attribute.

• val (bool, optional) – Initial value. Defaults to True.

mgear.rigbits.hide_transform(transform_list, attr_name, attr_host, val=True, keyable=False)

Hide transform nodes using a host boolean attribute.

Parameters:

• transform_list (list) – Transform nodes (or names) to hide.

• attr_name (str) – Attribute name to create/use on the host.

• attr_host (pm.DependNode|str) – Node holding the attribute.

• val (bool, optional) – Initial value. Defaults to True.

mgear.rigbits.lock_hide_ctl(ctlList, ctl_ext='_ctl', lock_ext='_lock')

Hide shapes, lock attrs, rename, and remove from object sets.

Parameters:

• ctl_list (list) – Iterable of controls (MObjects or names).

• ctl_ext (str, optional) – Suffix to replace. Defaults to “_ctl”.

• lock_ext (str, optional) – Replacement suffix. Defaults to “_lock”.

mgear.rigbits.matchPosfromBBox(*args)

Match the position usin bounding box of another object another.

Match the position of one object, using the boundig box center of another object.

mgear.rigbits.matchWorldXform(*args)

Align 2 selected objects in world space

mgear.rigbits.replaceShape(source=None, targets=None, *args)

Replace the shape of one object by another.

Parameters:

• source (None, PyNode) – Source object with the original shape.

• targets (None, list of pyNode) – Targets object to apply the source shape.

• *args – Maya’s dummy

Returns:

Return non if nothing is selected or the source and targets are none

Return type:

None

mgear.rigbits.selectDeformers(*args)

Select the deformers from the object skinCluster

mgear.rigbits.show_hide_toggle(ctl, at_name, groupA, groupB, keyable=False)

Create boolean attr on ctl to toggle visibility of two groups.

Parameters:

• ctl (pm.DagNode|str) – Control node or its name.

• attr_name (str) – Name of the toggle attribute to create.

• group_a (list) – Nodes visible when attr is True.

• group_b (list) – Nodes visible when attr is False.

mgear.rigbits.spaceJump(ref=None, space=None, *args)

Space Jump gimmick

This function create a local reference space from another space in the hierarchy

Parameters:

• ref (None, optional) – Transform reference

• space (None, optional) – Space reference

• *args – Maya dummy

Returns:

Transform

Return type:

pyNode