@ue-too/board / index / ZoomControlStateMachine

類別: ZoomControlStateMachine

定義於: packages/board/src/camera/camera-mux/animation-and-lock/zoom-control-state-machine.ts:436

State machine controlling zoom input flow and animations.

備註

This state machine manages the lifecycle of zoom operations:

User input handling: Accepts or blocks user zoom gestures based on state
Animation control: Manages smooth zoom-to animations
Object tracking: Supports locking camera to follow objects with zoom

State transitions:

ACCEPTING_USER_INPUT → TRANSITION: Start animation (initiateTransition)
ACCEPTING_USER_INPUT → LOCKED_ON_OBJECT: Lock to object (lockedOnObjectZoom...)
TRANSITION → ACCEPTING_USER_INPUT: User input interrupts animation
LOCKED_ON_OBJECT → ACCEPTING_USER_INPUT: User input unlocks

Helper methods simplify event dispatching without memorizing event names.

範例

typescript

const stateMachine = createDefaultZoomControlStateMachine(cameraRig);

// User zooms - accepted in ACCEPTING_USER_INPUT state
const result = stateMachine.notifyZoomByAtInput(1.2, { x: 400, y: 300 });

// Start animation - transitions to TRANSITION state
stateMachine.notifyZoomToAtWorldInput(2.0, { x: 1000, y: 500 });

// User input now may interrupt animation

參閱

createDefaultZoomControlStateMachine for factory function

Extends

TemplateStateMachine<ZoomEventPayloadMapping, BaseContext, ZoomControlStates, ZoomControlOutputMapping>

建構函式

new ZoomControlStateMachine(states, initialState, context): ZoomControlStateMachine

定義於: packages/board/src/camera/camera-mux/animation-and-lock/zoom-control-state-machine.ts:442

參數

states

Record<ZoomControlStates, State<ZoomEventPayloadMapping, BaseContext, ZoomControlStates, ZoomControlOutputMapping>>

initialState

ZoomControlStates

context

BaseContext

回傳

ZoomControlStateMachine

覆寫了

TemplateStateMachine< ZoomEventPayloadMapping, BaseContext, ZoomControlStates, ZoomControlOutputMapping >.constructor

屬性

_context

protected _context: BaseContext

定義於: packages/being/dist/interface.d.ts:384

繼承自

TemplateStateMachine._context

_currentState

protected _currentState: ZoomControlStates | "INITIAL" | "TERMINAL"

定義於: packages/being/dist/interface.d.ts:382

繼承自

TemplateStateMachine._currentState

_happensCallbacks

protected _happensCallbacks: (args, context) => void[]

定義於: packages/being/dist/interface.d.ts:387

參數

args

["unlock"] | [string, unknown] | ["userZoomByAtInput", ZoomByAtInputPayload] | ["userZoomToAtInput", ZoomToAtInputPayload] | ["transitionZoomByAtInput", ZoomByAtInputPayload] | ["transitionZoomToAtInput", ZoomToAtInputPayload] | ["transitionZoomByAtCenterInput", ZoomByPayload] | ["transitionZoomToAtCenterInput", ZoomToAtInputPayload] | ["transitionZoomToAtWorldInput", ZoomToAtInputPayload] | ["lockedOnObjectZoomByAtInput", ZoomByAtInputPayload] | ["lockedOnObjectZoomToAtInput", ZoomToAtInputPayload] | ["initiateTransition"]

context

BaseContext

回傳

void

繼承自

TemplateStateMachine._happensCallbacks

_initialState

protected _initialState: ZoomControlStates

定義於: packages/being/dist/interface.d.ts:389

繼承自

TemplateStateMachine._initialState

_stateChangeCallbacks

protected _stateChangeCallbacks: StateChangeCallback<ZoomControlStates>[]

定義於: packages/being/dist/interface.d.ts:386

繼承自

TemplateStateMachine._stateChangeCallbacks

_states

protected _states: Record<States, State<EventPayloadMapping, Context, States, EventOutputMapping>>

定義於: packages/being/dist/interface.d.ts:383

繼承自

TemplateStateMachine._states

_statesArray

protected _statesArray: ZoomControlStates[]

定義於: packages/being/dist/interface.d.ts:385

繼承自

