From 123ba8acf4817ae246130081f76fc7f4398e412d Mon Sep 17 00:00:00 2001 From: David Robillard Date: Sun, 23 Sep 2007 19:31:51 +0000 Subject: Fix LV2 UI stuff. Sineshaper embeds in Ingen now. git-svn-id: http://svn.drobilla.net/lad/slv2@773 a436a847-0d15-0410-975c-d299462d15a1 --- slv2/pluginuis.h | 91 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 91 insertions(+) create mode 100644 slv2/pluginuis.h (limited to 'slv2/pluginuis.h') diff --git a/slv2/pluginuis.h b/slv2/pluginuis.h new file mode 100644 index 0000000..06c38b7 --- /dev/null +++ b/slv2/pluginuis.h @@ -0,0 +1,91 @@ +/* SLV2 + * Copyright (C) 2007 Dave Robillard + * + * This library is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This library is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License + * for more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. + */ + +#ifndef __SLV2_PLUGIN_UIS_H__ +#define __SLV2_PLUGIN_UIS_H__ + +#include +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/** \defgroup plugins Collections of plugins + * + * These functions work with lists of plugins which come from an + * SLV2World. These lists contain only a weak reference to an LV2 plugin + * in the Model. + * + * @{ + */ + + +/** Free a plugin list. + * + * Freeing a plugin list does not destroy the plugins it contains (plugins + * are owned by the world). \a list is invalid after this call. + */ +void +slv2_plugin_uis_free(SLV2PluginUIs list); + + +/** Get the number of plugins in the list. + */ +unsigned +slv2_plugin_uis_size(SLV2PluginUIs list); + + +/** Get a plugin from the list by URI. + * + * Return value is shared (stored in \a list) and must not be freed or + * modified by the caller in any way. + * + * Time = O(log2(n)) + * + * \return NULL if plugin with \a url not found in \a list. + */ +SLV2PluginUI +slv2_plugin_uis_get_by_uri(SLV2PluginUIs list, + const char* uri); + + +/** Get a plugin from the list by index. + * + * \a index has no significance other than as an index into this list. + * Any \a index not less than slv2_list_get_length(list) will return NULL, + * so all plugins in a list can be enumerated by repeated calls + * to this function starting with \a index = 0. + * + * Time = O(1) + * + * \return NULL if \a index out of range. + */ +SLV2PluginUI +slv2_plugin_uis_get_at(SLV2PluginUIs list, + unsigned index); + + +/** @} */ + +#ifdef __cplusplus +} +#endif + +#endif /* __SLV2_PLUGIN_UIS_H__ */ + -- cgit v1.2.1