regcldmissile( sectionname, priority )

Parameters

_result

Not set.

Descriptions

Registers the section specified by sectionname to handle missile collision events. The missile collision event handler is called if no higher priority events are occurring when a robot collides with an energy missile.  

Missile collision events are triggered by the _cldmissile variable. When a missile collision event handler completes, the _cldmissile variable is automatically set to false causing the event to end. When a robot collides with any obstacle the following system variables are updated to provide information about the collision: _cldbearing, _cldheading, _cldenergy, _cldid, and _cldteamid. Robots only track information about the most recent collision event, causing all _cld variables to be reset for each collision. 

The priority value should be a whole number, decimals are ignored. Lower numbers are higher priority. The highest priority possible is 1. If two events registered with the same priority occur at the same time, it is unspecified which event handler will be called. 

When an event handler is registered or re-registered, it becomes immediately active. Use the cldmissileevents command to temporarily deactivate a registered event handler.

See Also

cldmissileevents, _cldmissile, _cldbearing, _cldheading, _cldenergy, _cldid, _cldteamid, event summary