controller

Go to: Synopsis. Return value. Keywords. Flags. Python examples.

Synopsis

controller([allControllers=boolean], [children=boolean], [group=boolean], [index=int], [isController=string], [parent=boolean], [pickWalkDown=boolean], [pickWalkLeft=boolean], [pickWalkRight=boolean], [pickWalkUp=boolean], [unparent=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

controller is undoable, queryable, and editable.

Return value

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

Keywords

Flags

Long name (short name)	Argument types	Properties
allControllers(ac)	boolean
When this flag is queried, returns all dependNode attached to a controller in the scene.
children(cld)	boolean
Return true if the specified dependNode is a controller.
group(g)	boolean
Create a controller that is not associated with any object. This new controller will be the parent of all the selected objects.
index(idx)	int
In query mode, returns the index of the controller in the parent controller's list of children. In edit mode, reorder the parent controller's children connections so that the current controller is assigned the given index.
isController(ic)	string
Returns true if the specified dependNode is a controller.
parent(p)	boolean
Set or query the parent controller of the selected controller node.
pickWalkDown(pwd)	boolean
Return the first child.
pickWalkLeft(pwl)	boolean
Return the previous sibling.
pickWalkRight(pwr)	boolean
Return the next sibling.
pickWalkUp(pwu)	boolean
Return the parent.
unparent(unp)	boolean
Unparent all selected controller objects from their respective parent.

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 have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

cmds.controller("object")