Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

jointCtx [-autoJointOrient string] [-autoPriorityH boolean] [-createIKHandle boolean] [-degreeOfFreedomJ string] [-exists] [-forceSolverH boolean] [-image1 string] [-image2 string] [-image3 string] [-jointAutoLimits boolean] [-jointOrientationJ angle angle angle] [-largeBoneLength float] [-largeBoneRadius float] [-poWeightH float] [-priorityH int] [-scaleCompensateJ boolean] [-scaleJ float float float] [-scaleOrientationJ angle angle angle] [-secondaryAxisOrient string] [-smallBoneLength float] [-smallBoneRadius float] [-snapHandleH boolean] [-solverTypeH string] [-stickyH string] [-symmetry boolean] [-symmetryAxis string] [-variableBoneSize int] [-weightH float] [object]

jointCtx is undoable, queryable, and editable.

The joint context command (jointCtx) updates the parameters of the joint tool. The options for the tool will be set by the flags the user specifies.

Return value

stringThe name of the context.

In query mode, return type is based on queried flag.

Flags

autoJointOrient, autoPriorityH, createIKHandle, degreeOfFreedomJ, exists, forceSolverH, image1, image2, image3, jointAutoLimits, jointOrientationJ, largeBoneLength, largeBoneRadius, poWeightH, priorityH, scaleCompensateJ, scaleJ, scaleOrientationJ, secondaryAxisOrient, smallBoneLength, smallBoneRadius, snapHandleH, solverTypeH, stickyH, symmetry, symmetryAxis, variableBoneSize, weightH
Long name (short name) Argument types Properties
-exists(-ex) create
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
-image1(-i1) string createqueryedit
-image2(-i2) string createqueryedit
-image3(-i3) string createqueryedit
Contexts support up to three icons that represent the tool associated with the context.
-autoJointOrient(-ajo) string createqueryedit
Specifies the joint orientation. Valid string choices are permutations of the axes; "none", "xyz", "yzx", "zxy", "xzy", "yxz", "zyx". The first letter determines which axis is aligned with the bone.
C: The default is "xyz".
Q: When queried, this flag returns a string.
-secondaryAxisOrient(-sao) string createqueryedit
Specifies the orientation of the secondary rotate axis. Valid string choices are: "xup", "xdown", "yup", "ydown", "zup", "zdown", "none".
-degreeOfFreedomJ(-dJ) string createqueryedit
Specifies the degrees of freedom for all of the joints created by the tool. Valid string choices are the free axes; "x", "y", "z", "xy", "xz", "yz", "xyz", and "none".
C: The default is "xyz".
Q: When queried, this flag returns a string.
-symmetry(-sym) boolean createqueryedit
Automaticaly create a symmetry joint based if symmetry is on.
C: The default is off.
Q: When queried, this flag returns an int.
-symmetryAxis(-sa) string createqueryedit
Automaticaly create a symmetry joint use x, y , z axis or combination to do the symmetry.
C: The default is x.
Q: When queried, this flag returns a string.
-jointAutoLimits(-jal) boolean createqueryedit
Automatically computes the joint limits based on the kind of joint created.
C: The default is off.
Q: When queried, this flag returns an int.
-jointOrientationJ(-joJ) angle angle angle createqueryedit
Sets the orientation of the joints created by the tool. If autoJointOrient in on, these values will be ignored.
C: The default is 0 0 0.
Q: When queried, this flag returns an array of three floats.
-scaleJ(-sJ) float float float createqueryedit
Sets the scale for the joints created by the tool.
C: The default is 1 1 1.
Q: When queried, this flag returns an array of three floats.
-scaleCompensateJ(-scJ) boolean createqueryedit
Specifies if scale compensate is enabled.
C: The default is on.
Q: When queried, this flag returns an int.
-scaleOrientationJ(-soJ) angle angle angle createqueryedit
Sets the current value for the scale orientation. If autoJointOrient in on, these values will be ignored.
C: The default is 0 0 0.
Q: When queried, this flag returns an array of three floats.
-createIKHandle(-ikh) boolean createqueryedit
Enables the joint tool to create an ikHandle when the tool is completed.
C: The default is off.
Q: When queried, this flag returns an int.
-forceSolverH(-fsH) boolean createqueryedit
Specifies if the ikSolver for the ikHandle is enabled.
C: The default is on.
Q: When queried, this flag returns an int.
-autoPriorityH(-apH) boolean createqueryedit
Specifies if the ikHandle's priority is assigned automatically.
C: The default is off.
Q: When queried, this flag returns an int.
-priorityH(-pH) int createqueryedit
Specifies the priority of the ikHandle.
C: The default is on.
Q: When queried, this flag returns an int.
-poWeightH(-pwH) float createqueryedit
Specifies the position/orientation weight of the ikHandle.
C: The default is 1.
Q: When queried, this flag returns a float.
-stickyH(-sH) string createqueryedit
Specifies if the ikHandle is sticky or not. If "sticky" is passed then the ikHandle will be sticky. If "off" is used then ikHandle stickiness will be turned off.
C: The default is "off".
Q: When queried, this flag returns a string.
-snapHandleH(-snH) boolean createqueryedit
Sepcifies if snapping is enabled for the ikHandle.
C: The default is on.
Q: When queried, this flag returns an int.
-solverTypeH(-stH) string createqueryedit
Sets the name of the solver to use with the ikHandle.
C: The default is the solver set to the default in the user preferences.
Q: When queried, this flag returns a string.
-weightH(-wH) float createqueryedit
Specifies the weight of the ikHandle. The weight is relative to the other ikHandles in the scene.
C: The default is 1.
Q: When queried, this flag returns a float.
-variableBoneSize(-vbs) int createqueryedit
Specifies whether or not variable bone length and radius settings should be used.
-largeBoneLength(-lbl) float createqueryedit
Specifies the length above which bones should be assigned the largeBoneRadius.
-largeBoneRadius(-lbr) float createqueryedit
Specifies the radius for bones whose length is above the largeBoneLength
-smallBoneLength(-sbl) float createqueryedit
Specifies the length below which bones should be assigned the smallBoneRadius.
-smallBoneRadius(-sbr) float createqueryedit
Specifies the radius for bones whose length is below the smallBoneLength.

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command.

MEL examples

//    Create a joint context that makes a ikHandle with an ikRPSolver.
//    The use the tool.
//
jointCtx -createIKHandle on -solverTypeH "ikRPsolver" myJointContext;
setToolTo myJointContext;