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 fitbased on the list of selected objects (if there are any) or on all the objects if nothing is selected. Notice that the fit flag cannot be set in conjunction with view along axis commands like viewX. 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
	Specifies that the transition between camera positions should be animated.
back / b		bool
	Moves the camera to the back position.
bottom / bo		bool
	Moves the camera to the bottom position.
fit / fit		bool
	Apply a viewFit after positioning camera to persp, top, side, or front.
fitFactor / ff		float
	Specifies how much of the view should be filled with the fitteditems
front / f		bool
	Moves the camera to the front position.
home / h		bool
	Executes the camera’s home attribute command. Before the string is executed, all occurances of %camerawill be replaced by the camera’s name. Use the camera command to set a camera’s home command.
keepRenderSettings / krs		bool
	Retain the ‘renderable’ flag vaue on the view. Especially important if it switches from perspective to orthographic and then back again.
leftSide / ls		bool
	Moves the camera to the left side position.
namespace / ns		unicode
	Specifies a namespace that should be excluded. All objects in the specified namespace will be excluded from the fit process.
nextView / nv		bool
	Moves the camera to the next position.
persp / p		bool
	Moves the camera to the persp position.
previousView / pv		bool
	Moves the camera to the previous position.
rightSide / rs		bool
	Moves the camera to the right side position.
side / s		bool
	Moves the camera to the (right) side position (deprecated).
t / t		bool
top / t		bool
	Moves the camera to the top position.
viewNegativeX / vnx		bool
	Moves the camera to view along negative X axis.
viewNegativeY / vny		bool
	Moves the camera to view along negative Y axis.
viewNegativeZ / vnz		bool
	Moves the camera to view along negative Z axis.
viewX / vx		bool
	Moves the camera to view along X axis.
viewY / vy		bool
	Moves the camera to view along Y axis.
viewZ / vz		bool
	Moves the camera to view along Z axis. Flag can have multiple arguments, passed either as a tuple or a list.

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 )