DreamLake
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.

2026-05-29 14:23:07
front/camera/front/image_compressed
2026-05-29 14:23:07
wrist/camera/wrist/image_compressed
2026-05-29 14:23:07
top/camera/top/image_compressed
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.

FRAME 1 / 106
front/camera/front/image_compressed
FRAME 1 / 106
wrist/camera/wrist/image_compressed
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.

FRAME 1 / 106
frontsynthetic detections
FRAME 1 / 106
topno overlay
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

ts
interface FrameImage {
  timestamp: number; // Unix seconds; 0 means no recorded time
  image: string; // remote, data:, or blob: URL
  alt?: string; // image alternative text
  frameIndex?: number;
}
interface FrameImageSource {
  id: string;
  frames: FrameImage[];
  title?: string;
  subtitle?: string;
  poster?: string;
  overlays?: MediaOverlay[];
}

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

PropTypeDefaultPurpose
sourcesFrameImageSource[]requiredCamera sequences in display order.
timenumber | nullnullSeconds 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.
activeIdstring | null—Controlled camera with the accent ring.
defaultActiveIdstring | nullnullInitial camera when uncontrolled.
onActiveChange(id: string) => void—Receive entry into a camera tile.
columns / gapnumber3 / 6Column count and gap in pixels.
showRecTimestampbooleantrueShow the recorded time or frame index.
showLabelbooleantrueShow the camera title and subtitle.
showResolutionbooleantrueShow the displayed image's dimensions.
showOverlaysbooleantrueShow source annotation layers.
classNamestring—Root CSS classes.