options: deprecate suboptions for the remaining AO/VOs

This commit is contained in:
wm4 2016-09-05 21:07:03 +02:00
parent 633eb30cbe
commit 69283bc0f8
23 changed files with 136 additions and 74 deletions

View File

@ -20,6 +20,10 @@ Interface changes
:: ::
--- mpv 0.21.0 --- --- mpv 0.21.0 ---
- deprecate _all_ --vo and --ao suboptions. Generally, all suboptions are
replaced by global options, which do exactly the same. For example,
"--vo=opengl:scale=nearest" turns into "--scale=nearest". In some cases,
the global option is prefixed.
- subtle changes in how "--no-..." options are treated mean that they are - subtle changes in how "--no-..." options are treated mean that they are
not accessible under "options/..." anymore (instead, these are resolved not accessible under "options/..." anymore (instead, these are resolved
at parsing time). This does not affect options which start with "--no-", at parsing time). This does not affect options which start with "--no-",

View File

@ -30,6 +30,8 @@ Available audio output drivers are:
``alsa`` (Linux only) ``alsa`` (Linux only)
ALSA audio output driver ALSA audio output driver
See `ALSA audio output options`_ for options specific to this AO.
.. warning:: .. warning::
To get multichannel/surround audio, use ``--audio-channels=auto``. The To get multichannel/surround audio, use ``--audio-channels=auto``. The
@ -45,11 +47,13 @@ Available audio output drivers are:
``oss`` ``oss``
OSS audio output driver OSS audio output driver
``<dsp-device>`` The following global options are supported by this audio output:
``--oss-device``
Sets the audio output device (default: ``/dev/dsp``). Sets the audio output device (default: ``/dev/dsp``).
``<mixer-device>`` ``--oss-mixer-device``
Sets the audio mixer device (default: ``/dev/mixer``). Sets the audio mixer device (default: ``/dev/mixer``).
``<mixer-channel>`` ``--oss-mixer-channel``
Sets the audio mixer channel (default: ``pcm``). Other valid values Sets the audio mixer channel (default: ``pcm``). Other valid values
include **vol, pcm, line**. For a complete list of options look for include **vol, pcm, line**. For a complete list of options look for
``SOUND_DEVICE_NAMES`` in ``/usr/include/linux/soundcard.h``. ``SOUND_DEVICE_NAMES`` in ``/usr/include/linux/soundcard.h``.
@ -91,7 +95,9 @@ Available audio output drivers are:
Automatically redirects to ``coreaudio_exclusive`` when playing compressed Automatically redirects to ``coreaudio_exclusive`` when playing compressed
formats. formats.
``change-physical-format=<yes|no>`` The following global options are supported by this audio output:
``--coreaudio-change-physical-format=<yes|no>``
Change the physical format to one similar to the requested audio format Change the physical format to one similar to the requested audio format
(default: no). This has the advantage that multichannel audio output (default: no). This has the advantage that multichannel audio output
will actually work. The disadvantage is that it will change the will actually work. The disadvantage is that it will change the
@ -99,7 +105,7 @@ Available audio output drivers are:
setting in the ``Audio Devices`` dialog in the ``Audio MIDI Setup`` setting in the ``Audio Devices`` dialog in the ``Audio MIDI Setup``
utility. Note that this does not affect the selected speaker setup. utility. Note that this does not affect the selected speaker setup.
``exclusive`` ``--coreaudio-exclusive``
Use exclusive mode access. This merely redirects to Use exclusive mode access. This merely redirects to
``coreaudio_exclusive``, but should be preferred over using that AO ``coreaudio_exclusive``, but should be preferred over using that AO
directly. directly.
@ -117,18 +123,20 @@ Available audio output drivers are:
``pulse`` ``pulse``
PulseAudio audio output driver PulseAudio audio output driver
``host=<host>``, ``sink=<sink>`` The following global options are supported by this audio output:
``--pulse-host=<host>``, ``--pulse-sink=<sink>``
Specify the host and optionally output sink to use. An empty <host> Specify the host and optionally output sink to use. An empty <host>
string uses a local connection, "localhost" uses network transfer string uses a local connection, "localhost" uses network transfer
(most likely not what you want). (most likely not what you want).
``buffer=<1-2000|native>`` ``--pulse-buffer=<1-2000|native>``
Set the audio buffer size in milliseconds. A higher value buffers Set the audio buffer size in milliseconds. A higher value buffers
more data, and has a lower probability of buffer underruns. A smaller more data, and has a lower probability of buffer underruns. A smaller
value makes the audio stream react faster, e.g. to playback speed value makes the audio stream react faster, e.g. to playback speed
changes. Default: 250. changes. Default: 250.
``latency-hacks=<yes|no>`` ``--pulse-latency-hacks=<yes|no>``
Enable hacks to workaround PulseAudio timing bugs (default: no). If Enable hacks to workaround PulseAudio timing bugs (default: no). If
enabled, mpv will do elaborate latency calculations on its own. If enabled, mpv will do elaborate latency calculations on its own. If
disabled, it will use PulseAudio automatically updated timing disabled, it will use PulseAudio automatically updated timing
@ -148,13 +156,15 @@ Available audio output drivers are:
environments, such as systems where none of the other drivers environments, such as systems where none of the other drivers
are available. are available.
``buflen=<length>`` The following global options are supported by this audio output:
``--sdl-buflen=<length>``
Sets the audio buffer length in seconds. Is used only as a hint by the Sets the audio buffer length in seconds. Is used only as a hint by the
sound system. Playing a file with ``-v`` will show the requested and sound system. Playing a file with ``-v`` will show the requested and
obtained exact buffer size. A value of 0 selects the sound system obtained exact buffer size. A value of 0 selects the sound system
default. default.
``bufcnt=<count>`` ``--sdl-bufcnt=<count>``
Sets the number of extra audio buffers in mpv. Usually needs not be Sets the number of extra audio buffers in mpv. Usually needs not be
changed. changed.
@ -162,47 +172,51 @@ Available audio output drivers are:
Produces no audio output but maintains video playback speed. Use Produces no audio output but maintains video playback speed. Use
``--ao=null:untimed`` for benchmarking. ``--ao=null:untimed`` for benchmarking.
``untimed`` The following global options are supported by this audio output:
``--ao-null-untimed``
Do not simulate timing of a perfect audio device. This means audio Do not simulate timing of a perfect audio device. This means audio
decoding will go as fast as possible, instead of timing it to the decoding will go as fast as possible, instead of timing it to the
system clock. system clock.
``buffer`` ``--ao-null-buffer``
Simulated buffer length in seconds. Simulated buffer length in seconds.
``outburst`` ``--ao-null-outburst``
Simulated chunk size in samples. Simulated chunk size in samples.
``speed`` ``--ao-null-speed``
Simulated audio playback speed as a multiplier. Usually, a real audio Simulated audio playback speed as a multiplier. Usually, a real audio
device will not go exactly as fast as the system clock. It will deviate device will not go exactly as fast as the system clock. It will deviate
just a little, and this option helps to simulate this. just a little, and this option helps to simulate this.
``latency`` ``--ao-null-latency``
Simulated device latency. This is additional to EOF. Simulated device latency. This is additional to EOF.
``broken-eof`` ``--ao-null-broken-eof``
Simulate broken audio drivers, which always add the fixed device Simulate broken audio drivers, which always add the fixed device
latency to the reported audio playback position. latency to the reported audio playback position.
``broken-delay`` ``--ao-null-broken-delay``
Simulate broken audio drivers, which don't report latency correctly. Simulate broken audio drivers, which don't report latency correctly.
``channel-layouts`` ``--ao-null-channel-layouts``
If not empty, this is a ``,`` separated list of channel layouts the If not empty, this is a ``,`` separated list of channel layouts the
AO allows. This can be used to test channel layout selection. AO allows. This can be used to test channel layout selection.
``pcm`` ``pcm``
Raw PCM/WAVE file writer audio output Raw PCM/WAVE file writer audio output
``(no-)waveheader`` The following global options are supported by this audio output:
``--ao-pcm-waveheader=<yes|no>``
Include or do not include the WAVE header (default: included). When Include or do not include the WAVE header (default: included). When
not included, raw PCM will be generated. not included, raw PCM will be generated.
``file=<filename>`` ``--ao-pcm-file=<filename>``
Write the sound to ``<filename>`` instead of the default Write the sound to ``<filename>`` instead of the default
``audiodump.wav``. If ``no-waveheader`` is specified, the default is ``audiodump.wav``. If ``no-waveheader`` is specified, the default is
``audiodump.pcm``. ``audiodump.pcm``.
``(no-)append`` ``--ao-pcm-append=<yes|no>``
Append to the file, instead of overwriting it. Always use this with the Append to the file, instead of overwriting it. Always use this with the
``no-waveheader`` option - with ``waveheader`` it's broken, because ``no-waveheader`` option - with ``waveheader`` it's broken, because
it will write a WAVE header every time the file is opened. it will write a WAVE header every time the file is opened.
@ -214,11 +228,13 @@ Available audio output drivers are:
confused with RoarAudio, which is something completely confused with RoarAudio, which is something completely
different. different.
``host=<name/path>`` The following global options are supported by this audio output:
``--rsound-host=<name/path>``
Set the address of the server (default: localhost). Can be either a Set the address of the server (default: localhost). Can be either a
network hostname for TCP connections or a Unix domain socket path network hostname for TCP connections or a Unix domain socket path
starting with '/'. starting with '/'.
``port=<number>`` ``--rsound-port=<number>``
Set the TCP port used for connecting to the server (default: 12345). Set the TCP port used for connecting to the server (default: 12345).
Not used if connecting to a Unix domain socket. Not used if connecting to a Unix domain socket.
@ -230,16 +246,20 @@ Available audio output drivers are:
(Note: only supports mono, stereo, 4.0, 5.1 and 7.1 channel (Note: only supports mono, stereo, 4.0, 5.1 and 7.1 channel
layouts.) layouts.)
``device=<device>`` The following global options are supported by this audio output:
``--ao-sndio-device=<device>``
sndio device to use (default: ``$AUDIODEVICE``, resp. ``snd0``). sndio device to use (default: ``$AUDIODEVICE``, resp. ``snd0``).
``wasapi`` ``wasapi``
Audio output to the Windows Audio Session API. Audio output to the Windows Audio Session API.
``exclusive`` The following global options are supported by this audio output:
``--ao-wasapi-exclusive``
Requests exclusive, direct hardware access. By definition prevents Requests exclusive, direct hardware access. By definition prevents
sound playback of any other program until mpv exits. sound playback of any other program until mpv exits.
``device=<id>`` ``--ao-wasapi-device=<id>``
Uses the requested endpoint instead of the system's default audio Uses the requested endpoint instead of the system's default audio
endpoint. Both an ordinal number (0,1,2,...) and the GUID endpoint. Both an ordinal number (0,1,2,...) and the GUID
String are valid; the GUID string is guaranteed to not change String are valid; the GUID string is guaranteed to not change

