summaryrefslogtreecommitdiffstats
path: root/DOCS/man/options.rst
Commit message (Collapse)AuthorAgeFilesLines
* manpage: fix typowm42016-08-201-1/+1
|
* manpage: info about --panscan vs. --video-unscaledrr-2016-08-191-1/+4
|
* aspect: add --video-unscaled=downscale-bigrr-2016-08-191-3/+4
|
* player: add option to control duration of image displaywm42016-08-171-0/+17
| | | | | | | | | | | | | The --image-display-duration option controls how long an image is displayed. It's also possible to display the image forever (until manual user interaction stops playback). With this, the core drops the old method to "drain" video (i.e. waiting for the last frame duration on end of playback). Instead, we reuse MPContext.time_frame. The old mechanism was disabled for non-images anyway. Fixes #3425.
* manpage: remove the word "slave"wm42016-08-111-6/+6
| | | | It's discriminatory or something.
* player: add --no-autoload-files optionwm42016-08-101-0/+10
| | | | Allt his auto-loading is getting annoying especially for testing.
* player: add --audio-wait-open optionswm42016-08-091-0/+8
| | | | Complements the option added in the previous commit.
* player: add --audio-stream-silencewm42016-08-091-0/+11
| | | | | Completely insane that this has to be done. Crap for compensating HDMI crap.
* audio: use --audio-channels=auto behavior, except on ALSAwm42016-08-041-19/+44
| | | | | | | | | | | | | | | | | | | | | | | This commit adds an --audio-channel=auto-safe mode, and makes it the default. This mode behaves like "auto" with most AOs, except with ao_alsa. The intention is to allow multichannel output by default on sane APIs. ALSA is not sane as in it's so low level that it will e.g. configure any layout over HDMI, even if the connected A/V receiver does not support it. The HDMI fuckup is of course not ALSA's fault, but other audio APIs normally isolate applications from dealing with this and require the user to globally configure the correct output layout. This will help with other AOs too. ao_lavc (encoding) is changed to the new semantics as well, because it used to force stereo (perhaps because encoding mode is supposed to produce safe files for crap devices?). Exclusive mode output on Windows might need to be adjusted accordingly, as it grants the same kind of low level access as ALSA (requires more research). In addition to the things mentioned above, the --audio-channels option is extended to accept a set of channel layouts. This is supposed to be the correct way to configure mpv ALSA multichannel output. You need to put a list of channel layouts that your A/V receiver supports.
* options: add vp9 to --hwdec-codecswm42016-07-301-3/+3
|
* audio: refactor mixer code and delete mixer.cwm42016-07-171-0/+5
| | | | | | | | | | | | | | | | | mixer.c didn't really deserve to be separate anymore, as half of its contents were unnecessary glue code after recent changes. It also created a weird split between audio.c and af.c due to the fact that mixer.c could insert audio filters. With the code being in audio.c directly, together with other code that unserts filters during runtime, it will be possible to cleanup this code a bit and make it work like the video filter code. As part of this change, make the balance code work like the volume code, and add an option to back the current balance value. Also, since the balance semantics are unexpected for most users (panning between the audio channels, instead of just changing the relative volume), and there are some other volumes, formally deprecate both the old property and the new option.
* videotoolbox: add yuv420p to --videotoolbox-formatwm42016-07-151-2/+2
|
* man: fix PDF build errorMartin Herkt2016-07-151-0/+1
| | | | | | | ReportLab really doesn’t like breaking inline literals, so insert an explicit line break. Fixes #3338
* videotoolbox: add --hwdec=videotoolbox-copy for h/w accelerated decoding ↵Aman Gupta2016-07-151-0/+1
| | | | with video filters
* Use - as command-name separator everywhereTimotej Lazar2016-07-141-4/+4
| | | | | | | Old-style commands using _ as separator (e.g. show_progress) were still used in some places, including documentation and configuration files. This commit updates all such instances to the new style (show-progress) so that commands are easier to find in the manual.
* audio: drop --softvol=no and --softvol=autowm42016-07-091-20/+15
| | | | | | | | | | | | | | Drop the code for switching the volume options and properties between af_volume and AO volume controls. interface-changes.rst mentions the changes in detail. Do this because this was exceedingly complex and had other problems as well. It was also very hard to test. It's just not worth the trouble. Some leftovers like AOCONTROL_HAS_PER_APP_VOLUME will be removed at a later point. Fixes #3322.
* man: fix typosJakub Wilk2016-07-091-7/+7
|
* man: fix botched sentencewm42016-07-081-3/+3
| | | | Fixes #3323.
* options: deprecate --heartbeat-cmdwm42016-06-291-0/+8
| | | | | It's useless. --heartbeat-interval is also considered deprecated, but this is not made explicit.
* manpage: fix typowm42016-06-261-1/+1
|
* vo_opengl: vdpau interop without RGB conversionwm42016-06-191-3/+6
| | | | | | | | | | | | | | | | | | | | | | Until now, we've always converted vdpau video surfaces to RGB, and then mapped the resulting RGB texture. Change this so that the surface is mapped as NV12 plane textures. The reason this wasn't done until now is because vdpau surfaces are mapped in an "interlaced" way as separate fields, even for progressive video. This requires messy reinterleraving. It turns out that even though it's an extra processing step, the result can be faster than going through the video mixer for RGB conversion. Other than some potential speed-gain, doing this has multiple other advantages. We can apply our own color conversion, which is important in more complex cases. We can correctly apply debanding and potentially other processing that requires chroma-specific or in-YUV handling. If deinterlacing is enabled, this switches back to the old RGB conversion method. Until we have at least a primitive deinterlacer in vo_opengl, this will stay this way. The d3d11 and vaapi code paths are similar. (Of course these don't require any crazy field reinterleaving.)
* manpage: update --hwdec=d3d11va remarkswm42016-05-311-5/+3
|
* manpage: adjust dxva2 descriptionwm42016-05-231-3/+6
|
* manpage: document how hardware decoding might cause quality losswm42016-05-231-0/+36
|
* video: add --hwdec=auto-copy modewm42016-05-111-0/+8
| | | | | | | | This uses the normal autoprobing rules like "auto", but rejects anything that isn't flagged as copying data back to system memory. The chunk in command.c was dead code, so remove it instead of updating it.
* manpage: unmark d3d11va as "experimental"wm42016-05-111-2/+3
| | | | Also add missing mediacodec entry.
* win32: make taskbar progress indication optionalmaniak13492016-05-081-0/+6
| | | | | | | | | | | Add --taskbar-progress command line option and property which controls taskbar progress indication rendering in Windows 7+. This option is on by default and can be toggled during playback. This option does not affect the creation process of ITaskbarList3. When the option is turned off the progress bar is just hidden with TBPF_NOPROGRESS. Closes #2535
* manpage: document --x11-bypass-compositor=nowm42016-05-081-1/+4
| | | | Requested.
* manpage: change gnome-screensaver-command exampleRahul Kalkani2016-05-071-1/+1
| | | | | | Correct options to deactivate is -d or --deactivate. Signed-off-by: wm4 <wm4@nowhere>
* x11: rename inappropriate --x11-bypass-compositor=never optionwm42016-05-071-2/+2
| | | | This obviously made no sense.
* x11: add --x11-bypass-compositor=alwayswm42016-05-061-2/+7
| | | | Also add missing documentation for fs-only, and correct the default.
* manpage: minor fixes to --lavfi-complexwm42016-05-061-2/+3
|
* manpage: fix typoVaidas Kascėnas2016-04-301-1/+1
| | | | Signed-off-by: wm4 <wm4@nowhere>
* options: add --fit-border video optionmaniak13492016-04-301-0/+6
| | | | | | | Flag that is set by default. Reseting it will result in mpv trying to fit client area with video instead of the whole window with border and decorations on the screen. Marked as (Windows only) for now until it's implemented on other platforms.
* sd_add: replace --sub-ass=no with --ass-style-override=stripwm42016-04-301-5/+10
| | | | | | --sub-ass=no / --ass=no still work, but --ass-style-override=strip is preferred now. With this change, --ass-style-override can control all the types of style overriding.
* vo_opengl: D3D11VA + ANGLE interopwm42016-04-271-0/+1
| | | | | | | | | | | | | | | | | | | This uses ID3D11VideoProcessor to convert the video to a RGBA surface, which is then bound to ANGLE. Currently ANGLE does not provide any way to bind nv12 surfaces directly, so this will have to do. ID3D11VideoContext1 would give us slightly more control about the colorspace conversion, though it's still not good, and not available in MinGW headers yet. The video processor is created lazily, because we need to have the coded frame size, of which AVFrame and mp_image have no concept of. Doing the creation lazily is less of a pain than somehow hacking the coded frame size into mp_image. I'm not really sure how ID3D11VideoProcessorInputView is supposed to work. We recreate it on every frame, which is simple and hopefully doesn't affect performance.
* manpage: fix --autofit examplewm42016-04-241-1/+1
| | | | Fixes #3069.
* command: if only ab-loop-b is set, loop from start of filewm42016-04-211-2/+7
| | | | | | | | | | Commit 382bafcb changed the behavior for ab-loop-a. This commit changes ab-loop-b so that the behavior is symmetric. Adjust the OSD rendering accordingly to the two changes. Also fix mentions of the "ab_loop" command to the now preferred "ab-loop".
* aspect: rework --video-unscaledNiklas Haas2016-04-101-7/+4
| | | | | | | | | | | | | | | | | | | In the past, --video-unscaled also disabled zooming and aspect ratio corrections. But this didn't make much sense in terms of being a useful option. The new behavior just sets the initial video size to be unscaled, but it's still affected by zoom commands and aspect ratio corrections. To get the old behavior back, --video-aspect=0 --video-zoom=0 need to be added as well (in the general case). Most of the time it should not make a difference though. Also, there seems to have been some additional dst_rect clamping code inside src_dst_split_scaling that didn't seem to either be necessary nor ever get triggered. (The code immediately above it already makes sure to crop the video if it's larger than the dst_rect) No idea why it was there, but I just removed it.
* osd: add italic font for osdst4t1k2016-04-081-0/+3
|
* x11: do not set _NET_WM_BYPASS_COMPOSITOR by defaultwm42016-04-031-2/+2
| | | | | | | | | | | It's pretty "unfriendly" and causes too many issues. (Probably. At least they're more obvious to a user than e.g. broken frame timing.) Potentially we could apply heuristics like applying this only on fullscreen, but let's not. It's up to the user to configure this to get best results. Fixes #2997.
* aspect: make video-zoom logarithmicNiklas Haas2016-04-031-6/+4
| | | | | | | | | | | | | The past behavior was a bit weird, especially when zooming out. There was no simple way to zoom in or out in consistent increments using keybindings alone. The new behavior preserves most of the old behavior's semantics but scales out to infinity better. It coincidentally also makes it really easy to get clean power of 2 ratios (e.g. 2x, 4x, 8x and their inverses). Fixes #3004.
* manpage: fix typoKevin Mitchell2016-04-021-1/+1
|
* manpage: add example for --msg-levelwm42016-04-021-0/+16
| | | | I guess the syntax is not necessarily very obvious.
* vd_lavc: add d3d11va hwdecKevin Mitchell2016-03-301-0/+1
| | | | | | This commit adds the d3d11va-copy hwdec mode using the ffmpeg d3d11va api. Functions in common with dxva2 are handled in a separate decode/d3d.c file. A future commit will rewrite decode/dxva2.c to share this code.
* man: ipc: update for named pipe IPC on WindowsJames Ross-Gowan2016-03-231-4/+10
|
* manpage: remove extraneous newlines from end of options.rstKevin Mitchell2016-03-101-2/+0
|
* manpage: add note about video filters and hwdecKevin Mitchell2016-03-101-1/+5
|
* manpage: document dxva2 option for hwdecKevin Mitchell2016-03-101-3/+6
| | | | Also mention dxva2-copy along with vaapi-copy.
* demux: add null demuxerwm42016-03-041-0/+2
| | | | It's useless, but can be used for fancy --lavfi-complex nonsense.
* manpage: add showvolume example to --lavfi-complexwm42016-02-271-0/+3
| | | | Pretty useful for debugging surround nonsense.
* manpage: fix typowm42016-02-211-1/+1
|
* demux_timeline: fix nested timelineswm42016-02-201-2/+1
| | | | | You can e.g. reference ordered chapters or other EDL files in EDLs. There were some bugs left which broke this in some cases.
* manpage: normal filters are still active with complex filterswm42016-02-121-0/+3
| | | | It's not exactly obvious how they interact.
* manpage: add example for playing 2 audio tracks at the same timewm42016-02-081-0/+2
|
* player: add --external-file optionwm42016-02-081-0/+5
| | | | Mostly intended for use with --lavfi-complex.
* player: add complex filter graph supportwm42016-02-051-1/+43
| | | | | | | | | | | | | | | | See --lavfi-complex option. This is still quite rough. There's no support for dynamic configuration of any kind. There are probably corner cases where playback might freeze or burn 100% CPU (due to dataflow problems when interaction with libavfilter). Future possible plans might include: - freely switch tracks by providing some sort of default track graph label - automatically enabling audio visualization - automatically mix audio or stack video when multiple tracks are selected at once (similar to how multiple sub tracks can be selected)
* audio: remove default preference for libdcadecwm42016-02-011-1/+1
| | | | Not needed anymore, because the decoder was merged with FFmpeg.
* manpage: minor correctionswm42016-01-241-1/+1
| | | | Pointed out by der_richter on IRC.
* audio: change downmix behavior, add --audio-normalize-downmixwm42016-01-201-0/+10
| | | | | | This is probably the 3rd time the user-visible behavior changes. This time, switch back because not normalizing seems to be the more expected behavior from users.
* audio: change --audio-channels default back to stereowm42016-01-201-5/+6
| | | | | | | | Too many problems. Well, actually it's just Linux audio systems which cause problems, and exclusive audio access on other platforms. In any case, it seems you have to do some manual configuration if you want multichannel audio output.
* manpage: adjust --display-fps descriptionwm42016-01-181-3/+7
| | | | | Make it more conservative. In most cases, mpv should be able to determine it correctly on all supported platforms.
* man: options: Clarify expected behaviour with --dvbin-full-transponder.Oliver Freyermuth2016-01-141-4/+7
| | | | | | | Since the streams are chosen from the full TS by the player frontend, one should not expect that the program which is shown matches the chosen channel which was used for tuning to the frequency. Also, reformulate slightly to simplify reading.
* man: options: hint to cycling of program property.Oliver Freyermuth2016-01-141-0/+2
| | | | | Very helpful to switch between the different programs on a transponder in full-transponder-mode for DVB.
* manpage: mention that image subtitles can not be repositioned etc.wm42016-01-121-0/+8
| | | | Fixes #2707. (Not entirely following the suggestions there.)
* options: exclude 360 from --video-rotate rangewm42016-01-021-1/+1
| | | | It's indeed completely useless. Pointed out in #2647.
* demux_mkv: adjust subtitle preroll defaultswm42015-12-271-2/+9
| | | | | | | | | | | | | | | | | Always preroll by default if the cue (index) information indicates overlapping subtitles. Increase the amount of maximum data it will skip to get such subtitles to 10 seconds. Since the index information can reliably tell whether reading earlier is needed, the maximum should be rarely actually used, thus we can set it high. On the other hand, the "old" prerolling mechanism always has to skip the maximum amount of data; thus the method using the index gets its own option to control the maximum amount of data to skip. (As more and more files With newer mkvtoolnix versions are muxed, and with this new and hopefully sane default established, these options can probably be removed in the future.)
* options: add --audio-file-pathswm42015-12-251-1/+5
| | | | | | | | Requested. It works like --sub-paths. This will also load audio files from a "audio" sub directory in the config file (because the same code as for subtitles is used, and it also had such a feature). Fixes #2632.
* man: fix grammar issuesMartin Herkt2015-12-191-23/+28
|
* stream: drop PVR supportwm42015-12-101-59/+0
| | | | | | | | | This is only for specific Hauppage cards. According to the comments in who is actively using this feature. Get it out of the way. Anyone who still wants to use this should complain. Keeping this code would not cause terribly much additional work, and it could be restored again. (But not if the request comes months later.)
* sub: increase gap/overlap fixing threshold to 210mswm42015-12-071-1/+1
| | | | Don't ask why.