TimelineGeometry (core) API

Signature

Interface TimelineGeometry

Methods

Name	Signature	Description
`getClip`	`getClip(clipId: string): TimelineClipEntry<string> \| undefined`	Locates a clip and returns its containing track and indexes.
`getClipAtPoint`	`getClipAtPoint(input: ClipHitTestInput): ClipHitTestResult \| null`	Hit-tests timeline clips in viewport coordinates, matching canvas track layout. Clip bodies remain selectable even when their track is locked or the clip is non-editable; edge/body edit regions are only reported when the clip can be edited.
`getClipRect`	`getClipRect(clipId: string, geometry: TimelineInteractionGeometry = {}): ClipViewportRect \| null`	Returns the current viewport rectangle for a clip, matching canvas track layout.
`getClipRects`	`getClipRects(options: TimelineInteractionGeometry = {}): TimelineClipRect<string>[]`	Returns viewport rectangles for every clip in track order. This is the canonical geometry source for DOM clip rendering and custom canvas layers. Pointer hit testing keeps a direct low-allocation path.
`getTrackAtPoint`	`getTrackAtPoint(input: TrackHitTestInput): TimelineTrackHitTestResult<string> \| null`	Hit-tests timeline tracks in viewport coordinates, matching canvas layout.
`getTrackRects`	`getTrackRects(options: TimelineTrackGeometryOptions = {}): TimelineTrackRect[]`	Returns viewport rectangles for every track row in track order.
`getVisibleTimelineClips`	`getVisibleTimelineClips(options: VisibleTimelineClipOptions = {}): VisibleTimelineClip<string>[]`	Returns clips intersecting the current horizontal viewport, plus optional overscan. The returned visible ranges map clipped viewport pixels back to timeline and source-media times so custom renderers can draw cached thumbnails, waveforms, annotations, or heatmaps without duplicating timeline math.