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

Synopsis

dollyCtx( object , [alternateContext=boolean], [boxDollyType=string], [centerOfInterestDolly=boolean], [dollyTowardsCenter=boolean], [exists=boolean], [history=boolean], [image1=string], [image2=string], [image3=string], [localDolly=boolean], [name=string], [orthoZoom=boolean], [scale=float], [toolName=string])

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

dollyCtx is undoable, queryable, and editable.

This command can be used to create, edit, or query a dolly context.

Return value

stringThe name of the context

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

Flags

alternateContext, boxDollyType, centerOfInterestDolly, dollyTowardsCenter, exists, history, image1, image2, image3, localDolly, name, orthoZoom, scale, toolName
Long name (short name) Argument types Properties
alternateContext(ac) boolean createquery
Set the ALT+MMB and ALT+SHIFT+MMB to refer to this context.
boxDollyType(bdt) string createqueryedit
Set the behavior of where the camera's center of interest is set to after the box dolly. In surface mode, the center of interest will be snapped to the surface point at the center of the marquee. In bbox mode, the closest bounding box to the camera will be used. Bounding box mode will use the selection mask to determine which objects to include into the calculation.
centerOfInterestDolly(cd) boolean createqueryedit
Set the translate the camera's center of interest. Left and right drag movements with the mouse will translate the center of interest towards or away respectively from the camera. The center of interest can be snapped to objects by using the left mouse button for selection. The default select mask will be used.
dollyTowardsCenter(dtc) boolean createqueryedit
Dolly towards center (if true), else dolly towards point where user clicks in the view.
exists(ex) boolean create
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
history(ch) boolean create
If this is a tool command, turn the construction history on for the tool in question.
image1(i1) string createqueryedit
First of three possible icons representing the tool associated with the context.
image2(i2) string createqueryedit
Second of three possible icons representing the tool associated with the context.
image3(i3) string createqueryedit
Third of three possible icons representing the tool associated with the context.
localDolly(ld) boolean createqueryedit
Dolly with respect to the camera's center of interest. The camera will not pass through the center of interest. Local dolly only applies to perspective cameras.
name(n) string create
If this is a tool command, name the tool appropriately.
orthoZoom(oz) boolean createqueryedit
Zoom orthographic view (if true), else dolly orthographic camera. Default value is true.
scale(s) float createqueryedit
The sensitivity for dollying the camera.
toolName(tn) string createquery
Name of the specific tool to which this command refers.

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

cmds.dollyCtx( 'dollyContext', s=1.0, ac=False, ld=False, cd=False )

cmds.dollyCtx( 'dollyContext', e=True, bdt='surface' )