summaryrefslogtreecommitdiffstats
path: root/DOCS/man/en/changes.rst
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2014-06-20 23:01:12 +0200
committerwm4 <wm4@nowhere>2014-06-20 23:01:12 +0200
commitf5e175647515b5e34c265dadad524e83c695cc93 (patch)
tree3a8b79e8182dc53a5763d7bb37af0c5b283b8e82 /DOCS/man/en/changes.rst
parent199e3b27630ae45cd396b8af4fbb5bcccf0e2456 (diff)
downloadmpv-f5e175647515b5e34c265dadad524e83c695cc93.tar.bz2
mpv-f5e175647515b5e34c265dadad524e83c695cc93.tar.xz
DOCS: remove en/ sub-directory
This additional sub-directory doesn't serve any purpose anymore. Get rid of it.
Diffstat (limited to 'DOCS/man/en/changes.rst')
-rw-r--r--DOCS/man/en/changes.rst371
1 files changed, 0 insertions, 371 deletions
diff --git a/DOCS/man/en/changes.rst b/DOCS/man/en/changes.rst
deleted file mode 100644
index f1f336ac7c..0000000000
--- a/DOCS/man/en/changes.rst
+++ /dev/null
@@ -1,371 +0,0 @@
-CHANGES FROM OTHER VERSIONS OF MPLAYER
-======================================
-
-**mpv** is based on mplayer2, which in turn is based on the original MPlayer
-(also called mplayer, mplayer-svn, mplayer1). Many changes have been made, a
-large part of which is incompatible or completely changes how the player
-behaves. Although there are still many similarities to its ancestors, **mpv**
-should generally be treated as a completely different program.
-
-.. note::
- These lists are incomplete.
-
-General Changes for MPlayer to mpv
-----------------------------------
-
-* Switch to GPLv2+. (Technically speaking, MPlayer as a whole seems to be
- GPLv2-only, while mplayer2 is GPLv3+ - see ``Copyright`` file for details.)
-* Removal of the internal GUI, MEncoder, OSD menu, video kernel drivers for
- Linux 2.4 (including VIDIX)
-* Large internal cleanups
-* Removal of support for dead platforms
-* New buildsystem
-* No embedded copy of ffmpeg and other libraries
-* Better pause handling (do not unpause on a command)
-* Better MKV support (such as ordered chapters)
-* vo_vdpau improvements
-* Precise seeking support
-* Native OpenGL backend for OSX
-* General OSX improvements
-* Improvements in audio/video sync handling
-* Cleaned up terminal output
-* Gapless audio support (``--gapless-audio``)
-* Improved responsiveness on user input
-* Support for modifier keys (alt, shift, ctrl) in input.conf
-* OSS4 volume control
-* More correct color reproduction (color matrix generation)
-* Use libass for subtitle rendering by default (better quality)
-* Generally preferring ffmpeg/libav over internal demuxers and decoders
-* Improvements when playing multiple files (``--fixed-vo``)
-* Screenshot improvements (instant screenshots without 1-frame delay, allow
- taking screenshots even with hardware decoding)
-* Improved support for PulseAudio
-* Generally improved MS Windows support (dealing with unicode filenames,
- improved ``--vo=direct3d``, improved window handling)
-* Better OSD rendering (using libass). This has full unicode support, and
- languages like Arabic should be better supported.
-* Cleaned up terminal output (nicer status line, less useless noise)
-* Support for playing URLs of popular streaming sites directly
- (e.g. ``mpv https://www.youtube.com/watch?v=...``)
-* Improved OpenGL output (``--vo=opengl-hq``)
-* Make ``--softvol`` default (**mpv** is not a mixer control panel)
-* Improved support for .cue files
-* Screenshot improvements (can save screenshots as JPG or PNG, configurable
- filenames, support for taking screenshots with or without subtitles - the
- ``screenshot`` video filter is not needed anymore, and should not be put
- into the mpv config file)
-* Removal of teletext support
-* Removal of most builtin demuxers, using libavformat instead
-* Removal of builtin network support, using libavformat instead (also,
- support https via libavformat)
-* Replace image VOs (``--vo=jpeg`` etc.) with ``--vo=image``
-* Do not lose settings when playing a new file in the same player instance
-* New location for config files, new name for the binary.
-* Slave mode compatibility broken (see below)
-* Encoding functionality (replacement for mencoder, see ``DOCS/encoding.rst``)
-* Remove ``--vo=gif89a``, ``--vo=md5sum``, ``--vo=yuv4mpeg``, as encoding can
- handle these use cases. For yuv4mpeg, for example, use:
- ``mpv input.mkv -o output.y4m --no-audio --oautofps --oneverdrop``.
-* Image subtitles (DVDs etc.) are rendered in color and use more correct
- positioning (color can be disabled with ``--sub-gray``)
-* Wayland support
-* Support for precise scrolling which scales the parameter of commands. If the
- input doesn't support precise scrolling the scale factor stays 1.
-* OSX: Cocoa event loop is independent from mplayer's event loop, so user
- actions like accessing menus and live resizing do not block the playback.
-* OSX: Apple Remote support.
-* OSX: Media Keys support.
-* Windows: Added WASAPI audio output.
-* New OSD bar with chapter marks and not positioned in the middle of the video
- (though this can be customized with the ``--osd-bar-align-y`` option).
-* Allow customizing whether a key binding for seeking shows the video time, the
- OSD bar, or nothing (see section `Input Command Prefixes`_).
-* Display list of chapters and audio/subtitle tracks on OSD (see section
- `Properties`_).
-* ``--keep-open`` option to stop the player from closing the window and
- exiting after playback ends.
-* Re-enable screensaver while the player is paused.
-* Matroska edition switching at runtime.
-* Support for libavfilter (for video->video and audio->audio). This allows
- using most of FFmpeg's filters, which improve greatly on the old MPlayer
- filters in features, performance, and correctness.
-* Improved downmixing and output of surround audio. Instead of using hardcoded
- pan filters to do remixing, use libavresample. Channel maps are used to
- identify the channel layout, so e.g. ``3.0`` and ``2.1`` audio can be
- distinguished.
-* Allow resuming playback at a later point with ``Shift+q``, also see
- ``quit_watch_later`` input command.
-* Support mapping multiple commands to one key.
-* Allow changing/adjusting video filters at runtime. (This is also used to make
- the ``D`` key insert vf_yadif if deinterlacing is not supported otherwise.)
-* Native VAAPI support
-* OSX: VDA support using libavcodec hwaccel API insted of FFmpeg's decoder. Up
- to 2-2.5x reduction in CPU usage.
-* Make hardware decoding in general work with the ``opengl`` video output.
-* Lua scripting (see `LUA SCRIPTING`_)
-* A client API, that allows embedding **mpv** into applications
- (see ``libmpv/client.h`` in the sources)
-* General bug fixes and removal of long-standing issues
-* General code cleanups (including refactoring or rewrites of many parts)
-* Many more changes
-
-Detailed Listing of User-visible Changes
-----------------------------------------
-
-This listing is about changed command line switches, slave commands, and similar
-things. Completely removed features are not listed.
-
-Command Line Switches
-~~~~~~~~~~~~~~~~~~~~~
-
-* There is a new command line syntax, which is generally preferred over the old
- syntax. ``-optname optvalue`` becomes ``--optname=optvalue``.
-
- The old syntax will not be removed. However, the new syntax is mentioned in
- all documentation and so on, and unlike the old syntax is not ambiguous,
- so it is a good thing to know about this change.
-* In general, negating switches like ``-noopt`` now have to be written as
- ``-no-opt`` or ``--no-opt``.
-* Per-file options are not the default anymore. You can explicitly specify
- file-local options. See ``Usage`` section.
-* Many options have been renamed, removed or changed semantics. Some options
- that are required for a good playback experience with MPlayer are now
- superfluous or even worse than the defaults, so make sure to read the manual
- before trying to use your existing configuration with **mpv**.
-* Table of renamed/replaced switches:
-
- =========================== ========================================
- Old New
- =========================== ========================================
- ``-no<opt>`` ``--no-<opt>`` (add a dash)
- ``-a52drc level`` ``--ad-lavc-ac3drc=level``
- ``-ac spdifac3`` ``--ad=spdif:ac3`` (see ``--ad=help``)
- ``-af volnorm`` ``--af=drc`` (renamed)
- ``-afm hwac3`` ``--ad=spdif:ac3,spdif:dts``
- ``-ao alsa:device=hw=0.3`` ``--ao=alsa:device=[hw:0,3]``
- ``-aspect`` ``--video-aspect``
- ``-ass-bottom-margin`` ``--vf=sub=bottom:top``
- ``-ass`` ``--sub-ass``
- ``-audiofile-cache`` (removed; the main cache settings are used)
- ``-audiofile`` ``--audio-file``
- ``-benchmark`` ``--untimed`` (no stats)
- ``-capture`` ``--stream-capture=<filename>``
- ``-channels`` ``--audio-channels`` (changed semantics)
- ``-cursor-autohide-delay`` ``--cursor-autohide``
- ``-delay`` ``--audio-delay``
- ``-dumpstream`` ``--stream-dump=<filename>``
- ``-dvdangle`` ``--dvd-angle``
- ``-endpos`` ``--length``
- ``-font`` ``--osd-font``
- ``-forcedsubsonly`` ``--sub-forced-only``
- ``-forceidx`` ``--index``
- ``-format`` ``--audio-format``
- ``-fsmode-dontuse`` (removed)
- ``-fstype`` ``--x11-netwm`` (changed semantics)
- ``-hardframedrop`` ``--framedrop=hard``
- ``-identify`` (removed; use TOOLS/mpv_identify.sh)
- ``-idx`` ``--index``
- ``-lavdopts ...`` ``--vd-lavc-...``
- ``-lavfdopts`` ``--demuxer-lavf-...``
- ``-lircconf`` ``--input-lirc-conf``
- ``-loop 0`` ``--loop=inf``
- ``-mixer-channel`` AO suboptions (``alsa``, ``oss``)
- ``-mixer`` AO suboptions (``alsa``, ``oss``)
- ``-mouse-movements`` ``--input-cursor``
- ``-msgcolor`` ``--msg-color``
- ``-msglevel`` ``--msg-level`` (changed semantics)
- ``-msgmodule`` ``--msg-module``
- ``-name`` ``--x11-name``
- ``-noar`` ``--no-input-appleremote``
- ``-noautosub`` ``--no-sub-auto``
- ``-noconsolecontrols`` ``--no-input-terminal``
- ``-nojoystick`` ``--no-input-joystick``
- ``-nosound`` ``--no-audio``
- ``-osdlevel`` ``--osd-level``
- ``-panscanrange`` ``--video-zoom``, ``--video-pan-x/y``
- ``-playing-msg`` ``--term-playing-msg``
- ``-pp ...`` ``'--vf=pp=[...]'``
- ``-pphelp`` ``--vf=pp:help``
- ``-rawaudio ...`` ``--demuxer-rawaudio-...``
- ``-rawvideo ...`` ``--demuxer-rawvideo-...``
- ``-spugauss`` ``--sub-gauss``
- ``-srate`` ``--audio-samplerate``
- ``-ss`` ``--start``
- ``-ssf <sub>`` ``--sws-...``
- ``-stop-xscreensaver`` ``--stop-screensaver``
- ``-sub-fuzziness`` ``--sub-auto``
- ``-sub`` ``--sub-file``
- ``-subcp`` ``--sub-codepage``
- ``-subdelay`` ``--sub-delay``
- ``-subfile`` ``--sub-file``
- ``-subfont-*`` ``--sub-text-*``, ``--osd-*``
- ``-subfont-text-scale`` ``--sub-scale``
- ``-subfont`` ``--sub-text-font``
- ``-subfps`` ``--sub-fps``
- ``-subpos`` ``--sub-pos``
- ``-sws`` ``--sws-scaler``
- ``-tvscan`` ``--tv-scan``
- ``-use-filename-title`` ``--title='${filename}'``
- ``-vc ffh264vdpau`` (etc.) ``--hwdec=vdpau``
- ``-vobsub`` ``--sub-file`` (pass the .idx file)
- ``-x W``, ``-y H`` ``--geometry=WxH`` + ``--no-keepaspect``
- ``-xineramascreen`` ``--screen`` (different values)
- ``-xy W`` ``--autofit=W``
- ``-zoom`` Inverse available as ``--video-unscaled``
- ``dvdnav://`` ``dvdnav://menu``
- ``dvd://1`` ``dvd://0`` (0-based offset)
- =========================== ========================================
-
-.. note::
-
- ``-opt val`` becomes ``--opt=val``.
-
-.. note::
-
- Quite some video filters, video outputs, audio filters, audio outputs, had
- changes in their option parsing. These aren't mentioned in the table above.
-
- Also, some video and audio filters have been removed, and you have to use
- libavfilter (using ``--vf=lavfi=[...]`` or ``--af=lavfi=[...]``) to get
- them back.
-
-input.conf and Slave Commands
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-* Table of renamed input commands:
-
- This lists only commands that are not always gracefully handled by the
- internal legacy translation layer. If an input.conf contains any legacy
- commands, a warning will be printed when starting the player. The warnings
- also show the replacement commands.
-
- Properties containing ``_`` to separate words use ``-`` instead.
-
- +--------------------------------+----------------------------------------+
- | Old | New |
- +================================+========================================+
- | ``pt_step 1 [0|1]`` | ``playlist_next [weak|force]`` |
- | | (translation layer cannot deal with |
- | | whitespace) |
- +--------------------------------+----------------------------------------+
- | ``pt_step -1 [0|1]`` | ``playlist_prev [weak|force] (same)`` |
- +--------------------------------+----------------------------------------+
- | ``switch_ratio [<ratio>]`` | ``set video-aspect <ratio>`` |
- | | |
- | | ``set video-aspect 0`` (reset aspect) |
- +--------------------------------+----------------------------------------+
- | ``step_property_osd <prop>`` | ``cycle <prop> <step>`` (wraps), |
- | ``<step> <dir>`` | ``add <prop> <step>`` (clamps). |
- | | ``<dir>`` parameter unsupported. Use |
- | | a negative ``<step>`` instead. |
- +--------------------------------+----------------------------------------+
- | ``step_property <prop>`` | Prefix ``cycle`` or ``add`` with |
- | ``<step> <dir>`` | ``no-osd``: ``no-osd cycle <prop>`` |
- | | ``<step>`` |
- +--------------------------------+----------------------------------------+
- | ``osd_show_property_text`` | ``show_text <text>`` |
- | ``<text>`` | The property expansion format string |
- | | syntax slightly changed. |
- +--------------------------------+----------------------------------------+
- | ``osd_show_text`` | Now does the same as |
- | | ``osd_show_property_text``. Use the |
- | | ``raw`` prefix to disable property |
- | | expansion. |
- +--------------------------------+----------------------------------------+
- | ``show_tracks`` | ``show_text ${track-list}`` |
- +--------------------------------+----------------------------------------+
- | ``show_chapters`` | ``show_text ${chapter-list}`` |
- +--------------------------------+----------------------------------------+
- | ``af_switch``, ``af_add``, ... | ``af set|add|...`` |
- +--------------------------------+----------------------------------------+
- | ``tv_start_scan`` | ``set tv-scan yes`` |
- +--------------------------------+----------------------------------------+
- | ``tv_set_channel <val>`` | ``set tv-channel <val>`` |
- +--------------------------------+----------------------------------------+
- | ``tv_step_channel`` | ``cycle tv-channel`` |
- +--------------------------------+----------------------------------------+
- | ``dvb_set_channel <v1> <v2>`` | ``set dvb-channel <v1>-<v2>`` |
- +--------------------------------+----------------------------------------+
- | ``dvb_step_channel`` | ``cycle dvb-channel`` |
- +--------------------------------+----------------------------------------+
- | ``tv_set_freq <val>`` | ``set tv-freq <val>`` |
- +--------------------------------+----------------------------------------+
- | ``tv_step_freq`` | ``cycle tv-freq`` |
- +--------------------------------+----------------------------------------+
- | ``tv_set_norm <norm>`` | ``set tv-norm <norm>`` |
- +--------------------------------+----------------------------------------+
- | ``tv_step_norm`` | ``cycle tv-norm`` |
- +--------------------------------+----------------------------------------+
-
- .. note::
-
- Due to lack of hardware and users using the TV/DVB/PVR features, and
- due to the need to cleanup the related command code, it's possible
- that the new commands are buggy or behave worse. This can be improved
- if testers are available. Otherwise, some of the TV code will be
- removed at some point.
-
-Slave mode
-~~~~~~~~~~
-
-* Slave mode is broken. This mode is entirely insane in the ``old`` versions of
- MPlayer. A proper slave mode application needed tons of code and hacks to get
- it right. The main problem is that slave mode is a bad and incomplete
- interface, and to get around that, applications parsed output messages
- intended for users. It is hard to know which messages exactly are parsed by
- slave mode applications. This makes it virtually impossible to improve
- terminal output intended for users without possibly breaking something.
-
- This is absolutely insane, and **mpv** will not try to keep slave mode
- compatible. If you are a developer of a slave mode application, contact us,
- and a new and better protocol can be developed.
-
- ``--identify`` was already removed (``TOOLS/mpv_identify.sh`` is provided
- instead), and ``--slave-broken`` might be removed in the future.
-
-* **mpv** also provides a client API, which can be used to embed the player
- by loading it as shared library. (See ``libmpv/client.h`` in the sources.)
- It might also be possible to implement a custom slave mode-like protocol
- using Lua scripting.
-
-* A slave protocol is planned, but nothing has emerged yet.
-
-Policy for Removed Features
----------------------------
-
-**mpv** is in active development. If something is in the way of more important
-development (such as fixing bugs or implementing new features), we sometimes
-remove features. Usually this happens only with old features that either seem
-to be useless, or are not used by anyone. Often these are obscure, or
-"inherited", or were marked experimental, but never received any particular
-praise by any users.
-
-Sometimes, features are replaced by something new. The new code will be either
-simpler or more powerful, but doesn't necessarily provide everything the old
-feature did.
-
-We can not exclude that we accidentally remove features that are actually
-popular. Generally, we do not know how much a specific functionality is used.
-If you miss a feature and think it should be re-added, please open an issue
-on the mpv bug tracker. Hopefully, a solution can be found. Often, it turns
-out that re-adding something is not much of a problem, or that there are
-better alternatives.
-
-Why this Fork?
---------------
-
-mplayer2 is practically dead, and mpv started out as a branch containing
-new/experimental development. (Some of it was merged right *after* the fork
-was made public, seemingly as an acknowledgment that development, or at
-least merging, should have been more active.)
-
-MPlayer is focused on not breaking anything, but is stuck with a horrible
-codebase resistant to cleanup. (Unless you do what mpv did - merciless and
-consequent pruning of bad, old code.) Cleanup and keeping broken things
-conflict, so the kind of development mpv strives for can't be done within
-MPlayer due to clashing development policies.
-
-Additionally, mplayer2 already had lots of changes over MPlayer, which would
-have needed to be backported to the MPlayer codebase. This would not only
-have been hard (several years of diverging development), but also would have
-been impossible due to the aforementioned MPlayer development policy.