TemplateStateMachine._statesArray

_timeouts

protected _timeouts: number | undefined

定義於: packages/being/dist/interface.d.ts:388

繼承自

TemplateStateMachine._timeouts

存取器

currentState

Getter 簽章

get currentState(): States | "INITIAL" | "TERMINAL"

定義於: packages/being/dist/interface.d.ts:399

回傳

States | "INITIAL" | "TERMINAL"

繼承自

TemplateStateMachine.currentState

possibleStates

Getter 簽章

get possibleStates(): States[]

定義於: packages/being/dist/interface.d.ts:401

回傳

States[]

繼承自

TemplateStateMachine.possibleStates

states

Getter 簽章

get states(): Record<States, State<EventPayloadMapping, Context, States, EventOutputMapping>>

定義於: packages/being/dist/interface.d.ts:402

回傳

Record<States, State<EventPayloadMapping, Context, States, EventOutputMapping>>

繼承自

TemplateStateMachine.states

方法

happens()

呼叫簽章

happens<K>(...args): EventResult<ZoomControlStates, K extends keyof ZoomControlOutputMapping ? ZoomControlOutputMapping[K<K>] : void>

定義於: packages/being/dist/interface.d.ts:395

型別參數

K

K extends keyof ZoomEventPayloadMapping

參數

args

...EventArgs<ZoomEventPayloadMapping, K>

回傳

EventResult<ZoomControlStates, K extends keyof ZoomControlOutputMapping ? ZoomControlOutputMapping[K<K>] : void>

繼承自

TemplateStateMachine.happens

呼叫簽章

happens<K>(...args): EventResult<ZoomControlStates, unknown>

定義於: packages/being/dist/interface.d.ts:396

型別參數

K

K extends string

參數

args

...EventArgs<ZoomEventPayloadMapping, K>

回傳

EventResult<ZoomControlStates, unknown>

繼承自

TemplateStateMachine.happens

initateTransition()

initateTransition(): EventResult<ZoomControlStates, void>

定義於: packages/board/src/camera/camera-mux/animation-and-lock/zoom-control-state-machine.ts:533

Initiates transition to TRANSITION state.

回傳

EventResult<ZoomControlStates, void>

備註

Forces state change to begin animation or transition sequence. Called when starting programmatic camera movements.

notifyZoomByAtInput()

notifyZoomByAtInput(delta, at): EventResult<ZoomControlStates, ZoomControlOutputEvent>

定義於: packages/board/src/camera/camera-mux/animation-and-lock/zoom-control-state-machine.ts:468

Notifies the state machine of user zoom input around an anchor point.

參數

delta

number

Zoom delta (multiplier)

at

Point

Anchor point for zoom

回傳

EventResult<ZoomControlStates, ZoomControlOutputEvent>

Event handling result with output event

備註

Dispatches userZoomByAtInput event. Accepted in ACCEPTING_USER_INPUT and TRANSITION states.

notifyZoomByAtInputAnimation()

notifyZoomByAtInputAnimation(delta, at): EventResult<ZoomControlStates, ZoomControlOutputEvent>

定義於: packages/board/src/camera/camera-mux/animation-and-lock/zoom-control-state-machine.ts:485

Initiates a zoom animation around an anchor point.

參數

delta

number

Zoom delta (multiplier)

at

Point

Anchor point for zoom

回傳

EventResult<ZoomControlStates, ZoomControlOutputEvent>

Event handling result

備註

Dispatches transitionZoomByAtInput event, starting a zoom animation.

notifyZoomToAtCenterInput()

notifyZoomToAtCenterInput(targetZoom, at): EventResult<ZoomControlStates, ZoomControlOutputEvent>

定義於: packages/board/src/camera/camera-mux/animation-and-lock/zoom-control-state-machine.ts:502

Initiates a zoom animation to target level around center anchor.

參數

targetZoom

number

Target zoom level

at

Point

Anchor point for zoom

回傳

EventResult<ZoomControlStates, ZoomControlOutputEvent>

Event handling result

備註

Dispatches transitionZoomToAtCenterInput event for center-anchored zoom animation.

notifyZoomToAtWorldInput()

notifyZoomToAtWorldInput(targetZoom, at): EventResult<ZoomControlStates, ZoomControlOutputEvent>