View File

@ -36,11 +36,13 @@ Available video output drivers are:
.. note:: This driver is for compatibility with old systems. .. note:: This driver is for compatibility with old systems.
``adaptor=<number>`` The following global options are supported by this video output:
``--xv-adaptor=<number>``
Select a specific XVideo adapter (check xvinfo results). Select a specific XVideo adapter (check xvinfo results).
``port=<number>`` ``--xv-port=<number>``
Select a specific XVideo port. Select a specific XVideo port.
``ck=<cur|use|set>`` ``--xv-ck=<cur|use|set>``
Select the source from which the color key is taken (default: cur). Select the source from which the color key is taken (default: cur).
cur cur
@ -51,7 +53,7 @@ Available video output drivers are:
set set
Same as use but also sets the supplied color key. Same as use but also sets the supplied color key.
``ck-method=<none|man|bg|auto>`` ``--xv-ck-method=<none|man|bg|auto>``
Sets the color key drawing method (default: man). Sets the color key drawing method (default: man).
none none
@ -63,11 +65,11 @@ Available video output drivers are:
auto auto
Let Xv draw the color key. Let Xv draw the color key.
``colorkey=<number>`` ``--xv-colorkey=<number>``
Changes the color key to an RGB value of your choice. ``0x000000`` is Changes the color key to an RGB value of your choice. ``0x000000`` is
black and ``0xffffff`` is white. black and ``0xffffff`` is white.
``buffers=<number>`` ``--xv-buffers=<number>``
Number of image buffers to use for the internal ringbuffer (default: 2). 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 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 not responding quickly enough if video FPS is close to or higher than
@ -90,17 +92,19 @@ Available video output drivers are:
``chroma-deint``, ``pullup``, ``hqscaling``. These sub-options are ``chroma-deint``, ``pullup``, ``hqscaling``. These sub-options are
deprecated, and you should use the ``vdpaupp`` video filter instead. deprecated, and you should use the ``vdpaupp`` video filter instead.
``sharpen=<-1-1>`` The following global options are supported by this video output:
``--vo-vdpau-sharpen=<-1-1>``
(Deprecated. See note about ``vdpaupp``.) (Deprecated. See note about ``vdpaupp``.)
For positive values, apply a sharpening algorithm to the video, for For positive values, apply a sharpening algorithm to the video, for
negative values a blurring algorithm (default: 0). negative values a blurring algorithm (default: 0).
``denoise=<0-1>`` ``--vo-vdpau-denoise=<0-1>``
(Deprecated. See note about ``vdpaupp``.) (Deprecated. See note about ``vdpaupp``.)
Apply a noise reduction algorithm to the video (default: 0; no noise Apply a noise reduction algorithm to the video (default: 0; no noise
reduction). reduction).
``deint=<-4-4>`` ``--vo-vdpau-deint=<-4-4>``
(Deprecated. See note about ``vdpaupp``.) (Deprecated. See note about ``vdpaupp``.)
Select deinterlacing mode (default: 0). In older versions (as well as Select deinterlacing mode (default: 0). In older versions (as well as
@ -123,32 +127,32 @@ Available video output drivers are:
4 4
Motion-adaptive temporal deinterlacing with edge-guided spatial Motion-adaptive temporal deinterlacing with edge-guided spatial
interpolation. Needs fast video hardware. interpolation. Needs fast video hardware.
``chroma-deint`` ``--vo-vdpau-chroma-deint``
(Deprecated. See note about ``vdpaupp``.) (Deprecated. See note about ``vdpaupp``.)
Makes temporal deinterlacers operate both on luma and chroma (default). Makes temporal deinterlacers operate both on luma and chroma (default).
Use no-chroma-deint to solely use luma and speed up advanced Use no-chroma-deint to solely use luma and speed up advanced
deinterlacing. Useful with slow video memory. deinterlacing. Useful with slow video memory.
``pullup`` ``--vo-vdpau-pullup``
(Deprecated. See note about ``vdpaupp``.) (Deprecated. See note about ``vdpaupp``.)
Try to apply inverse telecine, needs motion adaptive temporal Try to apply inverse telecine, needs motion adaptive temporal
deinterlacing. deinterlacing.
``hqscaling=<0-9>`` ``--vo-vdpau-hqscaling=<0-9>``
(Deprecated. See note about ``vdpaupp``.) (Deprecated. See note about ``vdpaupp``.)
0 0
Use default VDPAU scaling (default). Use default VDPAU scaling (default).
1-9 1-9
Apply high quality VDPAU scaling (needs capable hardware). Apply high quality VDPAU scaling (needs capable hardware).
``fps=<number>`` ``--vo-vdpau-fps=<number>``
Override autodetected display refresh rate value (the value is needed Override autodetected display refresh rate value (the value is needed
for framedrop to allow video playback rates higher than display for framedrop to allow video playback rates higher than display
refresh rate, and for vsync-aware frame timing adjustments). Default 0 refresh rate, and for vsync-aware frame timing adjustments). Default 0
means use autodetected value. A positive value is interpreted as a means use autodetected value. A positive value is interpreted as a
refresh rate in Hz and overrides the autodetected value. A negative refresh rate in Hz and overrides the autodetected value. A negative
value disables all timing adjustment and framedrop logic. value disables all timing adjustment and framedrop logic.
``composite-detect`` ``--vo-vdpau-composite-detect``
NVIDIA's current VDPAU implementation behaves somewhat differently NVIDIA's current VDPAU implementation behaves somewhat differently
under a compositing window manager and does not give accurate frame under a compositing window manager and does not give accurate frame
timing information. With this option enabled, the player tries to timing information. With this option enabled, the player tries to
@ -159,20 +163,20 @@ Available video output drivers are:
with the composited mode behavior of the NVIDIA driver, there is no with the composited mode behavior of the NVIDIA driver, there is no
hard playback speed limit even without the disabled logic. Enabled by hard playback speed limit even without the disabled logic. Enabled by
default, use ``no-composite-detect`` to disable. default, use ``no-composite-detect`` to disable.
``queuetime_windowed=<number>`` and ``queuetime_fs=<number>`` ``--vo-vdpau-queuetime_windowed=<number>`` and ``queuetime_fs=<number>``
Use VDPAU's presentation queue functionality to queue future video Use VDPAU's presentation queue functionality to queue future video
frame changes at most this many milliseconds in advance (default: 50). frame changes at most this many milliseconds in advance (default: 50).
See below for additional information. See below for additional information.
``output_surfaces=<2-15>`` ``--vo-vdpau-output_surfaces=<2-15>``
Allocate this many output surfaces to display video frames (default: Allocate this many output surfaces to display video frames (default:
3). See below for additional information. 3). See below for additional information.
``colorkey=<#RRGGBB|#AARRGGBB>`` ``--vo-vdpau-colorkey=<#RRGGBB|#AARRGGBB>``
Set the VDPAU presentation queue background color, which in practice Set the VDPAU presentation queue background color, which in practice
is the colorkey used if VDPAU operates in overlay mode (default: is the colorkey used if VDPAU operates in overlay mode (default:
``#020507``, some shade of black). If the alpha component of this value ``#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 is 0, the default VDPAU colorkey will be used instead (which is usually
green). green).
``force-yuv`` ``--vo-vdpau-force-yuv``
Never accept RGBA input. This means mpv will insert a filter to convert 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 to a YUV format before the VO. Sometimes useful to force availability
of certain YUV-only features, like video equalizer or deinterlacing. of certain YUV-only features, like video equalizer or deinterlacing.
@ -208,29 +212,31 @@ Available video output drivers are:
.. note:: Before to 0.21.0, ``direct3d_shaders`` and ``direct3d`` were .. note:: Before to 0.21.0, ``direct3d_shaders`` and ``direct3d`` were
different, with ``direct3d`` not using shader by default. Now different, with ``direct3d`` not using shader by default. Now
both use shaders by default, and ``direct3d_shaders`` is a both use shaders by default, and ``direct3d_shaders`` is a
deprecated alias. Use the ``prefer-stretchrect`` or the deprecated alias. Use the ``--vo-direct3d-prefer-stretchrect``
``disable-shaders`` sub-options to get the old behavior of or the ``--vo-direct3d-disable-shaders`` options to get the old
``direct3d``. behavior of ``direct3d``.
``prefer-stretchrect`` The following global options are supported by this video output:
``--vo-direct3d-prefer-stretchrect``
Use ``IDirect3DDevice9::StretchRect`` over other methods if possible. Use ``IDirect3DDevice9::StretchRect`` over other methods if possible.
``disable-stretchrect`` ``--vo-direct3d-disable-stretchrect``
Never render the video using ``IDirect3DDevice9::StretchRect``. Never render the video using ``IDirect3DDevice9::StretchRect``.
``disable-textures`` ``--vo-direct3d-disable-textures``
Never render the video using D3D texture rendering. Rendering with Never render the video using D3D texture rendering. Rendering with
textures + shader will still be allowed. Add ``disable-shaders`` to textures + shader will still be allowed. Add ``disable-shaders`` to
completely disable video rendering with textures. completely disable video rendering with textures.
``disable-shaders`` ``--vo-direct3d-disable-shaders``
Never use shaders when rendering video. Never use shaders when rendering video.
``only-8bit`` ``--vo-direct3d-only-8bit``
Never render YUV video with more than 8 bits per component. Never render YUV video with more than 8 bits per component.
Using this flag will force software conversion to 8-bit. Using this flag will force software conversion to 8-bit.
``disable-texture-align`` ``--vo-direct3d-disable-texture-align``
Normally texture sizes are always aligned to 16. With this option Normally texture sizes are always aligned to 16. With this option
enabled, the video texture will always have exactly the same size as enabled, the video texture will always have exactly the same size as
the video itself. the video itself.
@ -240,11 +246,11 @@ Available video output drivers are:
might crash, might cause slow downs, etc. Contact the developers if you might crash, might cause slow downs, etc. Contact the developers if you
actually need any of these for performance or proper operation. actually need any of these for performance or proper operation.
``force-power-of-2`` ``--vo-direct3d-force-power-of-2``
Always force textures to power of 2, even if the device reports Always force textures to power of 2, even if the device reports
non-power-of-2 texture sizes as supported. non-power-of-2 texture sizes as supported.
``texture-memory=<mode>`` ``--vo-direct3d-texture-memory=<mode>``
Only affects operation with shaders/texturing enabled, and (E)OSD. Only affects operation with shaders/texturing enabled, and (E)OSD.
Possible values: Possible values:
@ -268,11 +274,11 @@ Available video output drivers are:
Use ``D3DPOOL_SCRATCH``, with a ``D3DPOOL_SYSTEMMEM`` texture for Use ``D3DPOOL_SCRATCH``, with a ``D3DPOOL_SYSTEMMEM`` texture for
locking. locking.
``swap-discard`` ``--vo-direct3d-swap-discard``
Use ``D3DSWAPEFFECT_DISCARD``, which might be faster. Use ``D3DSWAPEFFECT_DISCARD``, which might be faster.
Might be slower too, as it must(?) clear every frame. Might be slower too, as it must(?) clear every frame.
``exact-backbuffer`` ``--vo-direct3d-exact-backbuffer``
Always resize the backbuffer to window size. Always resize the backbuffer to window size.
``opengl`` ``opengl``
@ -315,10 +321,12 @@ Available video output drivers are:
.. note:: This driver is for compatibility with systems that don't provide .. note:: This driver is for compatibility with systems that don't provide
proper graphics drivers, or which support GLES only. proper graphics drivers, or which support GLES only.
``sw`` The following global options are supported by this video output:
``--sdl-sw``
Continue even if a software renderer is detected. Continue even if a software renderer is detected.
``switch-mode`` ``--sdl-switch-mode``
Instruct SDL to switch the monitor video mode when going fullscreen. Instruct SDL to switch the monitor video mode when going fullscreen.
``vaapi`` ``vaapi``
@ -330,7 +338,9 @@ Available video output drivers are:
.. note:: This driver is for compatibility with crappy systems. You can .. note:: This driver is for compatibility with crappy systems. You can
use vaapi hardware decoding with ``--vo=opengl`` too. use vaapi hardware decoding with ``--vo=opengl`` too.
``scaling=<algorithm>`` The following global options are supported by this video output:
``--vo-vaapi-scaling=<algorithm>``
default default
Driver default (mpv default as well). Driver default (mpv default as well).
fast fast
@ -340,7 +350,7 @@ Available video output drivers are:
nla nla
``non-linear anamorphic scaling`` ``non-linear anamorphic scaling``
``deint-mode=<mode>`` ``--vo-vaapi-deint-mode=<mode>``
Select deinterlacing algorithm. Note that by default deinterlacing is Select deinterlacing algorithm. Note that by default deinterlacing is
initially always off, and needs to be enabled with the ``d`` key initially always off, and needs to be enabled with the ``d`` key
(default key binding for ``cycle deinterlace``). (default key binding for ``cycle deinterlace``).
@ -359,7 +369,7 @@ Available video output drivers are:
bob bob
bob deinterlacing (default for older libva). bob deinterlacing (default for older libva).
``scaled-osd=<yes|no>`` ``--vo-vaapi-scaled-osd=<yes|no>``
If enabled, then the OSD is rendered at video resolution and scaled to If enabled, then the OSD is rendered at video resolution and scaled to
display resolution. By default, this is disabled, and the OSD is display resolution. By default, this is disabled, and the OSD is
rendered at display resolution if the driver supports it. rendered at display resolution if the driver supports it.
@ -369,7 +379,9 @@ Available video output drivers are:
Usually, it's better to disable video with ``--no-video`` instead. Usually, it's better to disable video with ``--no-video`` instead.
``fps=<value>`` The following global options are supported by this video output:
``--vo-null-fps=<value>``
Simulate display FPS. This artificially limits how many frames the Simulate display FPS. This artificially limits how many frames the
VO accepts per second. VO accepts per second.
@ -428,14 +440,16 @@ Available video output drivers are:
.. note:: This driver is for compatibility with systems that don't provide .. note:: This driver is for compatibility with systems that don't provide
working OpenGL drivers. working OpenGL drivers.
``alpha`` The following global options are supported by this video output:
``--vo-wayland-alpha``
Use a buffer format that supports videos and images with alpha Use a buffer format that supports videos and images with alpha
information information
``rgb565`` ``--vo-wayland-rgb565``
Use RGB565 as buffer format. This format is implemented on most Use RGB565 as buffer format. This format is implemented on most
platforms, especially on embedded where it is far more efficient then platforms, especially on embedded where it is far more efficient then
RGB8888. RGB8888.
``triple-buffering`` ``--vo-wayland-triple-buffering``
Use 3 buffers instead of 2. This can lead to more fluid playback, but Use 3 buffers instead of 2. This can lead to more fluid playback, but
uses more memory. uses more memory.
@ -448,22 +462,24 @@ Available video output drivers are:
``rpi`` (Raspberry Pi) ``rpi`` (Raspberry Pi)
Native video output on the Raspberry Pi using the MMAL API. Native video output on the Raspberry Pi using the MMAL API.
``display=<number>`` The following global options are supported by this video output:
``--rpi-display=<number>``
Select the display number on which the video overlay should be shown Select the display number on which the video overlay should be shown
(default: 0). (default: 0).
``layer=<number>`` ``--rpi-layer=<number>``
Select the dispmanx layer on which the video overlay should be shown 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 (default: -10). Note that mpv will also use the 2 layers above the
selected layer, to handle the window background and OSD. Actual video selected layer, to handle the window background and OSD. Actual video
rendering will happen on the layer above the selected layer. rendering will happen on the layer above the selected layer.
``background=<yes|no>`` ``--rpi-background=<yes|no>``
Whether to render a black background behind the video (default: no). Whether to render a black background behind the video (default: no).
Normally it's better to kill the console framebuffer instead, which Normally it's better to kill the console framebuffer instead, which
gives better performance. gives better performance.
``osd=<yes|no>`` ``--rpi-osd=<yes|no>``
Enabled by default. If disabled with ``no``, no OSD layer is created. Enabled by default. If disabled with ``no``, no OSD layer is created.
This also means there will be no subtitles rendered. This also means there will be no subtitles rendered.
@ -473,15 +489,17 @@ Available video output drivers are:
environment (e.g. no X). Does not support hardware acceleration (if you environment (e.g. no X). Does not support hardware acceleration (if you
need this, check the ``drm-egl`` backend for ``opengl`` VO). need this, check the ``drm-egl`` backend for ``opengl`` VO).
``connector=<number>`` The following global options are supported by this video output:
``--drm-connector=<number>``
Select the connector to use (usually this is a monitor.) If set to -1, Select the connector to use (usually this is a monitor.) If set to -1,
mpv renders the output on the first available connector. (default: -1) mpv renders the output on the first available connector. (default: -1)
``devpath=<filename>`` ``--drm-devpath=<filename>``
Path to graphic card device. Path to graphic card device.
(default: /dev/dri/card0) (default: /dev/dri/card0)
``mode=<number>`` ``--drm-mode=<number>``
Mode ID to use (resolution, bit depth and frame rate). Mode ID to use (resolution, bit depth and frame rate).
(default: 0) (default: 0)

View File

@ -430,4 +430,5 @@ const struct ao_driver audio_out_coreaudio = {
OPT_FLAG("exclusive", exclusive, 0), OPT_FLAG("exclusive", exclusive, 0),
{0} {0}
}, },
.legacy_prefix = "coreaudio",
}; };

