Interface MediaRenderer

Flips playback without the caller first reading which way it is going, so a frame presented between the read and the call cannot invert the result. Rejects when the play it decides on fails.

Lands on mediaTime and resolves once the frame there is presented.

Moves the playhead for a gesture that is still moving, such as a timeline drag between pointer down and up. The frame that answers it may be an approximation; seek is what lands the released position exactly.

Re-read detections and redraw the currently presented media frame.

Encodes the media frame that is currently presented.

The renderer keeps decode and render ownership: the returned image is a copy of the presented media pixels taken before encoding starts, so a frame presented while the encoder runs cannot change the result.

Explicit renders issued under the render-on-change policy, which only a media source that pushes presented frames runs under: the count moves when something on screen changed, so a paused, untouched renderer holds it still. It is null when the renderer pulls samples instead, because Pixi's ticker then paints every animation frame and no count describes that, so a null here is an answer rather than a failure.

Span and per-frame readiness of the prepared annotation window, for instruments; null when the scene free-runs on the ticker or no window exists, so a null here is an answer rather than a failure.

Returns the label rectangle exactly as laid out by the renderer.

Coordinates are relative to the renderer container and already include fit, pan, zoom, screen-stable label sizing, and media-edge clamping.