SLV2(3) SLV2 SLV2(3)NAME
SLV2 - SLV2 is a host library to simplify the discovery, loading, and use of LV2 plugins (http://lv2plug.in).
SLV2 is written in standard C99, and depends only on the Redland RDF library (http://librdf.org). It should be portable to any system with
Redland, and is tested on various GNU/Linux distributions (often), and MacOS X (occasionally).
The Data (RDF) and code (shared library) functionality in SLV2 is strictly separated so it is simple to control where each is used (e.g. it
is possible to discover/investigate plugins and related data without loading any shared libraries, avoiding the associated risks).
The SLV2 documentation is broken into several pages:
o slv2_world - Global library initialisation, state, plugin discovery, etc.
o slv2_util - Generally useful utility functions
o slv2_collections - Collections of values (literals and URIs) and objects
o slv2_data - Access to plugin RDF data
o slv2_library - Access to plugin shared libraries
Author
Generated automatically by Doxygen for SLV2 from the source code.
Version 0.6.6 2 Apr 2009 SLV2(3)
Check Out this Related Man Page
PLKUGIN LIBRARY ACCESS(3) SLV2 PLKUGIN LIBRARY ACCESS(3)NAME
Plugin_library_access - An SLV2Instance is an instantiated SLV2Plugin (ie a loaded dynamic library).
Functions
SLV2Instance slv2_plugin_instantiate (SLV2Plugin plugin, double sample_rate, const LV2_Feature *const *features)
void slv2_instance_free (SLV2Instance instance)
static const char * slv2_instance_get_uri (SLV2Instance instance)
static void slv2_instance_connect_port (SLV2Instance instance, uint32_t port_index, void *data_location)
static void slv2_instance_activate (SLV2Instance instance)
static void slv2_instance_run (SLV2Instance instance, uint32_t sample_count)
static void slv2_instance_deactivate (SLV2Instance instance)
static const void * slv2_instance_get_extension_data (SLV2Instance instance, const char *uri)
static const LV2_Descriptor * slv2_instance_get_descriptor (SLV2Instance instance)
static LV2_Handle slv2_instance_get_handle (SLV2Instance instance)
SLV2UIInstance slv2_ui_instantiate (SLV2Plugin plugin, SLV2UI ui, LV2UI_Write_Function write_function, LV2UI_Controller controller, const
LV2_Feature *const *features)
void slv2_ui_instance_free (SLV2UIInstance instance)
const LV2UI_Descriptor * slv2_ui_instance_get_descriptor (SLV2UIInstance instance)
LV2UI_Handle slv2_ui_instance_get_handle (SLV2UIInstance instance)
Detailed Description
These functions interact with the binary library code only, they do not read data files in any way.
Function Documentation
SLV2Instance slv2_plugin_instantiate (SLV2Plugin plugin, double sample_rate, const LV2_Feature *const * features)
Instantiate a plugin.
The returned object represents shared library objects loaded into memory, it must be cleaned up with slv2_instance_free when no longer
needed.
plugin is not modified or directly referenced by the returned object (instances store only a copy of the plugin's URI).
host_features NULL-terminated array of features the host supports. NULL may be passed if the host supports no additional features (unlike
the LV2 specification - SLV2 takes care of it).
Returns:
NULL if instantiation failed.
void slv2_instance_free (SLV2Instance instance)
Free a plugin instance.
instance is invalid after this call.
static const char* slv2_instance_get_uri (SLV2Instance instance) [inline, static]
Get the URI of the plugin which instance is an instance of.
Returned string is shared and must not be modified or deleted.
static void slv2_instance_connect_port (SLV2Instance instance, uint32_t port_index, void * data_location) [inline, static]
Connect a port to a data location.
This may be called regardless of whether the plugin is activated, activation and deactivation does not destroy port connections.
static void slv2_instance_activate (SLV2Instance instance) [inline, static]
Activate a plugin instance.
This resets all state information in the plugin, except for port data locations (as set by slv2_instance_connect_port). This MUST be called
before calling slv2_instance_run.
static void slv2_instance_run (SLV2Instance instance, uint32_t sample_count) [inline, static]
Run instance for sample_count frames.
If the hint lv2:hardRtCapable is set for this plugin, this function is guaranteed not to block.
static void slv2_instance_deactivate (SLV2Instance instance) [inline, static]
Deactivate a plugin instance.
Note that to run the plugin after this you must activate it, which will reset all state information (except port connections).
static const void* slv2_instance_get_extension_data (SLV2Instance instance, const char * uri) [inline, static]
Get extension data from the plugin instance.
The type and semantics of the data returned is specific to the particular extension, though in all cases it is shared and must not be
deleted.
static const LV2_Descriptor* slv2_instance_get_descriptor (SLV2Instance instance) [inline, static]
Get the LV2_Descriptor of the plugin instance.
Normally hosts should not need to access the LV2_Descriptor directly, use the slv2_instance_* functions.
The returned descriptor is shared and must not be deleted.
static LV2_Handle slv2_instance_get_handle (SLV2Instance instance) [inline, static]
Get the LV2_Handle of the plugin instance.
Normally hosts should not need to access the LV2_Handle directly, use the slv2_instance_* functions.
The returned handle is shared and must not be deleted.
SLV2UIInstance slv2_ui_instantiate (SLV2Plugin plugin, SLV2UI ui, LV2UI_Write_Function write_function, LV2UI_Controller controller, const
LV2_Feature *const * features)
Instantiate a plugin UI.
The returned object represents shared library objects loaded into memory, it must be cleaned up with slv2_ui_instance_free when no longer
needed.
plugin is not modified or directly referenced by the returned object (instances store only a copy of the plugin's URI).
host_features NULL-terminated array of features the host supports. NULL may be passed if the host supports no additional features (unlike
the LV2 specification - SLV2 takes care of it).
Returns:
NULL if instantiation failed.
void slv2_ui_instance_free (SLV2UIInstance instance)
Free a plugin UI instance.
It is the caller's responsibility to ensure all references to the UI instance (including any returned widgets) are cut before calling this
function.
instance is invalid after this call.
LV2UI_Widget slv2_ui_instance_get_widget (SLV2UIInstance instance)
Get the widget for the UI instance.
const LV2UI_Descriptor* slv2_ui_instance_get_descriptor (SLV2UIInstance instance)
Get the LV2UI_Descriptor of the plugin UI instance.
Normally hosts should not need to access the LV2UI_Descriptor directly, use the slv2_ui_instance_* functions.
The returned descriptor is shared and must not be deleted.
LV2UI_Handle slv2_ui_instance_get_handle (SLV2UIInstance instance)
Get the LV2UI_Handle of the plugin UI instance.
Normally hosts should not need to access the LV2UI_Handle directly, use the slv2_ui_instance_* functions.
The returned handle is shared and must not be deleted.
Author
Generated automatically by Doxygen for SLV2 from the source code.
Version 0.6.6 2 Apr 2009 PLKUGIN LIBRARY ACCESS(3)