View File

@ -241,4 +241,5 @@ const struct ao_driver audio_out_null = {
OPT_CHANNELS("channel-layouts", channel_layouts, 0), OPT_CHANNELS("channel-layouts", channel_layouts, 0),
{0} {0}
}, },
.legacy_prefix = "ao-null",
}; };

View File

@ -359,4 +359,5 @@ const struct ao_driver audio_out_openal = {
OPT_STRING_VALIDATE("device", cfg_device, 0, validate_device_opt), OPT_STRING_VALIDATE("device", cfg_device, 0, validate_device_opt),
{0} {0}
}, },
.legacy_prefix = "ao-openal",
}; };

View File

@ -246,4 +246,5 @@ const struct ao_driver audio_out_opensles = {
OPT_INTRANGE("sample-rate", cfg_sample_rate, 0, 1000, 100000), OPT_INTRANGE("sample-rate", cfg_sample_rate, 0, 1000, 100000),
{0} {0}
}, },
.legacy_prefix = "opensles",
}; };

View File

@ -653,4 +653,5 @@ const struct ao_driver audio_out_oss = {
OPT_STRING("mixer-channel", cfg_oss_mixer_channel, 0), OPT_STRING("mixer-channel", cfg_oss_mixer_channel, 0),
{0} {0}
}, },
.legacy_prefix = "oss",
}; };

