manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
VIDEO OUTPUT DRIVERS
|
|
|
|
|
====================
|
|
|
|
|
|
|
|
|
|
Video output drivers are interfaces to different video output facilities. The
|
|
|
|
|
syntax is:
|
|
|
|
|
|
2016-09-07 10:55:21 +00:00
|
|
|
``--vo=<driver1,driver2,...[,]>``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
Specify a priority list of video output drivers to be used.
|
|
|
|
|
|
2016-09-07 10:55:21 +00:00
|
|
|
If the list has a trailing ``,``, mpv will fall back on drivers not contained
|
|
|
|
|
in the list.
|
2013-11-30 23:12:10 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
.. note::
|
|
|
|
|
|
|
|
|
|
See ``--vo=help`` for a list of compiled-in video output drivers.
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
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 06:04:55 +00:00
|
|
|
The recommended output driver is ``--vo=gpu``, which is the default. All
|
2016-09-07 10:55:21 +00:00
|
|
|
other drivers are for compatibility or special purposes. If the default
|
|
|
|
|
does not work, it will fallback to other drivers (in the same order as
|
|
|
|
|
listed by ``--vo=help``).
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
|
|
|
|
Available video output drivers are:
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``xv`` (X11 only)
|
2013-09-10 13:09:24 +00:00
|
|
|
Uses the XVideo extension to enable hardware-accelerated display. This is
|
2013-07-08 16:02:14 +00:00
|
|
|
the most compatible VO on X, but may be low-quality, and has issues with
|
2012-08-07 21:53:14 +00:00
|
|
|
OSD and subtitle display.
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2014-04-19 13:29:05 +00:00
|
|
|
.. note:: This driver is for compatibility with old systems.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
The following global options are supported by this video output:
|
|
|
|
|
|
|
|
|
|
``--xv-adaptor=<number>``
|
2014-09-01 02:25:57 +00:00
|
|
|
Select a specific XVideo adapter (check xvinfo results).
|
2016-09-05 19:07:03 +00:00
|
|
|
``--xv-port=<number>``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
Select a specific XVideo port.
|
2016-09-05 19:07:03 +00:00
|
|
|
``--xv-ck=<cur|use|set>``
|
2014-09-01 02:25:57 +00:00
|
|
|
Select the source from which the color key is taken (default: cur).
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
|
|
|
|
cur
|
2014-09-01 02:25:57 +00:00
|
|
|
The default takes the color key currently set in Xv.
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
use
|
2014-09-01 02:25:57 +00:00
|
|
|
Use but do not set the color key from mpv (use the ``--colorkey``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
option to change it).
|
|
|
|
|
set
|
2014-09-01 02:25:57 +00:00
|
|
|
Same as use but also sets the supplied color key.
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--xv-ck-method=<none|man|bg|auto>``
|
2014-09-01 02:25:57 +00:00
|
|
|
Sets the color key drawing method (default: man).
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2016-08-31 11:22:32 +00:00
|
|
|
none
|
|
|
|
|
Disables color-keying.
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
man
|
2014-09-01 02:25:57 +00:00
|
|
|
Draw the color key manually (reduces flicker in some cases).
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
bg
|
2014-09-01 02:25:57 +00:00
|
|
|
Set the color key as window background.
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
auto
|
2014-09-01 02:25:57 +00:00
|
|
|
Let Xv draw the color key.
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--xv-colorkey=<number>``
|
2014-09-01 02:25:57 +00:00
|
|
|
Changes the color key to an RGB value of your choice. ``0x000000`` is
|
2013-07-21 23:03:22 +00:00
|
|
|
black and ``0xffffff`` is white.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--xv-buffers=<number>``
|
2015-05-20 21:07:47 +00:00
|
|
|
Number of image buffers to use for the internal ringbuffer (default: 2).
|
|
|
|
|
Increasing this will use more memory, but might help with the X server
|
|
|
|
|
not responding quickly enough if video FPS is close to or higher than
|
|
|
|
|
the display refresh rate.
|
|
|
|
|
|
2015-09-30 20:52:22 +00:00
|
|
|
``x11`` (X11 only)
|
|
|
|
|
Shared memory video output driver without hardware acceleration that works
|
|
|
|
|
whenever X11 is present.
|
|
|
|
|
|
sws_utils, zimg: destroy vo_x11 and vo_drm performance
Raise swscale and zimg default parameters. This restores screenshot
quality settings (maybe) unset in the commit before. Also expose some
more libswscale and zimg options.
Since these options are also used for VOs like x11 and drm, this will
make x11/drm/etc. much slower. For compensation, provide a profile that
sets the old option values: sw-fast. I'm also enabling zimg here, just
as an experiment.
The core problem is that we have a single set of command line options
which control the settings used for most swscale/zimg uses. This was
done in the previous commit. It cannot differentiate between the VOs,
which need to be realtime and may accept/require lower quality options,
and things like screenshots or vo_image, which can be slower, but should
not sacrifice quality by default.
Should this have two sets of options or something similar to do the
right thing depending on the code which calls libswscale? Maybe. Or
should I just ignore the problem, make it someone else's problem (users
who want to use software conversion VOs), provide a sub-optimal
solution, and call it a day? Definitely, sounds good, pushing to master,
goodbye.
2019-10-31 15:45:28 +00:00
|
|
|
Since mpv 0.30.0, you may need to use ``--profile=sw-fast`` to get decent
|
|
|
|
|
performance.
|
|
|
|
|
|
2015-09-30 20:52:22 +00:00
|
|
|
.. note:: This is a fallback only, and should not be normally used.
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``vdpau`` (X11 only)
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
Uses the VDPAU interface to display and optionally also decode video.
|
2013-01-30 23:39:45 +00:00
|
|
|
Hardware decoding is used with ``--hwdec=vdpau``.
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2014-05-02 14:57:39 +00:00
|
|
|
.. note::
|
|
|
|
|
|
|
|
|
|
Earlier versions of mpv (and MPlayer, mplayer2) provided sub-options
|
2014-09-01 02:25:57 +00:00
|
|
|
to tune vdpau post-processing, like ``deint``, ``sharpen``, ``denoise``,
|
2014-05-02 14:57:39 +00:00
|
|
|
``chroma-deint``, ``pullup``, ``hqscaling``. These sub-options are
|
|
|
|
|
deprecated, and you should use the ``vdpaupp`` video filter instead.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
The following global options are supported by this video output:
|
|
|
|
|
|
|
|
|
|
``--vo-vdpau-sharpen=<-1-1>``
|
2014-05-02 14:57:39 +00:00
|
|
|
(Deprecated. See note about ``vdpaupp``.)
|
|
|
|
|
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
For positive values, apply a sharpening algorithm to the video, for
|
|
|
|
|
negative values a blurring algorithm (default: 0).
|
2016-09-05 19:07:03 +00:00
|
|
|
``--vo-vdpau-denoise=<0-1>``
|
2014-05-02 14:57:39 +00:00
|
|
|
(Deprecated. See note about ``vdpaupp``.)
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
Apply a noise reduction algorithm to the video (default: 0; no noise
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
reduction).
|
2016-09-05 19:07:03 +00:00
|
|
|
``--vo-vdpau-chroma-deint``
|
2014-05-02 14:57:39 +00:00
|
|
|
(Deprecated. See note about ``vdpaupp``.)
|
|
|
|
|
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
Makes temporal deinterlacers operate both on luma and chroma (default).
|
|
|
|
|
Use no-chroma-deint to solely use luma and speed up advanced
|
|
|
|
|
deinterlacing. Useful with slow video memory.
|
2016-09-05 19:07:03 +00:00
|
|
|
``--vo-vdpau-pullup``
|
2014-05-02 14:57:39 +00:00
|
|
|
(Deprecated. See note about ``vdpaupp``.)
|
|
|
|
|
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
Try to apply inverse telecine, needs motion adaptive temporal
|
|
|
|
|
deinterlacing.
|
2016-09-05 19:07:03 +00:00
|
|
|
``--vo-vdpau-hqscaling=<0-9>``
|
2014-05-02 14:57:39 +00:00
|
|
|
(Deprecated. See note about ``vdpaupp``.)
|
|
|
|
|
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
0
|
|
|
|
|
Use default VDPAU scaling (default).
|
|
|
|
|
1-9
|
|
|
|
|
Apply high quality VDPAU scaling (needs capable hardware).
|
2016-09-05 19:07:03 +00:00
|
|
|
``--vo-vdpau-fps=<number>``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
Override autodetected display refresh rate value (the value is needed
|
|
|
|
|
for framedrop to allow video playback rates higher than display
|
|
|
|
|
refresh rate, and for vsync-aware frame timing adjustments). Default 0
|
|
|
|
|
means use autodetected value. A positive value is interpreted as a
|
|
|
|
|
refresh rate in Hz and overrides the autodetected value. A negative
|
|
|
|
|
value disables all timing adjustment and framedrop logic.
|
2016-09-05 19:07:03 +00:00
|
|
|
``--vo-vdpau-composite-detect``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
NVIDIA's current VDPAU implementation behaves somewhat differently
|
|
|
|
|
under a compositing window manager and does not give accurate frame
|
|
|
|
|
timing information. With this option enabled, the player tries to
|
|
|
|
|
detect whether a compositing window manager is active. If one is
|
|
|
|
|
detected, the player disables timing adjustments as if the user had
|
2013-07-08 16:02:14 +00:00
|
|
|
specified ``fps=-1`` (as they would be based on incorrect input). This
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
means timing is somewhat less accurate than without compositing, but
|
2013-07-08 16:02:14 +00:00
|
|
|
with the composited mode behavior of the NVIDIA driver, there is no
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
hard playback speed limit even without the disabled logic. Enabled by
|
2016-10-21 16:50:40 +00:00
|
|
|
default, use ``--vo-vdpau-composite-detect=no`` to disable.
|
2016-09-06 16:43:51 +00:00
|
|
|
``--vo-vdpau-queuetime-windowed=<number>`` and ``queuetime-fs=<number>``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
Use VDPAU's presentation queue functionality to queue future video
|
|
|
|
|
frame changes at most this many milliseconds in advance (default: 50).
|
|
|
|
|
See below for additional information.
|
2016-09-06 16:43:51 +00:00
|
|
|
``--vo-vdpau-output-surfaces=<2-15>``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
Allocate this many output surfaces to display video frames (default:
|
|
|
|
|
3). See below for additional information.
|
2016-09-05 19:07:03 +00:00
|
|
|
``--vo-vdpau-colorkey=<#RRGGBB|#AARRGGBB>``
|
2013-08-17 17:57:18 +00:00
|
|
|
Set the VDPAU presentation queue background color, which in practice
|
|
|
|
|
is the colorkey used if VDPAU operates in overlay mode (default:
|
vo_vdpau: use color close to black as default colorkey (instead of green)
The VDPAU default colorkey, although it seems to be driver specific, is
usually green. This is a pretty annoying color, and you usually see it
briefly (as flashes) if the VDPAU window resizes.
Change it to some shade of black. The new default color is close to what
MPlayer picks as colorkey (and apparently it worked well for them):
VdpColor vdp_bg = {0.01, 0.02, 0.03, 0};
Since our OPT_COLOR can set 8 bit colors only, we use '#020507' instead,
which should be the same assuming 8 bit colors.
Obviously, you can't use black, because black is a way too common color,
and would make it too easy to observe the colorkey effect when e.g.
moving a terminal with black background over the video window.
2013-08-17 18:05:28 +00:00
|
|
|
``#020507``, some shade of black). If the alpha component of this value
|
|
|
|
|
is 0, the default VDPAU colorkey will be used instead (which is usually
|
|
|
|
|
green).
|
2016-09-05 19:07:03 +00:00
|
|
|
``--vo-vdpau-force-yuv``
|
2013-08-18 03:12:21 +00:00
|
|
|
Never accept RGBA input. This means mpv will insert a filter to convert
|
|
|
|
|
to a YUV format before the VO. Sometimes useful to force availability
|
|
|
|
|
of certain YUV-only features, like video equalizer or deinterlacing.
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2014-09-01 02:25:57 +00:00
|
|
|
Using the VDPAU frame queuing functionality controlled by the queuetime
|
2013-07-08 16:02:14 +00:00
|
|
|
options makes mpv's frame flip timing less sensitive to system CPU load and
|
|
|
|
|
allows mpv to start decoding the next frame(s) slightly earlier, which can
|
|
|
|
|
reduce jitter caused by individual slow-to-decode frames. However, the
|
|
|
|
|
NVIDIA graphics drivers can make other window behavior such as window moves
|
|
|
|
|
choppy if VDPAU is using the blit queue (mainly happens if you have the
|
|
|
|
|
composite extension enabled) and this feature is active. If this happens on
|
|
|
|
|
your system and it bothers you then you can set the queuetime value to 0 to
|
|
|
|
|
disable this feature. The settings to use in windowed and fullscreen mode
|
|
|
|
|
are separate because there should be no reason to disable this for
|
|
|
|
|
fullscreen mode (as the driver issue should not affect the video itself).
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
|
|
|
|
You can queue more frames ahead by increasing the queuetime values and the
|
2013-07-08 16:02:14 +00:00
|
|
|
``output_surfaces`` count (to ensure enough surfaces to buffer video for a
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
certain time ahead you need at least as many surfaces as the video has
|
|
|
|
|
frames during that time, plus two). This could help make video smoother in
|
|
|
|
|
some cases. The main downsides are increased video RAM requirements for
|
|
|
|
|
the surfaces and laggier display response to user commands (display
|
|
|
|
|
changes only become visible some time after they're queued). The graphics
|
|
|
|
|
driver implementation may also have limits on the length of maximum
|
|
|
|
|
queuing time or number of queued surfaces that work well or at all.
|
|
|
|
|
|
2016-09-05 19:05:31 +00:00
|
|
|
``direct3d`` (Windows only)
|
2012-08-07 21:53:14 +00:00
|
|
|
Video output driver that uses the Direct3D interface.
|
|
|
|
|
|
2014-04-19 13:29:05 +00:00
|
|
|
.. note:: This driver is for compatibility with systems that don't provide
|
2016-09-05 19:05:31 +00:00
|
|
|
proper OpenGL drivers, and where ANGLE does not perform well.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
The following global options are supported by this video output:
|
|
|
|
|
|
|
|
|
|
``--vo-direct3d-disable-texture-align``
|
2012-08-07 21:53:14 +00:00
|
|
|
Normally texture sizes are always aligned to 16. With this option
|
|
|
|
|
enabled, the video texture will always have exactly the same size as
|
|
|
|
|
the video itself.
|
|
|
|
|
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
Debug options. These might be incorrect, might be removed in the future,
|
|
|
|
|
might crash, might cause slow downs, etc. Contact the developers if you
|
|
|
|
|
actually need any of these for performance or proper operation.
|
2012-08-07 21:53:14 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--vo-direct3d-force-power-of-2``
|
2012-08-07 21:53:14 +00:00
|
|
|
Always force textures to power of 2, even if the device reports
|
|
|
|
|
non-power-of-2 texture sizes as supported.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--vo-direct3d-texture-memory=<mode>``
|
2012-08-07 21:53:14 +00:00
|
|
|
Only affects operation with shaders/texturing enabled, and (E)OSD.
|
2014-11-18 15:30:24 +00:00
|
|
|
Possible values:
|
|
|
|
|
|
|
|
|
|
``default`` (default)
|
|
|
|
|
Use ``D3DPOOL_DEFAULT``, with a ``D3DPOOL_SYSTEMMEM`` texture for
|
|
|
|
|
locking. If the driver supports ``D3DDEVCAPS_TEXTURESYSTEMMEMORY``,
|
|
|
|
|
``D3DPOOL_SYSTEMMEM`` is used directly.
|
|
|
|
|
|
|
|
|
|
``default-pool``
|
|
|
|
|
Use ``D3DPOOL_DEFAULT``. (Like ``default``, but never use a
|
|
|
|
|
shadow-texture.)
|
|
|
|
|
|
|
|
|
|
``default-pool-shadow``
|
|
|
|
|
Use ``D3DPOOL_DEFAULT``, with a ``D3DPOOL_SYSTEMMEM`` texture for
|
|
|
|
|
locking. (Like ``default``, but always force the shadow-texture.)
|
|
|
|
|
|
|
|
|
|
``managed``
|
|
|
|
|
Use ``D3DPOOL_MANAGED``.
|
|
|
|
|
|
|
|
|
|
``scratch``
|
|
|
|
|
Use ``D3DPOOL_SCRATCH``, with a ``D3DPOOL_SYSTEMMEM`` texture for
|
|
|
|
|
locking.
|
2012-08-07 21:53:14 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--vo-direct3d-swap-discard``
|
2013-07-08 16:02:14 +00:00
|
|
|
Use ``D3DSWAPEFFECT_DISCARD``, which might be faster.
|
|
|
|
|
Might be slower too, as it must(?) clear every frame.
|
2012-08-07 21:53:14 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--vo-direct3d-exact-backbuffer``
|
2012-08-07 21:53:14 +00:00
|
|
|
Always resize the backbuffer to window size.
|
|
|
|
|
|
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 06:04:55 +00:00
|
|
|
``gpu``
|
|
|
|
|
General purpose, customizable, GPU-accelerated video output driver. It
|
|
|
|
|
supports extended scaling methods, dithering, color management, custom
|
|
|
|
|
shaders, HDR, and more.
|
2012-08-07 21:53:14 +00:00
|
|
|
|
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 06:04:55 +00:00
|
|
|
See `GPU renderer options`_ for options specific to this VO.
|
2016-09-02 13:59:40 +00:00
|
|
|
|
|
|
|
|
By default, it tries to use fast and fail-safe settings. Use the
|
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 06:04:55 +00:00
|
|
|
``gpu-hq`` profile to use this driver with defaults set to high quality
|
|
|
|
|
rendering. The profile can be applied with ``--profile=gpu-hq`` and its
|
|
|
|
|
contents can be viewed with ``--show-profile=gpu-hq``.
|
2012-09-23 14:10:00 +00:00
|
|
|
|
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 06:04:55 +00:00
|
|
|
This VO abstracts over several possible graphics APIs and windowing
|
|
|
|
|
contexts, which can be influenced using the ``--gpu-api`` and
|
|
|
|
|
``--gpu-context`` options.
|
2015-01-23 16:09:25 +00:00
|
|
|
|
2013-11-03 23:00:18 +00:00
|
|
|
Hardware decoding over OpenGL-interop is supported to some degree. Note
|
|
|
|
|
that in this mode, some corner case might not be gracefully handled, and
|
2014-09-01 02:25:57 +00:00
|
|
|
color space conversion and chroma upsampling is generally in the hand of
|
2013-11-03 23:00:18 +00:00
|
|
|
the hardware decoder APIs.
|
|
|
|
|
|
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 06:04:55 +00:00
|
|
|
``gpu`` makes use of FBOs by default. Sometimes you can achieve better
|
2020-04-14 18:29:08 +00:00
|
|
|
quality or performance by changing the ``--fbo-format`` option to
|
2015-09-05 09:39:20 +00:00
|
|
|
``rgb16f``, ``rgb32f`` or ``rgb``. Known problems include Mesa/Intel not
|
|
|
|
|
accepting ``rgb16``, Mesa sometimes not being compiled with float texture
|
|
|
|
|
support, and some OS X setups being very slow with ``rgb16`` but fast
|
2016-09-02 13:59:40 +00:00
|
|
|
with ``rgb32f``. If you have problems, you can also try enabling the
|
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 06:04:55 +00:00
|
|
|
``--gpu-dumb-mode=yes`` option.
|
2012-09-29 16:36:05 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``sdl``
|
2012-12-28 07:07:14 +00:00
|
|
|
SDL 2.0+ Render video output driver, depending on system with or without
|
2013-07-08 16:02:14 +00:00
|
|
|
hardware acceleration. Should work on all platforms supported by SDL 2.0.
|
|
|
|
|
For tuning, refer to your copy of the file ``SDL_hints.h``.
|
2012-12-28 07:07:14 +00:00
|
|
|
|
2014-04-19 13:29:05 +00:00
|
|
|
.. note:: This driver is for compatibility with systems that don't provide
|
2019-08-29 20:02:09 +00:00
|
|
|
proper graphics drivers.
|
2014-04-19 13:29:05 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
The following global options are supported by this video output:
|
|
|
|
|
|
|
|
|
|
``--sdl-sw``
|
2013-01-04 16:43:37 +00:00
|
|
|
Continue even if a software renderer is detected.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--sdl-switch-mode``
|
2013-02-24 22:36:40 +00:00
|
|
|
Instruct SDL to switch the monitor video mode when going fullscreen.
|
|
|
|
|
|
video: add vaapi decode and output support
This is based on the MPlayer VA API patches. To be exact it's based on
a very stripped down version of commit f1ad459a263f8537f6c from
git://gitorious.org/vaapi/mplayer.git.
This doesn't contain useless things like benchmarking hacks and the
demo code for GLX interop. Also, unlike in the original patch, decoding
and video output are split into separate source files (the separation
between decoding and display also makes pixel format hacks unnecessary).
On the other hand, some features not present in the original patch were
added, like screenshot support.
VA API is rather bad for actual video output. Dealing with older libva
versions or the completely broken vdpau backend doesn't help. OSD is
low quality and should be rather slow. In some cases, only either OSD
or subtitles can be shown at the same time (because OSD is drawn first,
OSD is prefered).
Also, libva can't decide whether it accepts straight or premultiplied
alpha for OSD sub-pictures: the vdpau backend seems to assume
premultiplied, while a native vaapi driver uses straight. So I picked
straight alpha. It doesn't matter much, because the blending code for
straight alpha I added to img_convert.c is probably buggy, and ASS
subtitles might be blended incorrectly.
Really good video output with VA API would probably use OpenGL and the
GL interop features, but at this point you might just use vo_opengl.
(Patches for making HW decoding with vo_opengl have a chance of being
accepted.)
Despite these issues, decoding seems to work ok. I still got tearing
on the Intel system I tested (Intel(R) Core(TM) i3-2350M). It was also
tested with the vdpau vaapi wrapper on a nvidia system; however this
was rather broken. (Fortunately, there is no reason to use mpv's VAAPI
support over native VDPAU.)
2013-08-09 12:01:30 +00:00
|
|
|
``vaapi``
|
|
|
|
|
Intel VA API video output driver with support for hardware decoding. Note
|
2017-02-17 20:01:59 +00:00
|
|
|
that there is absolutely no reason to use this, other than compatibility.
|
|
|
|
|
This is low quality, and has issues with OSD.
|
video: add vaapi decode and output support
This is based on the MPlayer VA API patches. To be exact it's based on
a very stripped down version of commit f1ad459a263f8537f6c from
git://gitorious.org/vaapi/mplayer.git.
This doesn't contain useless things like benchmarking hacks and the
demo code for GLX interop. Also, unlike in the original patch, decoding
and video output are split into separate source files (the separation
between decoding and display also makes pixel format hacks unnecessary).
On the other hand, some features not present in the original patch were
added, like screenshot support.
VA API is rather bad for actual video output. Dealing with older libva
versions or the completely broken vdpau backend doesn't help. OSD is
low quality and should be rather slow. In some cases, only either OSD
or subtitles can be shown at the same time (because OSD is drawn first,
OSD is prefered).
Also, libva can't decide whether it accepts straight or premultiplied
alpha for OSD sub-pictures: the vdpau backend seems to assume
premultiplied, while a native vaapi driver uses straight. So I picked
straight alpha. It doesn't matter much, because the blending code for
straight alpha I added to img_convert.c is probably buggy, and ASS
subtitles might be blended incorrectly.
Really good video output with VA API would probably use OpenGL and the
GL interop features, but at this point you might just use vo_opengl.
(Patches for making HW decoding with vo_opengl have a chance of being
accepted.)
Despite these issues, decoding seems to work ok. I still got tearing
on the Intel system I tested (Intel(R) Core(TM) i3-2350M). It was also
tested with the vdpau vaapi wrapper on a nvidia system; however this
was rather broken. (Fortunately, there is no reason to use mpv's VAAPI
support over native VDPAU.)
2013-08-09 12:01:30 +00:00
|
|
|
|
2014-04-19 13:29:05 +00:00
|
|
|
.. note:: This driver is for compatibility with crappy systems. You can
|
2018-01-09 12:20:37 +00:00
|
|
|
use vaapi hardware decoding with ``--vo=gpu`` too.
|
2014-04-19 13:29:05 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
The following global options are supported by this video output:
|
|
|
|
|
|
|
|
|
|
``--vo-vaapi-scaling=<algorithm>``
|
video: add vaapi decode and output support
This is based on the MPlayer VA API patches. To be exact it's based on
a very stripped down version of commit f1ad459a263f8537f6c from
git://gitorious.org/vaapi/mplayer.git.
This doesn't contain useless things like benchmarking hacks and the
demo code for GLX interop. Also, unlike in the original patch, decoding
and video output are split into separate source files (the separation
between decoding and display also makes pixel format hacks unnecessary).
On the other hand, some features not present in the original patch were
added, like screenshot support.
VA API is rather bad for actual video output. Dealing with older libva
versions or the completely broken vdpau backend doesn't help. OSD is
low quality and should be rather slow. In some cases, only either OSD
or subtitles can be shown at the same time (because OSD is drawn first,
OSD is prefered).
Also, libva can't decide whether it accepts straight or premultiplied
alpha for OSD sub-pictures: the vdpau backend seems to assume
premultiplied, while a native vaapi driver uses straight. So I picked
straight alpha. It doesn't matter much, because the blending code for
straight alpha I added to img_convert.c is probably buggy, and ASS
subtitles might be blended incorrectly.
Really good video output with VA API would probably use OpenGL and the
GL interop features, but at this point you might just use vo_opengl.
(Patches for making HW decoding with vo_opengl have a chance of being
accepted.)
Despite these issues, decoding seems to work ok. I still got tearing
on the Intel system I tested (Intel(R) Core(TM) i3-2350M). It was also
tested with the vdpau vaapi wrapper on a nvidia system; however this
was rather broken. (Fortunately, there is no reason to use mpv's VAAPI
support over native VDPAU.)
2013-08-09 12:01:30 +00:00
|
|
|
default
|
|
|
|
|
Driver default (mpv default as well).
|
|
|
|
|
fast
|
|
|
|
|
Fast, but low quality.
|
|
|
|
|
hq
|
|
|
|
|
Unspecified driver dependent high-quality scaling, slow.
|
|
|
|
|
nla
|
|
|
|
|
``non-linear anamorphic scaling``
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--vo-vaapi-deint-mode=<mode>``
|
video: add vaapi decode and output support
This is based on the MPlayer VA API patches. To be exact it's based on
a very stripped down version of commit f1ad459a263f8537f6c from
git://gitorious.org/vaapi/mplayer.git.
This doesn't contain useless things like benchmarking hacks and the
demo code for GLX interop. Also, unlike in the original patch, decoding
and video output are split into separate source files (the separation
between decoding and display also makes pixel format hacks unnecessary).
On the other hand, some features not present in the original patch were
added, like screenshot support.
VA API is rather bad for actual video output. Dealing with older libva
versions or the completely broken vdpau backend doesn't help. OSD is
low quality and should be rather slow. In some cases, only either OSD
or subtitles can be shown at the same time (because OSD is drawn first,
OSD is prefered).
Also, libva can't decide whether it accepts straight or premultiplied
alpha for OSD sub-pictures: the vdpau backend seems to assume
premultiplied, while a native vaapi driver uses straight. So I picked
straight alpha. It doesn't matter much, because the blending code for
straight alpha I added to img_convert.c is probably buggy, and ASS
subtitles might be blended incorrectly.
Really good video output with VA API would probably use OpenGL and the
GL interop features, but at this point you might just use vo_opengl.
(Patches for making HW decoding with vo_opengl have a chance of being
accepted.)
Despite these issues, decoding seems to work ok. I still got tearing
on the Intel system I tested (Intel(R) Core(TM) i3-2350M). It was also
tested with the vdpau vaapi wrapper on a nvidia system; however this
was rather broken. (Fortunately, there is no reason to use mpv's VAAPI
support over native VDPAU.)
2013-08-09 12:01:30 +00:00
|
|
|
Select deinterlacing algorithm. Note that by default deinterlacing is
|
2015-11-23 23:16:19 +00:00
|
|
|
initially always off, and needs to be enabled with the ``d`` key
|
video: add vaapi decode and output support
This is based on the MPlayer VA API patches. To be exact it's based on
a very stripped down version of commit f1ad459a263f8537f6c from
git://gitorious.org/vaapi/mplayer.git.
This doesn't contain useless things like benchmarking hacks and the
demo code for GLX interop. Also, unlike in the original patch, decoding
and video output are split into separate source files (the separation
between decoding and display also makes pixel format hacks unnecessary).
On the other hand, some features not present in the original patch were
added, like screenshot support.
VA API is rather bad for actual video output. Dealing with older libva
versions or the completely broken vdpau backend doesn't help. OSD is
low quality and should be rather slow. In some cases, only either OSD
or subtitles can be shown at the same time (because OSD is drawn first,
OSD is prefered).
Also, libva can't decide whether it accepts straight or premultiplied
alpha for OSD sub-pictures: the vdpau backend seems to assume
premultiplied, while a native vaapi driver uses straight. So I picked
straight alpha. It doesn't matter much, because the blending code for
straight alpha I added to img_convert.c is probably buggy, and ASS
subtitles might be blended incorrectly.
Really good video output with VA API would probably use OpenGL and the
GL interop features, but at this point you might just use vo_opengl.
(Patches for making HW decoding with vo_opengl have a chance of being
accepted.)
Despite these issues, decoding seems to work ok. I still got tearing
on the Intel system I tested (Intel(R) Core(TM) i3-2350M). It was also
tested with the vdpau vaapi wrapper on a nvidia system; however this
was rather broken. (Fortunately, there is no reason to use mpv's VAAPI
support over native VDPAU.)
2013-08-09 12:01:30 +00:00
|
|
|
(default key binding for ``cycle deinterlace``).
|
|
|
|
|
|
2013-09-20 13:55:13 +00:00
|
|
|
This option doesn't apply if libva supports video post processing (vpp).
|
|
|
|
|
In this case, the default for ``deint-mode`` is ``no``, and enabling
|
|
|
|
|
deinterlacing via user interaction using the methods mentioned above
|
|
|
|
|
actually inserts the ``vavpp`` video filter. If vpp is not actually
|
|
|
|
|
supported with the libva backend in use, you can use this option to
|
|
|
|
|
forcibly enable VO based deinterlacing.
|
|
|
|
|
|
video: add vaapi decode and output support
This is based on the MPlayer VA API patches. To be exact it's based on
a very stripped down version of commit f1ad459a263f8537f6c from
git://gitorious.org/vaapi/mplayer.git.
This doesn't contain useless things like benchmarking hacks and the
demo code for GLX interop. Also, unlike in the original patch, decoding
and video output are split into separate source files (the separation
between decoding and display also makes pixel format hacks unnecessary).
On the other hand, some features not present in the original patch were
added, like screenshot support.
VA API is rather bad for actual video output. Dealing with older libva
versions or the completely broken vdpau backend doesn't help. OSD is
low quality and should be rather slow. In some cases, only either OSD
or subtitles can be shown at the same time (because OSD is drawn first,
OSD is prefered).
Also, libva can't decide whether it accepts straight or premultiplied
alpha for OSD sub-pictures: the vdpau backend seems to assume
premultiplied, while a native vaapi driver uses straight. So I picked
straight alpha. It doesn't matter much, because the blending code for
straight alpha I added to img_convert.c is probably buggy, and ASS
subtitles might be blended incorrectly.
Really good video output with VA API would probably use OpenGL and the
GL interop features, but at this point you might just use vo_opengl.
(Patches for making HW decoding with vo_opengl have a chance of being
accepted.)
Despite these issues, decoding seems to work ok. I still got tearing
on the Intel system I tested (Intel(R) Core(TM) i3-2350M). It was also
tested with the vdpau vaapi wrapper on a nvidia system; however this
was rather broken. (Fortunately, there is no reason to use mpv's VAAPI
support over native VDPAU.)
2013-08-09 12:01:30 +00:00
|
|
|
no
|
2013-09-20 13:55:13 +00:00
|
|
|
Don't allow deinterlacing (default for newer libva).
|
video: add vaapi decode and output support
This is based on the MPlayer VA API patches. To be exact it's based on
a very stripped down version of commit f1ad459a263f8537f6c from
git://gitorious.org/vaapi/mplayer.git.
This doesn't contain useless things like benchmarking hacks and the
demo code for GLX interop. Also, unlike in the original patch, decoding
and video output are split into separate source files (the separation
between decoding and display also makes pixel format hacks unnecessary).
On the other hand, some features not present in the original patch were
added, like screenshot support.
VA API is rather bad for actual video output. Dealing with older libva
versions or the completely broken vdpau backend doesn't help. OSD is
low quality and should be rather slow. In some cases, only either OSD
or subtitles can be shown at the same time (because OSD is drawn first,
OSD is prefered).
Also, libva can't decide whether it accepts straight or premultiplied
alpha for OSD sub-pictures: the vdpau backend seems to assume
premultiplied, while a native vaapi driver uses straight. So I picked
straight alpha. It doesn't matter much, because the blending code for
straight alpha I added to img_convert.c is probably buggy, and ASS
subtitles might be blended incorrectly.
Really good video output with VA API would probably use OpenGL and the
GL interop features, but at this point you might just use vo_opengl.
(Patches for making HW decoding with vo_opengl have a chance of being
accepted.)
Despite these issues, decoding seems to work ok. I still got tearing
on the Intel system I tested (Intel(R) Core(TM) i3-2350M). It was also
tested with the vdpau vaapi wrapper on a nvidia system; however this
was rather broken. (Fortunately, there is no reason to use mpv's VAAPI
support over native VDPAU.)
2013-08-09 12:01:30 +00:00
|
|
|
first-field
|
2017-07-21 18:00:09 +00:00
|
|
|
Show only first field.
|
video: add vaapi decode and output support
This is based on the MPlayer VA API patches. To be exact it's based on
a very stripped down version of commit f1ad459a263f8537f6c from
git://gitorious.org/vaapi/mplayer.git.
This doesn't contain useless things like benchmarking hacks and the
demo code for GLX interop. Also, unlike in the original patch, decoding
and video output are split into separate source files (the separation
between decoding and display also makes pixel format hacks unnecessary).
On the other hand, some features not present in the original patch were
added, like screenshot support.
VA API is rather bad for actual video output. Dealing with older libva
versions or the completely broken vdpau backend doesn't help. OSD is
low quality and should be rather slow. In some cases, only either OSD
or subtitles can be shown at the same time (because OSD is drawn first,
OSD is prefered).
Also, libva can't decide whether it accepts straight or premultiplied
alpha for OSD sub-pictures: the vdpau backend seems to assume
premultiplied, while a native vaapi driver uses straight. So I picked
straight alpha. It doesn't matter much, because the blending code for
straight alpha I added to img_convert.c is probably buggy, and ASS
subtitles might be blended incorrectly.
Really good video output with VA API would probably use OpenGL and the
GL interop features, but at this point you might just use vo_opengl.
(Patches for making HW decoding with vo_opengl have a chance of being
accepted.)
Despite these issues, decoding seems to work ok. I still got tearing
on the Intel system I tested (Intel(R) Core(TM) i3-2350M). It was also
tested with the vdpau vaapi wrapper on a nvidia system; however this
was rather broken. (Fortunately, there is no reason to use mpv's VAAPI
support over native VDPAU.)
2013-08-09 12:01:30 +00:00
|
|
|
bob
|
2013-09-20 13:55:13 +00:00
|
|
|
bob deinterlacing (default for older libva).
|
video: add vaapi decode and output support
This is based on the MPlayer VA API patches. To be exact it's based on
a very stripped down version of commit f1ad459a263f8537f6c from
git://gitorious.org/vaapi/mplayer.git.
This doesn't contain useless things like benchmarking hacks and the
demo code for GLX interop. Also, unlike in the original patch, decoding
and video output are split into separate source files (the separation
between decoding and display also makes pixel format hacks unnecessary).
On the other hand, some features not present in the original patch were
added, like screenshot support.
VA API is rather bad for actual video output. Dealing with older libva
versions or the completely broken vdpau backend doesn't help. OSD is
low quality and should be rather slow. In some cases, only either OSD
or subtitles can be shown at the same time (because OSD is drawn first,
OSD is prefered).
Also, libva can't decide whether it accepts straight or premultiplied
alpha for OSD sub-pictures: the vdpau backend seems to assume
premultiplied, while a native vaapi driver uses straight. So I picked
straight alpha. It doesn't matter much, because the blending code for
straight alpha I added to img_convert.c is probably buggy, and ASS
subtitles might be blended incorrectly.
Really good video output with VA API would probably use OpenGL and the
GL interop features, but at this point you might just use vo_opengl.
(Patches for making HW decoding with vo_opengl have a chance of being
accepted.)
Despite these issues, decoding seems to work ok. I still got tearing
on the Intel system I tested (Intel(R) Core(TM) i3-2350M). It was also
tested with the vdpau vaapi wrapper on a nvidia system; however this
was rather broken. (Fortunately, there is no reason to use mpv's VAAPI
support over native VDPAU.)
2013-08-09 12:01:30 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--vo-vaapi-scaled-osd=<yes|no>``
|
video: add vaapi decode and output support
This is based on the MPlayer VA API patches. To be exact it's based on
a very stripped down version of commit f1ad459a263f8537f6c from
git://gitorious.org/vaapi/mplayer.git.
This doesn't contain useless things like benchmarking hacks and the
demo code for GLX interop. Also, unlike in the original patch, decoding
and video output are split into separate source files (the separation
between decoding and display also makes pixel format hacks unnecessary).
On the other hand, some features not present in the original patch were
added, like screenshot support.
VA API is rather bad for actual video output. Dealing with older libva
versions or the completely broken vdpau backend doesn't help. OSD is
low quality and should be rather slow. In some cases, only either OSD
or subtitles can be shown at the same time (because OSD is drawn first,
OSD is prefered).
Also, libva can't decide whether it accepts straight or premultiplied
alpha for OSD sub-pictures: the vdpau backend seems to assume
premultiplied, while a native vaapi driver uses straight. So I picked
straight alpha. It doesn't matter much, because the blending code for
straight alpha I added to img_convert.c is probably buggy, and ASS
subtitles might be blended incorrectly.
Really good video output with VA API would probably use OpenGL and the
GL interop features, but at this point you might just use vo_opengl.
(Patches for making HW decoding with vo_opengl have a chance of being
accepted.)
Despite these issues, decoding seems to work ok. I still got tearing
on the Intel system I tested (Intel(R) Core(TM) i3-2350M). It was also
tested with the vdpau vaapi wrapper on a nvidia system; however this
was rather broken. (Fortunately, there is no reason to use mpv's VAAPI
support over native VDPAU.)
2013-08-09 12:01:30 +00:00
|
|
|
If enabled, then the OSD is rendered at video resolution and scaled to
|
|
|
|
|
display resolution. By default, this is disabled, and the OSD is
|
|
|
|
|
rendered at display resolution if the driver supports it.
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``null``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
Produces no video output. Useful for benchmarking.
|
|
|
|
|
|
2015-05-24 13:48:48 +00:00
|
|
|
Usually, it's better to disable video with ``--no-video`` instead.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
The following global options are supported by this video output:
|
|
|
|
|
|
|
|
|
|
``--vo-null-fps=<value>``
|
2015-05-24 13:48:48 +00:00
|
|
|
Simulate display FPS. This artificially limits how many frames the
|
|
|
|
|
VO accepts per second.
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``caca``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
Color ASCII art video output driver that works on a text console.
|
|
|
|
|
|
2014-04-19 13:29:05 +00:00
|
|
|
.. note:: This driver is a joke.
|
|
|
|
|
|
2016-10-12 23:30:45 +00:00
|
|
|
``tct``
|
|
|
|
|
Color Unicode art video output driver that works on a text console.
|
2020-08-16 09:22:22 +00:00
|
|
|
By default depends on support of true color by modern terminals to display
|
|
|
|
|
the images at full color range, but 256-colors outout is also supported (see
|
|
|
|
|
below). On Windows it requires an ansi terminal such as mintty.
|
2016-10-12 23:30:45 +00:00
|
|
|
|
sws_utils, zimg: destroy vo_x11 and vo_drm performance
Raise swscale and zimg default parameters. This restores screenshot
quality settings (maybe) unset in the commit before. Also expose some
more libswscale and zimg options.
Since these options are also used for VOs like x11 and drm, this will
make x11/drm/etc. much slower. For compensation, provide a profile that
sets the old option values: sw-fast. I'm also enabling zimg here, just
as an experiment.
The core problem is that we have a single set of command line options
which control the settings used for most swscale/zimg uses. This was
done in the previous commit. It cannot differentiate between the VOs,
which need to be realtime and may accept/require lower quality options,
and things like screenshots or vo_image, which can be slower, but should
not sacrifice quality by default.
Should this have two sets of options or something similar to do the
right thing depending on the code which calls libswscale? Maybe. Or
should I just ignore the problem, make it someone else's problem (users
who want to use software conversion VOs), provide a sub-optimal
solution, and call it a day? Definitely, sounds good, pushing to master,
goodbye.
2019-10-31 15:45:28 +00:00
|
|
|
Since mpv 0.30.0, you may need to use ``--profile=sw-fast`` to get decent
|
|
|
|
|
performance.
|
|
|
|
|
|
2020-08-16 09:22:22 +00:00
|
|
|
Note: the TCT image output is not synchronized with other terminal output
|
|
|
|
|
from mpv, which can lead to broken images. The options ``--no-terminal`` or
|
|
|
|
|
``--really-quiet`` can help with that.
|
|
|
|
|
|
2016-10-12 23:30:45 +00:00
|
|
|
``--vo-tct-algo=<algo>``
|
|
|
|
|
Select how to write the pixels to the terminal.
|
|
|
|
|
|
|
|
|
|
half-blocks
|
|
|
|
|
Uses unicode LOWER HALF BLOCK character to achieve higher vertical
|
|
|
|
|
resolution. (Default.)
|
|
|
|
|
plain
|
|
|
|
|
Uses spaces. Causes vertical resolution to drop twofolds, but in
|
|
|
|
|
theory works in more places.
|
|
|
|
|
|
2016-10-21 23:38:32 +00:00
|
|
|
``--vo-tct-width=<width>`` ``--vo-tct-height=<height>``
|
|
|
|
|
Assume the terminal has the specified character width and/or height.
|
|
|
|
|
These default to 80x25 if the terminal size cannot be determined.
|
|
|
|
|
|
2016-10-22 13:48:30 +00:00
|
|
|
``--vo-tct-256=<yes|no>`` (default: no)
|
|
|
|
|
Use 256 colors - for terminals which don't support true color.
|
|
|
|
|
|
2020-11-01 11:13:31 +00:00
|
|
|
``sixel``
|
|
|
|
|
Sixel graphics video output driver based on libsixel that works on a
|
|
|
|
|
console that has sixel graphics enabled such as ``xterm`` or ``mlterm``.
|
|
|
|
|
Additionally some terminals have limitation on the dimensions, so may
|
|
|
|
|
not display images bigger than 1000x1000 for example. Make sure that
|
|
|
|
|
``img2sixel`` can display images of the corresponding resolution.
|
|
|
|
|
You may need to use ``--profile=sw-fast`` to get decent performance.
|
|
|
|
|
|
|
|
|
|
Note: the Sixel image output is not synchronized with other terminal output
|
|
|
|
|
from mpv, which can lead to broken images. The option ``--really-quiet``
|
|
|
|
|
can help with that, and is recommended.
|
|
|
|
|
|
|
|
|
|
``--vo-sixel-diffusion=<algo>``
|
|
|
|
|
Selects the diffusion algorithm for dithering used by libsixel.
|
|
|
|
|
Can be one of the below list as per libsixel's documentation.
|
|
|
|
|
|
|
|
|
|
auto
|
|
|
|
|
Choose diffuse type automatically
|
|
|
|
|
none
|
|
|
|
|
Don't diffuse
|
|
|
|
|
atkinson
|
|
|
|
|
Diffuse with Bill Atkinson's method. (Default)
|
|
|
|
|
fs
|
|
|
|
|
Diffuse with Floyd-Steinberg method
|
|
|
|
|
jajuni
|
|
|
|
|
Diffuse with Jarvis, Judice & Ninke method
|
|
|
|
|
stucki
|
|
|
|
|
Diffuse with Stucki's method
|
|
|
|
|
burkes
|
|
|
|
|
Diffuse with Burkes' method
|
|
|
|
|
arithmetic
|
|
|
|
|
Positionally stable arithmetic dither
|
|
|
|
|
xor
|
|
|
|
|
Positionally stable arithmetic xor based dither
|
|
|
|
|
|
|
|
|
|
``--vo-sixel-width=<width>`` ``--vo-sixel-height=<height>``
|
|
|
|
|
The output video resolution will be set to width and height
|
|
|
|
|
These default to 320x240 if not set. The terminal window must
|
|
|
|
|
be bigger than this resolution to have smooth playback.
|
|
|
|
|
Additionally the last row will be a blank line and can't be
|
|
|
|
|
used to display pixel data.
|
|
|
|
|
|
|
|
|
|
``--vo-sixel-fixedpalette=<0|1>`` (default: 0)
|
|
|
|
|
Use libsixel's built-in static palette using the XTERM256 profile
|
|
|
|
|
for dither. Fixed palette uses 256 colors for dithering.
|
|
|
|
|
|
|
|
|
|
``--vo-sixel-reqcolors=<colors>`` (default: 256)
|
|
|
|
|
Setup libsixel to use required number of colors for dynamic palette.
|
|
|
|
|
This value depends on the console as well. Xterm supports 256.
|
|
|
|
|
Can set this to a lower value for faster performance.
|
|
|
|
|
This option has no effect if fixed palette is used.
|
|
|
|
|
|
|
|
|
|
``--vo-sixel-color-threshold=<threshold>`` (default: 0)
|
|
|
|
|
This threshold value is used in dynamic palette mode to
|
|
|
|
|
recompute the palette based on the scene changes.
|
|
|
|
|
|
|
|
|
|
``--vo-sixel-offset-top=<top>`` (default: 1)
|
|
|
|
|
The output video playback will start from the specified row number.
|
|
|
|
|
If this is greater than 1, then those many rows will be skipped.
|
|
|
|
|
This option can be used to shift video below in the terminal.
|
|
|
|
|
If it is greater than number of rows in terminal, then it is ignored.
|
|
|
|
|
|
|
|
|
|
``--vo-sixel-offset-left=<left>`` (default: 1)
|
|
|
|
|
The output video playback will start from the specified column number.
|
|
|
|
|
If this is greater than 1, then those many columns will be skipped.
|
|
|
|
|
This option can be used to shift video to the right in the terminal.
|
|
|
|
|
If it is greater than number of columns in terminal, then it is ignored.
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``image``
|
2012-08-06 17:15:04 +00:00
|
|
|
Output each frame into an image file in the current directory. Each file
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
takes the frame number padded with leading zeros as name.
|
|
|
|
|
|
2016-09-05 19:04:55 +00:00
|
|
|
The following global options are supported by this video output:
|
|
|
|
|
|
|
|
|
|
``--vo-image-format=<format>``
|
2012-08-06 17:15:04 +00:00
|
|
|
Select the image file format.
|
|
|
|
|
|
|
|
|
|
jpg
|
2012-11-15 13:25:20 +00:00
|
|
|
JPEG files, extension .jpg. (Default.)
|
2012-08-06 17:15:04 +00:00
|
|
|
jpeg
|
|
|
|
|
JPEG files, extension .jpeg.
|
|
|
|
|
png
|
|
|
|
|
PNG files.
|
2019-09-14 20:18:02 +00:00
|
|
|
webp
|
|
|
|
|
WebP files.
|
2012-08-06 17:15:04 +00:00
|
|
|
|
2016-09-05 19:04:55 +00:00
|
|
|
``--vo-image-png-compression=<0-9>``
|
2012-08-06 17:15:04 +00:00
|
|
|
PNG compression factor (speed vs. file size tradeoff) (default: 7)
|
2016-09-05 19:04:55 +00:00
|
|
|
``--vo-image-png-filter=<0-5>``
|
2013-06-15 13:14:06 +00:00
|
|
|
Filter applied prior to PNG compression (0 = none; 1 = sub; 2 = up;
|
|
|
|
|
3 = average; 4 = Paeth; 5 = mixed) (default: 5)
|
2016-09-05 19:04:55 +00:00
|
|
|
``--vo-image-jpeg-quality=<0-100>``
|
2012-08-23 12:12:30 +00:00
|
|
|
JPEG quality factor (default: 90)
|
2016-09-05 19:04:55 +00:00
|
|
|
``--vo-image-jpeg-optimize=<0-100>``
|
2012-08-22 13:45:34 +00:00
|
|
|
JPEG optimization factor (default: 100)
|
2019-09-14 20:18:02 +00:00
|
|
|
``--vo-image-webp-lossless=<yes|no>``
|
|
|
|
|
Enable writing lossless WebP files (default: no)
|
|
|
|
|
``--vo-image-webp-quality=<0-100>``
|
|
|
|
|
WebP quality (default: 75)
|
2019-08-02 14:04:54 +00:00
|
|
|
``--vo-image-webp-compression=<0-6>``
|
|
|
|
|
WebP compression factor (default: 4)
|
2016-09-05 19:04:55 +00:00
|
|
|
``--vo-image-outdir=<dirname>``
|
2012-08-06 17:15:04 +00:00
|
|
|
Specify the directory to save the image files to (default: ``./``).
|
2013-04-15 20:37:02 +00:00
|
|
|
|
2018-02-20 12:30:18 +00:00
|
|
|
``libmpv``
|
|
|
|
|
For use with libmpv direct embedding. As a special case, on OS X it
|
cocoa-cb: initial implementation via opengl-cb API
this is meant to replace the old and not properly working vo_gpu/opengl
cocoa backend in the future. the problems are various shortcomings of
Apple's opengl implementation and buggy behaviour in certain
circumstances that couldn't be properly worked around. there are also
certain regressions on newer macOS versions from 10.11 onwards.
- awful opengl performance with a none layer backed context
- huge amount of dropped frames with an early context flush
- flickering of system elements like the dock or volume indicator
- double buffering not properly working with a none layer backed context
- bad performance in fullscreen because of system optimisations
all the problems were caused by using a normal opengl context, that
seems somewhat abandoned by apple, and are fixed by using a layer backed
opengl context instead. problems that couldn't be fixed could be
properly worked around.
this has all features our old backend has sans the wid embedding,
the possibility to disable the automatic GPU switching and taking
screenshots of the window content. the first was deemed unnecessary by
me for now, since i just use the libmpv API that others can use anyway.
second is technically not possible atm because we have to pre-allocate
our opengl context at a time the config isn't read yet, so we can't get
the needed property. third one is a bit tricky because of deadlocking
and it needed to be in sync, hopefully i can work around that in the
future.
this also has at least one additional feature or eye-candy. a properly
working fullscreen animation with the native fs. also since this is a
direct port of the old backend of the parts that could be used, though
with adaptions and improvements, this looks a lot cleaner and easier to
understand.
some credit goes to @pigoz for the initial swift build support which
i could improve upon.
Fixes: #5478, #5393, #5152, #5151, #4615, #4476, #3978, #3746, #3739,
#2392, #2217
2018-02-12 11:28:19 +00:00
|
|
|
is used like a normal VO within mpv (cocoa-cb). Otherwise useless in any
|
|
|
|
|
other contexts.
|
2018-02-20 12:30:18 +00:00
|
|
|
(See ``<mpv/render.h>``.)
|
2015-01-08 16:06:17 +00:00
|
|
|
|
2018-02-20 12:30:18 +00:00
|
|
|
This also supports many of the options the ``gpu`` VO has, depending on the
|
|
|
|
|
backend.
|
2015-03-29 13:12:11 +00:00
|
|
|
|
|
|
|
|
``rpi`` (Raspberry Pi)
|
|
|
|
|
Native video output on the Raspberry Pi using the MMAL API.
|
|
|
|
|
|
2018-01-09 12:20:37 +00:00
|
|
|
This is deprecated. Use ``--vo=gpu`` instead, which is the default and
|
2016-09-12 17:58:06 +00:00
|
|
|
provides the same functionality. The ``rpi`` VO will be removed in
|
2018-01-09 12:20:37 +00:00
|
|
|
mpv 0.23.0. Its functionality was folded into --vo=gpu, which now uses
|
2016-09-12 17:58:06 +00:00
|
|
|
RPI hardware decoding by treating it as a hardware overlay (without applying
|
2016-11-21 19:17:41 +00:00
|
|
|
GL filtering). Also to be changed in 0.23.0: the --fs flag will be reset to
|
2016-09-12 17:58:06 +00:00
|
|
|
"no" by default (like on the other platforms).
|
|
|
|
|
|
|
|
|
|
The following deprecated global options are supported by this video output:
|
2016-09-05 19:07:03 +00:00
|
|
|
|
|
|
|
|
``--rpi-display=<number>``
|
2015-03-29 13:12:11 +00:00
|
|
|
Select the display number on which the video overlay should be shown
|
|
|
|
|
(default: 0).
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--rpi-layer=<number>``
|
2015-03-29 13:12:11 +00:00
|
|
|
Select the dispmanx layer on which the video overlay should be shown
|
|
|
|
|
(default: -10). Note that mpv will also use the 2 layers above the
|
|
|
|
|
selected layer, to handle the window background and OSD. Actual video
|
|
|
|
|
rendering will happen on the layer above the selected layer.
|
2015-04-16 19:43:01 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--rpi-background=<yes|no>``
|
2015-08-20 17:07:18 +00:00
|
|
|
Whether to render a black background behind the video (default: no).
|
|
|
|
|
Normally it's better to kill the console framebuffer instead, which
|
|
|
|
|
gives better performance.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--rpi-osd=<yes|no>``
|
2015-11-25 21:06:17 +00:00
|
|
|
Enabled by default. If disabled with ``no``, no OSD layer is created.
|
|
|
|
|
This also means there will be no subtitles rendered.
|
|
|
|
|
|
2015-04-16 19:43:01 +00:00
|
|
|
``drm`` (Direct Rendering Manager)
|
|
|
|
|
Video output driver using Kernel Mode Setting / Direct Rendering Manager.
|
vo_opengl: add DRM EGL backend
Notes:
- Unfortunately the only way to talk to EGL from within DRM I could find
involves linking with GBM (generic buffer management for Mesa.)
Because of this, I'm pretty sure it won't work with proprietary NVidia
drivers, but then again, last time I checked NVidia didn't offer
proper screen resolution for VT.
- VT switching doesn't seem to work at all. It's worth mentioning that
using vo_drm before introduction of VT switcher had an anomaly where
user could switch to another VT and input text to it, while video
played on top of that VT. However, that isn't the case with drm_egl:
I can't switch to other VT during playback like this. This makes me
think that it's either a limitation coming from my firmware or from
EGL/KMS itself rather than a bug with my code. Nonetheless, I still
left (untestable) VT switching code in place, in case it's useful to
someone else.
- The mode_id, connector_id and device_path should be configurable for
power users and people who wish to watch videos on nonprimary screen.
Unfortunately I didn't see anything that would allow OpenGL backends
to register their own set of options. At the same time, adding them to
global namespace is pointless.
- A few dozens of lines could be shared with vo_drm (setting up VT
switching, most of code behind page flipping). I don't have any strong
opinion on this.
- Sometimes I get minor visual glitches. I'm not sure if there's a race
condition of some sort, unitialized variable (doubtful), or if it's
buggy driver. (I'm using integrated Intel HD Graphics 4400 with Mesa)
- .config and .control are very minimal.
Signed-off-by: wm4 <wm4@nowhere>
2015-11-07 18:06:57 +00:00
|
|
|
Should be used when one doesn't want to install full-blown graphical
|
|
|
|
|
environment (e.g. no X). Does not support hardware acceleration (if you
|
2018-01-09 12:20:37 +00:00
|
|
|
need this, check the ``drm`` backend for ``gpu`` VO).
|
2015-04-16 19:43:01 +00:00
|
|
|
|
sws_utils, zimg: destroy vo_x11 and vo_drm performance
Raise swscale and zimg default parameters. This restores screenshot
quality settings (maybe) unset in the commit before. Also expose some
more libswscale and zimg options.
Since these options are also used for VOs like x11 and drm, this will
make x11/drm/etc. much slower. For compensation, provide a profile that
sets the old option values: sw-fast. I'm also enabling zimg here, just
as an experiment.
The core problem is that we have a single set of command line options
which control the settings used for most swscale/zimg uses. This was
done in the previous commit. It cannot differentiate between the VOs,
which need to be realtime and may accept/require lower quality options,
and things like screenshots or vo_image, which can be slower, but should
not sacrifice quality by default.
Should this have two sets of options or something similar to do the
right thing depending on the code which calls libswscale? Maybe. Or
should I just ignore the problem, make it someone else's problem (users
who want to use software conversion VOs), provide a sub-optimal
solution, and call it a day? Definitely, sounds good, pushing to master,
goodbye.
2019-10-31 15:45:28 +00:00
|
|
|
Since mpv 0.30.0, you may need to use ``--profile=sw-fast`` to get decent
|
|
|
|
|
performance.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
The following global options are supported by this video output:
|
|
|
|
|
|
2016-10-04 20:07:19 +00:00
|
|
|
``--drm-connector=[<gpu_number>.]<name>``
|
|
|
|
|
Select the connector to use (usually this is a monitor.) If ``<name>``
|
|
|
|
|
is empty or ``auto``, mpv renders the output on the first available
|
2018-06-02 10:53:58 +00:00
|
|
|
connector. Use ``--drm-connector=help`` to get a list of available
|
2016-10-04 20:07:19 +00:00
|
|
|
connectors. When using multiple graphic cards, use the ``<gpu_number>``
|
|
|
|
|
argument to disambiguate.
|
|
|
|
|
(default: empty)
|
2015-05-28 18:53:14 +00:00
|
|
|
|
2018-06-05 07:15:54 +00:00
|
|
|
``--drm-mode=<preferred|highest|N|WxH[@R]>``
|
|
|
|
|
Mode to use (resolution and frame rate).
|
|
|
|
|
Possible values:
|
|
|
|
|
|
|
|
|
|
:preferred: Use the preferred mode for the screen on the selected
|
|
|
|
|
connector. (default)
|
|
|
|
|
:highest: Use the mode with the highest resolution available on the
|
|
|
|
|
selected connector.
|
|
|
|
|
:N: Select mode by index.
|
|
|
|
|
:WxH[@R]: Specify mode by width, height, and optionally refresh rate.
|
|
|
|
|
In case several modes match, selects the mode that comes
|
|
|
|
|
first in the EDID list of modes.
|
|
|
|
|
|
|
|
|
|
Use ``--drm-mode=help`` to get a list of available modes for all active
|
|
|
|
|
connectors.
|
2016-09-02 13:59:40 +00:00
|
|
|
|
2018-06-28 13:23:19 +00:00
|
|
|
``--drm-atomic=<no|auto>``
|
|
|
|
|
Toggle use of atomic modesetting. Mostly useful for debugging.
|
|
|
|
|
|
|
|
|
|
:no: Use legacy modesetting.
|
|
|
|
|
:auto: Use atomic modesetting, falling back to legacy modesetting if
|
|
|
|
|
not available. (default)
|
|
|
|
|
|
|
|
|
|
Note: Only affects ``gpu-context=drm``. ``vo=drm`` supports legacy
|
|
|
|
|
modesetting only.
|
|
|
|
|
|
2018-12-01 11:01:17 +00:00
|
|
|
``--drm-draw-plane=<primary|overlay|N>``
|
|
|
|
|
Select the DRM plane to which video and OSD is drawn to, under normal
|
|
|
|
|
circumstances. The plane can be specified as ``primary``, which will
|
|
|
|
|
pick the first applicable primary plane; ``overlay``, which will pick
|
|
|
|
|
the first applicable overlay plane; or by index. The index is zero
|
|
|
|
|
based, and related to the CRTC.
|
2018-06-02 10:54:05 +00:00
|
|
|
(default: primary)
|
|
|
|
|
|
2018-12-01 11:01:17 +00:00
|
|
|
When using this option with the drmprime-drm hwdec interop, only the OSD
|
|
|
|
|
is rendered to this plane.
|
|
|
|
|
|
|
|
|
|
``--drm-drmprime-video-plane=<primary|overlay|N>``
|
|
|
|
|
Select the DRM plane to use for video with the drmprime-drm hwdec
|
|
|
|
|
interop (used by e.g. the rkmpp hwdec on RockChip SoCs, and v4l2 hwdec:s
|
|
|
|
|
on various other SoC:s). The plane is unused otherwise. This option
|
|
|
|
|
accepts the same values as ``--drm-draw-plane``. (default: overlay)
|
|
|
|
|
|
|
|
|
|
To be able to successfully play 4K video on various SoCs you might need
|
|
|
|
|
to set ``--drm-draw-plane=overlay --drm-drmprime-video-plane=primary``
|
|
|
|
|
and setting ``--drm-draw-surface-size=1920x1080``, to render the OSD at a
|
|
|
|
|
lower resolution (the video when handled by the hwdec will be on the
|
|
|
|
|
drmprime-video plane and at full 4K resolution)
|
2018-04-29 15:46:23 +00:00
|
|
|
|
2018-09-05 11:42:31 +00:00
|
|
|
``--drm-format=<xrgb8888|xrgb2101010>``
|
2018-02-13 17:40:47 +00:00
|
|
|
Select the DRM format to use (default: xrgb8888). This allows you to
|
|
|
|
|
choose the bit depth of the DRM mode. xrgb8888 is your usual 24 bit per
|
|
|
|
|
pixel/8 bits per channel packed RGB format with 8 bits of padding.
|
|
|
|
|
xrgb2101010 is a packed 30 bits per pixel/10 bits per channel packed RGB
|
|
|
|
|
format with 2 bits of padding.
|
|
|
|
|
|
2018-02-19 18:23:44 +00:00
|
|
|
There are cases when xrgb2101010 will work with the ``drm`` VO, but not
|
|
|
|
|
with the ``drm`` backend for the ``gpu`` VO. This is because with the
|
|
|
|
|
``gpu`` VO, in addition to requiring support in your DRM driver,
|
|
|
|
|
requires support for xrgb2101010 in your EGL driver
|
2018-02-13 17:40:47 +00:00
|
|
|
|
2018-12-01 11:01:17 +00:00
|
|
|
``--drm-draw-surface-size=<[WxH]>``
|
|
|
|
|
Sets the size of the surface used on the draw plane. The surface will
|
|
|
|
|
then be upscaled to the current screen resolution. This option can be
|
|
|
|
|
useful when used together with the drmprime-drm hwdec interop at high
|
|
|
|
|
resolutions, as it allows scaling the draw plane (which in this case
|
|
|
|
|
only handles the OSD) down to a size the GPU can handle.
|
|
|
|
|
|
|
|
|
|
When used without the drmprime-drm hwdec interop this option will just
|
|
|
|
|
cause the video to get rendered at a different resolution and then
|
|
|
|
|
scaled to screen size.
|
|
|
|
|
|
|
|
|
|
Note: this option is only available with DRM atomic support.
|
2018-04-29 13:09:16 +00:00
|
|
|
(default: display resolution)
|
|
|
|
|
|
2017-07-06 17:58:26 +00:00
|
|
|
``mediacodec_embed`` (Android)
|
|
|
|
|
Renders ``IMGFMT_MEDIACODEC`` frames directly to an ``android.view.Surface``.
|
|
|
|
|
Requires ``--hwdec=mediacodec`` for hardware decoding, along with
|
|
|
|
|
``--vo=mediacodec_embed`` and ``--wid=(intptr_t)(*android.view.Surface)``.
|
|
|
|
|
|
|
|
|
|
Since this video output driver uses native decoding and rendering routines,
|
|
|
|
|
many of mpv's features (subtitle rendering, OSD/OSC, video filters, etc)
|
|
|
|
|
are not available with this driver.
|
2017-10-05 18:58:37 +00:00
|
|
|
|
2019-08-29 20:02:09 +00:00
|
|
|
To use hardware decoding with ``--vo=gpu`` instead, use
|
2017-10-05 18:58:37 +00:00
|
|
|
``--hwdec=mediacodec-copy`` along with ``--gpu-context=android``.
|
2018-08-27 20:06:38 +00:00
|
|
|
|
|
|
|
|
``wlshm`` (Wayland only)
|
|
|
|
|
Shared memory video output driver without hardware acceleration that works
|
|
|
|
|
whenever Wayland is present.
|
|
|
|
|
|
sws_utils, zimg: destroy vo_x11 and vo_drm performance
Raise swscale and zimg default parameters. This restores screenshot
quality settings (maybe) unset in the commit before. Also expose some
more libswscale and zimg options.
Since these options are also used for VOs like x11 and drm, this will
make x11/drm/etc. much slower. For compensation, provide a profile that
sets the old option values: sw-fast. I'm also enabling zimg here, just
as an experiment.
The core problem is that we have a single set of command line options
which control the settings used for most swscale/zimg uses. This was
done in the previous commit. It cannot differentiate between the VOs,
which need to be realtime and may accept/require lower quality options,
and things like screenshots or vo_image, which can be slower, but should
not sacrifice quality by default.
Should this have two sets of options or something similar to do the
right thing depending on the code which calls libswscale? Maybe. Or
should I just ignore the problem, make it someone else's problem (users
who want to use software conversion VOs), provide a sub-optimal
solution, and call it a day? Definitely, sounds good, pushing to master,
goodbye.
2019-10-31 15:45:28 +00:00
|
|
|
Since mpv 0.30.0, you may need to use ``--profile=sw-fast`` to get decent
|
|
|
|
|
performance.
|
|
|
|
|
|
2018-08-27 20:06:38 +00:00
|
|
|
.. note:: This is a fallback only, and should not be normally used.
|
