Repel_Behavior :ReferenceTarget

Repel_Behavior - superclass: ReferenceTarget; super-superclass:MAXWrapper - 11:0 - classID: #(2016560612, 1924862305) 
 

   

Character Studio - Quick Navigation

Constructor

Repel_Behavior ... RepelBehavior ... 

Properties

<Repel_Behavior>.name String Default: "Repel" 

Get/set the name of the behavior.

   

<Repel_Behavior>.repulsionSources ArrayParameter Default: #() -- node array 

See Notes below.

   

<Repel_Behavior>.targetComp Integer Default: 0 

0-Closest Source : Each delegate is repelled by the closest of the assigned sources. Use this to have delegates assigned a single Repel behavior move away from sources in different directions.

1-Average of Sources : All delegates head to a common point determined by averaging all sources' locations.

   

<Repel_Behavior>.repelMethod Integer Default: 0 -- animatable 

0-Angle: Applies a force to the delegate based on the angle between the delegate's current direction and the direction it would need to take in order to be moving directly away from the source. If the behavior's Weight is set to 1, the delegate will be given a force that points directly away from the source. If Weight is set to .5, the force will bisect the angle between its current direction and the direction opposite that of the source.

1-Force: Always applies a force directly away from the source, but at different magnitudes. If the behavior's Weight is 1, the magnitude of the force will be the average speed. If the Weight is .5, the magnitude of the force will be half the average speed.

   

<Repel_Behavior>.useRadiiBoolean Default: True 

When true, the behavior applies only to delegates closer to the target than the Outer Distance value.

   

<Repel_Behavior>.innerRadiusFloat Default: 0.0 -- animatable 

The distance from the target at which the force is applied at full strength.

   

<Repel_Behavior>.outerRadius Float Default: 10.0 - animatable 

The distance from the target at which the force begins to be applied.

   

<Repel_Behavior>.falloff Float Default: 2.0 -- animatable 

   

<Repel_Behavior>.forceColor Color Default: (color 255 0 255) 

The color used to draw the Repel force vector.

   

<Repel_Behavior>.showRadii Boolean Default: True 

When true, the radii are displayed when the force is active.

   

<Repel_Behavior>.displayForce Boolean Default: True 

When true, force exerted on the delegate(s) by the Repel behavior is drawn in the viewports as a vector during the simulation solution. If Use Radii is turned on, the radii are also displayed when the force is active.

NOTE:

You can perform the following MAXScript operations:

   

deleteitem <array> <itemnumber><array> = #(item,item...)<array> = append <array> <item>

on all of the properties containing an ArrayParamater of objects listed below. You can also undo/redo these operations.

   

<Repel_Behavior>.repulsionSources 

The following MAXScript operations will cause Crowd to fail, either right away or later:

NEVER set a Crowd/Behavior ArrayParameter element to undefined.

See Also