mirror of https://github.com/mpv-player/mpv
options: deprecate suboptions for the remaining AO/VOs
This commit is contained in:
parent
633eb30cbe
commit
69283bc0f8
|
@ -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-",
|
||||||
|
|
|
@ -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
|
||||||
|
|
112
DOCS/man/vo.rst
112
DOCS/man/vo.rst
|
@ -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)
|
||||||
|
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
||||||
|
|
|
@ -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",
|
||||||
};
|
};
|
||||||
|
|
Loading…
Reference in New Issue