summaryrefslogtreecommitdiffstats
path: root/DOCS
Commit message (Collapse)AuthorAgeFilesLines
* manpage: clarify syntax for color optionswm42015-01-051-1/+1
| | | | | | | | | Options which take colors accept two variants. The first is "r/g/b/a", the second is "#AARRGGBB". Since they put alpha at different places, it's probably better to document the second variant explicitly. (It's a bit strange that they put alpha in different places, but on the other hand, it's kind of natural. The second variant should probably be considered deprecated.)
* manpage: fix --video-unscaled descriptionwm42015-01-041-3/+2
| | | | This was changed a long time ago in commit 37319ab6.
* vf_vapoursynth: pass through container FPS valuewm42015-01-031-0/+9
| | | | | | | | This is basically a hack; but apparently a needed one, since many vapoursynth filters insist on having a FPS set. We need to apply the FPS override before creating the filters. Also change some terminal output related to the FPS value.
* manpage: vf_vapoursynth: document mpv-specific predefined variableswm42015-01-031-0/+11
|
* manpage: talk about one script, not multiple scriptsRyan Jacobs2015-01-021-2/+2
| | | | | | There aren't multiple scripts. We're just talking about one: youtube-dl. Signed-off-by: wm4 <wm4@nowhere>
* OSC: add osc-message script command (wip)ChrisK22015-01-021-0/+4
|
* vo_opengl_old: remove ancient ATI-specific YUV conversionswm42015-01-021-5/+1
| | | | | | | | | | While there's no actual need to get rid of these, I want to make sure nobody actually needs this stuff, and removing it is the best way to get to know this. We still can revert this commit if it turns out there is a significant need for this stuff. The final goal is removing vo_opengl_old entirely. Add a warning, which basically announces this intention.
* build: try to make examples build both in-tree and out-of-treewm42015-01-022-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | The examples simple.c and cocoabasic.m can be compiled without installing libmpv. But also, they didn't use the correct include path libmpv programs normally use, so they couldn't be built with a properly installed system-libmpv. That's pretty bad for examples, which are supposed to show how to use libmpv correctly. So do some bullshit that symlinks libmpv to a "mpv" include directory under the build directory. This name-mismatch is a direct consequence of the bullshit done in 499a6758 (requested in #539 for dumb reasons). (We don't want to name the client API headers directory "mpv", because that would be too unspecific, and clashes with having the mpv binary in the same directory.) If you have spaces or other "unusual" characters in your paths, the build will break, because I couldn't find out where waf hides its function to escape shell parameters (or a way to invoke programs without involving the shell). Neither does such a thing to be documented, nor do they seem to have a clear way to do this in their code. This also doesn't compile the Qt examples, because everything becomes even more terrible from there on.
* DOCS/client_api_examples: move all examples into their own subdirswm42015-01-016-13/+20
| | | | | Also get rid of shared.h; it actually doesn't have much value. Just copy the tiny function it contained into the 2 files which used it.
* DOCS/client_api_examples: don't throw char* in C++ codewm42015-01-012-6/+9
| | | | | | | C++ is the worst language ever, and allows throwing any type, even if it doesn't make sense. In this case, we were throwing char*, which the runtime typically treats as opaque, instead of printing it as message if such an exception was not caught.
* manpage: fix typowm42015-01-011-1/+1
|
* command: make the "run" command work on Windows toowm42015-01-011-1/+0
| | | | | | | | | Do so by using mp_subprocess(). Although this uses completely different code on Unix too, you shouldn't notice a difference. A less ncie thing is that this reserves an entire thread while the command is running (which wastes some memory for stack, at least). But this is probably still the simplest way, and the fork() trick is apparently not implementable with posix_subprocess().
* client API: add function to create new mpv_handles from existing oneswm42014-12-311-0/+3
| | | | | | | This may or may not be useful for client API users. Fold this API extension into the previous API bump. The previous bump was only yesterday, so it's ok.
* vo_opengl_cb: simplify API uninitializationwm42014-12-311-9/+3
| | | | | | | | | | | Until now, calling mpv_opengl_cb_uninit_gl() at a "bad moment" could make the whole thing to explode. The API user was asked to avoid such situations by calling it only in "good moments". But this was probably a bit too subtle and could easily be overlooked. Integrate the approach the qml example uses directly into the implementation. If the OpenGL context is to be unitialized, forcefully disable video, and block until this is done.
* DOCS/client_api_examples: add an explicit licensewm42014-12-302-2/+14
| | | | IANAL, but we don't give a shit what you do with this code.
* DOCS/client_api_examples: qtexample: use queued signalswm42014-12-303-20/+19
| | | | | | | | Use queued signals instead of QEvent for the wakeup notification. This is slightly nicer, and reduces the chance that the event (QEvent::User) could clash with other code using the same event. Also switch to modern connect() syntax.
* DOCS/client_api_examples: qtquick: fix destructionwm42014-12-304-38/+35
| | | | | | | | | | | | | | | | Destruction (e.g. when closing the window) was a bit broken. This commit fixes some possible crashes, and should make lifetime management relatively sane. (Still a bit complex, though. Maybe this code should be moved into a tiny library.) QtQuick runs the renderer on a separate thread. This thread is rather loosely connected to the main thread. The loose separation is enforced by the API, which also makes coordination of initialization and destruction harder. Throw refcounting at the problem, which fixes it. The refcounting wrapper introduced in the previous commit is used for this. Also contains some general cleanups.
* client API: qthelper: add a refcounting wrapper around mpv_handlewm42014-12-301-0/+1
| | | | | This is useful to deal with crazy Qt object lifetime issues (the following commit needs it).
* command: add filtered-metadata propertywm42014-12-291-0/+4
| | | | | Goes in hand with the previous commit; the main purpose is to easily show on OSD what is shown on terminal.
* player: filter tags, add --display-tags optionwm42014-12-291-0/+8
| | | | | | | | This attempts to increase user-friendliness by excluding useless tags. It should be especially helpful with mp4 files, because the FFmpeg mp4 demuxer adds tons of completely useless information to the metadata. Fixes #1403.
* player: make --shuffle/--merge-files affect runtime loaded playlistswm42014-12-291-4/+0
| | | | | | | Until now, these options took effect only at program start. This could be confusing when e.g. doing "mpv list.m3u --shuffle". Make them always take effect when a playlist is loaded either via a playlist file, or with the "loadlist" command.
* 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: document new --stream-dump behaviorwm42014-12-271-0/+3
| | | | That's probably a good idea.
* command: overlay_add: more flexible treatment of offset parameterwm42014-12-261-7/+9
| | | | | | | | | | | | | | Essentially, don't make it the mmap() argument, and just add it to the memory address. This hides tricky things like alignment reequirements from the user. Strictly speaking, this is not entirely backwards compatible: this adds the regression that you can't access past 2 or 4 GB of a file on 32 bit systems anymore. But I doubt anyone cared about this. In theory, we could be clever, and just align the offset manually and pass that to mmap(). This would also be transparent to the user, but minimally more effort, so this is left as exercise to the reader.
* win32: add mmap() emulationwm42014-12-261-5/+0
| | | | | | | | Makes all of overlay_add work on windows/mingw. Since we now don't explicitly check for mmap() anymore (it's always present), this also requires us to make af_export.c compile, but I haven't tested it.
* manpage: lua: fix a linkwm42014-12-261-1/+1
|
* manpage: fix typowm42014-12-251-2/+2
| | | | Fixes #1384.
* manpage: lua: fixes and improvementswm42014-12-251-20/+15
| | | | Some things were outdated, or outright wrong.
* ipc: add enable_event and disable_event commandswm42014-12-241-0/+8
| | | | This was requested.
* command: extend revert_seek commandwm42014-12-171-2/+11
| | | | | "revert_seek mark" basically forces the seekback point. It's basically a one-way bookmark.
* vo_opengl: switch default FBO format to rgba, use GL_RGBAwm42014-12-171-1/+1
| | | | | | | | | | I'm hoping this is generally more compatible, and it works with GLES. This probably has not much of an effect on desktop GL. It also switches only the default format for --vo=opengl, not --vo=opengl-hq. "-hq" already uses GL_RGBA16, though since it's a sized format, the story is a bit different, and it won't work on GLES either.
* 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-152-4/+34
| | | | | | | | | | | | | | 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.
* vo_opengl: remove quadbuffer/anaglyph stereo 3D renderingwm42014-12-151-15/+0
| | | | | | | | Obscure feature, and I've never heard of anyone using it. The anaglyph effects can be reproduced with vf_stereo3d. The only thing that can't be reproduced with it is "quadbuffer", which requires special and expensive hardware.
* options: deprecate 'lua' based options/dirs for 'script'Avi Halachmi (:avih)2014-12-154-23/+23
| | | | | | | | | | | | - --lua and --lua-opts change to --script and --script-opts - 'lua' default script dirs change to 'scripts' - DOCS updated - 'lua-settings' dir was _not_ modified The old lua-based names/dirs still work, but display a warning. Signed-off-by: wm4 <wm4@nowhere>
* command, dvd: add property which returns list of DVD titleswm42014-12-131-0/+27
| | | | | | | | | This was requested. It seems libdvdread can't get the duration for titlesets other than the currently opened title. The data structures contain dangling pointers for these, and MPlayer works this around by opening every title separately for the purpose of dumping the title list.
* DOCS: add missing close bracketBen Boeckel2014-12-121-1/+1
|
* options: add option for ignoring patch in resume mechanismwm42014-12-131-0/+3
| | | | | | Whatever. Fixes #1281.
* player: add a --keep-open=always modewm42014-12-121-9/+20
| | | | | | | | The --keep-open behavior was recently changed to act only on the last file due to user requests (see commit 735a9c39). But the old behavior was useful too, so bring it back as an additional mode. Fixes #1332 (or rather, should help with it).
* DOCS/crosscompile-mingw: updatewm42014-12-121-7/+15
| | | | Unrecommend mingw-w64-cmake, point out MXE host requirements.
* command: add properties for current bitratewm42014-12-121-0/+11
| | | | Fixes #1192.
* demux: don't always make --cache-secs override --demuxer-readahead-secswm42014-12-121-1/+4
| | | | It's confusing. Whether the new behavior is less confusing... whatever.
* DOCS/contribute.md: remove unintentional headlineselsta2014-12-111-2/+2
| | | | The # from the IRC channel made it appear as a headline.
* manpage: fix mistake in --video-zoom mentionwm42014-12-111-1/+1
| | | | Fixes #1331.
* command: add "idle" propertywm42014-12-101-0/+4
| | | | Yes, it's redundant with events.
* 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".
* DOCS/client_api_examples: remove nonsensewm42014-12-092-4/+3
| | | | | | | I thought setSamples() was some funky abstraction to set the number of components, but it's actually something else. Also fix the include paths.
* options: enable --ytdl by defaultwm42014-12-092-6/+3
| | | | Let's see who complains...
* vo_opengl_cb: simplify reconfigure, render transparent if unconfiguredwm42014-12-091-0/+3
| | | | | | | I think that's expected; mpv shouldn't draw anything while no video is active. This doesn't blend transparently, though. Also document the vo_opengl_cb thing.
* vo_opengl: make background color configurablewm42014-12-091-0/+4
| | | | | This mainly affects the black bars that are drawn if the window and video aspect ratios mismatch.
* client API: expose OpenGL rendererwm42014-12-097-0/+236
| | | | | | | | | | | | | | | | | | | | | | | | | | | | This adds API to libmpv that lets host applications use the mpv opengl renderer. This is a more flexible (and possibly more portable) option to foreign window embedding (via --wid). This assumes that methods like context sharing and multithreaded OpenGL rendering are infeasible, and that a way is needed to integrate it with an application that uses a single thread to render everything. Add an example that does this with QtQuick/qml. The example is relatively lazy, but still shows how relatively simple the integration is. The FBO indirection could probably be avoided, but would require more work (and would probably lead to worse QtQuick integration, because it would have to ignore transformations like rotation). Because this makes mpv directly use the host application's OpenGL context, there is no platform specific code involved in mpv, except for hw decoding interop. main.qml is derived from some Qt example. The following things are still missing: - a way to do better video timing - expose GL renderer options, allow changing them at runtime - support for color equalizer controls - support for screenshots
* DOCS: Improve documentation of --ytdl-format optionChrisK22014-12-071-1/+4
| | | | As suggested in #1321
* options: add a 'once' idle modeStefano Pigozzi2014-12-071-1/+4
| | | | | This allows to make mpv wait for file open events at start but close after it is done playing the first playlist.
* DOCS, OSC: Un-document removed seektooltip optionChrisK22014-12-051-4/+0
|
* DOCS, OSC: Document layout optionChrisK22014-12-051-1/+6
|
* 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.
* video/filter: kill vf_pp (libpostproc)wm42014-12-031-150/+0
| | | | | | | | | This is an ancient filter, and we assume it's not useful anymore. If you really want this, it's still available in libavfilter (e.g. via --vf=lavfi=[pp...]). The disadvantage is that mpv doesn't pass through QP information to libavfilter. (This was probably the reason vf_pp still was part of mpv - it was slightly easier to pass QP internally.)
* DOCS/client-api-changes: mark release 0.7.0wm42014-12-021-0/+1
|
* cocoa: allow to black out other display when going fsStefano Pigozzi2014-12-011-0/+4
| | | fixes #1302
* manpage: rename input.conf supersectionwm42014-11-291-3/+11
| | | | | | | | By now, input.conf is actually just a small part of input handling. Rename the section to something else ("command interface" was the first reasonable thing that came to mind). Also fix a minor typo further down.
* manpage: lua: fix examplewm42014-11-291-2/+2
| | | | Oops.
* manpage: minor fixeswm42014-11-293-10/+9
| | | | | Also update the Lua example. The "pause" event was declared deprecated, so the example should use the newer API.
* vo_opengl: enable fancy-downscaling by default for opengl-hqwm42014-11-291-1/+1
|
* vo_opengl: disable fancy-downscaling for anamorphic videowm42014-11-291-0/+3
| | | | Includes some arbitrary minor refactoring.
* lua: add a function that formats Lua values as stringswm42014-11-291-0/+4
| | | | | | | | Yep, Lua is so crappy that the stdlib doesn't provide anything like this. Repurposes the undocumented mp.format_table() function and moves it to mp.utils.
* DOCS/crosscompile-mingw: updateTimothy Gu2014-11-261-8/+8
| | | | | | Add `.static` for MXE targets. Signed-off-by: wm4 <wm4@nowhere>
* manpage: lua: fix typo paramater -> parameterAlessandro Ghedini2014-11-261-1/+1
|
* player: add option not to use OSD/fontconfigwm42014-11-251-0/+10
| | | | | | | Makeshift-solution for working around certain fontconfig issues. With --use-text-osd=no, libass and fontconfig won't be initialized, and fontconfig won't block everything with scanning for fonts.
* input, lua: redo input handlingwm42014-11-233-9/+40
| | | | | Much of it is the same, but now there's the possibility to distinguish key down/up events in the Lua API.
* manpage: update utils.subprocess() for WindowsJames Ross-Gowan2014-11-221-2/+3
|
* lua: add a way to add repeatable key bindingswm42014-11-211-1/+5
| | | | For these, autorepeat is enabled.
*