pymel.core.context.ikHandleCtx

ikHandleCtx(*args, **kwargs)

The ikHandle context command (ikHandleCtx) updates parameters of ikHandle tool. The options for the tool will be set to the flags that 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. The flag is ignored in the ikHandleCtx.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. This flag is ignored in the ikHandleCtx.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
  First of three possible icons representing the tool associated with the context.
image2 / i2 unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Second of three possible icons representing the tool associated with the context.
image3 / i3 unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Third of three possible icons representing 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. This flag is ignored in the ikHandleCtx.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. The flag is ignored in the ikHandleCtx.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. This flag is ignored in the ikHandleCtx. 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. This flag is ignored in the ikHandleCtx. C: The default is off. Q: When queried, this flag returns an int.
simplifyCurve / scv bool ../../../_images/edit.gif
  Specifies if the ikSplineHandle curve should be simplified. This flag is ignored in the ikHandleCtx.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. This flag is ignored in the ikHandleCtx.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.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. The ikSplineSolver may not be selected. To use an ikSplineSolver use the ikSplineHandleCtx command. C: The default solver is the default set by the user preferences.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.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. This flag is ignored in the ikHandleCtx. 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.C: The default is 1.Q: When queried, this flag returns a float. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.ikHandleCtx

Example:

import pymel.core as pm

#    Edit an existing context to create an ikHandle with snapping on.
#
if pm.ikHandleCtx( 'ikHandleCtx', q=True, ex=True ):
  pm.ikHandleCtx('ikHandleCtx', e=True, snapHandleH=True)