Skip to content

TimeRulerViewer

Time ruler viewer canvas controller and coordinate tick renderer.

new TimeRulerViewer(
canvas: HTMLCanvasElement,
viewport: IViewportController,
options?: Partial<TimeRulerConfig>): TimeRulerViewer;
ParameterType
canvasHTMLCanvasElement
viewportIViewportController
options?Partial<TimeRulerConfig>

TimeRulerViewer

canvasToTime(x: number): number;

Converts canvas X pixel position to time in seconds.

ParameterType
xnumber

number

ITimeRulerViewer.canvasToTime


destroy(): void;

Disposes the ruler renderer and event listeners.

void

ITimeRulerViewer.destroy


getCanvas(): HTMLCanvasElement;

Returns the bound HTML canvas element.

HTMLCanvasElement

ITimeRulerViewer.getCanvas


getConfig(): ResolvedTimeRulerConfig;

Returns the resolved time ruler configuration options.

ResolvedTimeRulerConfig

ITimeRulerViewer.getConfig


getStatus(): TimeRulerStatus;

Returns the current render status.

TimeRulerStatus

ITimeRulerViewer.getStatus


getViewport(): TimeRulerViewport;

Returns the visible time viewport.

TimeRulerViewport

ITimeRulerViewer.getViewport


getViewportController(): IViewportController;

Returns the bound viewport controller.

IViewportController

ITimeRulerViewer.getViewportController


on<Name>(name: Name, handler: (event: TimeRulerEvents[Name]) => void): () => void;

Subscribes to time ruler events.

Type Parameter
Name extends keyof TimeRulerEvents
ParameterType
nameName
handler(event: TimeRulerEvents[Name]) => void

() => void

ITimeRulerViewer.on


render(): Promise<void>;

Renders the current time ruler viewport asynchronously.

Promise<void>

ITimeRulerViewer.render


requestRender(): void;

Schedules a render on the next animation frame.

void

ITimeRulerViewer.requestRender


setConfig(input: Partial<TimeRulerOptions>): void;

Alias for updateConfig.

ParameterType
inputPartial<TimeRulerOptions>

void

ITimeRulerViewer.setConfig


setViewport(vp: Partial<ViewportConfig>): void;
ParameterType
vpPartial<ViewportConfig>

void


timeToCanvas(time: number): number;

Converts time in seconds to canvas X pixel position.

ParameterType
timenumber

number

ITimeRulerViewer.timeToCanvas


updateConfig(input: Partial<TimeRulerOptions>): void;

Updates configuration options and triggers a re-render.

ParameterType
inputPartial<TimeRulerOptions>

void

ITimeRulerViewer.updateConfig