Events

../../_images/events_1.png

Events are actions that take place during the simulation. To add an event, click the plus button.

The same name can be used for several event entries. When determining if an event is currently active for an agent the list will be worked down until an entry meets the current conditions (the event is active) or until the end of the list (the event is inactive).

For example, in the following case (where the selected object is the agent testing for event “ev”) the three event entries are testing for volumes defined by the three cubes respectively. The event entry outlined in red is tested but found to be inactive. The event entry outlined in green is tested and found to be active. This means an Input > Event node with value “ev” will will output {“None”: 1} (as opposed to {“None”: 0} if the event is inactive). The event entry outlined in black isn’t tested since we already know the event is active.

../../_images/events_5.png

Categories

Time

This event will be triggered if the current frame is within the range chosen.

../../_images/events_2.png

Start

The start frame for the event time range.

End

The end frame for the event time range.

Volume

This event will be triggered if an agent enters the volume of the chosen object.

../../_images/events_3.png

When set to Volume or Time+Volume an event will only be active when the current agent is inside the bounding box of the specified object.

Warning

The center of the bounding box must be at the origin of the object. However, the object can be rotated, translated or scaled in anyway. The suggested way of creating an event volume is to create a cube and move, rotate and/or scale without entering edit mode.

Time + Volume

This event will be triggered if both the time and volume factors are true. The options are the combined of the two above.

../../_images/events_4.png