Surface Arrive Behavior

Create panel > Helpers > Object Type rollout > Crowd > Setup rollout > New button > Surface Arrive Behavior

Select a Crowd object. > Modify panel > Setup rollout > New button > Surface Arrive Behavior

The Surface Arrive behavior is similar to the Seek behavior in that it lets you specify an object or objects as a stationary or moving target for delegates. The principal difference is that you can use the Approach settings to specify an intermediate target. After reaching this location, the delegates will then make their final approach to the ultimate target surface. An example would be birds flying over a row of telephone poles, and then each one dropping to land on top of a different pole.

Procedure

To use the Surface Arrive behavior

  1. Add a Surface Arrive behavior to the Crowd object.

  2. Add an object or objects to serve as the target surface to the scene.

    Note: If you use multiple objects, delegates will arrive at the surface of the closest object.

  3. In the Surface Arrive Behavior rollout, use the None button or the Multiple Selection button to designate the one or more target objects.

  4. Change the default settings as desired.

  5. Use Behavior Assignments to assign the behavior to a delegate or team.

Interface

Surface Arrive Behavior rollout

None (label): Specifies a single target. Click this button, and then click the target object in the viewport. The target name then appears on the button.

If you've selected multiple targets using Multiple Selection (see next item), the word Multiple appears on the button. To see which objects are designated as targets, click the Multiple Selection button.

Multiple Selection: Opens the Select dialog to let you designate multiple targets. When you have more than one target, you can set delegates to move toward the closest target in the group, or to a computed average of the target positions.

Arrival group

Specifies three aspects of the Surface Arrive behavior: Rate, Speed, and Distance.

Disable After Arriving: When on, turns off the Surface Arrive behavior after the delegate arrives at the surface. Default=on.

Rate: A multiple of the delegate's Max Accel setting that specifies the acceleration with which it will try to arrive. A value of 1.0 means to use the full acceleration of the delegate. Default=0.5.

Deviation: Adds random variation to the to the Rate setting. The actual deviation is calculated by multiplying the Deviation setting by a random number between -1 and 1, and then multiplying the result by the Rate setting. Default=0.0.

Speed: The speed at which to arrive, relative to the speed of the target. Default=0.0.

Deviation: Adds random variation to the Speed setting. The actual deviation is calculated by multiplying the Deviation setting by a random number between -1 and 1, and then multiplying the result by the Speed setting. Default=0.0.

Distance: The maximum radial distance from the target within which the behavior will be active. Until the delegate is within this radius, the behavior has no influence. Default=9999999.0.

Deviation: Adds random variation to the to the Distance setting. The actual deviation is calculated by multiplying the Deviation setting by a random number between -1 and 1, and then multiplying the result by the Distance setting. Default=0.0.

Location group

Offset: Specifies a consistent distance from the calculated arrival point, based on the surface normal, for the delegate to use. Default=0.0.

Facing: When on, the delegate will try to arrive only at points on triangles on the surface that are facing it. Default=off.

Random: The software chooses a random point on the target surface as the arrival point. When using the Random option, the software chooses arrival points for delegates once, at the beginning of the simulation. This is the default choice

Closest: The software chooses the closest point on the target surface as the arrival point. If Closest is chosen, but Every Frame is off, the software chooses arrival points for delegates once, at the beginning of the simulation.

Every Frame: When on, the software chooses arrival points for delegates at every frame. Available only when Closest is chosen. Default=off.

Every Frame is useful when the target object is rotating during the animation, but requires more time for calculation.

Display Offset: When on, shows the Offset distance as lines emanating from each vertex in the surface object, perpendicular to the surface.

Approach group

The Height and Descent settings together specify the path the delegate will take for its arrival. They allow for a wide range of behavior, from soft, gradual landings to direct helicopter-type descents.

In both cases, the actual deviation is calculated by multiplying the Deviation setting by a random number between -1 and 1, and multiplying the result by the relevant value.

Height: Specifies a distance from the arrival point along its face normal. This is the point that the delegate will go to first before descending to the arrival point.

Deviation: Adds random variation to the to the Height setting. The actual deviation is calculated by multiplying the Deviation setting by a random number between -1 and 1, and then multiplying the result by the Height setting.

Descent Start: Specifies the distance between the delegate and the arrival point at which the descent should start.

Note: Be careful that Descent Start is set high enough that the delegate won't overshoot when descending because its speed is too high and deceleration too low, compared to when it should start descending.

Deviation: Adds random variation to the to the Descent Start setting. The actual deviation is calculated by multiplying the Deviation setting by a random number between -1 and 1, and then multiplying the result by the Descent Start setting.

Off This Normal: When on, lets you set an approach vector to specify the angle at which the final approach occurs. Default=off.

X/Y/Z: Use these settings to specify the final approach vector in world coordinates. For example, the vector specified by the default settings of X=0, Y=0, Z=1 means that the delegates will approach the target along the vertical world axis.

Seed: Affects the random numbers used to calculate the Deviation settings. For similar randomization among different Surface Arrive behaviors, use the same Seed value.

Color Swatch: Shows the color used to draw the target icon. Default=dark blue.

Display Target: Enables display of the target icon, which appears during the solution when a new interim goal is calculated for the delegate. Interim goals are created when using the Approach group settings. Default=on.

Target Scale: Specifies the overall size of the target icon. Default=5.0.

 

 

 


Comments