Bongo Document Options

Bongo Document Options Tab


Previous article: Looping

Change Bongo document settings

Command: "Options" - switch to "Bongo" on the Document Properties.





Animate inside instances (blocks)

Governs whether animation data on objects inside instances (blocks) will be animated. This can be rather slow, so this is off by default. Using this option, it is possible to create animated blocks that can be reused in the model. More info about this feature here.

Use proxy for multiple objects transform

When multiple objects are transformed in animate mode, they each receive their own pivot and transform around this. This can be counter-intuitive in many situations, especially when using groups.

Using this option, Bongo will create a point object (a proxy point) and link all of the transformed objects as children to this object. The transformation will then be applied to the proxy instead of the children.

Hierarchical animation can be used to create proxy objects. Proxy objects control other objects. Proxy objects are sometimes referred to as controller objects.

A good example of a use for proxy objects is animating a group. In Rhino, a group is not a single object, the objects simply all select together. This can create problems when animating a group because each object in the group receives its own pivot and transformations act around that.

Features in Bongo that aid in setting up proxy situations include:

  • The BongoPlaceProxyPoint command places a proxy point object and then prompts you to select children for the proxy point object.
  • Check the Use proxy for multiple object transforms option. Proxy points are created automatically when multiple objects are animated for the first time.
  • If multiple objects that have the same proxy point as their parent are transformed in animate mode, the transformation is applied to the parent proxy point rather than the selected objects. The same is true if children and their parent are transformed - only the proxy object will receive the transformation keyframes.

Despite these features, groups can still be cumbersome to animate in complex models. In these cases, we recommend using Rhino blocks to create a single object from a group before animating.


To create a pivot for a group of objects

  1. Create a proxy point at the required pivot.
  2. Make the group the child of the point.
  3. Apply the transformations to the point object rather than the group.


Use smart object dragging

Looks at the object selection set while dragging and recording a keyframe to see if the movement can be reached by applying the keyframe only to a parent instead of the whole selection.


Show reticle for animated viewports

By default, Bongo displays information inside animated viewports including the center of the view, the view aspect and the current slider position.  Turn the display of this information off with this option.


Inverse Kinematics



Enables or disables the Inverse Kinematics feature.



By default, Bongo precalculates the IK chain every time you make a change to it. Turn the precalucation off with this option.


Precalculation samples

Determines how many samples are calculated before solving an IK case. More info from here.


Display IK information in viewport

By default, when an IK chain is created Bongo the join types are drawn in the viewport. Use this option to enable disable these markings.


Position goal error

Specifies how accurately IK motion constraints are adhered to.

Position tolerance is absolute.

More info from here.


Rotation goal error

Specifies how accurately IK rotation constraints are adhered to. The rotation tolerance is absolute. More info from here.


Scaling goal error

Specifies how accurately IK scaling constraints are adhered to. Scaling tolerance is relative. More info from here.



Object Pivots


Display constraint heading

Controls the display of the Constraint Heading Indicator.


Display hierarchy links

Parents are linked to their children by dotted lines between their pivots.  Use this option to enable or disable these lines.


Enable object pivot display

Controls the display of object pivots for all animated objects.  Object pivots can also be turned off on a per-object basis using the command “BongoPivotDisplay”


Always show pivot for non-animated children

By default, children with no animation data do not display an object pivot.  This option enables pivot display for these objects.

Show decoration of hidden objects

Displays Bongo pivot, pivot path, parent-child links, constraint headings, IK information, and other Bongo object notation when objects are hidden.

Pivot size

Controls the pivot size in model units. 



Animation Preview




Plays the preview in a continuous loop. When this checkbox is cleared, the preview will stop at the end of the animation limits.


Run Forwards/Run Backwards/Run Forwards then Backwards

Changes the direction of the animation during preview.


Timeline length in seconds

Controls the amount of time it takes the slider to move from the start extent marker to the end extend marker during animation preview.  Does not affect output to video – see “Bongo Render Animation Dialog” for more information on  controlling the output speed.


Show pivot/view paths


Never show pivots/view paths

Enables or disables the pivots/view paths showing globally.


Show keyframes and frame markers as points

Displays points for keyframes and tick marks during pivot path display.



Displays dots for keyframes and tick marks during pivot path display.


Draw point/dot every X ticks

Determines how often points/dots are drawn on the paths.


Next article: Global options

© 2021   Created by Scott Davidson.   Powered by

Badges  |  Report an Issue  |  Terms of Service