diff options
author | wm4 <wm4@nowhere> | 2014-02-25 22:56:58 +0100 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2014-02-25 22:57:48 +0100 |
commit | 279bd8db1f16953d6c99293625440f184967a534 (patch) | |
tree | 5eb8a6ec618bb4a6acb44be37667668ec1100853 /libmpv | |
parent | 008fe558dcf5c19a19809f0bbaa1763eb8261a51 (diff) | |
download | mpv-279bd8db1f16953d6c99293625440f184967a534.tar.bz2 mpv-279bd8db1f16953d6c99293625440f184967a534.tar.xz |
client API: change description of format conversions
This changed during the time between writing the comment, and finishing
up the implementation.
Although I'm still unsure about this.
Diffstat (limited to 'libmpv')
-rw-r--r-- | libmpv/client.h | 16 |
1 files changed, 10 insertions, 6 deletions
diff --git a/libmpv/client.h b/libmpv/client.h index 04fc94663d..606fabbce5 100644 --- a/libmpv/client.h +++ b/libmpv/client.h @@ -627,9 +627,11 @@ int mpv_command_async(mpv_handle *ctx, uint64_t reply_userdata, * can be queried or set at runtime. For example, writing to the pause property * will actually pause or unpause playback. * - * If the format doesn't match with the internal format of the property, it's - * converted. This conversion doesn't always yield useful values, so you - * should be careful which format you use. + * If the format doesn't match with the internal format of the property, access + * usually will fail with MPV_ERROR_PROPERTY_FORMAT. In some cases, the data + * is automatically converted and access succeeds. For example, MPV_FORMAT_INT64 + * is always converted to MPV_FORMAT_DOUBLE, and access using MPV_FORMAT_STRING + * usually invokes a string formatter. * * @param name The property name. See input.rst for a list of properties. * @param format see enum mpv_format. Currently, only MPV_FORMAT_STRING is valid. @@ -665,9 +667,11 @@ int mpv_set_property_async(mpv_handle *ctx, uint64_t reply_userdata, /** * Read the value of the given property. * - * If the format doesn't match with the internal format of the property, it's - * converted. This conversion doesn't always yield useful values, so you - * should be careful which format you use. + * If the format doesn't match with the internal format of the property, access + * usually will fail with MPV_ERROR_PROPERTY_FORMAT. In some cases, the data + * is automatically converted and access succeeds. For example, MPV_FORMAT_INT64 + * is always converted to MPV_FORMAT_DOUBLE, and access using MPV_FORMAT_STRING + * usually invokes a string parser. * * @param name The property name. * @param format see enum mpv_format. |