def bendyJoints(sj, mj, ej, moduleType, module):
""" Create a bendy joints setup (mainly for arms & legs).
[Args]:
sj (string) - The name of the start joint
mj (string) - The name of the middle joint
ej (string) - The name of the end joint
moduleType (string) - The type of body part ('arm', 'leg')
module (class) - The class of the body part module
"""
moduleName = utils.setupBodyPartName(module.extraName, module.side)
extraName = module.extraName
mechGrp = utils.newNode('group',
name='{}BendyMech'.format(extraName),
side=module.side,
skipNum=True,
parent='{}{}Mech{}'.format(moduleName, moduleType,
suffix['group']))
mechGrp.setAttr('it', 0)
midBendCtrl = ribbonJoints(sj,
mj,
'Upper',
module,
extraName=extraName,
moduleType=moduleType,
par=mechGrp.name,
endCtrl=True)
ribbonJoints(mj,
ej,
'Lower',
module,
extraName=extraName,
moduleType=moduleType,
par=mechGrp.name,
basePar=midBendCtrl.ctrlEnd)
def __init__(self, rig, extraName='', side='C'):
""" Setup the initial variables to use when creating the face.
[Args]:
rig (class) - The rig class to use
extraName (string) - The extra name of the module
side (string) - The side of the module ('C', 'R' or 'L')
"""
self.moduleName = utils.setupBodyPartName(extraName, side)
self.extraName = extraName
self.side = side
self.rig = rig
def createLayeredSplineIK(jnts,
name,
rig=None,
side='C',
extraName='',
parent=None,
dyn=False):
""" Create a layered spline IK.
[Args]:
jnts (list)(string) - The names of the joints to create the IK with
name (string) - The name of the IK
rig (class) - The rig class to use
side (string) - The side of the IK
extraName (string) - The extra name of the IK
parent (string) - The name of the parent
dyn (bool) - Toggles dynamics on the spline IK
"""
moduleName = utils.setupBodyPartName(extraName, side)
col = utils.getColors(side)
## create base layer jnts
tmpCrv = utils.createCrvFromObjs(jnts, crvName='tmpCrv')
ctrlGrp = utils.newNode('group',
name='{}{}Ctrls'.format(extraName, name),
side=side,
parent=rig.ctrlsGrp.name if rig else None,
skipNum=True)
mechGrp = utils.newNode('group',
name='{}{}Mech'.format(extraName, name),
side=side,
parent=rig.mechGrp.name if rig else None,
skipNum=True)
baseJnts = utils.createJntsFromCrv(tmpCrv,
numOfJnts=4,
side=side,
name='{}{}_baseLayer'.format(
extraName, name))
if rig:
cmds.parent(jnts[0], rig.skelGrp.name)
cmds.parent(baseJnts[0], mechGrp.name)
## parent locs to base jnts
## base layer ctrls
baseLayerLocs = []
baseLayerCtrls = []
baseCtrlParent = ctrlGrp.name
for each in baseJnts:
baseLoc = utils.newNode('locator',
name='{}{}_baseLayer'.format(extraName, name),
side=side)
baseLoc.parent(each, relative=True)
utils.setShapeColor(baseLoc.name, color=None)
baseLayerLocs.append(baseLoc)
baseCtrl = ctrlFn.ctrl(name='{}{}_baseLayer'.format(extraName, name),
guide=each,
side=side,
parent=baseCtrlParent,
rig=rig,
scaleOffset=rig.scaleOffset)
baseCtrl.constrain(each)
baseCtrl.modifyShape(shape='cube', color=col['col2'], scale=(1, 1, 1))
baseLayerCtrls.append(baseCtrl)
baseCtrlParent = baseCtrl.ctrlEnd
baseSpaces = [rig.globalCtrl.ctrlEnd]
if parent:
baseSpaces.insert(0, parent)
baseLayerCtrls[0].spaceSwitching(parents=baseSpaces,
niceNames=None,
constraint='parent',
dv=0)
## mid layer crv FROM BASE JNTS
midCrv = utils.createCrvFromObjs(baseJnts,
crvName='{}_midLayer'.format(name),
side=side,
extraName=extraName)
## create mid jnts
midJnts = utils.createJntsFromCrv(tmpCrv,
numOfJnts=7,
side=side,
name='{}{}_midLayer'.format(
extraName, name))
cmds.parent(midJnts[0], mechGrp.name)
cmds.delete(tmpCrv)
## parent locs to mid jnts
## create mid ctrls - parent constrain root grp to mid jnts
midLayerLocs = []
midLayerCtrls = []
midCtrlParent = ctrlGrp.name
for each in midJnts:
midCtrl = ctrlFn.ctrl(name='{}{}_midLayer'.format(extraName, name),
guide=each,
side=side,
parent=midCtrlParent,
rig=rig,
scaleOffset=rig.scaleOffset)
cmds.parentConstraint(each, midCtrl.rootGrp.name, mo=1)
midCtrl.modifyShape(shape='sphere',
color=col['col1'],
scale=(0.4, 0.4, 0.4))
midLayerCtrls.append(midCtrl)
midLoc = utils.newNode('locator',
name='{}{}_midLayer'.format(extraName, name),
side=side)
utils.setShapeColor(midLoc.name, color=None)
midLoc.parent(midCtrl.ctrlEnd, relative=True)
midLayerLocs.append(midLoc)
midCtrlParent = midCtrl.ctrlEnd
## ik spline mid crv to mid jnts
midIKSpline = ikFn.ik(sj=midJnts[0],
ej=midJnts[-1],
name='{}{}_midLayerIK'.format(extraName, name),
side=side)
midIKSpline.createSplineIK(crv=midCrv, parent=mechGrp.name)
midIKSpline.addStretch(operation='both',
mode='length',
globalScaleAttr=rig.scaleAttr if rig else None)
midIKSpline.advancedTwist(baseLayerCtrls[0].ctrlEnd,
endObj=baseLayerCtrls[-1].ctrlEnd,
wuType=4)
## connect mid crv cvs to base locators
for i, each in enumerate(baseLayerLocs):
cmds.connectAttr('{}.wp'.format(each.name),
'{}Shape.cv[{}]'.format(midCrv, i))
## create skin crv FROM MID JNTS
skinCrvIn = utils.createCrvFromObjs(midJnts,
side=side,
extraName=extraName,
crvName='{}_skinLayer{}'.format(
name, 'DynIn' if dyn else ''))
skinCrvInShape = cmds.listRelatives(skinCrvIn, s=1)[0]
if dyn:
dynMechGrp = utils.newNode('group',
name='{}Dynamics'.format(name),
side=side,
parent=mechGrp.name,
skipNum=True)
cmds.parent(skinCrvIn, dynMechGrp.name)
skinCrv = utils.createCrvFromObjs(midJnts,
crvName='{}_skinLayer'.format(name),
side=side,
extraName=extraName)
## create output curve
dynOutCrv = utils.createCrvFromObjs(
midJnts,
side=side,
extraName=extraName,
crvName='{}_skinLayerDynOut'.format(name))
cmds.parent(dynOutCrv, dynMechGrp.name)
dynOutCrvShape = cmds.listRelatives(dynOutCrv, s=1)[0]
## create follicle
fol = utils.newNode('follicle',
name='{}_skinLayerDyn'.format(name),
side=side,
parent=dynMechGrp.name)
cmds.setAttr('{}.restPose'.format(fol.name), 1)
cmds.setAttr('{}.startDirection'.format(fol.name), 1)
cmds.setAttr('{}.degree'.format(fol.name), 3)
## create hair system
hs = utils.newNode('hairSystem',
name='{}_skinLayerDyn'.format(name),
side=side,
parent=dynMechGrp.name)
## create nucleus
nuc = utils.newNode('nucleus',
name='{}_skinLayerDyn'.format(name),
side=side,
parent=dynMechGrp.name)
## connect shit
fol.connect('startPosition',
'{}.local'.format(skinCrvInShape),
mode='to')
fol.connect('startPositionMatrix',
'{}.wm'.format(skinCrvIn),
mode='to')
fol.connect('currentPosition',
'{}.outputHair[0]'.format(hs.name),
mode='to')
fol.connect('outCurve',
'{}.create'.format(dynOutCrvShape),
mode='from')
fol.connect('outHair', '{}.inputHair[0]'.format(hs.name), mode='from')
hs.connect('currentState',
'{}.inputActive[0]'.format(nuc.name),
mode='from')
hs.connect('startState',
'{}.inputActiveStart[0]'.format(nuc.name),
mode='from')
hs.connect('nextState',
'{}.outputObjects[0]'.format(nuc.name),
mode='to')
hs.connect('startFrame', '{}.startFrame'.format(nuc.name), mode='to')
hs.connect('currentTime', 'time1.outTime', mode='to')
nuc.connect('currentTime', 'time1.outTime', mode='to')
## blend shape curves
blendNode = cmds.blendShape(skinCrvIn,
dynOutCrv,
skinCrv,
n='{}_{}Dynamics{}'.format(
side, name, suffix['blend']))[0]
## connect blend shape to attribute
##- create dyn control
dynCtrl = ctrlFn.ctrl(name='{}Settings'.format(name),
guide='{}_{}SettingsGuide{}'.format(
side, name, suffix['locator']),
rig=rig,
deleteGuide=True,
side=side,
skipNum=True,
parent=rig.settingCtrlsGrp.name)
dynCtrl.makeSettingCtrl(ikfk=False, parent=jnts[0])
dynCtrl.addAttr('dynSwitch',
nn='Dynamics Switch',
minVal=0,
maxVal=1,
defaultVal=1)
dynSwitchRev = utils.newNode('reverse',
name='{}DynamicsSwitch'.format(name),
side=side)
cmds.connectAttr(dynCtrl.ctrl.dynSwitch,
'{}.{}'.format(blendNode, dynOutCrv))
dynSwitchRev.connect('inputX', dynCtrl.ctrl.dynSwitch, mode='to')
dynSwitchRev.connect('outputX',
'{}.{}'.format(blendNode, skinCrvIn),
mode='from')
else:
skinCrv = skinCrvIn
## ik spline skin crv to skin jnts
skinIKSpline = ikFn.ik(sj=jnts[0],
ej=jnts[-1],
name='{}{}_skinLayerIK'.format(extraName, name),
side=side)
skinIKSpline.createSplineIK(crv=skinCrv, parent=mechGrp.name)
skinIKSpline.addStretch(operation='both',
mode='length',
globalScaleAttr=rig.scaleAttr if rig else None)
skinIKSpline.advancedTwist(midLayerCtrls[0].ctrlEnd,
endObj=midLayerCtrls[-1].ctrlEnd,
wuType=4)
## connect skin crv cvs to mid locators
for i, each in enumerate(midLayerLocs):
cmds.connectAttr('{}.wp'.format(each.name),
'{}Shape.cv[{}]'.format(skinCrvIn, i))
def ribbonJoints(sj,
ej,
bendyName,
module,
extraName='',
moduleType=None,
par=None,
endCtrl=False,
basePar=None):
""" Create a ribbon setup.
[Args]:
sj (string) -
ej (string) -
bendyName (string) - The name of the ribbon setup
module (class) - The class of the body part module
extraName (string) - The extra name of the ribbon setup
moduleType (string) - The type of module
par (string) - The name of the mechanics parent
endCtrl (bool) - Toggles creating an end control
basePar (string) - The name of the joints parent
[Returns]:
bendyEndCtrl (class) - The end control class or False
"""
if not basePar:
basePar = sj
moduleName = utils.setupBodyPartName(module.extraName, module.side)
bendyName = '{}{}'.format(moduleType, bendyName)
col = utils.getColors(module.side)
distance = cmds.getAttr('{}.tx'.format(ej))
nPlane = cmds.nurbsPlane(p=(distance / 2, 0, 0),
lr=0.1,
w=distance,
axis=[0, 1, 0],
u=3,
d=3)
nPlane = cmds.rename(
nPlane[0], '{}{}Bendy{}'.format(moduleName, bendyName,
suffix['nurbsSurface']))
if par:
cmds.parent(nPlane, par)
utils.matchTransforms(nPlane, sj)
## ctrl
if not cmds.objExists('{}{}Ctrls{}'.format(moduleName, moduleType,
suffix['group'])):
ctrlGrp = cmds.group(
n='{}{}Ctrls{}'.format(moduleName, moduleType, suffix['group']))
cmds.parent(ctrlGrp, module.rig.ctrlsGrp.name)
bendyCtrl = ctrlFn.ctrl(name='{}{}Bendy'.format(extraName, bendyName),
side=module.side,
offsetGrpNum=2,
skipNum=True,
rig=module.rig,
scaleOffset=module.rig.scaleOffset,
parent='{}{}Ctrls{}'.format(
moduleName, moduleType, suffix['group']))
bendyCtrl.modifyShape(color=col['col3'],
shape='starFour',
scale=(0.3, 0.3, 0.3))
cmds.pointConstraint(sj, ej, bendyCtrl.offsetGrps[0].name)
cmds.orientConstraint(sj, bendyCtrl.offsetGrps[0].name, sk='x')
orientConstr = cmds.orientConstraint(basePar,
ej,
bendyCtrl.offsetGrps[1].name,
sk=['y', 'z'],
mo=1)
cmds.setAttr('{}.interpType'.format(orientConstr[0]), 2)
## clusters
cmds.select('{}.cv[0:1][0:3]'.format(nPlane))
baseClu = utils.newNode('cluster',
name='{}{}BendyBase'.format(extraName, bendyName),
side=module.side,
parent=par)
cmds.select('{}.cv[2:3][0:3]'.format(nPlane))
midClu = utils.newNode('cluster',
name='{}{}BendyMid'.format(extraName, bendyName),
side=module.side,
parent=par)
bendyCtrl.constrain(midClu.name)
bendyCtrl.constrain(midClu.name, typ='scale')
endCluGrpTrans = utils.newNode('group',
name='{}{}BendyEndCluTrans'.format(
extraName, bendyName),
side=module.side,
parent=par)
utils.matchTransforms(endCluGrpTrans.name, ej)
endCluGrpOrientYZ = utils.newNode('group',
name='{}{}BendyEndCluOrient'.format(
extraName, bendyName),
side=module.side,
parent=endCluGrpTrans.name)
utils.matchTransforms(endCluGrpOrientYZ.name, endCluGrpTrans.name)
endCluGrpOrientX = utils.newNode('group',
name='{}{}BendyEndCluOrientX'.format(
extraName, bendyName),
side=module.side,
parent=endCluGrpOrientYZ.name)
utils.matchTransforms(endCluGrpOrientX.name, endCluGrpOrientYZ.name)
cmds.select('{}.cv[4:5][0:3]'.format(nPlane))
endClu = utils.newNode('cluster',
name='{}{}BendyEnd'.format(extraName, bendyName),
side=module.side,
parent=endCluGrpOrientX.name)
cmds.parentConstraint(basePar, baseClu.name, mo=1)
cmds.scaleConstraint(basePar, baseClu.name, mo=1)
if not endCtrl:
cmds.pointConstraint(ej, endCluGrpTrans.name, mo=1)
cmds.orientConstraint(ej, endCluGrpOrientX.name, mo=1, sk=['y', 'z'])
cmds.orientConstraint(sj, endCluGrpOrientYZ.name, mo=1, sk='x')
bendyEndCtrl = False
else:
bendyEndCtrl = ctrlFn.ctrl(
name='{}{}BendyEnd'.format(extraName, bendyName),
side=module.side,
skipNum=True,
rig=module.rig,
scaleOffset=module.rig.scaleOffset,
parent='{}{}Ctrls{}'.format(moduleName, moduleType,
suffix['group']))
bendyEndCtrl.modifyShape(color=col['col3'],
shape='starFour',
scale=(0.3, 0.3, 0.3))
cmds.parentConstraint(ej, bendyEndCtrl.offsetGrps[0].name)
bendyEndCtrl.constrain(endCluGrpTrans.name)
bendyEndCtrl.constrain(endCluGrpTrans.name, typ='scale')
## rivets
rivJntPar = sj
for i in [0.1, 0.3, 0.5, 0.7, 0.9]:
rivJnt = createRivet('{}Bendy'.format(bendyName),
extraName,
module,
nPlane,
pv=0.5,
pu=i,
parent=par,
rivJntPar=rivJntPar)
rivJntPar = rivJnt
return bendyEndCtrl