Browse docs
Image sequences
Inspect image recordings directly with EpisodeFrameStack. It chooses the
nearest frame in each camera and keeps the decoded image visible while its
replacement loads.
Timestamped
Scrub one tile to compare all three cameras. Each displays its nearest frame and that frame's local wall-clock time.



Code TimestampedSpec.tsx
Derived span
Supply ascending Unix timestamps in seconds. The earliest and latest frames
across all sources define the span; there is no duration prop. Controlled
time and hover callbacks use seconds from the span's start.
Use one clock across sources. Keep sequences without recorded times in a separate stack.
Invalid timestamp → frame index
Use timestamp: 0 for images with unknown capture times. Frames are then
spaced by index and labeled FRAME n / N.


Code FrameIndexSpec.tsx
Timestamps before January 1, 2000, non-finite values, and unrepresentable dates also count as unrecorded.
Bounding-box overlays
Scrub past frames 30–75: the cup detection disappears outside its recorded interval.


Code BBoxOverlaySpec.tsx
Overlays stay with the displayed image while the next frame loads. Preserve
original frameIndex values when subsampling so detections still match. See
Media overlays for coordinate and time lookup.
Frame source shape
Without frameIndex, lookup uses the image's array position. Valid timestamps
render as YYYY-MM-DD HH:MM:SS in the reader's timezone. title and subtitle
label the camera and its source.
Props
| Prop | Type | Default | Purpose |
|---|---|---|---|
sources | FrameImageSource[] | required | Camera sequences in display order. |
time | number | null | null | Seconds from the sequence start. Local hover takes precedence; null shows first frames without a cursor. |
onHover | (t: number) => void | — | Receive seconds from the sequence start. |
onHoverEnd | () => void | — | Receive pointer leave from the whole grid. |
activeId | string | null | — | Controlled camera with the accent ring. |
defaultActiveId | string | null | null | Initial camera when uncontrolled. |
onActiveChange | (id: string) => void | — | Receive entry into a camera tile. |
columns / gap | number | 3 / 6 | Column count and gap in pixels. |
showRecTimestamp | boolean | true | Show the recorded time or frame index. |
showLabel | boolean | true | Show the camera title and subtitle. |
showResolution | boolean | true | Show the displayed image's dimensions. |
showOverlays | boolean | true | Show source annotation layers. |
className | string | — | Root CSS classes. |