Go to: Synopsis. Return value. Related. Flags. Python examples.
viewFit(
[camera...]
, [allObjects=boolean], [animate=boolean], [center=boolean], [fitFactor=float], [namespace=string], [noChildren=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
viewFit is undoable, NOT queryable, and NOT editable.
The viewFit command positions the specified camera so its
point-of-view contains all selected objects other than itself. If
no objects are selected, everything is fit to the view (excepting
cameras, lights, and sketching plannes). The fit-factor, if
specified, determines how much of the view should be filled. If a
camera is not specified, the camera in the active view will be
used. After the camera is moved, its center of interest is set to
the center of the bounding box of the objects.
Additionally, a list of objects can be passed as arguments.
If a camera is specified it must be the first argument. Objects
passed as arguments to the command will be used instead of the
selected objects.
None
camera, cameraView, dolly, listCameras, lookThru, orbit, roll, track, tumble, viewCamera, viewClipPlane, viewHeadOn, viewLookAt, viewPlace, viewSet
allObjects, animate, center, fitFactor, namespace, noChildren
| Long name (short name) |
Argument types |
Properties |
|
allObjects(all)
|
boolean
|
|
|
Specifies that all objects are to be fit regardless of the
active list.
|
|
animate(an)
|
boolean
|
|
|
Specifies that the transition between camera positions
should be animated.
|
|
center(c)
|
boolean
|
|
|
Specifies that the camera moves to the center of the
selected object, but does not move the camera closer.
|
|
fitFactor(f)
|
float
|
|
|
Specifies how much of the view should be filled with the
"fitted" items.
|
|
namespace(ns)
|
string
|
|
|
Specifies a namespace that should be excluded. All objects
in the specified namespace will be excluded from the fit
process.
|
|
noChildren(noc)
|
boolean
|
|
|
Specifies that the children of fitted objects should be ignored when determining
the fit.
|
|
|
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
# Position the active camera to view the active objects
cmds.viewFit()
# Position cameraShape-1 to view all objects
cmds.viewFit( 'cameraShape1', all=True )
# Fill 50 percent of the active view with active objects
cmds.viewFit( f=0.5 )
cmds.viewFit( all=True )