COMMAND QUERY NOTE:
The command queries can be run on a node that is part of an ExoSwitch Constraint system. The command finds the connected ExoSwitch Constraint and runs the flag query on that constraint. In some of the code examples below we list "exoSwitchConstraint1" as part of the command syntax. Keep in mind you do not have to declare a constraint to run the command query.
PYTHON NOTE:
According to Autodesk the Python implementation for Maya does not take in string arrays as part of a flag argument. The exoSwitchConstraint command takes string arrays for:
- Declaring driven nodes
- Appending the driven nodes
- Removing nodes from the constraint
- Disabling nodes
- Enabling nodes
For example, to declare driven nodes on an ExoSwitch Constraint in python the command syntax looks as follows:
import maya.mel as mel
mel.eval('exoSwitchConstraint -dn {"locator1", "locator2"}')
-help (-h)
Return the list of command flags for the exoSwitchConstraint command.
Example Command Code:
Return the list of command flags for the exoSwitchConstraint command.
Example Command Code:
exoSwitchConstraint -h exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', h=True)
-fullPath (-f)
Return the full DAG path of nodes when performing queries on an ExoSwitch Constraint system.
Example Command Code:
Return the full DAG path of nodes when performing queries on an ExoSwitch Constraint system.
Example Command Code:
exoSwitchConstraint -q -f -td exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', q=True, f=True, td=True)
-name (-n)
The -name flag can name a constraint on creation, edit the name of a constraint post creation and query the name of selected constraint
Example Command Code:
The -name flag can name a constraint on creation, edit the name of a constraint post creation and query the name of selected constraint
Example Command Code:
exoSwitchConstraint -n "LfootRigESC" -td "LfootController" -rd "LfootController";
exoSwitchConstraint -e -n "LfootRigESC" exoSwitchConstraint1;
string $selection[] = `ls -sl`;
exoSwitchConstraint -q -n $selection[0];
import maya.cmds as cmds
cmds.exoSwitchConstraint(n='LfootRigESC', td='LfootController', rd='LfootController')
cmds.exoSwitchConstraint('exoSwitchConstraint1', e=True, n='LfootRigESC')
constraint = cmds.ls(sl=True)
cmds.exoSwitchConstraint(constraint[0], q=True, n=True)
-transDriver (-td) ( string )
Controls the translation driver on an ExoSwitch Constraint system.
Example Command Code:
Controls the translation driver on an ExoSwitch Constraint system.
Example Command Code:
exoSwitchConstraint -td "locator1";
exoSwitchConstraint -e -td "locator2" exoSwitchConstraint1;
exoSwitchConstraint -q -td exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint(td='locator1')
cmds.exoSwitchConstraint('exoSwitchConstraint1', e=True, td='locator2')
cmds.exoSwitchConstraint('exoSwitchConstraint1', q=True, td=True)
-rotDriver (-rd) ( string )
Controls the rotation driver on an ExoSwitch Constraint system.
Example Command Code:
Controls the rotation driver on an ExoSwitch Constraint system.
Example Command Code:
exoSwitchConstraint -rd "locator1";
exoSwitchConstraint -e -rd "locator1" exoSwitchConstraint1;
exoSwitchConstraint -q -rd exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint(rd='locator1')
cmds.exoSwitchConstraint('exoSwitchConstraint1', e=True, rd='locator2')
cmds.exoSwitchConstraint('exoSwitchConstraint1', q=True, rd=True)
-drivenNodes (-dn) ( string[] )
This flag helps set the nodes that are being driven by the translation and or rotation masters. It can be used during creation. When used in edit mode it replaces all current driven nodes in the system - if you would like to add a set of nodes to be driven to a given ExoSwitch Constraint system use the -appendDrivenNodes flag (-adn). You can also query which nodes are being driven on a constraint.
Example Command Code:
This flag helps set the nodes that are being driven by the translation and or rotation masters. It can be used during creation. When used in edit mode it replaces all current driven nodes in the system - if you would like to add a set of nodes to be driven to a given ExoSwitch Constraint system use the -appendDrivenNodes flag (-adn). You can also query which nodes are being driven on a constraint.
Example Command Code:
exoSwitchConstraint -dn {"locator1", "locator2"};
// REPLACE ALL THE DRIVEN NODES FOR A GIVEN CONSTRAINT
exoSwitchConstraint -e -dn {"locator1", "locator2"} exoSwitchConstraint1;
exoSwitchConstraint -q -dn exoSwitchConstraint1;
import maya.mel as mel
mel.eval('exoSwitchConstraint -e -dn {"locator1", "locator2"} exoSwitchConstraint1')
-appendDrivenNodes (-adn) ( string[] )
This flag connects new nodes to the specified constraint system and adds the nodes in the array of the existing list of driven nodes.
Example Command Code:
This flag connects new nodes to the specified constraint system and adds the nodes in the array of the existing list of driven nodes.
Example Command Code:
// APPENDS TO CURRENT DRIVEN NODE ARRAY
exoSwitchConstraint -e -adn {"locator3", "locator4"} exoSwitchConstraint1;
import maya.mel as mel
mel.eval('exoSwitchConstraint -e -adn {"locator3", "locator4"} exoSwitchConstraint1')
-removeNodes (-rm) ( string[] )
Removes nodes in the given array from the declared ExoSwitch Constraint system.
Any animation data pertaining to each node in the given array is destroyed.
To preserve animation see the -preserveAnimation flag.
Example Command Code:
Removes nodes in the given array from the declared ExoSwitch Constraint system.
Any animation data pertaining to each node in the given array is destroyed.
To preserve animation see the -preserveAnimation flag.
Example Command Code:
exoSwitchConstraint -e -rm {"locator1", "locator2"} exoSwitchConstraint1;
import maya.mel as mel
mel.eval('exoSwitchConstraint -e -rm {"locator1", "locator2"} exoSwitchConstraint1')
-disableNodes (-dsn) ( bool, string[] )
Queries the disabled nodes on a particular ExoSwitch Constraint.
Example Command Code:
Queries the disabled nodes on a particular ExoSwitch Constraint.
Example Command Code:
exoSwitchConstraint -e -dsn 1 {"locator1", "locator2"} exoSwitchConstraint1;
exoSwitchConstraint -q -dsn exoSwitchConstraint1;
import maya.mel as mel
mel.eval('exoSwitchConstraint -e -dsn 1 {"locator1", "locator2"} exoSwitchConstraint1')
-animatedNodes (-an) ( string[] )
Queries animated nodes connected to a particular ExoSwitch Constraint.
Example Command Code:
Queries animated nodes connected to a particular ExoSwitch Constraint.
Example Command Code:
exoSwitchConstraint -q -an exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', q=True, an=True)
-constraintMembers (-cm) ( string[] )
Queries all the nodes connected to a particular ExoSwitch Constraint.
Example Command Code:
Queries all the nodes connected to a particular ExoSwitch Constraint.
Example Command Code:
exoSwitchConstraint -q -cm exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', q=True, cm=True)
-constraintMemberName (-cmn) ( in=int, out=string )
Returns the name of a constraint member given a plug number integer as input.
Example Command Code:
Returns the name of a constraint member given a plug number integer as input.
Example Command Code:
exoSwitchConstraint -cmn 0 exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', cmn=0)
-autoSwitch (-asw) ( bool )
This flags automatically sets the translation and rotation drivers for an ExoSwitch Constraint system based on selection.
This is interactive so as a user changes selection the drivers are updated.
This provides an intuitive and fast workflow for posing ExoSwitch Constraint systems.
Example Command Code:
This flags automatically sets the translation and rotation drivers for an ExoSwitch Constraint system based on selection.
This is interactive so as a user changes selection the drivers are updated.
This provides an intuitive and fast workflow for posing ExoSwitch Constraint systems.
Example Command Code:
exoSwitchConstraint -asw 1 exoSwitchConstraint1;
exoSwitchConstraint -e -asw 0 exoSwitchConstraint1;
exoSwitchConstraint -q -asw exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint(asw=True)
cmds.exoSwitchConstraint('exoSwitchConstraint1', e=True, asw=False)
cmds.exoSwitchConstraint('exoSwitchConstraint1', q=True, asw=True)
-autoDriverSelect (-ads) ( bool )
This flag will automatically select the driver for the current frame.
As animation plays, if the drivers for the system change it will be reflected via selection.
Example Command Code:
This flag will automatically select the driver for the current frame.
As animation plays, if the drivers for the system change it will be reflected via selection.
Example Command Code:
exoSwitchConstraint -ads 1;
exoSwitchConstraint -e -ads 0 exoSwitchConstraint1;
exoSwitchConstraint -q -ads exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint(ads=True)
cmds.exoSwitchConstraint('exoSwitchConstraint1', e=True, ads=False)
cmds.exoSwitchConstraint('exoSwitchConstraint1', q=True, ads=True)
-autoKeySwitch (-aks) ( bool )
This flag will keyframe the transDriver and rotDriver attributes every time the system changes drivers.
Example Command Code:
This flag will keyframe the transDriver and rotDriver attributes every time the system changes drivers.
Example Command Code:
exoSwitchConstraint -aks 1;
exoSwitchConstraint -e -aks 0 exoSwitchConstraint1;
exoSwitchConstraint -q -aks exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint(ads=True)
cmds.exoSwitchConstraint('exoSwitchConstraint1', e=True, aks=False)
cmds.exoSwitchConstraint('exoSwitchConstraint1', q=True, aks=True)
-preserveAnimation (-pa) ( bool )
Keeps the animation on a node when being disconnected from an ExoSwitch Constraint.
Example Command Code:
Keeps the animation on a node when being disconnected from an ExoSwitch Constraint.
Example Command Code:
exoSwitchConstraint -e -rm {"locator1"} -pa 1 exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint(q=True, f=True, td=True, "exoSwitchConstraint1")
-maskConfigName (-mna) ( in=int, out=string )
Returns the name of the mask configuration for the input integer given with the flag
Example Command Code:
Returns the name of the mask configuration for the input integer given with the flag
Example Command Code:
exoSwitchConstraint -mna 0 exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint(mna=0)
-maskConfigNames (-mns)
Returns the names of all the mask configurations on the constraint node
Example Command Code:
Returns the names of all the mask configurations on the constraint node
Example Command Code:
exoSwitchConstraint -q -mns exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', q=True, mns=True)
-maskConfigNumber (-mcn) (in=string, out=int )
Return the mask configuration number given the input mask configuration name string
Example Command Code:
Return the mask configuration number given the input mask configuration name string
Example Command Code:
exoSwitchConstraint -mcn "myMaskConfig" exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', mcn='myMaskConfig')
-maskConfigNumbers (-mnu)
Return the mask configuration integer numbers for all the mask configs on the given constraint
Example Command Code:
Return the mask configuration integer numbers for all the mask configs on the given constraint
Example Command Code:
exoSwitchConstraint -q -mnu exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', q=True, mnu=True)
-currentMaskName (-cna)
Return the name of the current mask configuration.
Example Command Code:
Return the name of the current mask configuration.
Example Command Code:
exoSwitchConstraint -q -cna exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', q=True, cna=True)
-currentMaskNumber (-cnu)
Return the current mask configuration id number as an integer.
Example Command Code:
Return the current mask configuration id number as an integer.
Example Command Code:
exoSwitchConstraint -q -cnu exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', q=True, cnu=True)
-addMaskConfig (-amc)
Adds a new mask configuration to the constraint system with the input name.
Example Command Code:
Adds a new mask configuration to the constraint system with the input name.
Example Command Code:
exoSwitchConstraint -amc "myNewMaskConfig" exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', amc='myNewMaskConfig')
-removeMaskConfig (-rmc)
Removes the mask configuration with the input name.
Example Command Code:
Removes the mask configuration with the input name.
Example Command Code:
exoSwitchConstraint -rmc "myNewMaskConfig" exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', rmc='myNewMaskConfig')
-setMaskConfig (-smc)
Sets the constraint system to the mask config given in the string input.
Example Command Code:
Sets the constraint system to the mask config given in the string input.
Example Command Code:
exoSwitchConstraint -smc "myMaskConfig" exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', smc='myMaskConfig')
-plugNumber (-pn)
Given a string for a node connected to a constraint system return the plug number.
Example Command Code:
Given a string for a node connected to a constraint system return the plug number.
Example Command Code:
exoSwitchConstraint -q -plugNumber "locator1" exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', q=True, plugNumber='locator1')
-isNodeConnected (-inc)
Given a string for a node return the name of the connected constraint. If the node is not connected to an exoSwitchConstraint return nothing.
Example Command Code:
Given a string for a node return the name of the connected constraint. If the node is not connected to an exoSwitchConstraint return nothing.
Example Command Code:
exoSwitchConstraint -q -isNodeConnected "locator1" exoSwitchConstraint1;
import maya.cmds as cmds
cmds.exoSwitchConstraint('exoSwitchConstraint1', q=True, isNodeConnected='locator1')
Command Mode
Edit Mode
Query Mode