View File

@ -226,4 +226,5 @@ const struct ao_driver audio_out_pcm = {
OPT_FLAG("append", append, 0), OPT_FLAG("append", append, 0),
{0} {0}
}, },
.legacy_prefix = "ao-pcm",
}; };

View File

@ -841,4 +841,5 @@ const struct ao_driver audio_out_pulse = {
OPT_FLAG("latency-hacks", cfg_latency_hacks, 0), OPT_FLAG("latency-hacks", cfg_latency_hacks, 0),
{0} {0}
}, },
.legacy_prefix = "pulse",
}; };

View File

@ -160,5 +160,6 @@ const struct ao_driver audio_out_rsound = {
OPT_STRING("port", port, 0), OPT_STRING("port", port, 0),
{0} {0}
}, },
.legacy_prefix = "rsound",
}; };

View File

@ -212,4 +212,5 @@ const struct ao_driver audio_out_sdl = {
OPT_FLOAT("buflen", buflen, 0), OPT_FLOAT("buflen", buflen, 0),
{0} {0}
}, },
.legacy_prefix = "sdl",
}; };

View File

@ -323,4 +323,5 @@ const struct ao_driver audio_out_sndio = {
OPT_STRING("device", dev, 0, OPTDEF_STR(SIO_DEVANY)), OPT_STRING("device", dev, 0, OPTDEF_STR(SIO_DEVANY)),
{0} {0}
}, },
.legacy_prefix = "ao-sndio",
}; };

