1
0
mirror of https://github.com/cookiengineer/audacity synced 2025-07-18 01:27:41 +02:00
audacity/lib-src/slv2/slv2/pluginuis.h
2010-01-24 09:19:39 +00:00

88 lines
2.1 KiB
C

/* SLV2
* Copyright (C) 2007 Dave Robillard <http://drobilla.net>
*
* 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__
#ifdef __cplusplus
extern "C" {
#endif
#include <slv2/types.h>
#include <slv2/plugin.h>
/** \addtogroup slv2_collections
*
* @{
*/
/** 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_uis_free(SLV2UIs list);
/** Get the number of plugins in the list.
*/
unsigned
slv2_uis_size(SLV2UIs 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.
*/
SLV2UI
slv2_uis_get_by_uri(SLV2UIs list,
SLV2Value 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.
*/
SLV2UI
slv2_uis_get_at(SLV2UIs list,
unsigned index);
/** @} */
#ifdef __cplusplus
}
#endif
#endif /* __SLV2_PLUGIN_UIS_H__ */