FKiSS2 and FKiSS2.1 were so close on each other's heels that it's not always sure which command belongs to which version. The commands are split into the two versions, but a viewer which is supposedly only FKiSS2-capable may recognize some commands marked as FKiSS2.1.
Syntax: downside(object 1,object 2)
Example: downside(#12,#75)
Triggered when the first object is moved below the second object.
Note: UltraKiss does not implement the downside() command.
Related events: upside(), leftside(),
rightside()
Syntax: in(object 1,object 2)
Example: in(#12,#75)
Triggered when the bounding boxes of the two objects overlap after a move, provided they didn't overlap before.
Related events: out(), stillin()
Related actions: letinside()
Syntax: leftside(object 1,object 2)
Example: leftside(#12,#75)
Triggered when the first object is moved to the left of the second object.
Note: UltraKiss does not implement the leftside() command.
Related events: rightside(), upside(),
downside()
Syntax: out(object 1,object 2)
Example: out(#12,#75)
Triggered when the bounding boxes of the two objects no longer overlap after a move, if they overlapped before.
Related events: in(), stillout()
Related actions: letinside()
Syntax: rightside(object 1,object 2)
Example: rightside(#12,#75)
Triggered when the first object is moved to the right of the second object.
Note: UltraKiss does not implement the rightside() command.
Related events: leftside(), upside(),
downside()
Syntax: stillin(object 1,object 2)
Example: stillin(#12,#75)
Triggered when the bounding boxes of the two objects overlap after a move, regardless of whether they overlapped before.
Related events: in(), stillout()
Related actions: letinside()
Syntax: stillout(object 1,object 2)
Example: stillout(#12,#75)
Triggered when the bounding boxes of the two objects no longer overlap after a move, regardless of whether they overlapped before.
Related events: out(), stillin()
Related actions: letinside()
Syntax: upside(object 1,object 2)
Example: upside(#12,#75)
Triggered when the first object is moved above the second object.
Note: UltraKiss does not implement the upside() command.
Related events: downside(), leftside(),
rightside()
Syntax: version(version number)
Example: version(4)
Triggered after begin() when a set is opened, if the version number is of a FKiSS version the viewer supports. The version numbers are: 2 for FKiSS2, 3 for FKiSS2.1, 4 for FKiSS3 and 5 for FKiSS4. (FKiSS and FKiSS1b don't include version(), so there's not much point in giving them a version number.)
Related events: initialize(),
begin()
Syntax: movebyx(object to move,offset object,distance in pixels)
Example: movebyx(#88,#9,100)
Moves the first object to the X coordinate of the second object, plus the distance in pixels, on the current page. If the third value is positive, the first object moves to the right of the second object; if negative, to the left.
Related actions: move(), movebyy(),
moverandx(), letobjectx()
Syntax: movebyy(object to move,offset object,distance in pixels)
Example: movebyy(#88,#9,100)
Moves the first object to the Y coordinate of the second object, plus the distance in pixels, on the current page. If the third value is positive, the first object is moved below the second object; if negative, then above.
Related actions: move(), movebyx(),
moverandy(), letobjecty()
Syntax: moveto(object,X coordinate,Y coordinate)
Example: moveto(#11,50,55)
Moves the object to the given coordinates on the current page.
Related actions: move(), movetorand()
Syntax: music(midi file)
Example: music("theblues.mid"), music("")
Plays a midi, either once or continuously. Issuing music("") stops whatever
music is playing.
Related actions: sound()
Syntax: notify(string in quotes)
Example: notify("This is an error message")
Outputs the text in the string to a dialog or text file, depending on the viewer.
Related actions: debug()
Syntax: apart(celname 1,celname 2)
Example: apart("head.cel","hammer.cel")
Triggered when two cels with visible pixels that overlap are moved so that they no longer overlap.
(A mapped but completely transparent pixel
does qualify as visible if the pixel is not the palette transparent color.)
Related events: apart() under FKiSS4, collide(), out()
Syntax: collide(celname 1,celname 2)
Example: collide("head.cel","hammer.cel")
Triggered when two cels with visible pixels didn't overlap before, but are moved so that they overlap.
(A mapped but completely transparent pixel
does qualify as visible if the pixel if the pixel is not the palette transparent
color.)
Related events: collide() under FKiSS4, apart(), in()
Syntax: iffixed(object,alarm,duration)
Example: iffixed(#1,1,5000)
Sets a timer if an object is fixed (meaning, it has a lock value of 1 or greater).
Related events: alarm()
Related actions: ^iffixed() under FKiSS4, ifnotfixed(),
timer()
Syntax: ifmapped(celname,alarm,duration)
Example: ifmapped("celA.cel",1,5000)
Sets a timer if a cel is mapped.
Related events: alarm()
Related actions: ifmapped() under FKiSS4, ifnotmapped(),
timer()
Syntax: ifmoved(object,alarm,duration)
Example: ifmoved(#1,1,5000)
Sets a timer if an object has moved from its original position on the current page.
Related events: alarm()
Related actions: ^ifmoved() under FKiSS4, ifnotmoved(),
timer()
Syntax: ifnotfixed(object,alarm,duration)
Example: ifnotfixed(#1,1,5000)
Sets a timer if an object is not fixed (meaning, it has a lock value of 0).
Related events: alarm()
Related actions: ^ifnotfixed() under FKiSS4, iffixed(), timer()
Syntax: ifnotmapped(celname,alarm,duration)
Example: ifnotmapped("celA.cel",1,5000)
Sets a timer if a cel is unmapped.
Related events: alarm()
Related actions: ifnotmapped() under FKiSS4, ifmapped(),
timer()
Syntax: ifnotmoved(object,alarm,duration)
Example: ifnotmoved(#1,1,5000)
Sets a timer if an object has not moved from its original position on the current page.
Related events: alarm()
Related actions: ^ifmoved() under FKiSS4, ifnotmoved(),
timer()
Syntax: moverandx(object,minimum value, maximum value)
Example: moverandx(#9,100,200), moverandx(#9,-10,10)
Chooses a random value between the minimum and maximum value and sets the object's X coordinate to that value on the current page. If the random value is positive, the first object moves a random distance to the right; if negative, to the left.
Related actions: move(), moverandy(),
movetorand(), letobjectx()
Syntax: moverandy(object,minimum value, maximum value)
Example: moverandy(#9,100,200), moverandy(#9,-10,10)
Chooses a random value between the minimum and maximum value and sets the object's Y coordinate to that value on the current page. If the random value is positive, the first object moves a random distance downwards; if negative, upwards.
Related actions: move(), moverandx(),
movetorand(), letobjecty()
Syntax: movetorand(object)
Example: movetorand(#33)
Moves the object to a random position on the current page.
Related actions: move(), moveto(),
moverandx(), moverandy()
Syntax: setfix(object, number)
Example: setfix(#26,55)
Sets the lock value of the object to the number given. The setfix()
command can cause an unfix() event to fire.
Related events: unfix(), fixdrop(),
fixcatch()
Related actions: letfix()
Next Document: FKiSS 3
Specifications
Prior Document: FKiSS 1 Specifications
Copyright (c) 2002 WSM Information System Inc.