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

Synopsis

orbit( [camera] , [horizontalAngle=angle], [pivotPoint=[linear, linear, linear]], [rotationAngles=[angle, angle]], [verticalAngle=angle])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

orbit is undoable, NOT queryable, and NOT editable.

The orbit command revolves the camera(s) horizontally and/or vertically in the perspective window. The rotation axis is with respect to the camera.

To revolve horizontally: the rotation axis is the camera up direction vector. To revolve vertically: the rotation axis is the camera left direction vector.

When both the horizontal and the vertical angles are supplied on the command line, the camera is firstly revolved horizontally, then revolved vertically.

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.

Return value

None

Related

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

Flags

horizontalAngle, pivotPoint, rotationAngles, verticalAngle
Long name (short name) Argument types Properties
horizontalAngle(ha) angle create
Angle to revolve horizontally.
pivotPoint(pp) [linear, linear, linear] create
Used as the pivot point in the world space.
rotationAngles(ra) [angle, angle] create
Angle to revolve horizontally and vertically.
verticalAngle(va) angle create
Angle to revolve vertically.

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.

Python examples

import maya.cmds as cmds

cmds.camera()
cmds.orbit( 'cameraShape1', ha=-30 )# Change the horizontal angle by -30 degrees

cmds.orbit( 'cameraShape1', va=15 )# Change the vertical angle by 15 degrees

cmds.orbit( 'cameraShape1', ra=(-30, 15) )# Change the horizontal angle by -30 degrees and the vertical angle by 15 degrees