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

Synopsis

tumble [-azimuthAngle angle] [-elevationAngle angle] [-localTumble int] [-pivotPoint linear linear linear] [-rotationAngles angle angle] [camera]

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.

Return value

None

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

Related

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

Flags

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 be used more than once in a command

MEL examples

camera;
tumble -aa -30 cameraShape1;  // To change the azimuth angle

tumble -ea 15 cameraShape1;   // To change the elevation angle

tumble -ra -30 15;            // To change the azimuth angle and the elevation angle