Packageimpression.simulation
Interfacepublic interface ISequencer extends flash.events.IEventDispatcher

ISequencer defines the minimum functionality required by the SimulationPlayer for an object that performs sequencing.

sequencing--sometimes called driving--is the process of setting the simulation state through a series of programmatic commands. Note that, although the commands are provided to the ISequencer object as a single String object, the specific format of the commands and the mechanism used to place the simulation in the desired state is project- and simulation- specific. The sample runtime included in the AS3 DevKit shows only one possible approach.



Public Methods
 MethodDefined By
  
cancel():void
Cancels any sequencing currently in progress.
ISequencer
  
sequence(simulation:ISimulation, sequenceData:String):void
Begins sequencing the simulation.
ISequencer
Events
 Event Summary Defined By
  Dispatch when sequencing has completed.ISequencer
  Dispatch when an error occurs.ISequencer
Method Detail
cancel()method
public function cancel():void

Cancels any sequencing currently in progress.

sequence()method 
public function sequence(simulation:ISimulation, sequenceData:String):void

Begins sequencing the simulation. Implementers must dispatch the SimulationObjectEvent.INITIALIZATION_COMPLETE event when sequencing has completed.

Parameters

simulation:ISimulation — The simulation to sequence.
 
sequenceData:String — Sequence data.

Event Detail
initializationComplete Event
Event Object Type: impression.events.SimulationObjectEvent
SimulationObjectEvent.type property = impression.events.SimulationObjectEvent.INITIALIZATION_COMPLETE

Dispatch when sequencing has completed.

The SimulationObjectEvent.INITIALIZATION_COMPLETE constant defines the value of the type property of a simulation object initialization complete event object. This event has the following properties:
PropertyValue
bubblesfalse
cancelablefalse; there is no default behavior to cancel.
currentTargetThe object that is actively processing the Event object with an event listener.
targetThe object that raised the event.
simulationObjectError Event  
Event Object Type: impression.events.SimulationObjectErrorEvent
SimulationObjectErrorEvent.type property = impression.events.SimulationPlayerErrorEvent.ERROR

Dispatch when an error occurs.

The SimulationPlayerErrorEvent.ERROR constant defines the value of the type property of an error event object. This event has the following properties:
PropertyValue
bubblesfalse
cancelablefalse; there is no default behavior to cancel.
currentTargetThe object that is actively processing the Event object with an event listener.
targetThe object that raised the event.
sbThe Storyboard object assigned to the target.
loadingIndicates whether or not the event occurred during the loading phase of the storyboard.
messageThe message associated with the error.
errorDataAdditional data associated with the error.
sourceThe type of object that initially raised the error.