Class AnalysisSession

Opens a source for analysis. The returned session owns the source.

Keyframe timestamps (seconds) whose GOP overlaps the range, resolved lazily through the container. Useful for a contact sheet that lands on real I-frames, which decode without a GOP walk.

Decodes a frame for each requested timestamp and returns a stable copy of each. Timestamps are sorted so the sink decodes each packet at most once; a timestamp with no frame is skipped rather than yielding a gap.

One frame per requested timestamp, in the order asked for, null where no frame covers it, so a caller pairing frames with its own indices keeps the gaps attributable. Timestamps that climb decode in a single pass over the track: one seek and GOP walk for the whole set.

A consumer that finishes with each frame before pulling the next holds one frame of memory; extractFrames holds the whole set.