DollyConstraint

This node translates the camera along its look at (or local Z) axis, moving it towards or away from the target. DollyConstraint ensures that the target fits exactly in the camera's screen window and is useful for turntable setup.

See also FOVConstraint.

Connection Type

Connection Name

Function

Input

input

The place in the node graph where you want to apply the camera translation.

 

Control (UI)

Default Value

Function

basePath

N/A

Describes the scene graph location of the camera or light to dolly. The basePath parameter options are available in either the scene graph widget or dropdown menu to the right of the parameter.

For more information, refer to the Scene Graph Location Widget Type in the Common Parameter Widgets.

targetPath

N/A

Sets the location of the object(s) to fit within the field of view. The targetPath parameter options are available by clicking Add Locations or dropdown menu.

For more information, refer to the Scene Graph Location and Locations Widget Types in Common Parameter Widgets.

targetBounds

box

The type of bounds to use for the target object(s):

box - the camera is constrained to fit the bounding box of the target object(s).

sphere - the camera is constrained to fit a sphere that encloses the bounding box of the target objects(s).

angleOffset

0

Sets the angle to add to the FOV in the dolly calculation.

allowMissingTargets

No

When set to Yes, silently ignore the constraint if its target is not in the Scene Graph.

When set to No, produce an error on constraint resolution if the target is missing.

addToConstraintList

No

Adds base path to globals.constraintList at /root/world.

This is only needed for cases in which one constraint depends on another constraint already being evaluated. The globals.constraintList is used to specify the order of evaluation of constraints.

setRelativeTargets

No

Stores target paths in the scene graph constraint definition as paths relative to the base path.

Targets should still be specified as absolute paths in this node's parameters.