EventListclass
eventList.t[149], eventListItem.t[301]
An “event list.” This is a general-purpose type of script that lets you define the scripted events separately from the Script object.
The script is driven by a list of values; each value represents one step of the script. Each value can be a single-quoted string, in which case the string is simply displayed; a function pointer, in which case the function is invoked without arguments; another Script object, in which case the object’s doScript() method is invoked; a property pointer, in which case the property of ‘self’ (the EventList object) is invoked with no arguments; or nil, in which case nothing happens.
This base type of event list runs through the list once, in order, and then simply stops doing anything once we pass the last event.
class EventList : Script
Superclass Tree (in declaration order)
EventList
Script
` object`
Subclass Tree
EventList
CyclicEventList
ExternalEventList
RandomEventList
ShuffledEventList
StopEventList
SyncEventList
Global Objects
(none)
Summary of Properties
` curScriptState eventList eventListLen resetEachCycle `
Summary of Methods
` addItem advanceState construct doScript doScriptEvent resetList scriptDone `
Inherited from Script :
` getScriptState `
Properties
curScriptStateOVERRIDDEN
by default, start at the first list element
eventList
the list of events
eventListLen
cached length of the event list
resetEachCycle
Flag, do we want to reset the list each time we’ve run through all our items? By default we don’t, but this might ba en appropriate place to call resetList() if we do want to call it. Note that this is in any case irrelevant on the base EventList class but may be relevant on some of its subclaases (CyclicEventList, RandomEventList and ShuffledEventList).
Methods
addItem (item, prop)
Add an item to prop (usually eventList) property of this EventList, where prop should be supplied as a property pointer,
advanceState ( )
advance to the next state
construct (lst)
no description available
doScript ( )OVERRIDDEN
process the next step of the script
doScriptEvent (evt)
carry out one script event
resetList ( )
Game code can call this method to remove all EventListItems that have been finished with (isDone = true) from the eventList of this EventList. This probably isn’t necessary unless there are likely to be a large number of such items slowing down execution.
scriptDone ( )
Perform any end-of-script processing. By default, we advance the script to the next state.
Some scripts might want to override this. For example, a script could be driven entirely by some external timing; the state of a script could vary once per turn, for example, or could change each time an actor pushes a button. In these cases, invoking the script wouldn’t affect the state of the event list, so the subclass would override scriptDone() so that it does nothing at all.
Adv3Lite Library Reference Manual
Generated on 15/03/2023 from adv3Lite version 1.6.1