aboutsummaryrefslogtreecommitdiffhomepage
path: root/DOCS/man/ao.rst
Commit message (Collapse)AuthorAge
* ao_pulse: reduce requested device buffer sizeGravatar wm42018-04-15
| | | | | | Same deal as with the previous commit for ALSA. Untested.
* ao/openal: Remove notes on experimentality from the documentationGravatar LAGonauta2018-04-15
| | | | | Also, multi-channel audio should be fast now with the use of the MC extensions.
* ao/openal: Add option to set buffering characteristicsGravatar LAGonauta2018-04-15
| | | | | | | | | One can now set the number of buffers and the buffer size. This can reduce the CPU usage and the total latency stays mostly the same. As there are sync mechanisms the A/V sync continue intact and working. It also modifies 6.1 channel order, as per OpenAL spec and add AOPLAY_FINAL_CHUNK support
* ao/openal: Add support for direct channels outputGravatar LAGonauta2018-04-15
| | | | | | | Uses OpenAL Soft's AL_DIRECT_CHANNELS_SOFT extension and can be controlled through a new CLI option, --openal-direct-channels. This allows one to send the audio data direrctly to the desired channel without effects applied.
* ao_null: add --ao-null-format option for debuggingGravatar wm42018-01-30
| | | | Helpful especially to test spdif fallback and so on.
* manpage: fix typo in warningGravatar Bisaloo2017-12-27
|
* ao_rsound: allow setting the hostGravatar wm42017-08-21
| | | | | | | | Completely untested (rsound dev libs unavailable on my system). Trivial enough that it's very likely that it'll just work. No port selection, but could be added by parsing it as part of the device name. Should fix #4714.
* ao_coreaudio: insane hack for passing through AC3 as float PCMGravatar wm42017-06-30
| | | | | This uses the same hack as Kodi uses, and I suspect MPlayer/ancient mpv also did this (but didn't research that).
* options: remove remaining deprecated audio device selection optionsGravatar wm42017-04-23
|
* options: remove deprecated sub-option handling for --vo and --aoGravatar wm42016-11-25
| | | | | | | | Long planned. Leads to some sanity. There still are some rather gross things. Especially g_groups is ugly, and a hack that can hopefully be removed. (There is a plan for it, but whether it's implemented depends on how much energy is left.)
* manpage: remove more references to deprecated sub-option syntaxGravatar wm42016-09-07
| | | | Fixes #3497.
* audio/out: deprecate "exclusive" sub-optionsGravatar wm42016-09-05
| | | | | | | And introduce a global option which does this. Or more precisely, this deprecates the global wasapi and coreaudio options, and adds a new one that merges their functionality. (Due to the way the sub-option deprecation mechanism works, this is simpler.)
* audio/out: deprecate device sub-optionsGravatar wm42016-09-05
| | | | | We have --audio-device, which can force the device. Also add something describing to this extent to the manpage.
* options: deprecate suboptions for the remaining AO/VOsGravatar wm42016-09-05
|
* ao_jack: move to global optionsGravatar wm42016-09-05
|
* options: add a mechanism to make sub-option replacement slightly easierGravatar wm42016-09-05
| | | | | | | | Instead of requiring each VO or AO to manually add members to MPOpts and the global option table, make it possible to register them automatically via vo_driver/ao_driver.global_opts members. This avoids modifying options.c/options.h every time, including having to duplicate the exact ifdeffery used to enable a driver.
* ao_alsa: change sub-options to global optionsGravatar wm42016-09-02
| | | | | | Same deal as with vo_opengl. Also edit the outdated information about multichannel output a little.
* vo, ao: disable positional parameter suboptionsGravatar wm42016-09-01
| | | | | | | | | | | | | | | | Positional parameters cause problems because they can be ambiguous with flag options. If a flag option is removed or turned into a non-flag option, it'll usually be interpreted as value for the first sub-option (as positional parameter), resulting in very confusing error messages. This changes it into a simple "option not found" error. I don't expect that anyone really used positional parameters with --vo or --ao. Although the docs for --ao=pulse seem to encourage positional parameters for the host/sink options, which means it could possibly annoy some PulseAudio users. --vf and --af are still mostly used with positional parameters, so this must be a configurable option in the option parser.
* ao_dsound: remove this audio outputGravatar wm42016-01-06
| | | | | | | It existed for XP-compatibility only. There was also a time where ao_wasapi caused issues, but we're relatively confident that ao_wasapi works better or at least as good as ao_dsound on Windows Vista and later.
* man: fix grammar issuesGravatar Martin Herkt2015-12-19
|
* ao_jack: remove "alsa" std-channel-layout choiceGravatar wm42015-11-07
| | | | | Same deal as with previous commit. "waveext" is less arbitrary and at least supports 3/7 channels.
* docs: correct typo for 'ingore-chmap'Gravatar Ellis Berner2015-08-22
| | | | ingore-chmap -> ignore-chmap
* ao_coreaudio: add exclusive suboptionGravatar wm42015-07-03
|
* ao_coreaudio_exclusive: support PCMGravatar wm42015-07-03
| | | | | | | | | | | | | | | | | | Until now, this was for AC3 only. For PCM, we used AudioUnit in ao_coreaudio, and the only reason ao_coreaudio_exclusive exists is that there is no other way to passthrough AC3. PCM support is actually rather simple. The most complicated issue is that modern OS X versions actually do not support copying through the data; instead everything must go through float. So we have to deal with virtual and physical format being different, which causes some complications. This possibly also doesn't support some other things correctly. For one, if the device allows non-interleaved output only, we will probably fail. (I couldn't test it, so I don't even know what is required. Supporting it would probably be rather simple, and we already do it with AudioUnit.)
* manpage: fix typoGravatar wm42015-05-05
|
* ao_coreaudio: add an option for changing the physical formatGravatar wm42015-05-05
| | | | | | | | | | | | ao_coreaudio uses AudioUnit - the OSX software mixer. In theory, it supports multichannel audio just fine. But in practice, this might be disabled by default, and the user is supposed to select a multichannel base format in the "Audio MIDI Setup" utility. This option attempts to change this setting automatically. Some possible disadvantages and caveats are listed in the manpage additions. It is off by default, since changing this might be rather bad behavior for a normal application.
* ao_null: add an option for testing channel layout selectionGravatar wm42015-04-27
|
* man: fix PDF buildGravatar Martin Herkt2015-04-24
| | | | | | | | | | | | | | The build failed because rst2pdf apparently has problems with page breaks. In this case, the link to the ALSA upmix guide was causing a page break in an admonition block. My guess is that rst2pdf screws up when it can’t fill at least one line of text following a page break, so I worked around this by making that paragraph a little longer. Seems to do the trick. I also shortened the URL using GitHub’s service because it was causing some rather unsightly formatting in the manpage output. Maybe we should just build HTML instead of a PDF.
* ao_wasapi: fix device listingGravatar Kevin Mitchell2015-03-31
| | | | | remove depricated and convoluted validation. refer instead to the --audio-device option.
* ao_alsa: add an option to ignore ALSA channel map negotiationGravatar wm42015-03-28
| | | | This was requested, more or less.
* ao_null: add emulation for certain broken behaviorGravatar wm42015-01-30
| | | | | I'm not sure how common this behavior possibly is; well whatever. This option will allow reproducing such behavior, and help debugging it.
* ao_pcm: add append modeGravatar wm42015-01-14
| | | | | Pretty useful for debugging, although a bit useless or possibly misleading too (see comments in the manpage).
* ao_pulse: disable latency calculation hacks by defaultGravatar wm42015-01-07
| | | | | | | | | | | | | | This used to be required to workaround PulseAudio bugs. Even later, when the bugs were (partially?) fixed in PulseAudio, I had the feeling the hacks gave better behavior. On the other hand, I couldn't actually reproduce any bad behavior without the hacks lately. On top of this, it seems our hacks sometimes perform much worse than PulseAudio's native implementation (see #1430). So disable the hacks by default, but still leave the code and the option in case it still helps somewhere. Also, being able to blame PulseAudio's code by using its native API is much easier than trying to debug our own (mplayer2-derived) hacks.
* ao_portaudio: remove this audio outputGravatar wm42014-12-29
| | | | | It's just completely useless. We have good native support for all 3 desktop platforms, and ao_sdl or ao_openal as fallbacks.
* manpage: ao_alsa: link upmix wiki entryGravatar wm42014-12-16
| | | | | | Also clarify the statement about what we expect to happen by default. It's well possible that distros at some point will fix their ALSA configuration, and e.g. enable the upmix plugin by default.
* audio: make native channel count the default instead of stereo downmixGravatar wm42014-12-15
| | | | | | | | | | | | | | This should work well with most audio APIs, except ALSA. A long-winded explanation is provided how to make ALSA multichannel output work. All other AOs should have no such problems. Of course it's possible that previously unknown issues arise, because I assume that enabling multichannel audio is actually relatively rare. This also disables codec downmix by default, which could change the audio output due to different mixing in the codec and libavresample. Fixes #1313.
* manpage: update the ao_alsa example (no-block was removed)Gravatar wm42014-12-09
| | | | | Also, don't use the "hw" device, but "plughw". ALSA docs say never to use "hw".
* ao_alsa: simplify, remove no-block suboptionGravatar wm42014-12-05
| | | | | | | | | | | If no-block was given, the device would be opened with SND_PCM_NOBLOCK. Also, after opening, blocking mode was unconditionally enabled anyway with snd_pcm_nonblock(). Further, if opening with SND_PCM_NOBLOCK failed, opening was retried without this flag. This doesn't make any sense to me, and I've never heard of someone using this suboption. I suspect it has to do with ancient ALSA bugs or API caveats. Remove it and simplify the code.
* reflect recent coreaudio changes in the manualGravatar Stefano Pigozzi2014-10-23
|
* man: fix a whole bunch of typosGravatar Martin Herkt2014-09-01
|
* ao_dsound: raise default buffer size to 200ms, make it configurableGravatar wm42014-08-22
|
* ao_alsa: disable use of non-interleaved formats by defaultGravatar wm42014-07-30
| | | | | | | | Some ALSA plugins take non-interleaved audio, but treat it as interleaved, which results in various funny bugs. Users keep hitting this issue, and it just doesn't seem worth the trouble. CC: @mpv-player/stable
* ao_pulse: allow disabling timing bug workaroundsGravatar wm42014-07-26
| | | | | | | | | | | | | | | | Add an option that enables using native PulseAudio auto-updated timing information, instead of the manual calculations added in mplayer2 times. You can use --ao=pulse:no-latency-hacks to enable the new code. The code is almost the same as the code that was removed with commit de435ed5, but I didn't readd some bits I didn't understand. Likewise, the option will disable the code added with that commit. In my tests this seemed to work well, though the A/V sync display looks funny when seeking. The default is still the old behavior. See issue #959.
* manpage: reflect new coreaudio changesGravatar Stefano Pigozzi2014-07-02
|
* DOCS: remove en/ sub-directoryGravatar wm42014-06-20
This additional sub-directory doesn't serve any purpose anymore. Get rid of it.