Event: Stillout(target1, target2)

Related Events: in, out, stillin
Related Actions: letinside
See also: FKiSS, Events, Actions

stillout(target1, target2)

First defined in: FKiSS2
The stillout event makes a comparison based on the individual bounding rectangles of the two targets. If no bounding rectangle for target1 overlaps a bounding rectangle for target2, regardless of whether or not the rectangles previously overlapped, this event will occur. When the targets are objects or groups, comparison is made using the individual bounding rectangles of the applicable cels, not the single bounding rectangle for the entire object. In other words, if no cel in the target1 object or group still does not overlap any cel in the target2 object or group, the stillout event is triggered.
This event may be triggered by the user picking up an object and dropping it somewhere else or by FKiSS movement.
Use this event to react to collision-detection when pixel-collision detection is not necessary.
Only one stillout event should exist for any target1-target2 pair.

target1

In FKiSS2 to FKiSS3, target1 must be an object number.
In FKiSS4, target1 may be an object number, cel, or group.

target2

In FKiSS2 to FKiSS3, target2 must be an object number.
In FKiSS4, target2 may be an object number, cel, or group.

Example:

;@ stillout(#1, #2)       ; When no cel in object #1 still does not overlap any cel in object #2...
;@   unmap("hathair.cel") ; Hide the hat
;@   map("hair1.cel")     ; and show the hair.