mgear.rigbits.sdk_io

Rigbits, SDK i/o

exportSDKs([“drivenNodeA”, “drivenNodeB”], “path/to/desired/output.json”) importSDKs(path/to/desired/output.json)

# MIRRORING ——- # copy from source, say left, to target, right copySDKsToNode(“jacketFlap_L1_fk0_sdk”,

“neck_C0_0_jnt”, “jacketFlap_R1_fk0_sdk”)

# invert/mirror the attributes necessary for the other side, # in this case it is the following attributes mirrorSDKkeys(“jacketFlap_R1_fk0_sdk”,

attributes=[“rotateZ”], invertDriver=True, invertDriven=False)
mirrorSDKkeys(“jacketFlap_R1_fk0_sdk”,
attributes=[“translateX”, “translateY”], invertDriver=True, invertDriven=True)

# in this other instance, it was the same copySDKsToNode(“jacketFlap_L0_fk0_sdk”,

“neck_C0_0_jnt”, “jacketFlap_R0_fk0_sdk”)
mgear.rigbits.sdk_io.SDK_ANIMCURVES_TYPE

list – sdk anim curves to support

mgear.rigbits.sdk_io.copySDKsToNode(sourceDriven, targetDriver, targetDriven, sourceAttributes=[])

Duplicates sdk nodes from the source drive, to any designated target driver/driven

Parameters:
  • sourceDriven (pynode) – source to copy from
  • targetDriver (pynode) – to drive the new sdk node
  • targetDriven (pynode) – node to be driven
  • sourceAttributes (list, optional) – of attrs to copy, if none provided
  • all (assume) –
Returns:

n/a

Return type:

TYPE

mgear.rigbits.sdk_io.createSDKFromDict(sdkInfo_dict)

Create a sdk node from the provided info dict

Parameters:sdkInfo_dict (dict) – dict of node information to create
Returns:created sdk node
Return type:PyNode
mgear.rigbits.sdk_io.exportSDKs(nodes, filePath)

exports the sdk information based on the provided nodes to a json file

Parameters:
  • nodes (list) – of nodes to export
  • filePath (string) – full filepath to export jsons to
mgear.rigbits.sdk_io.getAllSDKInfoFromNode(node)

returns a dict for all of the connected sdk/animCurve on the provided node

Parameters:node (pynode) – name of node to the be searched
Returns:of all of the sdk nodes
Return type:dict
mgear.rigbits.sdk_io.getBlendNodes(attrPlug)

Check the attrPlug (node.attr) provided for any existing connections if blendWeighted exists, return the appropriate input[#], if sdk, create a blendweighted and connect sdk, return input[#]

Parameters:attrPlug (string) – node.attr
Returns:node.attr of the blendweighted node that was just created or existing
Return type:string
mgear.rigbits.sdk_io.getConnectedSDKs(driven, curvesOfType=[])

get all the sdk, animcurve, nodes/plugs connected to the provided node.

Parameters:
  • node (str, pynode) – name of node, or pynode
  • curvesOfType (list, optional) – animCurve nodes of type if none provided
  • fall back on module defined supported set. (will) –
Returns:

of sdk nodes, paired with the node/attr they effect

Return type:

list

mgear.rigbits.sdk_io.getMultiDriverSDKs(driven)

get the sdk nodes that are added through a blendweighted node

Parameters:driven (string) – name of the driven node
Returns:of sdk nodes
Return type:list
mgear.rigbits.sdk_io.getPynodes(nodes)

Conevenience function to allow uses to pass in strings, but convert to pynodes if not already.

Parameters:nodes (list) – string names
Returns:of pynodes
Return type:list
mgear.rigbits.sdk_io.getSDKDestination(animNodeOutputPlug)

Get the final destination of the sdk node, skips blendweighted and conversion node to get the transform node. TODO: Open this up to provided type destination

Parameters:animNodeOutputPlug (string) – animationNode.output
Returns:name of the node, and attr
Return type:list
mgear.rigbits.sdk_io.getSDKInfo(animNode)

get all the information from an sdk/animCurve in a dictioanry for exporting.

Parameters:animNode (pynode) – name of node, pynode
Returns:dictionary of all the attrs to be exported
Return type:dict
mgear.rigbits.sdk_io.importSDKs(*args, **kwargs)

create sdk nodes from json file, connected to drivers and driven

Parameters:filePath (string) – path to json file
mgear.rigbits.sdk_io.invertKeyValues(newKeyNode, invertDriver=True, invertDriven=True)

Mirror keyframe node procedure, in case you need to flip your SDK’s.

Parameters:
  • newKeyNode (PyNode) – sdk node to invert values on
  • invertDriver (bool, optional) – should the drivers values be inverted
  • invertDriven (bool, optional) – should the drivens values be inverted
mgear.rigbits.sdk_io.mirrorSDKkeys(node, attributes=[], invertDriver=True, invertDriven=True)

mirror/invert the values on the specified node and attrs, get the sdks and invert those values

Parameters:
  • node (pynode) – node being driven to have its sdk values inverted
  • attributes (list, optional) – attrs to be inverted
  • invertDriver (bool, optional) – should the driver, “time” values
  • inverted (be) –
  • invertDriven (bool, optional) – should the driven, “value” values
  • inverted
mgear.rigbits.sdk_io.removeSDKs(node, attributes=[])

Convenience function to remove, delete, all sdk nodes associated with the provided node

Parameters:
  • node (pynode) – name of the node
  • attributes (list, optional) – list of attributes to remove sdks from
  • none provided, assume all (if) –
mgear.rigbits.sdk_io.stripKeys(animNode)

remove animation keys from the provided sdk node

Parameters:animNode (pynode) – sdk/anim node