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
|
|
|
|
=================
|
|
|
|
|
|
|
|
::
|
|
|
|
|
2017-09-18 22:54:03 +02:00
|
|
|
--- mpv 0.28.0 ---
|
2017-07-06 19:40:40 +02:00
|
|
|
- rename --hwdec=mediacodec option to mediacodec-copy, to reflect
|
|
|
|
conventions followed by other hardware video decoding APIs
|
2017-09-18 22:54:03 +02:00
|
|
|
- drop previously deprecated --heartbeat-cmd and --heartbeat--interval
|
|
|
|
options
|
vo_opengl: refactor into vo_gpu
This is done in several steps:
1. refactor MPGLContext -> struct ra_ctx
2. move GL-specific stuff in vo_opengl into opengl/context.c
3. generalize context creation to support other APIs, and add --gpu-api
4. rename all of the --opengl- options that are no longer opengl-specific
5. move all of the stuff from opengl/* that isn't GL-specific into gpu/
(note: opengl/gl_utils.h became opengl/utils.h)
6. rename vo_opengl to vo_gpu
7. to handle window screenshots, the short-term approach was to just add
it to ra_swchain_fns. Long term (and for vulkan) this has to be moved to
ra itself (and vo_gpu altered to compensate), but this was a stop-gap
measure to prevent this commit from getting too big
8. move ra->fns->flush to ra_gl_ctx instead
9. some other minor changes that I've probably already forgotten
Note: This is one half of a major refactor, the other half of which is
provided by rossy's following commit. This commit enables support for
all linux platforms, while his version enables support for all non-linux
platforms.
Note 2: vo_opengl_cb.c also re-uses ra_gl_ctx so it benefits from the
--opengl- options like --opengl-early-flush, --opengl-finish etc. Should
be a strict superset of the old functionality.
Disclaimer: Since I have no way of compiling mpv on all platforms, some
of these ports were done blindly. Specifically, the blind ports included
context_mali_fbdev.c and context_rpi.c. Since they're both based on
egl_helpers, the port should have gone smoothly without any major
changes required. But if somebody complains about a compile error on
those platforms (assuming anybody actually uses them), you know where to
complain.
2017-09-14 08:04:55 +02:00
|
|
|
- rename --vo=opengl to --vo=gpu
|
|
|
|
- rename --opengl-backend to --gpu-context
|
|
|
|
- rename --opengl-shaders to --glsl-shaders
|
|
|
|
- rename --opengl-shader-cache-dir to --gpu-shader-cache-dir
|
|
|
|
- rename --opengl-tex-pad-x/y to --gpu-tex-pad-x/y
|
|
|
|
- rename --opengl-fbo-format to --fbo-format
|
|
|
|
- rename --opengl-gamma to --gamma-factor
|
|
|
|
- rename --opengl-debug to --gpu-debug
|
|
|
|
- rename --opengl-sw to --gpu-sw
|
|
|
|
- rename --opengl-vsync-fences to --swapchain-depth, and the interpretation
|
|
|
|
slightly changed. Now defaults to 3.
|
|
|
|
- rename the built-in profile `opengl-hq` to `gpu-hq`
|
|
|
|
- the semantics of --opengl-es=yes are slightly changed -> now requires GLES
|
|
|
|
- remove the (deprecated) alias --gpu-context=drm-egl
|
|
|
|
- remove the (deprecated) --vo=opengl-hq
|
|
|
|
- remove --opengl-es=force2 (use --opengl-es=yes --opengl-restrict=300)
|
2017-10-05 11:23:33 +02:00
|
|
|
- the --msg-level option now affects --log-file
|
2017-10-09 15:48:47 +02:00
|
|
|
- drop "audio-out-detected-device" property - this was unavailable on all
|
|
|
|
audio output drivers for quite a while (coreaudio used to provide it)
|
2017-10-16 14:37:28 +02:00
|
|
|
- deprecate --videotoolbox-format (use --hwdec-image-format, which affects
|
|
|
|
most other hwaccels)
|
2017-10-21 19:26:33 +02:00
|
|
|
- remove deprecated --demuxer-max-packets
|
2017-11-30 07:19:30 +01:00
|
|
|
- remove most of the deprecated audio and video filters
|
2017-11-29 21:34:08 +01:00
|
|
|
- remove the deprecated --balance option/property
|
vo_gpu: make it possible to load multiple hwdec interop drivers
Make the VO<->decoder interface capable of supporting multiple hwdec
APIs at once. The main gain is that this simplifies autoprobing a lot.
Before this change, it could happen that the VO loaded the "wrong" hwdec
API, and the decoder was stuck with the choice (breaking hw decoding).
With the change applied, the VO simply loads all available APIs, so
autoprobing trickery is left entirely to the decoder.
In the past, we were quite careful about not accidentally loading the
wrong interop drivers. This was in part to make sure autoprobing works,
but also because libva had this obnoxious bug of dumping garbage to
stderr when using the API. libva was fixed, so this is not a problem
anymore.
The --opengl-hwdec-interop option is changed in various ways (again...),
and renamed to --gpu-hwdec-interop. It does not have much use anymore,
other than debugging. It's notable that the order in the hwdec interop
array ra_hwdec_drivers[] still matters if multiple drivers support the
same image formats, so the option can explicitly force one, if that
should ever be necessary, or more likely, for debugging. One example are
the ra_hwdec_d3d11egl and ra_hwdec_d3d11eglrgb drivers, which both
support d3d11 input.
vo_gpu now always loads the interop lazily by default, but when it does,
it loads them all. vo_opengl_cb now always loads them when the GL
context handle is initialized. I don't expect that this causes any
problems.
It's now possible to do things like changing between vdpau and nvdec
decoding at runtime.
This is also preparation for cleaning up vd_lavc.c hwdec autoprobing.
It's another reason why hwdec_devices_request_all() does not take a
hwdec type anymore.
2017-12-01 05:05:00 +01:00
|
|
|
- rename the --opengl-hwdec-interop option to --gpu-hwdec-interop, and
|
|
|
|
change some of its semantics: extend it take the strings "auto" and
|
|
|
|
"all". "all" loads all backends. "auto" behaves like "all" for
|
|
|
|
vo_opengl_cb, while on vo_gpu it loads nothing, but allows on demand
|
|
|
|
loading by the decoder. The empty string as option value behaves like
|
|
|
|
"auto". Old --hwdec values do not work anymore.
|
|
|
|
This option is hereby declared as unstable and may change any time - its
|
|
|
|
old use is deprecated, and it has very little use outside of debugging
|
|
|
|
now.
|
2017-12-01 21:05:54 +01:00
|
|
|
- change the --hwdec option from a choice to a plain string (affects
|
|
|
|
introspection of the option/property), also affects some properties
|
2017-07-21 20:00:09 +02:00
|
|
|
--- mpv 0.27.0 ---
|
|
|
|
- drop previously deprecated --field-dominance option
|
2017-07-21 20:02:58 +02:00
|
|
|
- drop previously deprecated "osd" command
|
2017-07-21 20:09:22 +02:00
|
|
|
- remove client API compatibility handling for "script", "sub-file",
|
|
|
|
"audio-file", "external-file" (these cases used to log a deprecation
|
|
|
|
warning)
|
2017-07-21 20:19:39 +02:00
|
|
|
- drop deprecated --video-aspect-method=hybrid option choice
|
2017-08-03 12:46:57 +02:00
|
|
|
- rename --hdr-tone-mapping to --tone-mapping (and generalize it)
|
2017-08-04 13:48:37 +02:00
|
|
|
- --opengl-fbo-format changes from a choice to a string. Also, its value
|
|
|
|
will be checked only on renderer initialization, rather than when the
|
|
|
|
option is set.
|
2017-08-07 19:14:18 +02:00
|
|
|
- Using opengl-cb now always assumes 8 bit per component depth, and dithers
|
|
|
|
to this size. Before, it tried to figure out the depth of the first
|
|
|
|
framebuffer that was ever passed to the renderer. Having GL framebuffers
|
|
|
|
with a size larger than 8 bit per component is quite rare. If you need
|
|
|
|
it, set the --dither-depth option instead.
|
2017-08-12 23:08:48 +02:00
|
|
|
- --lavfi-complex can now be set during runtime. If you set this in
|
|
|
|
expectation it would be applied only after a reload, you might observe
|
|
|
|
weird behavior.
|
2017-08-12 23:43:05 +02:00
|
|
|
- add --track-auto-selection to help with scripts/applications that
|
|
|
|
make exclusive use of --lavfi-complex.
|
2017-08-14 20:01:08 +02:00
|
|
|
- undeprecate --loop, and map it from --loop-playlist to --loop-file (the
|
|
|
|
deprecation was to make sure no API user gets broken by a sudden behavior
|
|
|
|
change)
|
2017-08-22 15:58:49 +02:00
|
|
|
- remove previously deprecated vf_eq
|
2017-08-22 19:08:07 +02:00
|
|
|
- remove that hardware deinterlace filters (vavpp, d3d11vpp, vdpaupp)
|
|
|
|
changed their deinterlacing-enabled setting depending on what the
|
|
|
|
--deinterlace option or property was set to. Now, a filter always does
|
|
|
|
what its filter options and defaults imply. The --deinterlace option and
|
|
|
|
property strictly add/remove its own filters. For example, if you run
|
|
|
|
"mpv --vf=vavpp --deinterlace=yes", this will insert another, redundant
|
|
|
|
filter, which is probably not what you want. For toggling a deinterlace
|
|
|
|
filter manually, use the "vf toggle" command, and do not set the
|
|
|
|
deinterlace option/property. To customize the filter that will be
|
2017-08-23 12:10:51 +02:00
|
|
|
inserted automatically, use --vf-defaults. Details how this works will
|
|
|
|
probably change in the future.
|
2017-08-22 19:08:07 +02:00
|
|
|
- remove deinterlace=auto (this was not deprecated, but had only a very
|
|
|
|
obscure use that stopped working with the change above. It was also
|
|
|
|
prone to be confused with a feature not implemented by it: auto did _not_
|
|
|
|
mean that deinterlacing was enabled on demand.)
|
input: use mnemonic names for mouse buttons
mpv's mouse button numbering is based on X11 button numbering, which
allows for an arbitrary number of buttons and includes mouse wheel input
as buttons 3-6. This button numbering was used throughout the codebase
and exposed in input.conf, and it was difficult to remember which
physical button each number actually referred to and which referred to
the scroll wheel.
In practice, PC mice only have between two and five buttons and one or
two scroll wheel axes, which are more or less in the same location and
have more or less the same function. This allows us to use names to
refer to the buttons instead of numbers, which makes input.conf syntax a
lot easier to remember. It also makes the syntax robust to changes in
mpv's underlying numbering. The old MOUSE_BTNx names are still
understood as deprecated aliases of the named buttons.
This changes both the input.conf syntax and the MP_MOUSE_BTNx symbols in
the codebase, since I think both would benefit from using names over
numbers, especially since some platforms don't use X11 button numbering
and handle different mouse buttons in different windowing system events.
This also makes the names shorter, since otherwise they would be pretty
long, and it removes the high-numbered MOUSE_BTNx_DBL names, since they
weren't used.
Names are the same as used in Qt:
https://doc.qt.io/qt-5/qt.html#MouseButton-enum
2017-08-08 13:34:38 +02:00
|
|
|
- add shortened mnemonic names for mouse button bindings, eg. mbtn_left
|
|
|
|
the old numeric names (mouse_btn0) are deprecated
|
|
|
|
- remove mouse_btn3_dbl and up, since they are only generated for buttons
|
|
|
|
0-2 (these now print an error when sent from the 'mouse' command)
|
2017-09-02 16:00:52 +02:00
|
|
|
- rename the axis bindings to wheel_up/down/etc. axis scrolling and mouse
|
|
|
|
wheel scrolling are now conceptually the same thing
|
|
|
|
the old axis_up/down names remain as deprecated aliases
|
2017-04-23 17:51:55 +02:00
|
|
|
--- mpv 0.26.0 ---
|
2017-04-26 17:00:38 +02:00
|
|
|
- remove remaining deprecated audio device options, like --alsa-device
|
2017-04-23 17:51:55 +02:00
|
|
|
Some of them were removed in earlier releases.
|
2017-04-26 21:45:50 +02:00
|
|
|
- introduce --replaygain... options, which replace the same functionality
|
|
|
|
provided by the deprecated --af=volume:replaygain... mechanism.
|
2017-05-20 11:10:55 +02:00
|
|
|
- drop the internal "mp-rawvideo" codec (used by --demuxer=rawvideo)
|
2017-06-06 22:16:29 +02:00
|
|
|
- rename --sub-ass-style-override to --sub-ass-override, and rename the
|
|
|
|
`--sub-ass-override=signfs` setting to `--sub-ass-override=scale`.
|
dec_video: change license to LGPL (almost)
"Almost" because this might contain copyright by michael, who agreed
with LGPL, but only once the core is LGPL. This is preparation for that
to happen.
Apart from that, the usual remarks apply. In particular, dec_video.c
started out quite chaotic with no modularization, but was later
basically gutted, and in general rewritten a bunch of times. Not going
to give a history lesson.
Special attention needs to be given to 3 patches by cehosos, who did not
agree to the relicensing:
240b743ebdf: --field-dominance
e32cbbf7dc3: reinit VO if aspect ratio changes
306f6243fdf: use container aspect if codec aspect unset (?)
The first patch is pretty clearly still in the current code, and needs
to be disabled for LGPL.
The functionality of the second patch is still active, but implemented
completely different, and as part of general frame parameter changes (at
the time of the patch, MPlayer already reinitialized the VO on frame
size and pixel format changes - all this was merged into a single check
for changing image parameters).
The third patch makes me a bit more uncomfortable. It appears the code
was moved to dec_video.c in de68b8f23c8c, and further changed in
82f0d373, 0a0bb905, and bf13bd0d. You could claim that cehoyos'
copyright still sticks. Fortunately, we implement alternative aspect
detection, which is simpler and probably preferable, and which arguably
contains none of the original code and logic, and thus should be fully
safe.
While I don't know if cehoyos' copyright actually still applies, I'm
more comfortable with making the code GPL-only for now. Also change the
default to use the (in future) plain LGPL code, and deprecate the one
associated with the GPL code, so we can eventually remove the GPL code.
But it's also possible we decide that the copyright doesn't apply, and
undo the deprecation and GPL guards.
I expect that users won't notice anything. If you ask me, the old aspect
method was probably an accidental bug instead of intentional behavior.
Although, the new aspect method was broken too, so I had to fix it.
2017-06-18 18:27:48 +02:00
|
|
|
- change default of --video-aspect-method to "bitstream". The "hybrid"
|
|
|
|
method (old default) is deprecated.
|
2017-06-10 14:01:25 +02:00
|
|
|
- remove property "video-params/nom-peak"
|
|
|
|
- remove option --target-brightness
|
|
|
|
- replace vf_format's `peak` suboption by `sig-peak`, which is relative to
|
|
|
|
the reference white level instead of in cd/m^2
|
2017-06-13 17:09:02 +02:00
|
|
|
- renamed the TRCs `st2084` and `std-b67` to `pq` and `hlg` respectively
|
2017-06-23 14:27:53 +02:00
|
|
|
- the "osd" command is deprecated (use "cycle osd-level")
|
2017-06-25 18:54:33 +02:00
|
|
|
- --field-dominance is deprecated (use --vf=setfield=bff or tff)
|
2017-06-23 20:42:20 +02:00
|
|
|
- --really-quiet subtle behavior change
|
2017-06-26 19:55:40 +02:00
|
|
|
- the deprecated handling of setting "no-" options via client API is dropped
|
options: change path list options, and document list options
The changes to path list options is basically getting rid of the need to
pass multiple paths to a single option. Instead, you can use the option
multiple times. The old behavior can be used by using the -set suffix
with the option.
Change some options to path lists. For example --script is now append by
default, and if you use --script-set, you need to use ":"/";" as
separator instead of ",".
--sub-paths/--audio-file-paths is a deprecated alias now, and will break
if the user tries to pass multiple paths to it. I'm assuming that if
these are used, most users will pass only 1 path anyway.
--opengl-shaders has more compatibility handling, since it's probably
rather common that users pass multiple options to it.
Also document all that in the manpage.
I'll probably regret this later, as it somewhat increases the complexity
of the option parser, rather than increasing it.
2017-06-30 16:39:36 +02:00
|
|
|
- the following options change to append-by-default (and possibly separator):
|
|
|
|
--script
|
|
|
|
also, the following options are deprecated:
|
2017-07-02 16:26:41 +02:00
|
|
|
--sub-paths => --sub-file-paths
|
|
|
|
the following options are deprecated for setting via API:
|
|
|
|
"script" (use "scripts")
|
|
|
|
"sub-file" (use "sub-files")
|
|
|
|
"audio-file" (use "audio-files")
|
|
|
|
"external-file" (use "external-files")
|
|
|
|
(the compatibility hacks for this will be removed after this release)
|
vo_opengl: refactor vo performance subsystem
This replaces `vo-performance` by `vo-passes`, bringing with it a number
of changes and improvements:
1. mpv users can now introspect the vo_opengl passes, which is something
that has been requested multiple times.
2. performance data is now measured per-pass, which helps both
development and debugging.
3. since adding more passes is cheap, we can now report information for
more passes (e.g. the blit pass, and the osd pass). Note: we also
switch to nanosecond scale, to be able to measure these passes
better.
4. `--user-shaders` authors can now describe their own passes, helping
users both identify which user shaders are active at any given time
as well as helping shader authors identify performance issues.
5. the timing data per pass is now exported as a full list of samples,
so projects like Argon-/mpv-stats can immediately read out all of the
samples and render a graph without having to manually poll this
option constantly.
Due to gl_timer's design being complicated (directly reading performance
data would block, so we delay the actual read-back until the next _start
command), it's vital not to conflate different passes that might be
doing different things from one frame to another. To accomplish this,
the actual timers are stored as part of the gl_shader_cache's sc_entry,
which makes them unique for that exact shader.
Starting and stopping the time measurement is easy to unify with the
gl_sc architecture, because the existing API already relies on a
"generate, render, reset" flow, so we can just put timer_start and
timer_stop in sc_generate and sc_reset, respectively.
The ugliest thing about this code is that due to the need to keep pass
information relatively stable in between frames, we need to distinguish
between "new" and "redrawn" frames, which bloats the code somewhat and
also feels hacky and vo_opengl-specific. (But then again, this entire
thing is vo_opengl-specific)
2017-06-29 17:00:06 +02:00
|
|
|
- remove property `vo-performance`, and add `vo-passes` as a more general
|
|
|
|
replacement
|
2017-07-02 16:46:27 +02:00
|
|
|
- deprecate passing multiple arguments to -add/-pre options (affects the
|
|
|
|
vf/af commands too)
|
2017-07-06 17:58:26 +02:00
|
|
|
- remove --demuxer-lavf-cryptokey. Use --demux-lavf-o=cryptokey=<hex> or
|
|
|
|
--demux-lavf-o=decryption_key=<hex> instead (whatever fits your situation).
|
2017-07-07 14:46:46 +02:00
|
|
|
- rename --opengl-dumb-mode=no to --opengl-dumb-mode=auto, and make `no`
|
|
|
|
always disable it (unless forced on by hardware limitation).
|
2017-07-12 19:08:58 +02:00
|
|
|
- generalize --scale-clamp, --cscale-clamp etc. to accept a float between
|
|
|
|
0.0 and 1.0 instead of just being a flag. A value of 1.0 corresponds to
|
|
|
|
the old `yes`, and a value of 0.0 corresponds to the old `no`.
|
2017-02-20 08:39:08 +01:00
|
|
|
--- mpv 0.25.0 ---
|
|
|
|
- remove opengl-cb dxva2 dummy hwdec interop
|
|
|
|
(see git "vo_opengl: remove dxva2 dummy hwdec backend")
|
2017-03-18 14:24:53 +01:00
|
|
|
- remove ppm, pgm, pgmyuv, tga choices from the --screenshot-format and
|
|
|
|
--vo-image-format options
|
2017-03-18 15:03:05 +01:00
|
|
|
- the "jpeg" choice in the option above now leads to a ".jpg" file extension
|
2017-03-17 16:49:28 +01:00
|
|
|
- --af=drc is gone (you can use e.g. lavfi/acompressor instead)
|
2017-03-19 15:13:51 +01:00
|
|
|
- remove image_size predefined uniform from OpenGL user shaders. Use
|
|
|
|
input_size instead
|
2017-02-02 10:53:19 +01:00
|
|
|
- add --sub-filter-sdh
|
|
|
|
- add --sub-filter-sdh-harder
|
2017-03-26 20:32:04 +02:00
|
|
|
- remove --input-app-events option (macOS)
|
2017-04-04 17:16:54 +02:00
|
|
|
- deprecate most --vf and --af filters. Only some filters not in libavfilter
|
|
|
|
will be kept.
|
|
|
|
Also, you can use libavfilter filters directly (e.g. you can use
|
|
|
|
--vf=name=opts instead of --vf=lavfi=[name=opts]), as long as the
|
|
|
|
libavfilter filter's name doesn't clash with a mpv builtin filter.
|
|
|
|
In the long term, --vf/--af syntax might change again, but if it does, it
|
|
|
|
will switch to libavfilter's native syntax. (The above mentioned direct
|
|
|
|
support for lavfi filters still has some differences, such as how strings
|
|
|
|
are escaped.) If this happens, the non-deprecated builtin filters might be
|
|
|
|
moved to "somewhere else" syntax-wise.
|
2017-04-10 21:19:13 +02:00
|
|
|
- deprecate --loop - after a deprecation period, it will be undeprecated,
|
|
|
|
but changed to alias --loop-file
|
2017-03-27 11:34:02 +02:00
|
|
|
- add --keep-open-pause=no
|
2017-04-14 19:19:44 +02:00
|
|
|
- deprecate --demuxer-max-packets
|
2017-04-20 05:29:04 +02:00
|
|
|
- change --audio-file-auto default from "exact" to "no" (mpv won't load
|
|
|
|
files with the same filename as the video, but different extension, as
|
|
|
|
audio track anymore)
|
2017-01-17 14:51:08 +01:00
|
|
|
--- mpv 0.24.0 ---
|
|
|
|
- deprecate --hwdec-api and replace it with --opengl-hwdec-interop.
|
|
|
|
The new option accepts both --hwdec values, as well as named backends.
|
|
|
|
A minor difference is that --hwdec-api=no (which used to be the default)
|
|
|
|
now actually does not preload any interop layer, while the new default
|
|
|
|
("") uses the value of --hwdec.
|
2017-01-19 15:38:58 +01:00
|
|
|
- drop deprecated --ad/--vd features
|
2017-01-19 15:44:49 +01:00
|
|
|
- drop deprecated --sub-codepage syntax
|
2017-01-20 17:01:29 +01:00
|
|
|
- rename properties:
|
|
|
|
- "drop-frame-count" to "decoder-frame-drop-count"
|
|
|
|
- "vo-drop-frame-count" to "frame-drop-count"
|
|
|
|
The old names still work, but are deprecated.
|
2017-01-21 17:19:01 +01:00
|
|
|
- remove the --stream-capture option and property. No replacement.
|
2017-02-08 06:54:47 +01:00
|
|
|
(--record-file might serve as alternative)
|
2017-02-01 13:19:09 +01:00
|
|
|
- add --sub-justify
|
|
|
|
- add --sub-ass-justify
|
2017-02-02 18:38:16 +01:00
|
|
|
- internally there's a different way to enable the demuxer cache now
|
|
|
|
it can be auto-enabled even if the stream cache remains disabled
|
2016-11-22 14:57:34 +01:00
|
|
|
--- mpv 0.23.0 ---
|
|
|
|
- remove deprecated vf_vdpaurb (use "--hwdec=vdpau-copy" instead)
|
2016-11-22 15:38:01 +01:00
|
|
|
- the following properties now have new semantics:
|
|
|
|
- "demuxer" (use "current-demuxer")
|
|
|
|
- "fps" (use "container-fps")
|
|
|
|
- "idle" (use "idle-active")
|
|
|
|
- "cache" (use "cache-percent")
|
|
|
|
- "audio-samplerate" (use "audio-params/samplerate")
|
|
|
|
- "audio-channels" (use "audio-params/channel-count")
|
|
|
|
- "audio-format" (use "audio-codec-name")
|
|
|
|
(the properties equivalent to the old semantics are in parentheses)
|
2016-11-25 21:00:39 +01:00
|
|
|
- remove deprecated --vo and --ao sub-options (like --vo=opengl:...), and
|
|
|
|
replace them with global options. A somewhat complete list can be found
|
|
|
|
here: https://github.com/mpv-player/mpv/wiki/Option-replacement-list#mpv-0210
|
|
|
|
- remove --vo-defaults and --ao-defaults as well
|
2016-11-22 15:52:55 +01:00
|
|
|
- remove deprecated global sub-options (like -demuxer-rawaudio format=...),
|
|
|
|
use flat options (like --demuxer-rawaudio-format=...)
|
2016-12-09 19:51:29 +01:00
|
|
|
- the --sub-codepage option changes in incompatible ways:
|
|
|
|
- detector-selection and fallback syntax is deprecated
|
|
|
|
- enca/libguess are removed and deprecated (behaves as if they hadn't
|
|
|
|
been compiled-in)
|
|
|
|
- --sub-codepage=<codepage> does not force the codepage anymore
|
|
|
|
(this requires different and new syntax)
|
2016-12-04 22:52:14 +01:00
|
|
|
- remove --fs-black-out-screens option for macOS
|
2016-12-23 18:03:16 +01:00
|
|
|
- change how spdif codecs are selected. You can't enable spdif passthrough
|
|
|
|
with --ad anymore. This was deprecated; use --audio-spdif instead.
|
2016-12-23 18:12:29 +01:00
|
|
|
- deprecate the "family" selection with --ad/--vd
|
2016-12-23 18:18:17 +01:00
|
|
|
forcing/excluding codecs with "+", "-", "-" is deprecated as well
|
2016-12-23 18:12:54 +01:00
|
|
|
- explicitly mark --ad-spdif-dtshd as deprecated (it was done so a long time
|
|
|
|
ago, but it didn't complain when using the option)
|
2016-11-20 17:37:22 +01:00
|
|
|
--- mpv 0.22.0 ---
|
|
|
|
- the "audio-device-list" property now sets empty device description to the
|
|
|
|
device name as a fallback
|
|
|
|
- add --hidpi-window-scale option for macOS
|
|
|
|
- add audiounit audio output for iOS
|
|
|
|
- make --start-time work with --rebase-start-time=no
|
|
|
|
- add --opengl-early-flush=auto mode
|
|
|
|
- add --hwdec=vdpau-copy, deprecate vf_vdpaurb
|
|
|
|
- add tct video output for true-color and 256-color terminals
|
2016-08-31 16:45:58 +02:00
|
|
|
--- mpv 0.21.0 ---
|
2016-11-15 23:45:57 +01:00
|
|
|
- unlike in older versions, setting options at runtime will now take effect
|
|
|
|
immediately (see for example issue #3281). On the other hand, it will also
|
2016-09-17 20:48:22 +02:00
|
|
|
do runtime verification and reject option changes that do not work
|
|
|
|
(example: setting the "vf" option to a filter during playback, which fails
|
|
|
|
to initialize - the option value will remain at its old value). In general,
|
|
|
|
"set name value" should be mostly equivalent to "set options/name value"
|
|
|
|
in cases where the "name" property is not deprecated and "options/name"
|
|
|
|
exists - deviations from this are either bugs, or documented as caveats
|
|
|
|
in the "Inconsistencies between options and properties" manpage section.
|
2016-09-05 21:07:03 +02:00
|
|
|
- deprecate _all_ --vo and --ao suboptions. Generally, all suboptions are
|
|
|
|
replaced by global options, which do exactly the same. For example,
|
|
|
|
"--vo=opengl:scale=nearest" turns into "--scale=nearest". In some cases,
|
2016-09-13 10:02:27 +02:00
|
|
|
the global option is prefixed, e.g. "--vo=opengl:pbo" turns into
|
|
|
|
"--opengl-pbo".
|
2016-09-06 20:10:05 +02:00
|
|
|
Most of the exact replacements are documented here:
|
|
|
|
https://github.com/mpv-player/mpv/wiki/Option-replacement-list
|
2016-09-13 10:02:27 +02:00
|
|
|
- remove --vo=opengl-hq. Set --profile=opengl-hq instead. Note that this
|
|
|
|
profile does not force the VO. This means if you use the --vo option to
|
|
|
|
set another VO, it won't work. But this also means it can be used with
|
|
|
|
opengl-cb.
|
|
|
|
- remove the --vo=opengl "pre-shaders", "post-shaders" and "scale-shader"
|
|
|
|
sub-options: they were deprecated in favor of "user-shaders"
|
|
|
|
- deprecate --vo-defaults (no replacement)
|
|
|
|
- remove the vo-cmdline command. You can set OpenGL renderer options
|
|
|
|
directly via properties instead.
|
2016-09-05 21:07:30 +02:00
|
|
|
- deprecate the device/sink options on all AOs. Use --audio-device instead.
|
2016-09-05 21:07:34 +02:00
|
|
|
- deprecate "--ao=wasapi:exclusive" and "--ao=coreaudio:exclusive",
|
|
|
|
use --audio-exclusive instead.
|
2016-08-31 16:45:58 +02:00
|
|
|
- subtle changes in how "--no-..." options are treated mean that they are
|
|
|
|
not accessible under "options/..." anymore (instead, these are resolved
|
|
|
|
at parsing time). This does not affect options which start with "--no-",
|
|
|
|
but do not use the mechanism for negation options.
|
2016-08-31 17:28:42 +02:00
|
|
|
(Also see client API change for API version 1.23.)
|
2016-09-01 20:01:02 +02:00
|
|
|
- rename the following properties
|
|
|
|
- "demuxer" -> "current-demuxer"
|
|
|
|
- "fps" -> "container-fps"
|
|
|
|
- "idle" -> "idle-active"
|
2016-09-02 09:42:19 +02:00
|
|
|
- "cache" -> "cache-percent"
|
2016-11-21 20:17:41 +01:00
|
|
|
the old names are deprecated and will change behavior in mpv 0.23.0.
|
2016-09-01 20:01:29 +02:00
|
|
|
- remove deprecated "hwdec-active" and "hwdec-detected" properties
|
2016-09-03 12:46:26 +02:00
|
|
|
- deprecate the ao and vo auto-profiles (they never made any sense)
|
2016-09-05 21:05:31 +02:00
|
|
|
- deprecate "--vo=direct3d_shaders" - use "--vo=direct3d" instead.
|
|
|
|
Change "--vo=direct3d" to always use shaders by default.
|
2016-09-18 13:38:45 +02:00
|
|
|
- deprecate --playlist-pos option, renamed to --playlist-start
|
player: more option/property consistency fixes
Some properties had a different type from their equivalent options (such
as mute, volume, deinterlace, edition). This wasn't really sane, as raw
option values should be always within their bounds. On the other hand,
these properties use a different type to reflect runtime limits (such as
range of available editions), or simply to improve the "UI" (you don't
want to cycle throuhg the completely useless "auto" value when cycling
the "mute" property).
Handle this by making them always return the option type, but also
allowing them to provide a "constricted" type, which is used for UI
purposes. All M_PROPERTY_GET_CONSTRICTED_TYPE changes are related to
this.
One consequence is that you can set the volume property to arbitrary
high values just like with the --volume option, but using the "add"
command it still restricts it to the --volume-max range.
Also deprecate --chapter, as it is grossly incompatible to the chapter
property. We pondered renaming it to --chapters, or introducing a more
powerful --range option, but concluded that --start --end is actually
enough.
These changes appear to take care of the last gross property/option
incompatibilities, although there might still be a few lurking.
2016-09-18 16:06:12 +02:00
|
|
|
- deprecate the --chapter option, as it is redundant with --start/--end,
|
|
|
|
and conflicts with the semantics of the "chapter" property
|
2016-10-02 17:08:14 +02:00
|
|
|
- rename --sub-text-* to --sub-* and --ass-* to --sub-ass-* (old options
|
|
|
|
deprecated)
|
2016-09-09 17:39:22 +02:00
|
|
|
- incompatible change to cdda:// protocol options: the part after cdda://
|
|
|
|
now always sets the device, not the span or speed to be played. No
|
|
|
|
separating extra "/" is needed. The hidden --cdda-device options is also
|
|
|
|
deleted (it was redundant with the documented --cdrom-device).
|
2016-11-21 20:17:41 +01:00
|
|
|
- deprecate --vo=rpi. It will be removed in mpv 0.23.0. Its functionality
|
2016-09-12 19:58:06 +02:00
|
|
|
was folded into --vo=opengl, which now uses RPI hardware decoding by
|
|
|
|
treating it as a hardware overlay (without applying GL filtering). Also
|
2016-11-21 20:17:41 +01:00
|
|
|
to be changed in 0.23.0: the --fs flag will be reset to "no" by default
|
2016-09-12 19:58:06 +02:00
|
|
|
(like on the other platforms).
|
2016-09-18 11:58:24 +02:00
|
|
|
- deprecate --mute=auto (informally has been since 0.18.1)
|
2016-09-16 14:24:31 +02:00
|
|
|
- deprecate "resume" and "suspend" IPC commands. They will be completely
|
2016-11-21 20:17:41 +01:00
|
|
|
removed in 0.23.0.
|
2016-09-16 14:24:31 +02:00
|
|
|
- deprecate mp.suspend(), mp.resume(), mp.resume_all() Lua scripting
|
|
|
|
commands, as well as setting mp.use_suspend. They will be completely
|
2016-11-21 20:17:41 +01:00
|
|
|
removed in 0.23.0.
|
2016-10-03 15:49:53 +02:00
|
|
|
- the "seek" command's absolute seek mode will now interpret negative
|
|
|
|
seek times as relative from the end of the file (and clamps seeks that
|
|
|
|
still go before 0)
|
2016-09-13 10:02:27 +02:00
|
|
|
- add almost all options to the property list, meaning you can change
|
|
|
|
options without adding "options/" to the property name (a new section
|
|
|
|
has been added to the manpage describing some conflicting behavior
|
|
|
|
between options and properties)
|
|
|
|
- implement changing sub-speed during playback
|
2016-09-20 00:59:54 +02:00
|
|
|
- make many previously fixed options changeable at runtime (for example
|
|
|
|
--terminal, --osc, --ytdl, can all be enable/disabled after
|
|
|
|
mpv_initialize() - this can be extended to other still fixed options
|
|
|
|
on user requests)
|
2016-08-17 22:45:44 +02:00
|
|
|
--- mpv 0.20.0 ---
|
|
|
|
- add --image-display-duration option - this also means that image duration
|
|
|
|
is not influenced by --mf-fps anymore in the general case (this is an
|
|
|
|
incompatible change)
|
2016-08-15 16:16:17 +02:00
|
|
|
--- mpv 0.19.0 ---
|
2016-07-17 19:21:28 +02:00
|
|
|
- deprecate "balance" option/property (no replacement)
|
2016-06-29 18:10:15 +02:00
|
|
|
--- mpv 0.18.1 ---
|
|
|
|
- deprecate --heartbeat-cmd
|
2016-07-09 18:31:18 +02:00
|
|
|
- remove --softvol=no capability:
|
|
|
|
- deprecate --softvol, it now does nothing
|
2016-07-10 14:30:02 +02:00
|
|
|
- --volume, --mute, and the corresponding properties now always control
|
2016-07-09 18:31:18 +02:00
|
|
|
softvol, and behave as expected without surprises (e.g. you can set
|
|
|
|
them normally while no audio is initialized)
|
|
|
|
- rename --softvol-max to --volume-max (deprecated alias is added)
|
|
|
|
- the --volume-restore-data option and property are removed without
|
|
|
|
replacement. They were _always_ internal, and used for watch-later
|
|
|
|
resume/restore. Now --volume/--mute are saved directly instead.
|
|
|
|
- the previous point means resuming files with older watch-later configs
|
|
|
|
will print an error about missing --volume-restore-data (which you can
|
|
|
|
ignore), and will not restore the previous value
|
|
|
|
- as a consequence, volume controls will no longer control PulseAudio
|
|
|
|
per-application value, or use the system mixer's per-application
|
|
|
|
volume processing
|
|
|
|
- system or per-application volume can still be controlled with the
|
|
|
|
ao-volume and ao-mute properties (there are no command line options)
|
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 ---
|