Class MultiTouchFSM

The FSM that defines a multi-touch interaction (that works like a DnD)

Hierarchy

Constructors

  • Creates the FSM.

    Parameters

    • nbTouch: number

      The number of touches of the interaction

    • totalReinit: boolean

      Defines whether a cancellation of one of the fsms, reinits all the fsms.

    • logger: Logger

      The logger to use for this interaction

    • dataHandler: TouchDnDFSMHandler

      The data handler the FSM will use

    • movementRequired: boolean = false

      Whether the DnD starts after the touch point has begun moving (default) or as soon as the screen is touched. The latter is used for the MultiTouch interaction.

    Returns MultiTouchFSM

Properties

_currentState: OutputState
_dataHandler: undefined | TouchDnDFSMHandler
_log: boolean
_started: boolean

Goes with 'startingState'. It permits to know whether the FSM has started, ie whether the 'starting state' has been reached.

_states: State[]

The states that compose the finite state machine.

currentStatePublisher: Subject<[OutputState, OutputState]>
currentSubFSM: undefined | FSM

The current sub FSM in which this FSM is while running.

currentTimeout: undefined | TimeoutTransition

The current timeout in progress.

eventsToProcess: Event[]

The events still in process. For example when the user press key ctrl and scroll one time using the wheel of the mouse, the interaction scrolling is finished but the event keyPressed 'ctrl' is still in process. At the end of the interaction, these events are re-introduced into the state machine of the interaction for processing.

handlers: FSMHandler[]

The handlers to be notified on FSM state changes.

initState: InitState

The initial state of the FSM

inner: boolean

Defines whether the FSM is an inner FSM (ie, whether it is included into another FSM as a sub-FSM transition).

logger: Logger
startingState: State

By default an FSM triggers its 'start' event when it leaves its initial state. In some cases, this is not the case. For example, a double-click interaction is an FSM that must trigger its start event when the FSM reaches... its terminal state. Similarly, a DnD must trigger its start event on the first move, not on the first press. The goal of this attribute is to identify the state of the FSM that must trigger the start event. By default, this attribute is set with the initial state of the FSM.

Accessors

  • get dataHandler(): undefined | T
  • Returns undefined | T

  • set dataHandler(dataHandler): void
  • Parameters

    • dataHandler: undefined | T

    Returns void

  • set log(log): void
  • Logs (or not) information about the execution of the FSM.

    Parameters

    • log: boolean

    Returns void

  • get states(): readonly State[]
  • The set of the states that compose the FSM. This returns a copy of the real set.

    Returns readonly State[]

Methods

  • Adds a standard state to the state machine.

    Parameters

    • name: string

      The name of the state to add.

    • startingState: boolean = false

      States whether the new state is the one that starts the FSM.

    Returns StdState

    The created state.

  • Jobs to do when a timeout transition is executed. Because the timeout transition is based on a separated thread, the job done by this method must be executed in the UI thread. UI Platforms must override this method to do that.

    Returns void

Generated using TypeDoc