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 specified pivot point if the rotate pivot is not at the camera’s eye point.

(<function tumble at 0x0000027562329978>, <function addCmdDocsCallback at 0x0000027561FEE278>, (‘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.
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. Flag can have multiple arguments, passed either as a tuple or a list.

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