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

Synopsis

viewSet( [camera] , [back=boolean], [bottom=boolean], [fitFactor=float], [front=boolean], [home=boolean], [leftSide=boolean], [nextView=boolean], [persp=boolean], [previousView=boolean], [rightSide=boolean], [side=boolean], [top=boolean])

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

viewSet is undoable, queryable, and NOT editable.

This command positions the camera to one of the pre-defined positions. If the fit flag is set in conjunction with persp, top, side, or front; the view is "fit" based on the list of selected objects (if there are any) or on all the objects if nothing is selected. If a camera is not specified, the camera in the active view will be used. If no flag is specified, the camera is set to the home position.

Return value

None

In query mode, return type is based on queried flag.

Related

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

Flags

back, bottom, fitFactor, front, home, leftSide, nextView, persp, previousView, rightSide, side, top
Long name (short name) Argument types Properties
persp(p) boolean create
Moves the camera to the persp position.
top(top) boolean create
Moves the camera to the top position.
bottom(bo) boolean create
Moves the camera to the bottom position.
rightSide(rs) boolean create
Moves the camera to the right side position.
leftSide(ls) boolean create
Moves the camera to the left side position.
side(s) boolean create
Moves the camera to the (right) side position (deprecated).
front(f) boolean create
Moves the camera to the front position.
back(b) boolean create
Moves the camera to the back position.
home(h) boolean create
Executes the camera's home attribute command. Before the string is executed, all occurances of "%camera" will be replaced by the camera's name. Use the camera command to set a camera's home command.
previousView(pv) boolean createquery
Moves the camera to the previous position.
nextView(nv) boolean createquery
Moves the camera to the next position. -fit Apply a viewFit after positioning camera to persp, top, side, or front.
fitFactor(ff) float create
Specifies how much of the view should be filled with the "fitted" items

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

# Create a new camera
cam = cmds.camera();
camShape = cam[1];

# Set cameraShape1 to the persp position
cmds.viewSet( camShape, p=True )

# Set the camera in the active view to the top position
cmds.viewSet( t=True )