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 0x1390a4668>, <function addCmdDocsCallback at 0x138d26320>, (‘tumble’, ‘’), {})

Flags:
Long name (short name) Argument Types Properties
azimuthAngle (aa) float ../../../_images/create.gif
 
Degrees to change the azimuth angle.
elevationAngle (ea) float ../../../_images/create.gif
 
Degrees to change the elevation angle.
localTumble (lt) int ../../../_images/create.gif
 

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 have multiple arguments, passed either as a tuple or a list.

pivotPoint (pp) float, float, float ../../../_images/create.gif
 
Three dimensional point used as the pivot point in the world space.
rotationAngles (ra) float, float ../../../_images/create.gif
 
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

Previous topic

pymel.core.rendering.track

Next topic

pymel.core.rendering.uvLink

Core

Core Modules

Other Modules

This Page