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


tumble( [camera] , [azimuthAngle=angle], [elevationAngle=angle], [localTumble=int], [pivotPoint=[linear, linear, linear]], [rotationAngles=[angle, angle]])

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

tumble is undoable, NOT queryable, and NOT editable.

The tumble command revolves the camera(s) by varying the azimuth and elevation angles in the perspective window. When both the azimuth and the elevation angles are supplied on the command line, the camera is firstly tumbled for the azimuth angle, then tumbled for the elevation angle.

When no camera name is supplied, this command is applied to the camera in the active view.

The camera's rotate pivot will override a specifed pivot point if the rotate pivot is not at the camera's eye point.

Return value



camera, cameraView, dolly, listCameras, lookThru, orbit, roll, track, viewCamera, viewClipPlane, viewFit, viewHeadOn, viewLookAt, viewPlace, viewSet


azimuthAngle, elevationAngle, localTumble, pivotPoint, rotationAngles
Long name (short name) Argument types Properties
azimuthAngle(aa) angle create
Degrees to change the azimuth angle.
elevationAngle(ea) angle create
Degrees to change the elevation angle.
rotationAngles(ra) [angle, angle] create
Two values in degrees to change the azimuth and elevation angles.
pivotPoint(pp) [linear, linear, linear] create
Three dimensional point used as the pivot point in the world space.
localTumble(lt) int create
Describes what point the camera will tumble around: 0 for the camera's tumble pivot, 1 for the camera's center of interest, and 2 for the camera's local axis, offset by its tumble pivot.

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.tumble( 'cameraShape1', aa=-30 )# To change the azimuth angle

cmds.tumble( 'cameraShape1', ea=15 )# To change the elevation angle

cmds.tumble( ra=(-30, 15) )# To change the azimuth angle and the elevation angle