View File

@ -499,4 +499,5 @@ const struct ao_driver audio_out_wasapi = {
OPT_STRING("device", opt_device, 0), OPT_STRING("device", opt_device, 0),
{NULL}, {NULL},
}, },
.legacy_prefix = "ao-wasapi",
}; };

View File

@ -1749,4 +1749,5 @@ const struct vo_driver video_out_direct3d = {
.priv_size = sizeof(d3d_priv), .priv_size = sizeof(d3d_priv),
.priv_defaults = &defaults, .priv_defaults = &defaults,
.options = opts, .options = opts,
.legacy_prefix = "vo-direct3d",
}; };

View File

@ -513,4 +513,5 @@ const struct vo_driver video_out_drm = {
.connector_id = -1, .connector_id = -1,
.mode_id = 0, .mode_id = 0,
}, },
.legacy_prefix = "drm",
}; };

View File

@ -101,4 +101,5 @@ const struct vo_driver video_out_null = {
OPT_DOUBLE("fps", cfg_fps, M_OPT_RANGE, .min = 0, .max = 10000), OPT_DOUBLE("fps", cfg_fps, M_OPT_RANGE, .min = 0, .max = 10000),
{0}, {0},
}, },
.legacy_prefix = "vo-null",
}; };

View File

@ -803,4 +803,5 @@ const struct vo_driver video_out_rpi = {
.uninit = uninit, .uninit = uninit,
.priv_size = sizeof(struct priv), .priv_size = sizeof(struct priv),
.options = options, .options = options,
.legacy_prefix = "rpi",
}; };

