aboutsummaryrefslogtreecommitdiffstats
path: root/lv2/lv2plug.in/ns/extensions/ui/ui.h
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2014-07-31 20:39:26 +0000
committerDavid Robillard <d@drobilla.net>2014-07-31 20:39:26 +0000
commit1c67d8123580b5cf70b5530277ad8320e97174cd (patch)
tree7b2382e550b35c6d87362f8995198f640fd5fdad /lv2/lv2plug.in/ns/extensions/ui/ui.h
parent64e25ef4f27e9e82402ba1a361e8c443eefc93db (diff)
downloadlv2-1c67d8123580b5cf70b5530277ad8320e97174cd.tar.xz
Use Doxygen Markdown support for more human-readable doc comments.
Minor improvements to UI documentation.
Diffstat (limited to 'lv2/lv2plug.in/ns/extensions/ui/ui.h')
-rw-r--r--lv2/lv2plug.in/ns/extensions/ui/ui.h41
1 files changed, 22 insertions, 19 deletions
diff --git a/lv2/lv2plug.in/ns/extensions/ui/ui.h b/lv2/lv2plug.in/ns/extensions/ui/ui.h
index 91651dd..8fada66 100644
--- a/lv2/lv2plug.in/ns/extensions/ui/ui.h
+++ b/lv2/lv2plug.in/ns/extensions/ui/ui.h
@@ -59,7 +59,7 @@
#define LV2_UI__windowTitle LV2_UI_PREFIX "windowTitle"
/**
- The index returned by LV2_UI_Port_Port::port_index() for unknown ports.
+ The index returned by LV2UI_Port_Map::port_index() for unknown ports.
*/
#define LV2UI_INVALID_PORT_INDEX ((uint32_t)-1)
@@ -98,18 +98,21 @@ typedef void* LV2UI_Feature_Handle;
/**
A host-provided function that sends data to a plugin's input ports.
- The @p buffer parameter must point to a block of data, @p buffer_size bytes
- large. The format of this data and how the host should use it is defined by
- the @p port_protocol. This buffer is owned by the UI and is only valid for
- the duration of this call.
+ @param controller The opaque controller pointer passed to
+ LV2UI_Descriptor::instantiate().
- The @p port_protocol parameter should either be 0 or the URID for a
- ui:PortProtocol. If it is 0, the protocol is implicitly ui:floatProtocol,
- the port MUST be an lv2:ControlPort input, @p buffer MUST point to a single
- float value, and @p buffer_size MUST be sizeof(float).
+ @param port_index Index of the port to update.
- The UI SHOULD NOT use a protocol not supported by the host, but the host
- MUST gracefully ignore any protocol it does not understand.
+ @param buffer Buffer containing `buffer_size` bytes of data.
+
+ @param buffer_size Size of `buffer` in bytes.
+
+ @param port_protocol Either 0 or the URID for a ui:PortProtocol. If 0, the
+ protocol is implicitly ui:floatProtocol, the port MUST be an lv2:ControlPort
+ input, `buffer` MUST point to a single float value, and `buffer_size` MUST
+ be sizeof(float). The UI SHOULD NOT use a protocol not supported by the
+ host, but the host MUST gracefully ignore any protocol it does not
+ understand.
*/
typedef void (*LV2UI_Write_Function)(LV2UI_Controller controller,
uint32_t port_index,
@@ -143,7 +146,7 @@ typedef struct _LV2UI_Descriptor {
@param write_function A function that the UI can use to send data to the
plugin's input ports.
- @param controller A handle for the plugin instance to be passed as the
+ @param controller A handle for the UI instance to be passed as the
first parameter of UI methods.
@param widget (output) widget pointer. The UI points this at its main
@@ -173,18 +176,18 @@ typedef struct _LV2UI_Descriptor {
/**
Tell the UI that something interesting has happened at a plugin port.
- What is "interesting" and how it is written to @p buffer is defined by
- @p format, which has the same meaning as in LV2UI_Write_Function().
+ What is "interesting" and how it is written to `buffer` is defined by
+ `format`, which has the same meaning as in LV2UI_Write_Function().
Format 0 is a special case for lv2:ControlPort, where this function
should be called when the port value changes (but not necessarily for
- every change), @p buffer_size must be sizeof(float), and @p buffer
+ every change), `buffer_size` must be sizeof(float), and `buffer`
points to a single IEEE-754 float.
By default, the host should only call this function for lv2:ControlPort
inputs. However, the UI can request updates for other ports statically
with ui:portNotification or dynamicaly with ui:portSubscribe.
- The UI MUST NOT retain any reference to @p buffer after this function
+ The UI MUST NOT retain any reference to `buffer` after this function
returns, it is only valid for the duration of the call.
This member may be NULL if the UI is not interested in any port events.
@@ -247,7 +250,7 @@ typedef struct _LV2UI_Port_Map {
LV2UI_Feature_Handle handle;
/**
- Get the index for the port with the given @p symbol.
+ Get the index for the port with the given `symbol`.
@return The index of the port, or LV2UI_INVALID_PORT_INDEX if no such
port is found.
@@ -271,7 +274,7 @@ typedef struct _LV2UI_Port_Subscribe {
This means that the host will call the UI's port_event() function when
the port value changes (as defined by protocol).
- Calling this function with the same @p port_index and @p port_protocol
+ Calling this function with the same `port_index` and `port_protocol`
as an already active subscription has no effect.
@param handle The handle field of this struct.
@@ -291,7 +294,7 @@ typedef struct _LV2UI_Port_Subscribe {
This means that the host will cease calling calling port_event() when
the port value changes.
- Calling this function with a @p port_index and @p port_protocol that
+ Calling this function with a `port_index` and `port_protocol` that
does not refer to an active port subscription has no effect.
@param handle The handle field of this struct.