Go to: Synopsis. Return value. Flags. Python examples.
cameraSet([active=boolean], [appendTo=boolean], [camera=name], [clearDepth=boolean], [deleteAll=boolean], [deleteLayer=boolean], [insertAt=boolean], [layer=uint], [name=name], [numLayers=boolean], [objectSet=name], [order=int])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
cameraSet is undoable, queryable, and editable.
This command manages camera set nodes. Camera sets allow the users
to break a single camera shot into layers. Instead of drawing all
objects with a single camera, you can isolate the camera to only
focus on certain objects and layer another camera into the viewport
that draws the other objects. The situation to use camera sets
primarily occurs when building stereoscopic scenes. For example, a
set of stereo parameters may make the background objects divergent
beyond the tolerable range of the human perceptual system. However,
you like the settings because the main focus is in the foreground
and the depth is important to the visual look of the scene. You can
use camera sets to break apart the shot into a foreground stereo
camera and background stereo camera. The foreground stereo camera
will retain the original parameters; however, it will only focus on
the foreground elements. The background stereo camera will have a
different set of stereo parameters and will only draw the
background element. Camera sets can be viewed using the stereo
viewer and are currently only designed to work with stereo camera
rigs.
string |
The new cameraSet node (when in create mode) |
In query mode, return type is based on queried flag.
active, appendTo, camera,
clearDepth, deleteAll, deleteLayer, insertAt, layer,
name, numLayers, objectSet, order
Long name (short name) |
Argument types |
Properties |
active(a) |
boolean |
|
|
Gets / sets the active camera layer. |
|
appendTo(atl) |
boolean |
|
|
Append a new camera and/or object set to then end of the
cameraSet layer list. This flag cannot be used in conjunction with
insert flag. Additionally, it requires the camera and/or objectSet
flag to be used. |
|
insertAt(ins) |
boolean |
|
|
Inserts the specified camera and/or object set at the specified
layer. This flag cannot be used in conjunction with the append
flag. Additionally, this flag requires layer and camera (or
objectSet) flag to be used. |
|
objectSet(os) |
name |
|
|
Set/get the objectSet for a particular layer. When in query
mode, you must specify the layer with the layer flag. |
|
camera(cam) |
name |
|
|
Set/get the camera for a particular layer. When in query mode,
You must specify the layer with the layer flag. |
|
deleteLayer(d) |
boolean |
|
|
Delete a layer from the camera set. You must specify the layer
using the layer flag. |
|
deleteAll(da) |
boolean |
|
|
name(n) |
name |
|
|
Gets or sets the name for the created camera set. |
|
numLayers(nl) |
boolean |
|
|
Returns the number of layers defined in the specified
cameraSet |
|
order(o) |
int |
|
|
Set the order in which a particular layer is processed. This
flag must be used in conjunction with the layer flag. |
|
layer(l) |
uint |
|
|
Specifies the layer index to be used when accessing layer
information |
|
clearDepth(cd) |
boolean |
|
|
Specifies if the drawing buffer should be cleared before
beginning the draw for that layer. |
|
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
# create some objects
cmds.sphere(n='sphere1')
cmds.cone(n='cone1')
# create a set with whatever is currently active
cmds.select( 'sphere1', 'cone1')
newSet2 = cmds.sets()
cmds.loadPlugin( "stereoCamera", qt=True )
from maya.app.stereo import stereoCameraRig
rig = stereoCameraRig.createStereoCameraRig('StereoCamera')
# Create a new cameraSet node.
cmds.cameraSet()
# Add the cam & object set to the set
cmds.cameraSet( 'cameraSet1', edit=True, appendTo=True, cam=rig[0], objectSet=newSet2 )