FKiSS Actions

See also: FKiSS, General Syntax, Data Types, If-Endif Structure, Shortcuts, HINTs, Events

Description

An Action is a command which is immediately executed. It could change a cel from mapped to unmapped or change its transparency. It could move an object to a new location or change the value of a variable. Actions cover a wide-range of functionality.
All actions must belong to an FKiSS event.

Alarms

These actions set up alarms, which are events triggered when certain conditions occur, such as a timer going off.
timer randomtimer lettimer
iffixed ifmapped ifmoved
ifnotfixed ifnotmapped ifnotmoved
exitevent

Labels

These actions use labels that mark a block of actions to execute that block of actions from several different places.
gosub gosubrandom
goto gotorandom
repeat exitloop
exitevent

Mapping

These actions control the visibility of a cel. A mapped cel is visible while an unmapped cel is not visible.
map unmap altmap
letmapped ifmapped ifnotmapped

Movement and Position

These actions control the position of a target and allow an action to move a cel in response to an event.
move moveto
movebyx movebyy
movetorand moverandx moverandy
restrictx restricty
letinitx letinity
letobjectx letobjecty
letcatch

Message

These actions show messages to the user or trigger a shell command.
debug notify shell

Sound and Music

These actions control music and sound.
music sound

Translucency

These actions control the translucency of a target.
transparent lettransparent

Attachment

These actions control the process of attaching or detaching an object to another object.
attach glue detach
letchild letparent letsibling

Group Frame

These actions change the frame that is displayed for a group of cels.
setframe letframe

Arithmetic

These actions perform arithmetic operations on a variable.
add sub mul div mod
random

Object/Cel State

These actions control or read the state of an object.
setkcf letkcf
setfix letfix ghost
transparent lettransparent letinitx
letinity letmapped letobjectx
letobjecty letwidth letheight
letcollide letinside
letcatch

Conditionals

These actions control the flow of execution through a block of actions (see If-Endif Structure).
ifequal ifnotequal
ifgreaterthan iflessthan
else
elseifequal elseifnotequal
elseifgreaterthan elseiflessthan
endif

Keyboard

These actions read the keyboard.
letkey letkeymap

Mouse

These actions read the position of the mouse cursor.
letmousex letmousey

Environment

These actions affect the environment, set, or play field.
changecol changeset
letpal letset
letcatch

Viewport

These actions control the size of the window and view on that window.
windowsize viewport

Miscellaneous

These actions fall in no particular category.
nop quit exitevent

Pool Values

These actions control access to value pools.
valuepool savevalue loadvalue deletevalue

Variables

These actions affect variables.

Arithmetic

add sub mul div mod
random

Assignment

let letcatch letchild
letcollide letfix letframe
letheight letinitx letinity
letinside letkeymap letkey
letmapped letmousex letmousey
letobjectx letobjecty letpal
letparent letset letsibling
lettimer lettransparent letwidth