summaryrefslogtreecommitdiffstats
path: root/libmpv
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2014-05-18 18:58:36 +0200
committerwm4 <wm4@nowhere>2014-05-18 19:21:39 +0200
commit537ac1a15fbc02619ebe8c7b97823d06937c8107 (patch)
treea01632430d92ab42e64248119a48f9168f0bb090 /libmpv
parentcaa939aa91157937759a8be54f9c794d05fd0120 (diff)
downloadmpv-537ac1a15fbc02619ebe8c7b97823d06937c8107.tar.bz2
mpv-537ac1a15fbc02619ebe8c7b97823d06937c8107.tar.xz
client API: add mpv_load_config_file()
This is probably a good idea, because it would make it easier for software embedding mpv to configure the mpv parts, without requiring the host program to provide explicit mechanisms for this (other than calling mpv_load_config_file()).
Diffstat (limited to 'libmpv')
-rw-r--r--libmpv/client.h24
1 files changed, 24 insertions, 0 deletions
diff --git a/libmpv/client.h b/libmpv/client.h
index 3b43c2f383..673586e169 100644
--- a/libmpv/client.h
+++ b/libmpv/client.h
@@ -312,6 +312,30 @@ int mpv_initialize(mpv_handle *ctx);
void mpv_destroy(mpv_handle *ctx);
/**
+ * Load a config file. This loads and parses the file, and sets every entry in
+ * the config file's default section as if mpv_set_option_string() is called.
+ *
+ * The filename should be an absolute path. If it isn't, the actual path used
+ * is unspecified. (Note: an absolute path starts with '/' on UNIX.) If the
+ * file wasn't found, MPV_ERROR_INVALID_PARAMETER is returned.
+ *
+ * If a fatal error happens when parsing a config file, MPV_ERROR_OPTION_ERROR
+ * is returned. Errors when setting options as well as other types or errors
+ * are ignored (even if options do not exist). You can still try to capture
+ * the resulting error messages with mpv_request_log_messages(). Note that it's
+ * possible that some options were successfully set even if any of these errors
+ * happen.
+ *
+ * The same restrictions as with mpv_set_option() apply: some options can't
+ * be set outside of idle or uninitialized state, and many options don't
+ * take effect immediately.
+ *
+ * @param filename absolute path to the config file on the local filesystem
+ * @return error code
+ */
+int mpv_load_config_file(mpv_handle *ctx, const char *filename);
+
+/**
* Stop the playback thread. Normally, the client API stops the playback thread
* automatically in order to process requests. However, the playback thread is
* restarted again after the request was processed. Then the playback thread