From f3c933e5d3501c71e7f38dc62b27096a90090d5e Mon Sep 17 00:00:00 2001 From: wm4 Date: Tue, 25 Feb 2014 23:59:27 +0100 Subject: options: allow changing options at runtime Allow changing all options at runtime, except some cherry-picked options, which are disabled with M_OPT_FIXED. --- libmpv/client.h | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) (limited to 'libmpv') diff --git a/libmpv/client.h b/libmpv/client.h index 606fabbce5..0c0cde7b0f 100644 --- a/libmpv/client.h +++ b/libmpv/client.h @@ -561,11 +561,14 @@ void mpv_free_node_contents(mpv_node *node); /** * Set an option. Note that you can't normally set options during runtime. It - * works in uninitialized state (see mpv_create()), and in some cases in idle - * mode. - * - * You can use mpv_set_property() to change options during playback, but this - * does not work with all options. + * works in uninitialized state (see mpv_create()), and in some cases in at + * runtime. + * + * Changing options at runtime does not always work. For some options, attempts + * to change them simply fails. Many other options may require reloading the + * file for changes to take effect. In general, you should prefer calling + * mpv_set_property() to change settings during playback, because the property + * mechanism guarantees that changes take effect immediately. * * @param name Option name. This is the same as on the mpv command line, but * without the leading "--". -- cgit v1.2.3