Event: Apart(target1, target2)

Related Events: collide
Related Actions: letcollide
See also: FKiSS, Events, Actions

apart(target1, target2)

First defined in: FKiSS2
The apart event makes a comparison based on the individual pixels of the two targets. If no pixel for target1 overlaps a pixel for target2 and pixels were previously overlapped, this event is triggered.
This event may be triggered by the user picking up an object and dropping it somewhere else or by FKiSS movement.
Since pixel-by-pixel comparison is more task-intensive, only use this event to react to collision-detection when pixel-collision detection is necessary.
Only one apart event should exist for any target1-target2 pair.

target1

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

target2

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

Example:

;@ apart("this.cel", "that.cel") ; If "this.cel" no longer overlaps "that.cel",
;@   sound("whoosh.wav")         ; then play a sound.