From 6fbb9dc728cdac7dc7a09c14ed35dbcf7af569cb Mon Sep 17 00:00:00 2001 From: hap Date: Sat, 31 May 2025 12:25:31 +0200 Subject: sound: print verbose message if module doesn't support audio_latency option, docs: small update, remove references to dsound --- docs/source/commandline/commandline-all.rst | 22 ++++++++++------------ 1 file changed, 10 insertions(+), 12 deletions(-) (limited to 'docs/source/commandline') diff --git a/docs/source/commandline/commandline-all.rst b/docs/source/commandline/commandline-all.rst index e9a0d79b2df..8ee84ae9a27 100644 --- a/docs/source/commandline/commandline-all.rst +++ b/docs/source/commandline/commandline-all.rst @@ -1937,9 +1937,9 @@ Core Performance Options half speed, and a ** of 2.0 means run at double speed. Note that changing this value affects sound playback as well, which will scale in pitch accordingly. A very low speed will introduce sound glitches, this - can be prevented by increasing **-audio_latency**. The internal precision - of the fraction is two decimal places, so a ** of ``1.002`` is - rounded to ``1.00``. + can be prevented by increasing the :ref:`audio latency + `. The internal precision of the fraction is + two decimal places, so a ** of ``1.002`` is rounded to ``1.00``. The default is ``1.0`` (normal speed). @@ -2977,17 +2977,16 @@ Core Sound Options Specifies which sound module to use. Selecting ``none`` disables sound output and input altogether (sound hardware is still emulated). - Available features, performance and latency vary between sound modules. The - exact interpretation and useful range of the :ref:`latency option - ` varies between sound modules. You may have - to change the value of the latency option if you change the sound module. + Available features, performance and latency vary between sound modules. + You may have to change the value of the :ref:`latency option + ` if you change the sound module. When using the ``sdl`` sound subsystem, the audio API to use may be selected by setting the *SDL_AUDIODRIVER* environment variable. Available audio APIs depend on the operating system. On Windows, it may be necessary to set ``SDL_AUDIODRIVER=directsound`` if no sound output is produced by default. - The default is ``dsound`` on Windows. On Mac, ``coreaudio`` is the default. + The default is ``wasapi`` on Windows. On Mac, ``coreaudio`` is the default. On all other platforms, ``sdl`` is the default. Example: @@ -3072,10 +3071,9 @@ Core Sound Options interruptions. A value of 0.0 will use the default for the selected sound module. - The exact interpretation and useful range of values for this option depends - on the selected sound module. You may need to change the value of this - option if you change the sound module using the :ref:`sound option - `. + You may need to change the value of this option if you change the sound module + using the :ref:`sound option `. This option is + unsupported on sound modules ``pipewire``, ``pulse``, ``sdl``. The default is ``0.0``. -- cgit v1.2.3