Viewerframe mode is a software architecture pattern where a separate buffer or object (the viewerframe) holds a processed frame ready for display, inspection, or further transformation.
Key characteristics:
Common implementations:
| Metric | Immediate Mode | Viewerframe Mode (double-buffered) | |--------|---------------|-------------------------------------| | Render-to-display latency | ~1 ms (vsync dependent) | ~16.7 ms (1 frame at 60 Hz) | | Tearing artifacts | Possible | None | | Frame drop during inspection | Yes (render skips) | No | | Memory overhead | Minimal | ~8 MB per buffer (RGB 1080p) | | CPU usage for copy | 0% | <1% on modern CPU | | Suitable for frame-accurate editing | No | Yes | viewerframe mode better
Deep feature: aspect ratio override independent of scaling mode.
Example: source is 4:3, viewer is 16:9, user chooses FIT + “stretch to 16:9” → results in distortion unless anamorphic flag is set.
Also, subtitle and OSD placement must follow the effective frame mode – otherwise subs drawn in letterbox bars will be cut off in FILL mode. Viewerframe mode is a software architecture pattern where
Before we establish why viewerframe mode is better, we must define what it is. Traditional media players operate within a standard window—a rectangular box surrounded by browser chrome, toolbars, tabs, and status bars. When you toggle "full screen," that box expands to cover your entire monitor, hiding everything else.
Viewerframe Mode sits in the elegant middle ground. It is a specialized display state that removes all navigational clutter (address bars, bookmarks, OS taskbars) not by expanding to the edge of the monitor, but by creating a seamless, floating canvas. It persists the content at an optimal aspect ratio while stripping away every visual element that does not contribute directly to the media itself. Common implementations:
Think of it as the difference between looking at a photograph in a heavy, ornate gold frame on a cluttered wall versus viewing that same photograph in a sleek, minimalistic, backlit frame in a dark room. The content doesn't change, but your perception of it does entirely.