Action: Altmap(target)

Related Actions: map, unmap, letmapped, ifmapped, ifnotmapped
See also: FKiSS, Events, Actions

altmap(target)

First defined in: FKiSS1
The altmap action causes target to become mapped if it is unmapped and unmapped if it is mapped on all sets in which it is present. When target is an object or group, mapping is switched based on the map-state of the individual cels. In other words, altmap toggles the visible state of all cels in target.
Mapped cels may be clickable and visible (although ghost and transparent can also affect this). Unmapped cels are unclickable and invisible.

target

In FKiSS1 to FKiSS3, target may be an object number or cel.
In FKiSS4, target may be an object number, cel, group, or a variable representing an object number.

Example:

;@ altmap("doll.cel") ; Toggle visibility of "doll.cel".
;@ altmap(#5)         ; Toggle visibility of all cels in object #5.
;@ altmap(!MyGroup)   ; Toggle visibility of all cels in group !MyGroup.
;@ altmap(VarObj)     ; Toggle visibility of all cels that are in the object identified by the variable VarObj.