Repository navigation
Media Formats and 3D Modes
Codec, container, stereo layout and display mode are four different things.
Video terminology put them in one cupboard and then wondered why nobody could find the teaspoons.
A filename tells you very little about how its images are encoded. An MKV can contain MVC, ordinary H.264, HEVC or something else entirely; a stereo pair can be carried as a multiview bitstream or packed into a single rectangular frame. SyLC separates those questions before deciding how to decode and present the result.
| Layer | Question | Examples |
|---|---|---|
| Container | What file or disc structure holds the streams? | MKV, MP4, MOV, M2TS, SSIF, BDMV, ISO |
| Codec | How is each coded video stream compressed? | H.264/AVC, HEVC, VC-1, MPEG-2 |
| Stereo representation | Where is the second eye? | MVC dependent view, MV-HEVC layer, SBS/TAB half-frame, or nowhere because the source is 2D |
| Presentation | How should the two decoded eyes reach your display? | Frame-packed MultiView, SBS, TAB, Dual Projector, Glasses |
Changing the presentation does not rewrite the source. Choosing Side-by-Side for an MVC file is like pouring the same wine into a different glass; no grape is re-encoded in the process.
MVC is an extension of H.264 defined in Annex H. The base view is a complete H.264 picture stream. The dependent view saves space by predicting not only from its own history but also across the view boundary.
That dependency is why a conventional H.264 decoder cannot simply be run twice. It often decodes the base view successfully and ignores the dependent one — technically a picture, spiritually a betrayal.
SyLC's MVC route:
- finds and separates base/dependent access units;
- feeds them to one extended
edge264session; - maintains per-view decoded-picture buffers;
- pairs completed views by picture order;
- presents only synchronized eye pairs.
Common sources are MVC-in-MKV, Blu-ray .ssif, and BDMV backups where base and dependent streams live in separate .m2ts files.
MV-HEVC carries multiple HEVC views as signalled layers. SyLC asks the native avcodec path for both views, pairs them strictly by presentation timestamp, applies the stream's eye-order signalling and promotes the result into the same two-eye rendering path used by MVC.
Apple spatial video is the best-known member of this family, but the underlying idea is pleasantly old-fashioned: two views, one coordinated bitstream, considerably newer paperwork.
Packed stereo stores both eyes inside one conventional frame:
- Side-by-Side (SBS): eyes are arranged horizontally.
- Top-Bottom (TAB): eyes are arranged vertically.
- Full-SBS / Full-TAB: each eye retains full spatial resolution; the packed canvas doubles one dimension.
- Half-SBS / Half-TAB: each eye is squeezed into half of the stored canvas and expanded for display.
SyLC splits the decoded canvas into views and preserves their display aspect. Full-SBS eyes are letterboxed into the frame-pack slot when necessary, never stretched merely to make the rectangle stop complaining.
H.264 2D travels through edge264; native HEVC uses the avcodec-backed path; other codecs can fall back to libmpv. The output remains 2D unless the optional synthesis pipeline is enabled.
See Real-time 2D→3D AI pipeline for the important distinction between decoding authored stereo and synthesizing a second eye.
| Input | Preferred route | Honest fallback |
|---|---|---|
| H.264 MVC | Native demuxer + extended edge264
|
Base-view 2D only if real MVC decode cannot be established |
| H.264 2D / packed H.264 | Native or libavformat demuxer + edge264
|
libmpv when the native route rejects the stream |
| HEVC / MV-HEVC | In-process avcodec source, including 8/10-bit and paired views | libmpv for compatible non-native cases |
| VC-1, MPEG-2 and other codecs | libmpv | Clear playback failure if the bundled stack cannot open it |
Fallback is a reliability policy, not an attempt to hide missing stereo. SyLC distinguishes “this source is 2D” from “a 3D source lost one eye,” because those are very different evenings.
SyLC combines container metadata, codec probing, bitstream signatures and dimensions:
- MVC-in-MKV can be recognized from
mvcC, the MVC codec identifier or the subset SPS before media clusters begin. -
.ssifis treated as a Blu-ray 3D candidate even when generic probing becomes unhelpful. - MV-HEVC uses multiview signalling and returns paired view IDs.
- Packed stereo uses layout metadata plus full/half dimension thresholds.
- BDMV sources are resolved through their playlists rather than guessed from the largest filename.
The on-screen badge reports names such as MultiView 3D, Full-SBS 3D, SBS 3D, Full-TAB 3D or TAB 3D. Treat it as the decoded verdict, not a marketing subtitle.
Once SyLC owns a valid eye pair, the presentation selector decides where those eyes go.
The normal authored-stereo presentation. For MVC and MV-HEVC it keeps the two views separate through decode and sends them to the detached frame-packed output path.
Repack the two decoded eyes into a display-compatible SBS or TAB surface. Useful for televisions, projectors, capture devices and software that expect a conventional packed signal.
Creates two eye windows and routes one synchronized view to each. The left output acts as the timing leader; the two windows replace the ordinary detached frame-pack surface so the same frame is not uploaded twice for sport.
Produces the full-SBS glasses/output signal from the current eye pair. Source layout does not need to be SBS; SyLC already did the difficult part by this stage.
Some sources are left-first, some right-first, and some metadata is less decisive than its authors hoped. SyLC uses signalled or remembered order where possible and lets you override it.
Symptoms of reversed eyes include:
- foreground objects appearing behind the screen;
- backgrounds pushing forward;
- immediate visual discomfort despite otherwise sharp frames;
- a strong sense that the film has become hostile architecture.
Swap the eye order before adjusting depth strength, convergence or the display. A geometric inversion cannot be cured by making it smaller; it merely becomes a quieter geometric inversion.
Blu-ray PGS subtitles are streamed, labelled from CLPI language metadata when the raw stream lacks tags, and rendered on every active surface. Authored per-GOP subtitle depth is retained so captions occupy a sensible stereo plane instead of being stapled indiscriminately to your nose.
The same subtitle state follows the embedded view, detached output, Dual Projector windows and SyLC Cast. A subtitle toggle should be a content decision, not a scavenger hunt across renderers.
| What you observe | Most likely interpretation |
|---|---|
| MKV plays as 2D and no MultiView badge appears | The file may contain only the MVC base view or be an ordinary H.264 encode |
| Image contains two squeezed views before 3D is enabled | Packed SBS or TAB source |
Apple spatial .mov exposes two HEVC views |
MV-HEVC |
BDMV has STREAM/SSIF and a 3D playlist |
Blu-ray MVC source |
| BDMV is authored 3D but SSIF files are missing | Split base/dependent backup; SyLC attempts dual-file MVC pairing |
For disc-specific details, continue with Blu-ray, ISO and disc archiving.
Start
Watch & preserve
Under the hood