定義於: packages/board/src/camera/camera-mux/animation-and-lock/zoom-control-state-machine.ts:519

Initiates a zoom animation to target level around world anchor.

參數

targetZoom

number

Target zoom level

at

Point

World anchor point for zoom

回傳

EventResult<ZoomControlStates, ZoomControlOutputEvent>

Event handling result

備註

Dispatches transitionZoomToAtWorldInput event for world-anchored zoom animation.

onHappens()

onHappens(callback): void

定義於: packages/being/dist/interface.d.ts:398

參數

callback

(args, context) => void

回傳

void

繼承自

TemplateStateMachine.onHappens

onStateChange()

onStateChange(callback): void

定義於: packages/being/dist/interface.d.ts:397

參數

callback

StateChangeCallback<ZoomControlStates>

回傳

void

繼承自

TemplateStateMachine.onStateChange

reset()

reset(): void

定義於: packages/being/dist/interface.d.ts:391

回傳

void

繼承自

TemplateStateMachine.reset

setContext()

setContext(context): void

定義於: packages/being/dist/interface.d.ts:400

參數

context

BaseContext

回傳

void

繼承自

TemplateStateMachine.setContext

start()

start(): void

定義於: packages/being/dist/interface.d.ts:392

回傳

void

繼承自

TemplateStateMachine.start

switchTo()

switchTo(state): void

定義於: packages/being/dist/interface.d.ts:394

參數

state

ZoomControlStates | "INITIAL" | "TERMINAL"

回傳

void

繼承自

TemplateStateMachine.switchTo

wrapup()

wrapup(): void

定義於: packages/being/dist/interface.d.ts:393

回傳

void

繼承自

TemplateStateMachine.wrapup

類別: ZoomControlStateMachine ​

備註 ​

範例 ​

參閱 ​

Extends ​

建構函式 ​

建構函式 ​

參數 ​

states ​

initialState ​

context ​

回傳 ​

覆寫了 ​

屬性 ​

_context ​

繼承自 ​

_currentState ​

繼承自 ​

_happensCallbacks ​

參數 ​

args ​

context ​

回傳 ​

繼承自 ​

_initialState ​

繼承自 ​

_stateChangeCallbacks ​

繼承自 ​

_states ​

繼承自 ​

_statesArray ​

繼承自 ​

_timeouts ​

繼承自 ​

存取器 ​

currentState ​

Getter 簽章 ​

回傳 ​

繼承自 ​

possibleStates ​

Getter 簽章 ​

回傳 ​

繼承自 ​

states ​

Getter 簽章 ​

回傳 ​

繼承自 ​

方法 ​

happens() ​

呼叫簽章 ​

型別參數 ​

K ​

參數 ​

args ​

回傳 ​

繼承自 ​

呼叫簽章 ​

型別參數 ​

K ​

參數 ​

args ​

回傳 ​

繼承自 ​

initateTransition() ​

回傳 ​

備註 ​

notifyZoomByAtInput() ​

參數 ​

delta ​

at ​

回傳 ​

備註 ​

notifyZoomByAtInputAnimation() ​

參數 ​

delta ​

at ​

回傳 ​

備註 ​

notifyZoomToAtCenterInput() ​

參數 ​

類別: ZoomControlStateMachine

備註

範例

參閱

Extends

建構函式

建構函式

參數

states

initialState

context

回傳

覆寫了

屬性

_context

繼承自

_currentState

繼承自

_happensCallbacks

參數

args

context

回傳

繼承自

_initialState

繼承自

_stateChangeCallbacks

繼承自

_states

繼承自

_statesArray

繼承自

_timeouts

繼承自

存取器

currentState

Getter 簽章

回傳

繼承自

possibleStates

Getter 簽章

回傳

繼承自

states

Getter 簽章

回傳

繼承自

方法

happens()

呼叫簽章

型別參數

K

參數

args

回傳

繼承自

呼叫簽章

型別參數

K

參數

args

回傳

繼承自

initateTransition()

回傳

備註

notifyZoomByAtInput()

參數

delta

at

回傳

備註

notifyZoomByAtInputAnimation()

參數

delta

at

回傳

備註

notifyZoomToAtCenterInput()

參數