From 8e4508482b3f8abcd997d527ddcbce25bbd63384 Mon Sep 17 00:00:00 2001 From: David Robillard Date: Mon, 9 Jul 2012 04:48:26 +0000 Subject: Add proper documentation for suil_instance_port_event(). git-svn-id: http://svn.drobilla.net/lad/trunk/suil@4525 a436a847-0d15-0410-975c-d299462d15a1 --- suil/suil.h | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/suil/suil.h b/suil/suil.h index cf7cf8f..35ed29b 100644 --- a/suil/suil.h +++ b/suil/suil.h @@ -211,6 +211,19 @@ suil_instance_get_widget(SuilInstance* instance); /** Notify the UI about a change in a plugin port. + @param instance UI instance. + @param port_index Index of the port which has changed. + @param buffer_size Size of @p buffer in bytes. + @param format Format of @p buffer (mapped URI, or 0 for float). + @param buffer Change data, e.g. the new port value. + + This function can be used to notify the UI about any port change, but in the + simplest case is used to set the value of lv2:ControlPort ports. For + simplicity, this is a special case where @p format is 0, @p buffer_size is + 4, and @p buffer should point to a single float. + + The @p buffer must be valid only for the duration of this call, the UI must + not keep a reference to it. */ SUIL_API void -- cgit v1.2.1