Input Video File

How it fits

Typical backends

Caveats

• I/O contractThe bound slot is a directory whose files are decoded in sorted order; pin it at a single file for a deterministic test.
• LatencyEmission cadence tracks the source's own inter-frame spacing, so clips with constant and with variable frame spacing both play at their authentic timing; rate scales that cadence (greater than one is faster, less than one slower, zero emits as fast as the file decodes). A rate change applies from the current frame onward and never rescales the already-played timeline. A high real-time rate against a high-FPS or high-resolution file can still overwhelm a slow downstream consumer.
• I/O contractOnly regular files are played; an entry that cannot be decoded is logged and skipped, and playback continues with the next file in the playlist.
• I/O contractFrames are emitted in BGR colour order; each timestamp is anchored to host wall-clock at start and then advanced by the source's real inter-frame spacing, giving a monotonic timeline rather than the raw container presentation timestamp.
• Parameter interactionwidth and height left at the sentinel keep the source resolution; setting only one rescales the other axis to preserve aspect ratio, while setting both is an explicit stretch to the exact target.
• State lifetimerepeat loops the playlist when on, which is the default; when off the playlist plays exactly once and the output stream then stays open but silent, with no end-of-stream, until the slot is rebound or repeat is switched on, which plays the playlist again. The bound slot, width, height, repeat, and rate are hot-swappable, and changing the slot restarts from the new directory.
• I/O contractA slot rebound at runtime to an unreadable path is logged and the current playlist is kept; the previous binding keeps playing until a readable path arrives.