summaryrefslogtreecommitdiffstats
path: root/DOCS/man/input.rst
Commit message (Collapse)AuthorAgeFilesLines
* command: mark get_property as deprecatedwm42015-02-161-3/+2
| | | | | | | Using it just makes no sense. But we're really being nice about this and don't remove it immediately. (cherry picked from commit fd5403cb404ca8fb30c2c6b1f415201bbce40d77)
* manpage: document hook APIwm42015-02-041-0/+61
| | | | | | | This shouldn't exist and for the most part is meant to be used by the ytdl Lua script, but let's document it anyway. Since the Lua API handles all the details, it's considered much more "stable" than the raw API, which is why the raw API wasn't documented.
* command: new commands audio_add/audio_remove/audio_reloadxylosper2015-02-031-0/+9
| | | | | | | | These commands are counterparts of sub_add/sub_remove/sub_reload which work for external audio file. Signed-off-by: wm4 <wm4@nowhere> (minor simplification)
* command: add property returning detected audio deviceStefano Pigozzi2015-02-031-0/+4
| | | | | This can be useful to adjust some other audio related properties at runtime depending on the audio device being used.
* command: add property returning detected hwdec APIwm42015-02-021-0/+11
| | | | | | | | | This is somewhat imperfect, because detection of hw decoding APIs is mostly done on demand, and often avoided if not necessary. (For example, we know very well that there are no hw decoders for certain codecs.) This also requires every hwdec backend to identify itself (see hwdec.h changes).
* command: add properties returning the current VO and AO driverwm42015-02-021-0/+6
| | | | This wasn't possible before.
* command: export more details about file seekabilitywm42015-01-261-0/+8
| | | | | | | | | | If a file is unseekable (consider e.g. a http server without resume functionality), but the stream cache is active, the player will enable seeking anyway. Until know, client API user couldn't know that this happens, and it has implications on how well seeking will work. So add a property which exports whether this situation applies. Fixes #1522.
* input, player: new command for mouse eventxylosper2015-01-231-0/+17
| | | | | | | New command `mouse <x> <y> [<button> [single|double]]` is introduced. This will update mouse position with given coordinate (`<x>`, `<y>`), and additionally, send single-click or double-click event if `<button>` is given.
* manpage: minor changeswm42015-01-231-1/+1
| | | | | | Mostly related to vo_opengl. Fix the opengl lscale option in the qml example too.
* command: export file format as propertywm42015-01-231-0/+5
| | | | | | | | | | | | Repurpose demuxer->filetype for this. It used to be used to print a human readable format description; change it to a symbolic format name and export it as property. Unfortunately, libavformat has its own weird conventions, which are reflected through the new property, e.g. the .mp4 case mentioned in the manpage. Fixes #1504.
* x11: add --on-all-workspaces option and propertywm42015-01-161-0/+3
| | | | Fixes #1469.
* manpage: fix osd-ass-cc exampleswm42015-01-161-1/+4
| | | | | | | | The "\\" escape was rendered as "\" on the website. I'm hoping quoting this in ``...`` will render it correctly. Also add an example for show_text, which awkwardly does not require escaping the "\".
* command: fix property naming conventionwm42015-01-101-2/+2
| | | | Use "-" instead of "_" as separator.
* command: change properties added in previous commitwm42015-01-101-5/+9
| | | | | | | | | | | | | Make their meaning more exact, and don't pretend that there's a reasonable definition for "bits-per-pixel". Also make unset fields unavailable. average_depth still might be inconsistent: for example, 10 bit 4:2:0 is identified as 24 bits, but RGB 4:4:4 as 12 bits. So YUV formats seemingly drop the per-component padding, while RGB formats do not. Internally it's consistent though: 10 bit YUV components are read as 16 bit, and the padding must be 0 (it's basically like an odd fixed- point representation, rather than a bitfield).
* command.c: new subproperties for video-params: bpp and depthxylosper2015-01-101-0/+6
| | | | | | | | bpp(bits-per-pixel) and depth(bit-depth for color component) can be calculated from pixelformat technically but it requires massive informations to be implemented in client side. These subproperties are provided for convenience.
* 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().
* 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.
* 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.
* command: extend revert_seek commandwm42014-12-171-2/+11
| | | | | "revert_seek mark" basically forces the seekback point. It's basically a one-way bookmark.
* 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.
* command: add properties for current bitratewm42014-12-121-0/+11
| | | | Fixes #1192.
* command: add "idle" propertywm42014-12-101-0/+4
| | | | Yes, it's redundant with events.
* 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.
* input, lua: redo input handlingwm42014-11-231-2/+20
| | | | | Much of it is the same, but now there's the possibility to distinguish key down/up events in the Lua API.
* input: add a prefix to make any binding act on key repeatwm42014-11-201-1/+3
| | | | | | The fact that it's a generic command prefix that is parsed even when using the client API is a bit unclean (because this flag makes sense for actual key-bindings only), but it's less code this way.
* command: add drop_bufferswm42014-11-201-0/+4
| | | | | | | | | | | | | | | This command was actually requested on IRC ages ago, but I forgot about it. The main purpose is that the decoding state can be reset without issuing a seek, in particular in situations where you can't seek. This restarts decoding from the middle of the packet stream; since it discards the packet buffer intentionally, and the decoder will typically not output "incomplete" frames until it has recovered, it can skip a large amount of data. It doesn't clear the byte stream cache - I'm not sure if it should.
* demux_mkv: add an option for compatibility with Haaliwm42014-11-181-0/+1
| | | | This was requested on IRC.
* manpage: document vo_cmdline commandwm42014-11-181-1/+8
|
* command: add an ab_loop commandwm42014-11-181-1/+6
| | | | | | As suggested in #1241; to make using the feature easier. Also add better OSD-formatting for the ab-loop-a/b properties.
* command: implement A-B loopswm42014-11-181-0/+3
| | | | | | | | | | | | | Probably needs to be polished a bit more. Also, might require a key binding that can set/clear the loop points in a more intuitive way. For now, something like this can be put into input.conf to use it: ctrl+y set ab-loop-a ${time-pos} # set A ctrl+x set ab-loop-b ${time-pos} # set B ctrl+c set ab-loop-a no # clear (mostly) Fixes #1241.
* command: adjust previous commitwm42014-11-171-6/+7
| | | | | | | | Due to the current code structure, the "current" entry and the entry which is playing can be different. This is probably silly, but still try to mark the entries correctly. Refs #1260.
* command: playlist property: return if an entry is currently playingwm42014-11-171-0/+8
| | | | | | | | This actually doesn't even write/return the new sub-property, because I dislike the idea of dumping that field for every single playlist entry, even though it's "needed" only for one. Fixes #1260.
* command: export some option metadatawm42014-11-131-1/+24
| | | | | | | This might be interesting for GUIs and such. It's probably still a little bit insufficient. For example, the filter and audio/video output lists are not available through this.
* command: rename "option-flags" property to "option-info"wm42014-11-131-3/+3
|
* command: export mpv configure arguments as propertywm42014-11-131-0/+4
| | | | | It seems strange that a client API user can't get this string, other than analyzing the mpv log output.
* command: export the flag whether an option was set on commandlinewm42014-11-071-0/+12
| | | | Can be useful for certain scripts; I think someone requested this.
* command: add display-names propertyKevin Mitchell2014-11-071-0/+4
| | | | | | | Call VOCTRL_GET_DISPLAY_NAMES it when the property is requested. The vo should return the names of the displays that the mpv window is covering. For example, with x11 vos, xrandr names LVDS1, HDMI1, etc.
* command: add window-minimized property (X11 only)wm42014-11-021-0/+3
| | | | | | More or less requested by #1237. Should be simple to extend this to other backends.
* command: expose mpv version as propertywm42014-11-021-0/+4
| | | | A client API user has no other way to know the version.
* player: update meaning of drop_frame_cntwm42014-11-011-3/+4
| | | | | Rename the variable, update comments, and update the documentation of the property which returns its value.
* manpage: clarify loadfile append-play modewm42014-10-281-1/+3
| | | | Documents the behavior introduced with the previous commit.
* command: add audio-device propertywm42014-10-271-0/+13
| | | | Meant for changing the --audio-device at runtime.
* audio: add command/function to reload audio outputwm42014-10-271-1/+1
| | | | | Anticipated use: simple solution for dealing with audio APIs which request configuration changes via events.
* Drop libquvi supportwm42014-10-251-4/+1
| | | | | | | | | | | No development activity (or even any sign of life) for almost a year. A replacement based on youtube-dl will probably be provided before the next mpv release. Ask on the IRC channel if you want to test. Simplify the Lua check too: libquvi linking against a different Lua version than mpv was a frequent issue, but with libquvi gone, no direct dependency uses Lua, and such a clash is rather unlikely.
* command: add vo-configured propertywm42014-10-241-0/+5
| | | | | | | | | So a client API user can know when a window is created or destroyed. Also might be useful for the OSC: it could disable itself if video is disabled. Before this commit, there were only indirect ways of detecting this.
* command: add a "cached" mode to sub_addwm42014-10-231-0/+7
| | | | | This avoids reloading a subtitle if it was already added. In all cases, the subtitle is selected.
* command: make reverse cycle_values match up with forward onewm42014-10-211-1/+1
| | | | | | | | | The behavior of reverse cycling (with the "!reverse" magic value) was a bit weird and acted with a "delay". This was because the command set the value the _next_ command should use. Change this and make each command invocation select and use the next command directly. This requires an "uninitialized" special index in the counter, but that is no problem at all.
* command: add cursor-autohide propertywm42014-10-211-0/+4
| | | | | | | | | | | Allows properly changing/updating the cursor state. Useful for client API window embedding, because the host application may not want the mpv window to grab mouse input, and this has to manually handle the cursor. Changing the cursor of foreign windows is usually not sane. It might make sense to allow changing the cursor icon, but that would be much more complicated, so I won't add it unless someone actually requests it.
* command: add playback-abort propertywm42014-10-211-0/+5
| | | | Now this is obscure.
* command: add video-rotate propertywm42014-10-211-0/+3
|
* command: add field-dominance propertyKevin Mitchell2014-10-211-0/+3
|
* command: extend sub_add commandwm42014-10-211-1/+17
|
* manpage: fix reference to a defunct optionshdown2014-10-161-2/+2
| | | | The change was made with faad40aad92d51290ef2fc4d94277eca89863873.
* command: allow setting per-file options at runtimewm42014-10-151-0/+10
| | | | | The intended use-case is for doing this at load time, after the load command was issued. (See following commit.)
* command: make audio device list available to the client APIwm42014-10-101-0/+21
|
* command: add cache-buffering-state propertywm42014-10-071-0/+4
|
* client API: clarify pause/unpause events, modify core-idle propertywm42014-10-071-0/+4
| | | | | | | | Whether you consider the semantics weird or not depends on your use case, but I suppose it's a bit confusing anyway. At this point, we keep MPV_EVENT_PAUSE/UNPAUSE for compatibility only. Make the "core-idle" property somewhat more useful in this context.
* manpage: improve consistency with new ~/.config/mpv defaultKevin Mitchell2014-10-041-2/+3
| | | | Signed-off-by: wm4 <wm4@nowhere>
* command: allow passing memory addresses to overlay_addwm42014-10-031-0/+10
| | | | | | | | | For the sake of libmpv. Might make things much easier for the user, especially on Windows. On the other hand, it's a bit sketchy that a command exists that makes the player access arbitrary memory regions. (But do note that input commands are not meant to be "secure" and never were - for example, there's the "run" command, which obviously allows running random shell commands.)
* manpage: remove non-existing ratio-pos propertywm42014-10-021-3/+0
| | | | | | | | | | Use percent-pos instead, which is exactly the same, except with the range 0.0-100.0. I'm not sure how this got there; it was probably introduced and then removed again as percent-pos got more precise. CC: @mpv-player/stable
* man: fix to->too typoKevin Mitchell2014-09-301-1/+1
|
* command: allow using ASS tags on OSD messageswm42014-09-181-2/+19
| | | | | | | | | | | We don't allow this by default, because it would be silly if random external data (like filenames or file tags) could accidentally trigger them. Add a property that magically disables this ASS tag escaping. Note that malicious input could still disable ASS tag escaping by itself. This would be annoying but harmless.
* command: add osd-sym-cc propertywm42014-09-181-0/+5
| | | | This allows you to reproduce the OSD symbol.
* manpage: fix typo in input.rstAleksey Andreev2014-09-151-1/+1
| | | | Signed-off-by: wm4 <wm4@nowhere>
* manpage: clarify description of dwidth/dheightwm42014-09-151-2/+6
|
* input: "quit_watch_later" and "stop" are abort commandswm42014-09-131-2/+8
| | | | | | | | | This means they get special handling for asynchronously aborting playback, even if the player is "stuck". Also document "stop". It seems somewhat useful for client API users (although that will be implemented properly only in the following commits.)
* manpage: fix sub_add descriptionwm42014-09-051-1/+1
| | | | | It is in fact selected. The manpage wasn't updated when this was changed.
* command: remove broken quvi-format propertywm42014-09-011-5/+0
| | | | Never really worked, and libquvi is probably a lost cause anyway.
* man: fix a whole bunch of typosMartin Herkt2014-09-011-8/+8
|
* manpage: be more explicit about "estimated-..." propertieswm42014-08-311-2/+7
| | | | | |