View File

@ -1034,4 +1034,5 @@ const struct vo_driver video_out_sdl = {
.flip_page = flip_page, .flip_page = flip_page,
.wait_events = wait_events, .wait_events = wait_events,
.wakeup = wakeup, .wakeup = wakeup,
.legacy_prefix = "sdl",
}; };

View File

@ -698,4 +698,5 @@ const struct vo_driver video_out_vaapi = {
OPT_FLAG("scaled-osd", force_scaled_osd, 0), OPT_FLAG("scaled-osd", force_scaled_osd, 0),
{0} {0}
}, },
.legacy_prefix = "vo-vaapi",
}; };

View File

@ -1162,5 +1162,6 @@ const struct vo_driver video_out_vdpau = {
}), }),
OPT_FLAG("force-yuv", force_yuv, 0), OPT_FLAG("force-yuv", force_yuv, 0),
{NULL}, {NULL},
} },
.legacy_prefix = "vo-vdpau",
}; };

View File

@ -680,5 +680,6 @@ const struct vo_driver video_out_wayland = {
OPT_FLAG("rgb565", use_rgb565, 0), OPT_FLAG("rgb565", use_rgb565, 0),
{0} {0}
}, },
.legacy_prefix = "vo-wayland",
}; };

View File

@ -935,4 +935,5 @@ const struct vo_driver video_out_xv = {
OPT_REMOVED("no-colorkey", "use ck-method=none instead"), OPT_REMOVED("no-colorkey", "use ck-method=none instead"),
{0} {0}
}, },
.legacy_prefix = "xv",
}; };