path: root/libmpv
diff options
authorwm4 <wm4@nowhere>2014-04-08 22:06:39 +0200
committerwm4 <wm4@nowhere>2014-04-08 22:06:39 +0200
commit89d400dc21881e63fda20e23b11a88bca6ee49d6 (patch)
tree3d8cbe72f74bb37a0dc4165af99da0a79250ec1a /libmpv
parentd6022f33d64df9c0226db49bef68197473bfc598 (diff)
client API: avoid redundant property change events if possible
This is done simply by comparing the previous and current values. Do this only if the requested format is not MPV_FORMAT_NONE.
Diffstat (limited to 'libmpv')
1 files changed, 4 insertions, 0 deletions
diff --git a/libmpv/client.h b/libmpv/client.h
index 35c193f64a..0811935476 100644
--- a/libmpv/client.h
+++ b/libmpv/client.h
@@ -752,6 +752,10 @@ int mpv_get_property_async(mpv_handle *ctx, uint64_t reply_userdata,
* Observing a property that doesn't exist is allowed, although it may still
* cause some sporadic change events.
+ * If you set the format parameter to a value other than MPV_FORMAT_NONE, the
+ * API will suppress redundant change events by comparing the raw value against
+ * the previous value.
+ *
* @param reply_userdata This will be used for the mpv_event.reply_userdata
* field for the received MPV_EVENT_PROPERTY_CHANGE
* events. (Also see section about asynchronous calls,