def blendshape(character=None,
mod=None,
side=None,
name=None,
suffix=None,
shapes=None,
target=None,
envelope=1,
shapeAttr=None,
shapeValue=1,
show=True,
lockAttr=None,
ihi=True):
""" Create a blendshape deformer """
#--- create the blendshape deformer and rename it
node = cmds.blendShape(shapes, target)[0]
filter_name = (name + node[0].upper() + node[1:])
node = rename.deformer(mod=mod,
side=side,
name=filter_name,
suffix=suffix,
obj=node)
#--- take care of the node's settings
#--- envelope
cmds.setAttr(node + '.envelope', envelope)
#--- change the shape weight value
if isinstance(shapeAttr, list):
for s in shapeAttr:
cmds.setAttr(node + '.' + s, shapeValue)
else:
cmds.setAttr(node + '.' + shapeAttr, shapeValue)
#--- show or hide transform
if not show:
if isinstance(target, list):
for t in target:
cmds.setAttr(t + '.v', 0)
else:
cmds.setAttr(target + '.v', 0)
#--- lock specified attributes
if lockAttr:
if node:
cmds.setAttr(node + '.' + lockAttr, lock=True)
#--- set isHistoricalInteresting attribute
if not ihi:
cmds.setAttr(node + '.ihi', 0)
return node
def wire(character=None,
mod=None,
side=None,
name=None,
suffix=None,
wire=None,
geometry=None,
position=[0, 0, 0],
rotation=[0, 0, 0],
envelope=1,
crossingEffect=0,
tension=1,
localInfluence=0,
wireRotation=1,
dropoffDistance=1,
wireScale=1,
parent=None,
show=True,
lockAttr=None,
ihi=True):
""" Create a wire deformer """
node = []
if wire:
if geometry:
#--- create a wire deformer
node = cmds.wire(geometry, wire=wire, groupWithBase=False)
base = cmds.ls(node[-1] + 'BaseWire')
#--- filter the individual name
filter_name = (name + node[0][0].upper() + node[0][1:])
#--- rename the wire deformer
node = rename.deformer(mod=mod,
side=side,
name=filter_name,
suffix=suffix,
obj=node)
#--- rename the baseWire curve
base = rename.deformer(mod=mod,
side=side,
name=filter_name + 'BaseWire',
suffix=suffix,
obj=base)
#--- create a group on top and parent the deformer under the group
node_grp = cmds.createNode('transform', parent=node[0])
cmds.parent(node_grp, world=True)
cmds.parent(node[0], base[0], node_grp)
#--- rename the node group
node_grp = rename.deformer(mod=mod,
side=side,
name=filter_name,
suffix='GRP',
obj=node_grp)[0]
#--- reposition the transform of the deformer locally
cmds.xform(node[0], translation=position, worldSpace=False)
cmds.xform(node[0], rotation=rotation, worldSpace=False)
#--- take care of the node's settings
#--- envelope
cmds.setAttr(node[-1] + '.envelope', envelope)
#--- crossingEffect
cmds.setAttr(node[-1] + '.crossingEffect', crossingEffect)
#--- tension
cmds.setAttr(node[-1] + '.tension', tension)
#--- localInfluence
cmds.setAttr(node[-1] + '.localInfluence', localInfluence)
#--- wireRotation
cmds.setAttr(node[-1] + '.rotation', wireRotation)
#--- dropoffDistance
cmds.setAttr(node[-1] + '.dropoffDistance[0]', dropoffDistance)
#--- wireScale
cmds.setAttr(node[-1] + '.scale[0]', wireScale)
#--- parent the group under the specified parent
assert parent, "Specified parent: " + str(parent) + 'is not a valid'
if not isinstance(parent, list):
cmds.parent(node_grp, parent)
#--- show or hide transform
if not show:
cmds.setAttr(node[0] + '.v', 0)
#--- lock specified attributes
if lockAttr:
if node[-1]:
cmds.setAttr(node[-1] + '.' + lockAttr, lock=True)
#--- set isHistoricalInteresting attribute
if not ihi:
for n in node:
cmds.setAttr(n + '.ihi', 0)
#--- add the base wire to the node list
node.append(base[0])
return node
def wave(character=None,
mod=None,
side=None,
name=None,
suffix=None,
geometry=None,
position=[0, 0, 0],
rotation=[0, 0, 0],
envelope=1,
amplitude=0,
wavelength=1,
offset=0,
dropoff=0,
dropoffPosition=0,
minRadius=0,
maxRadius=1,
parent=None,
show=True,
lockAttr=None,
ihi=True):
""" Create a wave deformer """
#--- select the specified geometry and create a wave deformer
cmds.select(geometry)
node = cmds.nonLinear(type='wave')
#--- filter the individual name
filter_name = (name + node[0].split('Handle')[0][0].upper() +
node[0].split('Handle')[0][1:])
#--- rename the wave deformer
node = rename.deformer(mod=mod,
side=side,
name=filter_name,
suffix=suffix,
obj=node)
#--- create a group on top and parent the deformer under the group
node_grp = cmds.createNode('transform', parent=node[0])
cmds.parent(node_grp, world=True)
cmds.parent(node[0], node_grp)
#--- rename the node group
node_grp = rename.deformer(mod=mod,
side=side,
name=filter_name,
suffix='GRP',
obj=node_grp)[0]
#--- reposition the transform of the deformer locally
cmds.xform(node[0], translation=position, worldSpace=False)
cmds.xform(node[0], rotation=rotation, worldSpace=False)
#--- take care of the node's settings
#--- envelope
cmds.setAttr(node[-1] + '.envelope', envelope)
#--- amplitude
cmds.setAttr(node[-1] + '.amplitude', amplitude)
#--- wavelength
cmds.setAttr(node[-1] + '.wavelength', wavelength)
#--- offset
cmds.setAttr(node[-1] + '.offset', offset)
#--- dropoff
cmds.setAttr(node[-1] + '.dropoff', dropoff)
#--- dropoffPosition
cmds.setAttr(node[-1] + '.dropoffPosition', dropoffPosition)
#--- minRadius
cmds.setAttr(node[-1] + '.minRadius', minRadius)
#--- maxRadius
cmds.setAttr(node[-1] + '.maxRadius', maxRadius)
#--- parent the group under the specified parent
assert parent, "Specified parent: " + str(parent) + 'is not a valid'
if not isinstance(parent, list):
cmds.parent(node_grp, parent)
#--- show or hide transform
if not show:
cmds.setAttr(node[0] + '.v', 0)
#--- lock specified attributes
if lockAttr:
if node[-1]:
cmds.setAttr(node[-1] + '.' + lockAttr, lock=True)
#--- set isHistoricalInteresting attribute
if not ihi:
for n in node:
cmds.setAttr(n + '.ihi', 0)
return node
def twist(character=None,
mod=None,
side=None,
name=None,
suffix=None,
geometry=None,
position=[0, 0, 0],
rotation=[0, 0, 0],
envelope=1,
startAngle=0,
endAngle=0,
lowBound=-1,
highBound=1,
parent=None,
show=True,
lockAttr=None,
ihi=True):
""" Create a twist deformer """
#--- select the specified geometry and create a twist deformer
cmds.select(geometry)
node = cmds.nonLinear(type='twist')
#--- filter the individual name
filter_name = (name + node[0].split('Handle')[0][0].upper() +
node[0].split('Handle')[0][1:])
#--- rename the twist deformer
node = rename.deformer(mod=mod,
side=side,
name=filter_name,
suffix=suffix,
obj=node)
#--- create a group on top and parent the deformer under the group
node_grp = cmds.createNode('transform', parent=node[0])
cmds.parent(node_grp, world=True)
cmds.parent(node[0], node_grp)
#--- rename the node group
node_grp = rename.deformer(mod=mod,
side=side,
name=filter_name,
suffix='GRP',
obj=node_grp)[0]
#--- reposition the transform of the deformer locally
cmds.xform(node[0], translation=position, worldSpace=False)
cmds.xform(node[0], rotation=rotation, worldSpace=False)
#--- take care of the node's settings
#--- envelope
cmds.setAttr(node[-1] + '.envelope', envelope)
#--- startAngle
cmds.setAttr(node[-1] + '.startAngle', startAngle)
#--- endAngle
cmds.setAttr(node[-1] + '.endAngle', endAngle)
#--- lowBound
cmds.setAttr(node[-1] + '.lowBound', lowBound)
#--- highBound
cmds.setAttr(node[-1] + '.highBound', highBound)
#--- parent the group under the specified parent
assert parent, "Specified parent: " + str(parent) + 'is not a valid'
if not isinstance(parent, list):
cmds.parent(node_grp, parent)
#--- show or hide transform
if not show:
cmds.setAttr(node[0] + '.v', 0)
#--- lock specified attributes
if lockAttr:
if node[-1]:
cmds.setAttr(node[-1] + '.' + lockAttr, lock=True)
#--- set isHistoricalInteresting attribute
if not ihi:
for n in node:
cmds.setAttr(n + '.ihi', 0)
return node
def sculpt(character=None,
mod=None,
side=None,
name=None,
suffix=None,
geometry=None,
position=[0, 0, 0],
rotation=[0, 0, 0],
envelope=1,
mode='flip',
insideMode='ring',
maxDisplacement=0.1,
dropoffType='linear',
dropoffDistance=1,
groupWithLocator=0,
objectCentered=0,
radius=1,
parent=None,
show=True,
lockAttr=None,
ihi=True):
""" Create a sculpt deformer """
#--- select the specified geometry and create a sculpt deformer
cmds.select(geometry)
node = cmds.sculpt(mode=mode,
insideMode=insideMode,
maxDisplacement=maxDisplacement,
dropoffType=dropoffType,
dropoffDistance=dropoffDistance,
groupWithLocator=groupWithLocator,
objectCentered=objectCentered)
#--- filter the individual name
filter_name = node[0]
#--- create a group on top and parent the deformer under the group
node_grp = cmds.createNode('transform')
#--- rename the node group
node_grp = rename.deformer(mod=mod,
side=side,
name=filter_name,
suffix='GRP',
obj=node_grp)[0]
#--- rename the sculpt deformer
node = rename.deformer(mod=mod,
side=side,
name=filter_name,
suffix=suffix,
obj=node)
cmds.parent(node_grp, node[0])
cmds.parent(node_grp, world=True)
cmds.parent(node[0], node_grp)
#--- reposition the transform of the deformer locally
cmds.xform(node[0], translation=position, worldSpace=False)
cmds.xform(node[0], rotation=rotation, worldSpace=False)
#--- take care of the node's settings
#--- envelope
cmds.setAttr(node[-1] + '.envelope', envelope)
#--- radius
cmds.setAttr(node[1] + '.radius', radius)
#--- parent the group under the specified parent
assert parent, "Specified parent: " + str(parent) + 'is not a valid'
if not isinstance(parent, list):
cmds.parent(node_grp, parent)
#--- show or hide transform
if not show:
cmds.setAttr(node[0] + '.v', 0)
#--- lock specified attributes
if lockAttr:
if node[-1]:
cmds.setAttr(node[-1] + '.' + lockAttr, lock=True)
#--- set isHistoricalInteresting attribute
if not ihi:
for n in node:
cmds.setAttr(n + '.ihi', 0)
node.append(node_grp)
return node
def lattice(character=None,
mod=None,
side=None,
name=None,
suffix=None,
geometry=None,
position=[0, 0, 0],
rotation=[0, 0, 0],
envelope=1,
divisions=[2, 5, 2],
objectCentered=True,
localInfluences=[2, 2, 2],
outsideLattice='inside',
outsideFalloffDist=1,
resolution='full',
partialResolution=0.01,
freezeGeometry=False,
parent=None,
show=True,
lockAttr=None,
ihi=True):
""" Create a lattice deformer """
#--- select the specified geometry and create a lattice deformer
cmds.select(geometry)
node = cmds.lattice(divisions=divisions,
objectCentered=objectCentered,
ldivisions=localInfluences)
#--- filter the name
filter_lat = name + 'Lattice' + node[0].split('ffd')[-1]
filter_bas = name + 'Base' + node[0].split('ffd')[-1]
#--- create a group on top and parent the deformer under the group
node_grp = cmds.createNode('transform')
#--- rename the node group
node_grp = rename.deformer(mod=mod,
side=side,
name=filter_lat,
suffix='GRP',
obj=node_grp)
#--- rename the lattice deformer
lat = rename.deformer(mod=mod,
side=side,
name=filter_lat,
suffix=suffix,
obj=node)
#--- rename the base deformer
base = rename.deformer(mod=mod,
side=side,
name=filter_bas,
suffix=suffix,
obj=node[-1])
cmds.parent(node_grp, lat[0])
cmds.parent(node_grp, world=True)
cmds.parent(lat[0], base[0], node_grp)
node = lat
#--- reposition the transform of the deformer locally
cmds.xform(node_grp, translation=position, worldSpace=False)
cmds.xform(node_grp, rotation=rotation, worldSpace=False)
#--- take care of the node's settings
#--- envelope
cmds.setAttr(node[-1] + '.envelope', envelope)
#--- outsideLattice
if outsideLattice == 'inside':
cmds.setAttr(node[-1] + '.outsideLattice', 0)
elif outsideLattice == 'all':
cmds.setAttr(node[-1] + '.outsideLattice', 1)
elif outsideLattice == 'falloff':
cmds.setAttr(node[-1] + '.outsideLattice', 2)
#--- outsideFalloffDist
if outsideLattice == 'falloff':
cmds.setAttr(node[-1] + '.outsideFalloffDist', outsideFalloffDist)
#--- resolution
if resolution == 'full':
cmds.setAttr(node[-1] + '.usePartialResolution', 0)
elif resolution == 'partial':
cmds.setAttr(node[-1] + '.usePartialResolution', 1)
#--- partialResolution
if resolution == 'partial':
cmds.setAttr(node[-1] + '.partialResolution', partialResolution)
#--- freezeGeometry
cmds.setAttr(node[-1] + '.freezeGeometry', freezeGeometry)
#--- parent the group under the specified parent
assert parent, "Specified parent: " + str(parent) + 'is not a valid'
if not isinstance(parent, list):
cmds.parent(node_grp, parent)
#--- show or hide transform
if not show:
cmds.setAttr(node_grp + '.v', 0)
#--- lock specified attributes
if lockAttr:
if node[-1]:
cmds.setAttr(node[-1] + '.' + lockAttr, lock=True)
#--- set isHistoricalInteresting attribute
if not ihi:
for n in node:
cmds.setAttr(n + '.ihi', 0)
for b in base:
cmds.setAttr(b + '.ihi', 0)
node.insert(-1, base[0])
return node
def cluster(character=None,
mod=None,
side=None,
name=None,
suffix=None,
geometry=None,
origin=[0, 0, 0],
weightObj=None,
weightValue=1,
parent=None,
show=True,
lockAttr=None,
ihi=True):
""" Create a cluster deformer """
#--- select the specified geometry and create a cluster deformer
cmds.select(geometry)
node = cmds.cluster()
filter_name = (name + node[0].split('Handle')[0][0].upper() +
node[0].split('Handle')[0][1:])
#--- rename the cluster deformer and get the cluster deform node
node = rename.deformer(mod=mod,
side=side,
name=filter_name,
suffix=suffix,
obj=node)
node.append(cmds.listConnections(node[0])[0])
#--- create a group on top and parent the deformer under the group
node_grp = cmds.createNode('transform')
cmds.parent(node[0], node_grp)
#--- rename the node group
node_grp = rename.deformer(mod=mod,
side=side,
name=filter_name,
suffix='GRP',
obj=node_grp)[0]
#--- take care of the node's settings
#--- origin
ori_x = cmds.getAttr(node[1] + '.originX')
ori_y = cmds.getAttr(node[1] + '.originY')
ori_z = cmds.getAttr(node[1] + '.originZ')
new_origin = [ori_x + origin[0], ori_y + origin[1], ori_z + origin[2]]
cmds.setAttr(node[1] + '.origin', new_origin[0], new_origin[1],
new_origin[2])
cmds.xform(node[0], pivots=new_origin, worldSpace=True)
#--- reposition the pivot of the group to the location of the cluster
cmds.xform(node_grp, pivots=new_origin, worldSpace=True)
#--- weightValue
if weightObj:
if isinstance(weightObj, list):
if isinstance(weightValue, list):
for obj, val in zip(weightObj, weightValue):
cmds.percent(node[-1], obj, value=val)
else:
for obj in weightObj:
cmds.percent(node[-1], obj, value=weightValue)
else:
cmds.percent(node[-1], weightObj, value=weightValue)
#--- parent the group under the specified parent
assert parent, "Specified parent: " + str(parent) + 'is not a valid'
if not isinstance(parent, list):
cmds.parent(node_grp, parent)
#--- show or hide transform
if not show:
if isinstance(node, list):
for n in node:
cmds.setAttr(n + '.v', 0)
else:
cmds.setAttr(node + '.v', 0)
#--- lock specified attributes
if lockAttr:
if node:
cmds.setAttr(node + '.' + lockAttr, lock=True)
#--- set isHistoricalInteresting attribute
if not ihi:
cmds.setAttr(node + '.ihi', 0)
return node
