2015-05-22 19:00:13 +02:00
|
|
|
Introduction
|
|
|
|
============
|
|
|
|
|
2016-01-23 11:41:28 +01:00
|
|
|
mpv provides access to its internals via the following means:
|
2015-05-22 19:00:13 +02:00
|
|
|
|
|
|
|
- options
|
|
|
|
- commands
|
|
|
|
- properties
|
|
|
|
- events
|
|
|
|
|
|
|
|
All of these are important for interfacing both with end users and API users
|
|
|
|
(which include Lua scripts, libmpv, and the JSON IPC). As such, they constitute
|
|
|
|
a large part of the user interface and APIs.
|
|
|
|
|
|
|
|
This document lists changes to them. New changes are added to the top.
|
|
|
|
|
|
|
|
Interface changes
|
|
|
|
=================
|
|
|
|
|
|
|
|
::
|
|
|
|
|
2016-06-29 18:10:15 +02:00
|
|
|
--- mpv 0.18.1 ---
|
|
|
|
- deprecate --heartbeat-cmd
|
2016-06-25 12:39:08 +02:00
|
|
|
--- mpv 0.18.0 ---
|
2016-04-21 22:15:17 +02:00
|
|
|
- now ab-loops are active even if one of the "ab-loop-a"/"-b" properties is
|
|
|
|
unset ("no"), in which case the start of the file is used if the A loop
|
2016-05-23 18:43:49 +02:00
|
|
|
point is unset, and the end of the file for an unset B loop point
|
2016-04-30 14:25:23 +02:00
|
|
|
- deprecate --sub-ass=no option by --ass-style-override=strip
|
|
|
|
(also needs --embeddedfonts=no)
|
2016-05-04 16:55:26 +02:00
|
|
|
- add "hwdec-interop" and "hwdec-current" properties
|
|
|
|
- deprecated "hwdec-active" and "hwdec-detected" properties (to be removed
|
2016-06-25 12:39:08 +02:00
|
|
|
in mpv 0.20.0)
|
2016-05-04 17:37:54 +02:00
|
|
|
- choice option/property values that are "yes" or "no" will now be returned
|
|
|
|
as booleans when using the mpv_node functions in the client API, the
|
|
|
|
"native" property accessors in Lua, and the JSON API. They can be set as
|
|
|
|
such as well.
|
2016-05-20 23:21:43 +02:00
|
|
|
- the VO opengl fbo-format sub-option does not accept "rgb" or "rgba"
|
|
|
|
anymore
|
2016-06-10 14:35:09 +02:00
|
|
|
- all VO opengl prescalers have been removed (replaced by user scripts)
|
2016-02-29 20:55:44 +01:00
|
|
|
--- mpv 0.17.0 ---
|
|
|
|
- deprecate "track-list/N/audio-channels" property (use
|
|
|
|
"track-list/N/demux-channel-count" instead)
|
2016-03-09 23:34:04 +01:00
|
|
|
- remove write access to "stream-pos", and change semantics for read access
|
2016-03-18 22:03:04 +01:00
|
|
|
- Lua scripts now don't suspend mpv by default while script code is run
|
2016-03-20 19:48:55 +01:00
|
|
|
- add "cache-speed" property
|
2016-03-24 19:24:40 +01:00
|
|
|
- rename --input-unix-socket to --input-ipc-server, and make it work on
|
|
|
|
Windows too
|
2016-04-03 13:55:37 +02:00
|
|
|
- change the exact behavior of the "video-zoom" property
|
2016-04-10 17:26:32 +02:00
|
|
|
- --video-unscaled no longer disables --video-zoom and --video-aspect
|
|
|
|
To force the old behavior, set --video-zoom=0 and --video-aspect=0
|
2016-01-20 17:12:08 +01:00
|
|
|
--- mpv 0.16.0 ---
|
|
|
|
- change --audio-channels default to stereo (use --audio-channels=auto to
|
|
|
|
get the old default)
|
2016-01-20 17:14:04 +01:00
|
|
|
- add --audio-normalize-downmix
|
|
|
|
- change the default downmix behavior (--audio-normalize-downmix=yes to get
|
|
|
|
the old default)
|
2016-01-25 20:24:41 +01:00
|
|
|
- VO opengl custom shaders must now use "sample_pixel" as function name,
|
|
|
|
instead of "sample"
|
2016-01-25 21:35:39 +01:00
|
|
|
- change VO opengl scaler-resizes-only default to enabled
|
2016-01-27 21:07:17 +01:00
|
|
|
- add VO opengl "interpolation-threshold" suboption (introduces new default
|
|
|
|
behavior, which can change e.g. ``--video-sync=display-vdrop`` to the
|
|
|
|
worse, but is usually what you want)
|
2016-01-26 15:12:42 +01:00
|
|
|
- make "volume" and "mute" properties changeable even if no audio output is
|
|
|
|
active (this gives not-ideal behavior if --softvol=no is used)
|
|
|
|
- add "volume-max" and "mixer-active" properties
|
2016-02-04 23:01:15 +01:00
|
|
|
- ignore --input-cursor option for events injected by input commands like
|
|
|
|
"mouse", "keydown", etc.
|
2015-12-21 22:04:53 +01:00
|
|
|
--- mpv 0.15.0 ---
|
|
|
|
- change "yadif" video filter defaults
|
2015-11-13 22:48:32 +01:00
|
|
|
--- mpv 0.14.0 ---
|
2015-11-29 13:07:04 +01:00
|
|
|
- vo_opengl interpolation now requires --video-sync=display-... to be set
|
|
|
|
- change some vo_opengl defaults (including changing tscale)
|
|
|
|
- add "vsync-ratio", "estimated-display-fps" properties
|
2015-11-16 22:47:17 +01:00
|
|
|
- add --rebase-start-time option
|
|
|
|
This is a breaking change to start time handling. Instead of making start
|
|
|
|
time handling an aspect of different options and properties (like
|
|
|
|
"time-pos" vs. "playback-time"), make it dependent on the new option. For
|
|
|
|
compatibility, the "time-start" property now always returns 0, so code
|
|
|
|
which attempted to handle rebasing manually will not break.
|
2015-11-09 20:49:30 +01:00
|
|
|
--- mpv 0.13.0 ---
|
|
|
|
- remove VO opengl-cb frame queue suboptions (no replacement)
|
2015-09-23 22:43:27 +02:00
|
|
|
--- mpv 0.12.0 ---
|
2015-10-24 19:09:35 +02:00
|
|
|
- remove --use-text-osd (useless; fontconfig isn't a requirement anymore,
|
|
|
|
and text rendering is also lazily initialized)
|
2015-10-16 16:16:10 +02:00
|
|
|
- some time properties (at least "playback-time", "time-pos",
|
|
|
|
"time-remaining", "playtime-remaining") now are unavailable if the time
|
|
|
|
is unknown, instead of just assuming that the internal playback position
|
|
|
|
is 0
|
2015-10-05 18:53:02 +02:00
|
|
|
- add --audio-fallback-to-null option
|
2015-09-29 21:12:26 +02:00
|
|
|
- replace vf_format outputlevels suboption with "video-output-levels" global
|
|
|
|
property/option; also remove "colormatrix-output-range" property
|
2015-09-23 22:43:27 +02:00
|
|
|
- vo_opengl: remove sharpen3/sharpen5 scale filters, add sharpen sub-option
|
2015-09-11 23:04:02 +02:00
|
|
|
--- mpv 0.11.0 ---
|
|
|
|
- add "af-metadata" property
|
2015-09-10 14:08:10 +02:00
|
|
|
--- mpv 0.10.0 ---
|
2015-08-30 23:01:46 +02:00
|
|
|
- add --video-aspect-method option
|
2015-08-22 22:08:17 +02:00
|
|
|
- add --playlist-pos option
|
2015-08-10 18:43:25 +02:00
|
|
|
- add --video-sync* options
|
|
|
|
"display-sync-active" property
|
|
|
|
"vo-missed-frame-count" property
|
|
|
|
"audio-speed-correction" and "video-speed-correction" properties
|
2015-08-05 23:38:23 +02:00
|
|
|
- remove --demuxer-readahead-packets and --demuxer-readahead-bytes
|
2015-08-05 23:41:29 +02:00
|
|
|
add --demuxer-max-packets and --demuxer-max-bytes
|
|
|
|
(the new options are not replacement and have very different semantics)
|
2015-08-05 21:29:09 +02:00
|
|
|
- change "video-aspect" property: always settable, even if no video is
|
|
|
|
running; always return the override - if no override is set, return
|
|
|
|
the video's aspect ratio
|
2015-08-03 23:33:03 +02:00
|
|
|
- remove disc-nav (DVD, BD) related properties and commands
|
2015-07-23 22:59:04 +02:00
|
|
|
- add "option-info/<name>/set-locally" property
|
2015-07-22 23:38:45 +02:00
|
|
|
- add --cache-backbuffer; change --cache-default default to 75MB
|
|
|
|
the new total cache size is the sum of backbuffer and the cache size
|
|
|
|
specified by --cache-default or --cache
|
2015-07-03 02:33:54 +02:00
|
|
|
- add ``track-list/N/audio-channels`` property
|
2015-07-18 18:33:54 +02:00
|
|
|
- change --screenshot-tag-colorspace default value
|
2015-07-18 14:36:17 +02:00
|
|
|
- add --stretch-image-subs-to-screen
|
2015-07-10 21:22:35 +02:00
|
|
|
- add "playlist/N/title" property
|
2015-07-10 18:04:34 +02:00
|
|
|
- add --video-stereo-mode=no to disable auto-conversions
|
2015-07-08 22:04:35 +02:00
|
|
|
- add --force-seekable, and change default seekability in some cases
|
2015-07-08 15:14:38 +02:00
|
|
|
- add vf yadif/vavpp/vdpaupp interlaced-only suboptions
|
|
|
|
Also, the option is enabled by default (Except vf_yadif, which has
|
|
|
|
it enabled only if it's inserted by the deinterlace property.)
|
2015-07-07 14:53:58 +02:00
|
|
|
- add --hwdec-preload
|
2015-07-03 19:21:22 +02:00
|
|
|
- add ao coreaudio exclusive suboption
|
2015-06-28 13:23:16 +02:00
|
|
|
- add ``track-list/N/forced`` property
|
2015-06-25 19:10:24 +02:00
|
|
|
- add audio-params/channel-count and ``audio-params-out/channel-count props.
|
2015-06-24 14:40:03 +02:00
|
|
|
- add af volume replaygain-fallback suboption
|
|
|
|
- add video-params/stereo-in property
|
2015-06-11 01:56:56 +02:00
|
|
|
- add "keypress", "keydown", and "keyup" commands
|
2015-06-05 22:35:43 +02:00
|
|
|
- deprecate --ad-spdif-dtshd and enabling passthrough via --ad
|
|
|
|
add --audio-spdif as replacement
|
2015-05-27 18:08:02 +02:00
|
|
|
- remove "get_property" command
|
2015-05-27 18:01:26 +02:00
|
|
|
- remove --slave-broken
|
2015-05-27 11:28:21 +02:00
|
|
|
- add vo opengl custom shader suboptions (source-shader, scale-shader,
|
|
|
|
pre-shaders, post-shaders)
|
2015-05-25 21:44:48 +02:00
|
|
|
- completely change how the hwdec properties work:
|
|
|
|
- "hwdec" now reflects the --hwdec option
|
|
|
|
- "hwdec-detected" does partially what the old "hwdec" property did
|
|
|
|
(and also, "detected-hwdec" is removed)
|
|
|
|
- "hwdec-active" is added
|
2015-05-23 15:26:55 +02:00
|
|
|
- add protocol-list property
|
2015-05-22 20:28:20 +02:00
|
|
|
- deprecate audio-samplerate and audio-channels properties
|
|
|
|
(audio-params sub-properties are the replacement)
|
2015-05-22 20:23:47 +02:00
|
|
|
- add audio-params and audio-out-params properties
|
2015-05-22 20:05:04 +02:00
|
|
|
- deprecate "audio-format" property, replaced with "audio-codec-name"
|
2015-05-22 20:03:14 +02:00
|
|
|
- deprecate --media-title, replaced with --force-media-title
|
2015-05-22 20:02:47 +02:00
|
|
|
- deprecate "length" property, replaced with "duration"
|
2015-05-22 19:00:13 +02:00
|
|
|
- change volume property:
|
|
|
|
- the value 100 is now always "unchanged volume" - with softvol, the
|
|
|
|
range is 0 to --softvol-max, without it is 0-100
|
|
|
|
- the minimum value of --softvol-max is raised to 100
|
|
|
|
- remove vo opengl npot suboption
|
|
|
|
- add relative seeking by percentage to "seek" command
|
|
|
|
- add playlist_shuffle command
|
|
|
|
- add --force-window=immediate
|
|
|
|
- add ao coreaudio change-physical-format suboption
|
|
|
|
- remove vo opengl icc-cache suboption, add icc-cache-dir suboption
|
|
|
|
- add --screenshot-directory
|
|
|
|
- add --screenshot-high-bit-depth
|
|
|
|
- add --screenshot-jpeg-source-chroma
|
|
|
|
- default action for "rescan_external_files" command changes
|
2015-09-10 14:08:10 +02:00
|
|
|
--- mpv 0.9.0 ---
|