pymel.core.rendering.viewSet

viewSet(*args, **kwargs)

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. In query mode, return type is based on queried flag.

Flags:
Long name (short name) Argument Types Properties
animate (an) bool  
   
back (b) bool ../../../_images/create.gif
 
Moves the camera to the back position.
bottom (bo) bool ../../../_images/create.gif
 
Moves the camera to the bottom position.
fit (fit) bool  
   
fitFactor (ff) float ../../../_images/create.gif
 

Specifies how much of the view should be filled with the “fitted” itemsFlag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.

front (f) bool ../../../_images/create.gif
 
Moves the camera to the front position.
home (h) bool ../../../_images/create.gif
 

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.

keepRenderSettings (krs) bool  
   
leftSide (ls) bool ../../../_images/create.gif
 
Moves the camera to the left side position.
namespace (ns) unicode  
   
nextView (nv) bool ../../../_images/create.gif ../../../_images/query.gif
 
Moves the camera to the next position. -fit Apply a viewFit after positioning camera to persp, top, side, or front.
persp (p) bool ../../../_images/create.gif
 
Moves the camera to the persp position.
previousView (pv) bool ../../../_images/create.gif ../../../_images/query.gif
 
Moves the camera to the previous position.
rightSide (rs) bool ../../../_images/create.gif
 
Moves the camera to the right side position.
side (s) bool ../../../_images/create.gif
 
Moves the camera to the (right) side position (deprecated).
t (t) bool  
   
top (top) bool ../../../_images/create.gif
 
Moves the camera to the top position.

Derived from mel command maya.cmds.viewSet

Example:

import pymel.core as pm

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

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

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

Previous topic

pymel.core.rendering.viewPlace

Next topic

pymel.core.runtime

Core

Core Modules

Other Modules

This Page