summaryrefslogtreecommitdiffstats
path: root/DOCS/man/ao.rst
Commit message (Collapse)AuthorAgeFilesLines
* ao_rsound: allow setting the hostwm42017-08-211-1/+2
| | | | | | | | 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 PCMwm42017-06-301-0/+9
| | | | | 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 optionswm42017-04-231-50/+3
|
* options: remove deprecated sub-option handling for --vo and --aowm42016-11-251-5/+0
| | | | | | | | 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 syntaxwm42016-09-071-7/+4
| | | | Fixes #3497.
* audio/out: deprecate "exclusive" sub-optionswm42016-09-051-0/+3
| | | | | | | 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-optionswm42016-09-051-5/+8
| | | | | 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/VOswm42016-09-051-26/+46
|
* ao_jack: move to global optionswm42016-09-051-6/+8
|
* options: add a mechanism to make sub-option replacement slightly easierwm42016-09-051-6/+2
| | | | | | | | 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 optionswm42016-09-021-68/+4
| | | | | | Same deal as with vo_opengl. Also edit the outdated information about multichannel output a little.
* vo, ao: disable positional parameter suboptionswm42016-09-011-1/+1
| | | | | | | | | | | | | | | | 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 outputwm42016-01-061-16/+2
| | | | | | | 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 issuesMartin Herkt2015-12-191-4/+4
|
* ao_jack: remove "alsa" std-channel-layout choicewm42015-11-071-6/+3
| | | | | Same deal as with previous commit. "waveext" is less arbitrary and at least supports 3/7 channels.
* docs: correct typo for 'ingore-chmap'Ellis Berner2015-08-221-1/+1
| | | | ingore-chmap -> ignore-chmap
* ao_coreaudio: add exclusive suboptionwm42015-07-031-0/+5
|
* ao_coreaudio_exclusive: support PCMwm42015-07-031-2/+0
| | | | | | | | | | | | | | | | | | 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 typowm42015-05-051-1/+1
|
* ao_coreaudio: add an option for changing the physical formatwm42015-05-051-0/+8
| | | | | | | | | | | | 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 selectionwm42015-04-271-0/+4
|
* man: fix PDF buildMartin Herkt2015-04-241-2/+4
| | | | | | | | | | | | | | 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 listingKevin Mitchell2015-03-311-12/+12
| | | | | remove depricated and convoluted validation. refer instead to the --audio-device option.
* ao_alsa: add an option to ignore ALSA channel map negotiationwm42015-03-281-0/+8
| | | | This was requested, more or less.
* ao_null: add emulation for certain broken behaviorwm42015-01-301-0/+3
| | | | | 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 modewm42015-01-141-0/+4
| | | | | Pretty useful for debugging, although a bit useless or possibly misleading too (see comments in the manpage).
* ao_pulse: disable latency calculation hacks by defaultwm42015-01-071-2/+7
| | | | | | | | | | | | | | 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 outputwm42014-12-291-13/+0
| | | | | 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 entrywm42014-12-161-2/+6
| | | | | | 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 downmixwm42014-12-151-0/+30
| | | | | | | | | | | | | | 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)wm42014-12-091-2/+2
| | | | | Also, don't use the "hw" device, but "plughw". ALSA docs say never to use "hw".
* ao_alsa: simplify, remove no-block suboptionwm42014-12-051-2/+0
| | | | | | | | | | | 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 manualStefano Pigozzi2014-10-231-11/+4
|
* man: fix a whole bunch of typosMartin Herkt2014-09-011-1/+1
|
* ao_dsound: raise default buffer size to 200ms, make it configurablewm42014-08-221-0/+3
|
* ao_alsa: disable use of non-interleaved formats by defaultwm42014-07-301-0/+4
| | | | | | | | 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 workaroundswm42014-07-261-0/+6
| | | | | | | | | | | | | | | | 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 changesStefano Pigozzi2014-07-021-1/+13
|
* DOCS: remove en/ sub-directorywm42014-06-201-0/+263
This additional sub-directory doesn't serve any purpose anymore. Get rid of it.