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, queryable, and 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.
None
In query mode, return type is based on queried flag.
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
|
|
|
Degrees to change the azimuth angle.
|
|
elevationAngle(ea)
|
angle
|
|
|
Degrees to change the elevation angle.
|
|
rotationAngles(ra)
|
[angle, angle]
|
|
|
Two values in degrees to change the azimuth and elevation
angles.
|
|
pivotPoint(pp)
|
[linear, linear, linear]
|
|
|
Three dimensional point used as the pivot point in the world
space.
|
|
localTumble(lt)
|
int
|
|
|
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.
|
import maya.cmds as cmds
cmds.camera()
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