pymel.core.rendering.tumble

tumble(*args, **kwargs)

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.

(<function tumble at 0x149e99578>, <function addCmdDocsCallback at 0x149aceb18>, (‘tumble’, ‘’), {})

Flags:

Long name (short name)		Argument Types	Properties
azimuthAngle (aa)		float
	Degrees to change the azimuth angle.
elevationAngle (ea)		float
	Degrees to change the elevation angle.
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 commandFlag can have multiple arguments, passed either as a tuple or a list.
pivotPoint (pp)		float, float, float
	Three dimensional point used as the pivot point in the world space.
rotationAngles (ra)		float, float
	Two values in degrees to change the azimuth and elevation angles.

Derived from mel command maya.cmds.tumble

Example:

import pymel.core as pm

pm.camera()
# Result: [nt.Transform(u'camera1'), nt.Camera(u'cameraShape1')] #
pm.tumble( 'cameraShape1', aa=-30 )# To change the azimuth angle

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

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