summaryrefslogtreecommitdiffstats
path: root/DOCS/man/input.rst
Commit message (Collapse)AuthorAgeFilesLines
* command: add keypress, keydown, and keyup commands.torque2015-06-111-0/+17
| | | | | These commands are used to simulate keypresses using the key names from input.conf.
* command: remove deprecated get_property commandwm42015-05-271-1/+1
| | | | | | This command has been deprecated in the 0.8.x and 0.9.x releases - get rid of it. Its only point ever was MPlayer compatibility, which broke years ago anyway.
* input: allow - as separator between commands, instead of _wm42015-05-251-40/+40
| | | | | | | | | | Wnile it seems quite logical to me that commands use _ as word separator, while properties use -, I can't really explain the difference, and it tends to confuse users as well. So always prefer - as separator for everything. Using _ still works, and will probably forever. Not doing so would probably create too much chaos and confusion.
* command: change the hwdec propertieswm42015-05-251-19/+23
| | | | | | Another very minor step towards property/option unification. Not bothering with interface compatibility here.
* command: add protocol-list propertywm42015-05-231-0/+6
| | | | Fixes #1972.
* command: deprecate audio-sampleratewm42015-05-221-7/+0
| | | | | | | Also replace their implementation with the recently introduced properties. One significant difference is that audio-channels using OSD formatting does not print the channel layout. The user can just use the replacement property instead.
* command: add audio-params and audio-out-params propertieswm42015-05-221-0/+36
|
* command: rename audio-format propertywm42015-05-221-3/+3
| | | | Clashes with the option.
* command: deprecate the "length" propertywm42015-05-221-2/+5
| | | | It collides with the --length option.
* audio: change range of volume option/propertywm42015-05-221-1/+1
| | | | | | | | | Now --volume takes an absolute volume, meaning it doesn't depend on --softvol-max. 0 is still silence, and 100 now always means unchanged volume. The OSD and the "volume" property are changed accordingly. Also raise the minimum value of --softvol-max. A value below 100 makes no sense and breaks the OSD.
* input: add relative percentage seekrrooij2015-05-191-1/+3
| | | | | | | | | | | Only absolute percentage seeking was permitted first. It is now also possible to seek by relative percentage. MPSEEK_FACTOR is used as seek_type. Fixes #1950. Signed-off-by: wm4 <wm4@nowhere>
* command: add playlist_shuffle commandwm42015-05-171-0/+4
| | | | Fixes #965.
* manpage: explain some property expansion restrictionswm42015-05-131-1/+4
|
* manpage: remove stray newlinewm42015-05-131-1/+0
|
* command: change the default action for rescan_external_fileswm42015-04-281-5/+5
| | | | | | | | Now the rescan_external_files command will by default reselect the audio and subtitle streams. This should be more intuitive. Client API users and Lua scripts might break, but can be fixed in a backward-compatible way by setting the mode explicitly.
* manpage: update colormatrix property descriptionwm42015-04-271-8/+9
|
* manpage: document ff-index sub-propertywm42015-04-231-0/+7
|
* command: demuxer-cache-time propertyxylosper2015-04-211-0/+5
| | | | | | | | Approximate time of video buffered in the demuxer, in seconds. Same as `demuxer-cache-duration` but returns the last timestamp of bufferred data in demuxer. Signed-off-by: wm4 <wm4@nowhere>
* client API: add a screenshot_raw commandwm42015-04-201-0/+9
| | | | | | | | | Requested. The wild code for setting up the mpv_node probably deserves to be cleaned up later. Fixes #1800.
* player: change video-bitrate and audio-bitrate propertieswm42015-04-201-7/+22
| | | | | | | | | | | | | | Remove the old implementation for these properties. It was never very good, often returned very innaccurate values or just 0, and was static even if the source was variable bitrate. Replace it with the implementation of "packet-video-bitrate". Mark the "packet-..." properties as deprecated. (The effective difference is different formatting, and returning the raw value in bits instead of kilobits.) Also extend the documentation a little. It appears at least some decoders (sipr?) need the AVCodecContext.bit_rate field set, so this one is still passed through.
* command: disc-mouse-on-button propertyxylosper2015-04-211-0/+4
| | | | | This property indicates whether mouse cursor is located on button or not for disc naviation.
* command: let screenshot_to_file command overwrite fileswm42015-04-161-2/+1
| | | | | | | The old behavior does not make too much sense after all. If you don't want to file to be overwritten, the user can check this manually. This is a change in behavior - let's hope nobody actually relied on it.
* command: new subproperty for video-params: gammaNiklas Haas2015-04-041-0/+3
|
* command: add property returning current working directorywm42015-03-241-0/+4
| | | | Requested; fixes #1717.
* command: display-fps is the display FPS as assumed by the VOwm42015-03-121-3/+3
| | | | | | | | | Requested change in behavior. Note that we set the assumed "infinite" display_fps to 1e6, which conveniently lets vo_get_vsync_interval() return a dummy value of 1, which can be easily checked against, and still avoids doing math with float INFs.
* command: add display-fps propertywm42015-03-101-0/+7
| | | | Requested. Untested; leaving that to the users.
* client API: mention the changes to the seek/screenshot commandswm42015-03-051-1/+1
| | | | Also fix a typo in the manpage.
* input: use flag option type for some input commandswm42015-03-041-16/+15
| | | | | | | | | | This gets rid of the need for a second (or more) parameters; instead it can be all in one parameter. The (now) redundant parameter is still parsed for compatibility, though. The way the flags make each other conflict is a bit tricky: they have overlapping bits, and the option parser disallows setting already set bits.
* command: add rescan_external_fileswm42015-02-161-0/+15
| | | | | | | | | Requested. Hopefully will be useful for things that download and add external subtitles on demand. Or something. Closes #1586.
* sub: mess with styling defaults, change --ass-use-margins behaviorwm42015-02-161-2/+5
| | | | | | | | | | | | | | | | | | | Now --ass-use-margins doesn't apply to normal subtitles anymore. This is probably the inverse from the mpv behavior users expected so far, and thus a breaking change, so rename the option, that the user at least has a chance to lookup the option and decide whether the new behavior is wanted or not. The basic idea here is: - plain text subtitles should have a certain useful defalt behavior, like actually using margins - ASS subtitles should never be broken by default - ASS subtitles should look and behave like plaintext subtitles if the --ass-style-override=force option is used This also subtly changes --sub-scale-with-window and adds the --ass- scale-with-window option. Since this one isn't so important, don't bother with compatibility.
* command: mark get_property as deprecatedwm42015-02-131-3/+2
| | | | | Using it just makes no sense. But we're really being nice about this and don't remove it immediately.
* audio: add device change notification for hotpluggingwm42015-02-121-0/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | Not very important for the command line player; but GUI applications will want to know about this. This only adds the internal API; support for specific audio outputs comes later. This reuses the ao struct as context for the hotplug event listener, similar to how the "old" device listing API did. This is probably a bit unclean and confusing. One argument got reusing it is that otherwise rewriting parts of ao_pulse would be required (because the PulseAudio API requires so damn much boilerplate). Another is that --ao-defaults is applied to the hotplug dummy ao struct, which automatically applies such defaults even to the hotplug context. Notification works through the property observation mechanism in the client API. The notification chain is a bit complicated: the AO notifies the player, which in turn notifies the clients, which in turn will actually retrieve the device list. (It still has the advantage that it's slightly cleaner, since the AO stuff doesn't need to know about client API issues.) The weird handling of atomic flags in ao.c is because we still don't require real atomics from the compiler. Otherwise we'd just use atomic bitwise operations.
* 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
| | |