This is an automated email from the git hooks/post-receive script. Git pushed a commit to branch master in repository ffmpeg.
commit f7fbb1260e1df3389143cfbbc603008f4230ee48 Author: Jun Zhao <[email protected]> AuthorDate: Fri Aug 28 10:31:54 2026 +0800 Commit: Jun Zhao <[email protected]> CommitDate: Fri Sep 11 22:31:03 2026 +0000 doc: document the -stereo3d option Describe the CLI values, that the option writes layout metadata rather than rearranging pixels, and how MP4/MOV/Matroska consume the resulting side data. Signed-off-by: Jun Zhao <[email protected]> --- doc/ffmpeg.texi | 42 ++++++++++++++++++++++++++++++++++++++++++ doc/muxers.texi | 23 +++++++++++++++++++++++ 2 files changed, 65 insertions(+) diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi index 1cbb1ccbdd..a312fd31b6 100644 --- a/doc/ffmpeg.texi +++ b/doc/ffmpeg.texi @@ -1590,6 +1590,48 @@ If used together with @option{-vcodec copy}, it will affect the aspect ratio stored at container level, but not the aspect ratio stored in encoded frames, if it exists. +@item -stereo3d[:@var{stream_specifier}] @var{layout} (@emph{output,per-stream}) +Set stereoscopic 3D layout metadata on the output stream. This does +@emph{not} rearrange pixels; use @option{-vf stereo3d} for that. + +The metadata is stored as @code{AV_PKT_DATA_STEREO3D} side data on the +output stream. Muxers that already consume that side data will write the +corresponding container boxes or elements, including: + +@itemize +@item +MP4 Google spatial-media @code{st3d} (requires @option{-strict unofficial}) +@item +QuickTime MOV Apple @code{vexu} eyes (no @code{st3d}) +@item +Matroska @code{StereoMode}; @option{-stereo3d} overrides the +@code{stereo_mode} metadata tag, including a value inherited from the +input +@end itemize + +@var{layout} is case-insensitive. The following values are accepted: + +@table @samp +@item 2d +@itemx mono +Monoscopic video. +@item sbs +@itemx sbsl +@itemx side by side +Side-by-side, left eye on the left. +@item tb +@itemx tbl +@itemx top and bottom +Top-and-bottom, left eye on top. +@end table + +Inverted layouts such as @samp{sbsr} are not supported. An empty stream +specifier applies to video streams only and is ignored for audio and +other types. An explicit specifier on a non-video stream (for example +@option{-stereo3d:a}) is an error. + +Recommended form: @option{-stereo3d:v sbsl}. + @item -display_rotation[:@var{stream_specifier}] @var{rotation} (@emph{input,per-stream}) Set video rotation metadata. diff --git a/doc/muxers.texi b/doc/muxers.texi index 99584e2b8d..c28a94c57f 100644 --- a/doc/muxers.texi +++ b/doc/muxers.texi @@ -377,6 +377,24 @@ on MPEG-4 Part 14 format with a few incompatible variants, used to play files on PlayStation devices. @end table +@subsection Stereoscopic 3D + +When the output stream has stereoscopic 3D side data (see the +@option{-stereo3d} option), these muxers write: + +@itemize +@item +MP4: Google spatial-media @code{st3d} and Apple @code{vexu} can be +written for supported metadata with @option{-strict unofficial}. +Stricter compliance levels skip these boxes. Warnings are logged +when stereoscopic or spherical side data is present, naming +@code{st3d} or @code{sv3d}, respectively; there is no corresponding +compliance warning for @code{vexu}. Monoscopic layouts do not +produce an @code{eyes} box. +@item +MOV: Apple @code{vexu} eyes only. @code{st3d} is not written. +@end itemize + @subsection Fragmentation The @samp{mov}, @samp{mp4}, and @samp{ismv} muxers support @@ -2867,6 +2885,11 @@ French). @item stereo_mode Set stereo 3D video layout of two views in a single video track. +The @option{-stereo3d} option overrides existing stereoscopic side data +and @code{stereo_mode} metadata for the selected output stream. +Otherwise, stream-level @code{stereo_mode} metadata takes priority over +global metadata, and stereoscopic side data is used when neither tag is +present. The following values are recognized: @table @samp -- To stop receiving notification emails like this one, please contact [email protected]. _______________________________________________ ffmpeg-cvslog mailing list -- [email protected] To unsubscribe send an email to [email protected]
