IViewportController

Controls visible time and frequency coordinates across synchronized viewers.

Methods

attachNavigation()

attachNavigation(container: HTMLElement, options?: NavigationOptions): () => void;

Attaches drag, wheel, and pinch gestures on an element.

Parameters

Parameter	Type	Description
container	HTMLElement	DOM element to attach listeners to.
options?	NavigationOptions	Gesture configuration.

Returns

Cleanup function that removes listeners.

() => void

---

destroy()

destroy(): void;

Disposes listeners and event emitters.

Returns

void

---

getTimeBounds()

getTimeBounds(): object;

Returns active outer time limits in seconds.

Returns

object

maxTime

maxTime: number;

minTime

minTime: number;

---

getViewport()

getViewport(): ViewportState;

Returns the current viewport state.

Returns

ViewportState

---

on()

on<K>(event: K, handler: (e: ViewportEvents[K]) => void): () => void;

Subscribes to viewport change and destruction events.

Type Parameters

Type Parameter
K extends keyof ViewportEvents

Parameters

Parameter	Type
event	K
handler	(e: ViewportEvents[K]) => void

Returns

() => void

---

pan()

pan(deltaSeconds: number, source?: string): void;

Shifts visible start and end times by a delta in seconds.

Parameters

Parameter	Type
deltaSeconds	number
source?	string

Returns

void

---

panFrequency()

panFrequency(deltaHz: number, source?: string): void;

Shifts visible frequency range by a delta in Hz.

Parameters

Parameter	Type
deltaHz	number
source?	string

Returns

void

---

panTime()

panTime(deltaSeconds: number, source?: string): void;

Shifts visible start and end times by a delta in seconds.

Parameters

Parameter	Type
deltaSeconds	number
source?	string

Returns

void

---

panTo()

panTo(startTime: number, source?: string): void;

Moves the viewport start to a specific timestamp in seconds.

Parameters

Parameter	Type
startTime	number
source?	string

Returns

void

---

reset()

reset(): void;

Resets viewport to default time and frequency limits.

Returns

void

---

setTimeBounds()

setTimeBounds(minTime: number, maxTime: number): void;

Sets outer time limits in seconds for panning and zooming.

Parameters

Parameter	Type
minTime	number
maxTime	number

Returns

void

---

setViewport()

setViewport(patch: Partial<ViewportConfig>, source?: string): void;

Updates viewport coordinates and notifies listeners.

Parameters

Parameter	Type
patch	Partial<ViewportConfig>
source?	string

Returns

void

---

updateViewport()

updateViewport(patch: Partial<ViewportConfig>, source?: string): void;

Alias for setViewport.

Parameters

Parameter	Type
patch	Partial<ViewportConfig>
source?	string

Returns

void

---

zoom()

zoom(
   factor: number,
   centerTime?: number,
   source?: string): void;

Zooms the time axis around an optional center time in seconds.

Parameters

Parameter	Type
factor	number
centerTime?	number
source?	string

Returns

void

---

zoomBoth()

zoomBoth(
   factor:
  | number
  | {
  frequency: number;
  time: number;
},
   center?: object,
   source?: string): void;

Zooms both time and frequency axes simultaneously.

Parameters

Parameter	Type
factor	| number | { frequency: number; time: number; }
center?	{ frequency?: number; time?: number; }
center.frequency?	number
center.time?	number
source?	string

Returns

void

---

zoomFreq()

zoomFreq(
   factor: number,
   centerFrequency?: number,
   source?: string): void;

Alias for zoomFrequency.

Parameters

Parameter	Type
factor	number
centerFrequency?	number
source?	string

Returns

void

---

zoomFrequency()

zoomFrequency(
   factor: number,
   centerFrequency?: number,
   source?: string): void;

Zooms the frequency axis around an optional center frequency in Hz.

Parameters

Parameter	Type
factor	number
centerFrequency?	number
source?	string

Returns

void

---

zoomTime()

zoomTime(
   factor: number,
   centerTime?: number,
   source?: string): void;

Zooms the time axis around an optional center time in seconds.

Parameters

Parameter	Type
factor	number
centerTime?	number
source?	string

Returns

void