diff options
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/man/en/input.rst | 16 | ||||
-rw-r--r-- | DOCS/man/en/mpv.rst | 4 | ||||
-rw-r--r-- | DOCS/man/en/options.rst | 61 | ||||
-rw-r--r-- | DOCS/man/en/vf.rst | 39 | ||||
-rw-r--r-- | DOCS/man/en/vo.rst | 10 |
5 files changed, 111 insertions, 19 deletions
diff --git a/DOCS/man/en/input.rst b/DOCS/man/en/input.rst index 339168b3c4..638172289c 100644 --- a/DOCS/man/en/input.rst +++ b/DOCS/man/en/input.rst @@ -79,6 +79,17 @@ seek <seconds> [relative|absolute|absolute-percent|- [default-precise|exact|keyf frame_step Play one frame, then pause. +frame_back_step + Go back by one frame, then pause. Note that this can be very slow (it tries + to be precise, not fast), and sometimes fails to behave as expected. How + well this works depends on whether precise seeking works correctly (e.g. + see the ``--hr-seek-demuxer-offset`` option). Video filters or other video + postprocessing that modifies timing of frames (e.g. deinterlacing) should + usually work, but might make backstepping silently behave incorrectly in + corner cases. + + This doesn't work with audio-only playback. + set <property> "<value>" Set the given property to the given value. @@ -158,6 +169,10 @@ run "<command>" quit [<code>] Exit the player using the given exit code. +quit_watch_later + Exit player, and store current playback position. Playing that file later + will seek to the previous position on start. + sub_add "<file>" Load the given subtitle file. It's not selected as current subtitle after loading. @@ -269,6 +284,7 @@ length length of the current file in seconds avsync last A/V synchronization difference percent-pos x position in current file (0-100) time-pos x position in current file in seconds +time-remaining estimated remaining length of the file in seconds chapter x current chapter number edition x current MKV edition number titles number of DVD titles diff --git a/DOCS/man/en/mpv.rst b/DOCS/man/en/mpv.rst index 9a62333983..2ebdcab506 100644 --- a/DOCS/man/en/mpv.rst +++ b/DOCS/man/en/mpv.rst @@ -90,6 +90,10 @@ p / SPACE q / ESC Stop playing and quit. +Q + Like ``q``, but store the current playback position. Playing the same file + later will resume at the old playback position if possible. + U Stop playing (and quit if ``--idle`` is not used). diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst index f528c3f849..cd1b4ab90a 100644 --- a/DOCS/man/en/options.rst +++ b/DOCS/man/en/options.rst @@ -273,11 +273,6 @@ Some Blu-ray discs contain scenes that can be viewed from multiple angles. Here you can tell mpv which angles to use (default: 1). ---bluray-chapter=<ID> - (Blu-ray only) - Tells mpv which Blu-ray chapter to start the current title from - (default: 1). - --bluray-device=<path> (Blu-ray only) Specify the Blu-ray disc location. Must be a directory with Blu-ray @@ -298,6 +293,12 @@ from slow media, but can also have negative effects, especially with file formats that require a lot of seeking, such as mp4. See also ``--no-cache``. + Note that half the cache size will be used to allow fast seeking back. This + is also the reason why a full cache is usually reported as 50% full. The + cache fill display does not include the part of the cache reserved for + seeking back. Likewise, when starting a file the cache will be at 100%, + because no space is reserved for seeking back yet. + --cache-pause=<no|percentage> If the cache percentage goes below the specified value, pause and wait until the percentage set by ``--cache-min`` is reached, then resume @@ -687,6 +688,13 @@ ``--fstype=fullscreen`` Fixes fullscreen switching on OpenBox 1.x. +--native-fs + (OS X only) + Use OSX's Mission Control's fullscreen feature instead of the custom one + provided by mpv. This can potentially break a lot of stuff like + ``--geometry`` and is disabled by default. On the other hand it provides + a more 'OS X-like' user experience. + --gamma=<-100-100> Adjust the gamma of the video signal (default: 0). Not supported by all video output drivers. @@ -849,13 +857,25 @@ :vda: OSX :crystalhd: Broadcom Crystal HD +--hwdec-codecs=<codec1,codec2,...|all> + Allow hardware decoding for a given list of codecs only. The default is the + special value ``all``, which always allows all codecs. + + This is usually only needed with broken GPUs, where fallback to software + decoding doesn't work properly. + + *EXAMPLE*: + + - ``mpv --hwdec=vdpau --vo=vdpau --hwdec-codecs=h264,mpeg2video`` + Enable vdpau decoding for h264 and mpeg2 only. + --identify Deprecated. Use ``TOOLS/mpv_identify.sh``. --idle Makes mpv wait idly instead of quitting when there is no file to play. Mostly useful in slave mode where mpv can be controlled through input - commands (see also ``--slave``). + commands (see also ``--slave-broken``). --idx Rebuilds index of files if no index was found, allowing seeking. Useful @@ -895,7 +915,7 @@ Number of key presses to generate per second on autorepeat. --no-input-default-bindings - Use the key bindings that mpv ships with by default. + Disable mpv default (builtin) key bindings. --input-keylist Prints all keys that can be bound to commands. @@ -908,7 +928,7 @@ --input-file=<filename> Read commands from the given file. Mostly useful with a FIFO. - See also ``--slave``. + See also ``--slave-broken``. *NOTE*: When the given file is a FIFO mpv opens both ends so you can do several `echo "seek 10" > mp_pipe` and the pipe will stay @@ -1247,6 +1267,12 @@ --name Set the window class name for X11-based video output methods. +--native-keyrepeat + Use system settings for keyrepeat delay and rate, instead of + ``--input-ar-delay`` and ``--input-ar-rate``. (Whether this applies + depends on the VO backend and how it handles keyboard input. Does not + apply to terminal input.) + --avi-ni (Internal AVI demuxer which is not used by default only) Force usage of non-interleaved AVI parser (fixes playback of some bad AVI @@ -1286,6 +1312,10 @@ Do not play sound. With some demuxers this may not work. In those cases you can try ``--ao=null`` instead. +--no-resume-playback + Do not restore playback position from ``~/.mpv/watch_later/``. + See ``quit_watch_later`` input command. + --no-sub Disables display of internal and external subtitles. @@ -1327,6 +1357,9 @@ --osd-back-color=<#RRGGBB>, --sub-text-back-color=<#RRGGBB> See ``--osd-color``. Color used for OSD/sub text background. +--osd-blur=<0..20.0>, --sub-text-blur=<0..20.0> + Gaussian blur factor. 0 means no blur applied (default). + --osd-border-color=<#RRGGBB>, --sub-text-border-color=<#RRGGBB> See ``--osd-color``. Color used for the OSD/sub font border. @@ -1703,9 +1736,6 @@ *EXAMPLE*: - - ``mpv foreman.qcif --demuxer=rawvideo --rawvideo=qcif`` Play the - famous "foreman" sample video. - - ``mpv sample-720x576.yuv --demuxer=rawvideo --rawvideo=w=720:h=576`` Play a raw YUV sample. @@ -1748,6 +1778,15 @@ grayscale output with this option. Not supported by all video output drivers. +--save-position-on-quit + Always save the current playback position on quit. When this file is + played again later, the player will seek to the old playback position on + start. This affects any form of stopping playback (quitting, going to the + next file). + + This behavior is disabled by default, but is always available when quitting + the player with Shift+Q. + --sb=<n> Seek to byte position. Useful for playback from CD-ROM images or VOB files with junk at the beginning. See also ``--start``. diff --git a/DOCS/man/en/vf.rst b/DOCS/man/en/vf.rst index 4e1e0b733b..846d3ffac6 100644 --- a/DOCS/man/en/vf.rst +++ b/DOCS/man/en/vf.rst @@ -367,6 +367,45 @@ pp[=filter1[:option1[:option2...]]/[-]filter2...] Horizontal deblocking on luminance only, and switch vertical deblocking on or off automatically depending on available CPU time. +lavfi=graph[:sws_flags] + Filter video using ffmpeg's libavfilter. + + <graph> + The libavfilter graph string. The filter must have a single video input + pad and a single video output pad. + + See ``https://ffmpeg.org/ffmpeg-filters.html`` for syntax and available + filters. + + *WARNING*: if you want to use the full filter syntax with this option, + you have to quote the filter graph in order to prevent mpv's syntax + and the filter graph syntax from clashing. + + *EXAMPLE*: + + ``-vf lavfi=[gradfun=20:30,vflip]`` + gradfun filter with nonsense parameters, followed by a vflip + filter. (This demonstrates how libavfilter takes a graph and not + just a single filter.) The filter graph string is quoted with + ``[`` and ``]``. This requires no additional quoting or escaping + with some shells (like bash), while others (like zsh) require + additional ``"`` quotes around the option string. + + ``'--vf=lavfi="gradfun=20:30,vflip"'`` + same as before, but uses quoting that should be safe with all + shells. The outer ``'`` quotes make sure that the shell doesn't + remove the ``"`` quotes needed by mpv. + + ``'--vf=lavfi=graph="gradfun=radius=30:strength=20,vflip"'`` + same as before, but uses named parameters for everything. + + <sws_flags> + If libavfilter inserts filters for pixel format conversion, this + option gives the flags which should be passed to libswscale. This + option is numeric and takes a bit-wise combination of ``SWS_`` flags. + + See ``http://git.videolan.org/?p=ffmpeg.git;a=blob;f=libswscale/swscale.h``. + noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]] Adds noise. diff --git a/DOCS/man/en/vo.rst b/DOCS/man/en/vo.rst index 6d64e3062e..6e39e57793 100644 --- a/DOCS/man/en/vo.rst +++ b/DOCS/man/en/vo.rst @@ -320,7 +320,7 @@ opengl sporadic and temporary image corruption. dither-depth=<N|no|auto> - Set dither target depth to N. Default: auto. + Set dither target depth to N. Default: no. no Disable any dithering done by mpv. @@ -474,7 +474,7 @@ opengl-old (no-)force-pbo Always uses PBOs to transfer textures even if this involves an extra copy. Currently this gives a little extra speed with NVidia drivers - and a lot more speed with ATI drivers. May need ``--no-slices`` and + and a lot more speed with ATI drivers. May need the ati-hack suboption to work correctly. (no-)scaled-osd Changes the way the OSD behaves when the size of the window changes @@ -626,12 +626,6 @@ opengl-old slice-height=<0-...> Number of lines copied to texture in one piece (default: 0). 0 for whole image. - - *NOTE*: If YUV colorspace is used (see `yuv` suboption), special rules - apply: If the decoder uses slice rendering (see ``--no-slices``), this - setting has no effect, the size of the slices as provided by the - decoder is used. If the decoder does not use slice rendering, the - default is 16. sw Continue even if a software renderer is detected. |