Go to: Synopsis. Return value. Related. Flags. Python examples.
roll(
[camera]
, [absolute=boolean], [degree=angle], [relative=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
roll is undoable, NOT queryable, and NOT editable.
The roll command rotates a camera about its viewing direction, a
positive angle produces clockwise camera rotation, while a
negative angle produces counter-clockwise camera rotation.
The default mode is relative and the rotation is applied with
respect to the current orientation of the camera. When mode is set
to absolute, the rotation is applied with respect to the plane
constructed from the following three vectors in the world space:
the world up vector, the camera view vector, and the camera up
vector.
The rotation angle is specified in degrees.
The roll command can be applied to either a perspective or an
orthographic camera.
This command may be applied to more than one camera; objects that
are not cameras are ignored. When no camera name supplied, this command
is applied to all currently active cameras.
None
camera, cameraView, dolly, listCameras, lookThru, orbit, track, tumble, viewCamera, viewClipPlane, viewFit, viewHeadOn, viewLookAt, viewPlace, viewSet
absolute, degree, relative
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()
# Align the horizontal direction with the world horizon
cmds.roll( 'cameraShape1', abs=True, d=0 )
# Roll the camera 15 degrees clockwise
cmds.roll( 'cameraShape1', d=15 )
cmds.roll( d=15 )