diff options
author | wm4 <wm4@nowhere> | 2012-08-07 22:24:50 +0200 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2012-08-07 22:24:50 +0200 |
commit | 97810cbfbd408ce0908f291d085a8156068a18c3 (patch) | |
tree | 6d9ed20fb40d2cbdc65d779cd65eae6468b7f9aa /DOCS | |
parent | d1783c6f7a83432a08473a2f71fbdcfc800aad6f (diff) | |
download | mpv-97810cbfbd408ce0908f291d085a8156068a18c3.tar.bz2 mpv-97810cbfbd408ce0908f291d085a8156068a18c3.tar.xz |
manpage: document per-file options
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/man/en/mplayer.rst | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/DOCS/man/en/mplayer.rst b/DOCS/man/en/mplayer.rst index 02db237819..3c1ffe43f1 100644 --- a/DOCS/man/en/mplayer.rst +++ b/DOCS/man/en/mplayer.rst @@ -312,6 +312,48 @@ the *XXX* option or if *XXX* is compiled in. | `mplayer --ao pcm:file=%\`expr length "$NAME"\`%"$NAME" test.avi` +Per-file options +---------------- + +When playing multiple files, any option given on the command line usually +affects all files. Example: + +`mplayer --a file1.mkv --b file2.mkv --c` + ++-----------+-------------------------+ +| File | Active options | ++===========+=========================+ +| file1.mkv | --a --b --c | ++-----------+-------------------------+ +| file2.mkv | --a --b --c | ++-----------+-------------------------+ + +Also, if any option is changed at runtime (via slave commands), they aren't +reset when a new file is played. + +Sometimes, it's useful to change options per-file. This can be achieved by +adding the special per-file markers `--{` and `--}`. (Note that you must +escape these on some shells.) Example: + +`mplayer --a file1.mkv --b --\\\{ --c file2.mkv --d file3.mkv --e --\\\} file4.mkv --f` + ++-----------+-------------------------+ +| File | Active options | ++===========+=========================+ +| file1.mkv | --a --b --f | ++-----------+-------------------------+ +| file2.mkv | --a --b --f --c --d --e | ++-----------+-------------------------+ +| file3.mkv | --a --b --f --c --d --e | ++-----------+-------------------------+ +| file4.mkv | --a --b --f | ++-----------+-------------------------+ + +Additionally, any file-local option changed at runtime is reset when the current +file stops playing. If option ``-c`` is changed during playback of `file2.mkv`, +it's reset when advancing to `file3.mkv`. This only affects file-local options. +The option ``--a`` is never reset here. + CONFIGURATION FILES =================== |