summaryrefslogtreecommitdiffstats
path: root/DOCS/man/options.rst
Commit message (Collapse)AuthorAgeFilesLines
* win32: snap to screen edgespavelxdd2017-01-271-0/+3
| | | | | | | Disabled by default. The snap sensitivity value depends on the screen DPI. The default value is 16px on a 96 DPI screen. Fixes #2248
* sub: add option to force using video resolution for image subtitleswm42017-01-231-0/+7
| | | | Basically for debugging and dealing with broken files.
* player: remove --stream-capture option/propertywm42017-01-211-15/+4
| | | | | | | | | | | | | | | This was excessively useless, and I want my time back that was needed to explain users why they don't want to use it. It captured the byte stream only, and even for types of streams it was designed for (like transport streams), it was rather questionable. As part of the removal, un-inline demux_run_on_thread() (which has only 1 call-site now), and sort of reimplement --stream-dump to write the data directly instead of using the removed capture code. (--stream-dump is also very useless, and I struggled coming up with an explanation for it in the manpage.)
* x11: pseudo HiDPI scalingwm42017-01-191-1/+1
| | | | | | | | | | | | | | | | Scale the window by the assumed DPI scaling factor, using 96 DPI as base. For example, a screen that reports 192 DPI is assumed to have a DPI scale factor 2. The window will then be created with twice the size. For robustness reasons, we accept only integer DPI scales between 1 and 9. We also error out if the X and Y scales are very different, as this most likely indicates a multiscreen system with botched size reporting. I'm not sure if reading the X server's DPI is such a good idea - maybe the Xrdb "Xft.dpi" value should be used instead. The current method follows what xdpyinfo does. This can be disabled with --hidpi-window-scale=no.
* options: drop deprecated --sub-codepage syntaxwm42017-01-191-2/+3
|
* options: drop deprecated --vd/--ad codecs selection featureswm42017-01-191-12/+2
| | | | | Only simple selection works now. Using "-" to terminate codec selection remains in the code (might get undeprecated).
* player: add prefetching of the next playlist entrywm42017-01-181-0/+21
| | | | | | | | | | | | Since for mpv CLI, the player state is a singleton, full prefetching is a bit tricky. We do it only on the demuxer layer. The implementation reuses the old "open thread". This means there is significant potential for regressions even if the new option is not used. This is made worse by the fact that I barely tested this code. The generic mpctx_run_reentrant() wrapper is also removed - this was its only user, and its remains become part of the new implementation.
* vo_opengl, vo_opengl_cb: better hwdec interop backend selectionwm42017-01-171-2/+15
| | | | | | | | | | | Introduce the --opengl-hwdec-interop option, which replaces --hwdec-preload. The new option allows explicit selection of the interop backend. This is relatively complex, and I would have preferred not to add this, but it's probably useful to debug certain problems. In exchange, the "new" option documents that pretty much any but the simplest use of it will not be forward compatible.
* manpage: add comment about --alpha being broken on X11/EGL/Mesawm42017-01-161-0/+1
|
* manpage: document x11probe OpenGL backendwm42017-01-061-0/+3
| | | | Fixes #3994.
* options: deprecate some other complex --ad/--vd featureswm42016-12-231-2/+3
| | | | | | | Who even needs those? Once these deprecations are gone, --ad/--vd are simple lists without any kind of complex matching.
* options: deprecate codec family selection in --vd/--adwm42016-12-231-8/+11
| | | | | Useless now, so get rid of it. Also affects some user-visible display things (like reported codec in use).
* audio: change how spdif codecs are selectedwm42016-12-231-4/+3
| | | | | | | | | | | | | | Remove ad_spdif from the normal codec list, and select it explicitly. One goal was to decouple this from the normal codec selection, so they're less entangled and the decoder selection code can be simplified in the far future. This means spdif codec selection is now done explicitly via select_spdif_codec(). We can also remove the weird requirements on "dts" and "dts-hd" for the --audio-spdif option, and it can just do the right thing. Now both video and audio codecs consist of a single codec family each, vd_lavc and ad_lavc.
* Fix mistakes in spelling and grammarDario Russo2016-12-211-1/+1
|
* options: change --h=... behaviorwm42016-12-161-3/+4
| | | | | Does not match a shell pattern anymore. Instead, a simple sub-string search is done.
* cocoa: fullscreen refactoringAkemi2016-12-151-4/+0
| | | | | | | | | | this replaces the old fullscreen with the native macOS fullscreen. additional the --fs-black-out-screens was removed since the new API doesn't support it in a way the old one did. it can possibly be re-added if done manually. Fixes #2857 #3272 #1352 #2062 #3864
* manpage: clarify --loop optionwm42016-12-121-2/+2
| | | | Fixes #3899.
* charset_conv: simplify and change --sub-codepage optionwm42016-12-091-52/+17
| | | | | | | As documented in interface-changes.rst. This makes it much easier to follow what the heck is going on. Whether this is adequate for real-world use is unknown.
* manpage: replace `-vo` with `--vo`Douglas Christman2016-12-081-2/+2
|
* manpage: move the --opengl-dumb-mode option downwm42016-12-071-14/+14
| | | | | | | It's horribly obscure - why would it be the first option to be listed? Also might fix the --scale option formatting/anchor in the HTML rendering.
* demux, stream: add option to prevent opening referenced fileswm42016-12-041-0/+20
| | | | Quite irresponsibly hacked together. Sue me.
* vo_opengl: hwdec_cuda: Support P016 output surfacesPhilip Langdale2016-11-221-2/+2
| | | | | | | | | The latest 375.xx nvidia drivers add support for P016 output surfaces. In combination with an ffmpeg change to return those surfaces, we can display them. The bulk of the work is related to knowing which format you're dealing with at the right time. Once you know, it's straight forward.
* options: clarify --softvol deprecation message and manpage entrywm42016-11-191-3/+3
| | | | | People seem to think that the softvol behavior is deprecated, but what is deprecated is actually disabling softvol.
* vo_opengl: blend against background color for --alpha=blendPhilip Sequeira2016-11-131-1/+2
| | | | | Do it after color management, etc. so that it matches the color drawn in the margins.
* docs: remove trailing spacesStefano Pigozzi2016-11-111-2/+2
| | | Some slipped in with previous commit.
* cocoa: option to scale window by HiDPI scale factorAkemi2016-11-111-0/+7
| | | | | | | | | | Deactivating this options makes it possible to circumvent the default OS X behavior of using points. Windows on HiDPI resolutions won't open in double the size anymore and videos are display in their native resolution when windowed. Fixes #3716
* man/options.rst: fix typoDouglas Christman2016-11-061-1/+1
|
* manpage: explicitly document all scaling optionsNiklas Haas2016-11-011-82/+77
| | | | | | | | | | Enumerate all of the scaling-related options, even for the ``--cscale`` / ``--tscale`` etc. variants. Unfortunately this breaks 80col quite severely, but there's nothing I can do about it due to a bug in rst2man preventing definition list labels from spanning multiple lines. Also reorder some of the scaling-related options to be closer together and in a more consistent order (for a top-to-bottom reading flow).
* filter_kernels: add ability to taper kernels/windowsNiklas Haas2016-11-011-6/+13
| | | | | | | This allows us to define the tukey window (and other tapered windows). Also add a missing option definition for `wblur` while we're at it, to make testing out window-related stuff easier.
* vo_opengl: partially re-enable glFlush() callswm42016-10-211-3/+6
| | | | | | | | | | | | It turns out the glFlush() call really helps in some cases, though only in audio timing mode (where we render, then wait for a while, then display the frame). Add a --opengl-early-flush=auto mode, which does exactly that. It's unclear whether this is fine on OSX (strange things going on there), but it should be. See #3670.
* video: add --hwdec=vdpau-copy modewm42016-10-201-3/+4
| | | | | | | At this point, all other hwaccels provide -copy modes, and vdpau is the exception with not having one. Although there is vf_vdpaurb, it's less convenient in certain situations, and exposes some issues with the filter chain code as well.
* vd_lavc: Add hwdec wrapper for crystalhdPhilip Langdale2016-10-151-0/+6
| | | | This hardware decodes to system memory so it only requires a wrapper.
* cocoa: add glFlush() to cocoa backendAkemi2016-10-061-1/+1
| | | | | | | | | | | | The glFlush() call was made optional recently since it's not needed in most cases. On OSX though this is needed since we removed kCGLPFADoubleBuffer from the context creation, so the glFlush() call was added to the cocoa backend only. The CGLFlushDrawable() call can be safely removed since it only does something when a double buffered context is used. Also fixes a small typo. Fixes #3627.
* vo_opengl: disable glFlush() by default, and add an option to enable itwm42016-10-051-0/+5
| | | | | | | | | | | It seems this can cause issues with certain platforms, so better to disable it by default. The original reason for this isn't overly justified, and display-sync mode should get rid of the need for it anyway. The new option is meant for testing, and will probably be removed if nobody comes up and reports that enabling the option actually improves anything.
* manpage: fix closing quotewm42016-10-041-1/+1
|
* options: rename subtitle optionsDan Oscarsson2016-10-031-104/+193
| | | | | | | | | | | Rename the text subtitle options from --sub-text- to --sub- and --ass- options to --sub-ass-. The intention is to common sub options to prefixed --sub- and special ASS option be seen as a special version of sub options. The OSD options that work like the --sub- options are still named --osd-. Man page updated including a short note about renamed --sub-text-* and --ass-* options to --sub-* and --sub-ass-*.
* vo_opengl: add debugging options for testing with padded textureswm42016-10-011-1/+7
|
* rpi: add --hwdec=rpi-copywm42016-09-301-0/+4
| | | | | | This means it can be used with normal video filters. Might help out with #3604.
* vo_opengl: deprecate 'drm-egl' backend and introduce 'drm' insteadwm42016-09-271-2/+2
| | | | Just a name change. Requested.
* manpage: hwdec_cuda: update docs to say 10bit hevc is supportedPhilip Langdale2016-09-241-2/+2
| | | | | Now that ffmpeg bundles working headers, this no longer relies on a custom ffmpeg build with a hacked up header file.
* player: do not let pseudo-gui override user config settingswm42016-09-231-0/+6
| | | | | | | | Seems like this confused users quite often. Instead of --profile=pseudo-gui, --player-operation-mode=pseudo-gui now has to be used to invoke pseudo GUI mode. The old way still works, and still behaves in the old way.
* hwdec/cuda: Document how to activate cuda deinterlacingPhilip Langdale2016-09-221-8/+11
| | | | | | The latest changes to the decoder in ffmpeg enable frame doubled deinterlacing so that it's actually useful. Let's document how to use it.
* player: add --watch-later-directory optionDavid Logie2016-09-221-0/+7
| | | | | | | This option allows the user to set the directory where "watch later" files are stored. Signed-off-by: wm4 <wm4@nowhere>
* man/options.rst: fix typo and layoutKranky K. Krackpot2016-09-201-6/+8
| | | | Signed-off-by: wm4 <wm4@nowhere>
* options: rename/deprecate --playlist-poswm42016-09-181-3/+5
| | | | | | Conflicts with the "playlist-pos" property. They're really a bit too different, and since the --playlist-pos option is relatively new and obscure, just rename it to get this out of the way.
* options: actually deprecate --mute=autowm42016-09-181-3/+4
| | | | Also, make it internally actually an alias to "no".
* options: add --hwdec=yes as alias for --hwdec=autowm42016-09-151-2/+3
| | | | | | This also lets you just do "mpv --hwdec file.mkv", with the minor caveat that the legacy syntax "--hwdec val" or "-hwdec val" (without "=") does not work as expected anymore.
* manpage: explain "speed-adjusted" FPS for --interpolation-thresholdwm42016-09-151-2/+5
| | | | Fixes #3528.
* vo_opengl: mali fbdev supportwm42016-09-131-0/+2
| | | | | | | | | | | | Minimal support just for testing. Only the window surface creation (including size determination) is really platform specific, so this could be some generic thing with platform-specific support as some sort of sub-driver, but on the other hand I don't see much of a need for such a thing. While most of the fbdev usage is done by the EGL driver, using this fbdev ioctl is apparently the only way to get the display resolution.
* manpage: vo_rpi -> vo_openglwm42016-09-131-1/+1
|
* man: fix building pdfshinchiro2016-09-121-4/+6
|
* hwdec_cuda: Add trivial cuda-copy wrapperPhilip Langdale2016-09-111-4/+9
| | | | | | | | | The cuvid decoder already knows how to copy back to system memory if NV12 frames are requested, and this will happen if the decoder is used without the hwdec. For convenience, let's add a wrapper hwdec so people don't have to explicitly pick the cuvid decoder if they want this behaviour.
* options: make --h list options according to a pattern passed to itwm42016-09-101-1/+5
| | | | | | Useless feature, but I want it. Won't work on Windows due to missing fnmatch().
* man: fix typobugdone2016-09-101-1/+1
|
* man/options: Document cuda hwdec.Philip Langdale2016-09-091-0/+6
|
* options: drop unreferenced --bluray-angle optionwm42016-09-081-4/+0
| | | | | Uh, what? It wasn't used at all. It was probably accidentally dropped at one point, or it was never used at all. Whatever, who cares.
* manpage: remove more references to deprecated sub-option syntaxwm42016-09-071-34/+26
| | | | Fixes #3497.
* audio/out: deprecate "exclusive" sub-optionswm42016-09-051-0/+9
| | | | | | | 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-11/+8
| | | | | We have --audio-device, which can force the device. Also add something describing to this extent to the manpage.
* sd_lavc: enable teletextwm42016-09-031-0/+4
| | | | | | | | | | | | Whitelisting supported codecs is (probably) still better than just allowing everything, given the weird FFmpeg API. I'm also assuming Libav doesn't even have the codec ID, but I didn't check. Also add a --teletext-page option, since otherwise it decodes every teletext page and shows them in succession. And yes, we can't use av_opt_set_int() - instead we have to set it as string. Because FFmpeg's option system is terrible.
* ao_alsa: change sub-options to global optionswm42016-09-021-0/+54
| | | | | | Same deal as with vo_opengl. Also edit the outdated information about multichannel output a little.
* vo_opengl: deprecate sub-options, add them as global optionswm42016-09-021-0/+799
| | | | | | | | | | | | | | | | | | | | | | | | vo_opengl sub-option were always rather annoying to handle. It seems better to make them global options instead. This is simpler and easier to use. The only disadvantage we are aware of is that it's not clear that many/all of these new global options work with vo_opengl only. --vo=opengl-hq is also deprecated. There is extensive compatibility with the old behavior. One exception is that --vo-defaults will not apply to opengl-hq (though with opengl it still works). vo-cmdline is also dysfunctional and will be removed in a following commit. These changes also affect opengl-cb. The update mechanism is still rather inefficient: it requires syncing with the VO after each option change, rather than batching updates. There's also no granularity (video.c just updates "everything", and if auto-ICC profiles are enabled, vo_opengl.c will fetch them on each update). Most of the manpage changes were done by Niklas Haas <git@haasn.xyz>.
* command: add options to property listwm42016-09-011-1/+4
| | | | | | | | | | | Now options are accessible through the property list as well, which unifies them to a degree. Not all options support runtime changes (meaning affected components need to be restarted for the options to take effects). Remove from the manpage those properties which are cleanly mapped to options anyway. From the user-perspective they're just options available through the property interface.
* m_option: replace --no-video-aspect aliaswm42016-08-311-6/+4
| | | | | | | | | Instead, add a hacky OPT_ASPECT option type, which only exists to accept a "no" parameter, which in combination with the "--no-..." handling code makes --no-video-aspect work again. We can also remove the code in m_config.c, which only existed to make "--no-aspect" (a deprecated alias) to work.
* client API: deprecate "no-..." option handlingwm42016-08-311-16/+18
| | | | | | | | The client API can do this (and there are apparently some libmpv using projects which rely on this). But it's just unnecessary bloat as it requires a separate code path from the option parser. It would be better to remove this code. Formally deprecate it, including API bump and warning in the API changes file to make it really clear.
* player: add option to disable video OSDwm42016-08-281-4/+19
| | | | | | | | | | | | | | Normally, OSD can be disabled with --osd-level=0. But this also disables terminal OSD, and some users want _only_ the terminal OSD. Add --video-osd=no, which essentially disables the video OSD. Ideally, it should probably be possible to control terminal and video OSD levels independently, but that would require separate OSD timers (and other state) for both components, so don't do it. But because the current situation isn't too ideal, add a threat to the manpage that might be changed in the future. Fixes #3387.
* manpage: fix typowm42016-08-201-1/+1
|
* manpage: info about --panscan vs. --video-unscaled