pymel.core.context.ikSplineHandleCtx

ikSplineHandleCtx(*args, **kwargs)

The ikSplineHandle context command (ikSplineHandleCtx) updates parameters of ikSplineHandle tool. The options for the tool will be set to the flags the user specifies.

Flags:
Long name (short name) Argument Types Properties
autoPriorityH (apH) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies that this handle’s priority is assigned automatically.C: The default is off.Q: When queried, this flag returns an int.
createCurve (ccv) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies if a curve should be automatically created for the ikSplineHandle. C: The default is on. Q: When queried, this flag returns an int.
createRootAxis (cra) bool ../../../_images/edit.gif
 

Specifies if a root transform should automatically be created above the joints affected by the ikSplineHandle. This option is used to prevent the root flipping singularity on a motion path. C: The default is off. Q: When queried, this flag returns an int.

exists (ex) bool ../../../_images/create.gif
 
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
forceSolverH (fsH) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies if the ikSolver is enabled for the ikHandle.C: The default is on. Q: When queried, this flag returns an int.
history (ch) bool ../../../_images/create.gif
 
If this is a tool command, turn the construction history on for the tool in question.
image1 (i1) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
   
image2 (i2) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
   
image3 (i3) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Contexts support up to three icons that represent the tool associated with the context.
name (n) unicode ../../../_images/create.gif
 
If this is a tool command, name the tool appropriately.
numSpans (ns) int ../../../_images/edit.gif
 
Specifies the number of spans in the automatically generated curve of the ikSplineHandle. C: The default is 1. Q: When queried, this flag returns an int.
parentCurve (pcv) bool ../../../_images/edit.gif
 

Specifies if the curve should automatically be parented to the parent of the first joint affected by the ikSplineHandle. C: The default is on. Q: When queried, this flag returns an int.

poWeightH (pwH) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies the position/orientation weight of the ikHandle.C: The default is 1.Q: When queried, this flag returns a float.
priorityH (pH) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies the priority of the ikHandle.C: The default is 1.Q: When queried, this flag returns an int.
rootOnCurve (roc) bool ../../../_images/edit.gif
 
Specifies if the root is locked onto the curve of the ikSplineHandle. C: The default is on. Q: When queried, this flag returns an int.
rootTwistMode (rtm) bool ../../../_images/edit.gif
 

Specifies whether the start joint is allowed to twist or not. If not, then the required twist is distributed over the remaining joints. This applies to all the twist types. C: The default is off. Q: When queried, this flag returns an int. Flag can have multiple arguments, passed either as a tuple or a list.

simplifyCurve (scv) bool ../../../_images/edit.gif
 
Specifies if the ikSplineHandle curve should be simplified. C: The default is on. Q: When queried, this returns an int.
snapCurve (snc) bool ../../../_images/edit.gif
 

Specifies if the curve should automatically snap to the first joint affected by the ikSplineHandle. C: The default is off. Q: When queried, this flag returns an int.

snapHandleH (snH) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies if the ikHandle snapping is on. This flag is ignored for the ikSplineSolver.C: The default is on.Q: When queried, this flag returns an int.
solverTypeH (stH) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

Lists what ikSolver is being used. For the ikSplineContext the solver can only be the ikSplineSolver and this flag is ignored. C: The default solver is the ikSplineSolver.Q: When queried, this flag returns a string.

stickyH (sH) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

Specifies if the ikHandle is sticky or not. Valid strings are stickyand off. This flag is ignored for the ikSplineSolver.C: The default is off.Q: When queried, this flag returns a string.

twistType (tws) unicode ../../../_images/edit.gif
 

Specifies the type of interpolation to be used by the ikSplineHandle. The interpolation options are linear, easeIn, easeOut, and easeInOut.C: The default is linear. Q: When queried, this flag returns a string.

weightH (wH) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies the weight of the ikHandle. This flag is ignored in the ikSplineHandleCtx.C: The default is 1.Q: When queried, this flag returns a float.

Derived from mel command maya.cmds.ikSplineHandleCtx

Example:

import pymel.core as pm

#    Edit an existing context to create an ikSplineHandle with
#    the curve parented to the corresponding joint.
#
if pm.ikSplineHandleCtx( 'ikSplineHandleCtx', q=True, ex=True ):
  pm.ikSplineHandleCtx('ikSplineHandleCtx', e=True, parentCurve=True)

Previous topic

pymel.core.context.ikHandleCtx

Next topic

pymel.core.context.insertJointCtx

Core

Core Modules

Other Modules

This Page