Plugin registry

Database of all installed plugins. More...

Data Structures
struct	bg_plugin_info_s
	Information about a plugin. More...
struct	bg_plugin_registry_options_t
	Creation options for a plugin registry. More...
struct	bg_plugin_handle_s
	Handle of a loaded plugin. More...
Modules
	Defaults saved between sessions
	Plugin defaults.
Typedefs
typedef struct bg_plugin_info_s	bg_plugin_info_t
	Typedef for plugin info.
typedef struct bg_plugin_registry_s	bg_plugin_registry_t
	Opaque handle for a plugin registry.
typedef struct bg_plugin_handle_s	bg_plugin_handle_t
	Typedef for plugin handle.
Enumerations
enum	bg_plugin_api_t {   BG_PLUGIN_API_GMERLIN = 0,   BG_PLUGIN_API_LADSPA,   BG_PLUGIN_API_LV,   BG_PLUGIN_API_FREI0R }
	Identifiers for plugin APIs. More...
enum	bg_stream_type_t {   BG_STREAM_AUDIO = (1<<0),   BG_STREAM_SUBTITLE_TEXT = (1<<1),   BG_STREAM_SUBTITLE_OVERLAY = (1<<2),   BG_STREAM_VIDEO = (1<<3) }
	Identifiers for stream types. More...
Functions
bg_plugin_registry_t *	bg_plugin_registry_create (bg_cfg_section_t *section)
	Create a plugin registry.
bg_plugin_registry_t *	bg_plugin_registry_create_with_options (bg_cfg_section_t *section, const bg_plugin_registry_options_t *opt)
	Create a plugin registry with options.
void	bg_plugin_registry_scan_devices (bg_plugin_registry_t *plugin_reg, uint32_t type_mask, uint32_t flag_mask)
	Scan for pluggable devices.
void	bg_plugin_registry_destroy (bg_plugin_registry_t *reg)
	Destroy a plugin registry.
int	bg_plugin_registry_get_num_plugins (bg_plugin_registry_t *reg, uint32_t type_mask, uint32_t flag_mask)
	Count plugins.
const bg_plugin_info_t *	bg_plugin_find_by_index (bg_plugin_registry_t *reg, int index, uint32_t type_mask, uint32_t flag_mask)
	Find a plugin by index.
const bg_plugin_info_t *	bg_plugin_find_by_name (bg_plugin_registry_t *reg, const char *name)
	Find a plugin by it's unique short name.
const bg_plugin_info_t *	bg_plugin_find_by_filename (bg_plugin_registry_t *reg, const char *filename, int type_mask)
	Find a plugin by the file extension.
const bg_plugin_info_t *	bg_plugin_find_by_protocol (bg_plugin_registry_t *reg, const char *protocol)
	Find an input plugin for a network protocol.
char **	bg_plugin_registry_get_plugins (bg_plugin_registry_t *reg, uint32_t type_mask, uint32_t flag_mask)
	Get a list of plugins.
void	bg_plugin_registry_free_plugins (char **plugins)
	Free a plugin list.
int	bg_input_plugin_load (bg_plugin_registry_t *reg, const char *location, const bg_plugin_info_t *info, bg_plugin_handle_t **ret, bg_input_callbacks_t *callbacks, int prefer_edl)
	Load and open an input plugin.
int	bg_input_plugin_load_edl (bg_plugin_registry_t *reg, const bg_edl_t *edl, const bg_plugin_info_t *info, bg_plugin_handle_t **ret, bg_input_callbacks_t *callbacks)
	Load and open an edl decoder.
void	bg_plugin_registry_set_extensions (bg_plugin_registry_t *reg, const char *plugin_name, const char *extensions)
	Set file extensions for a plugin.
void	bg_plugin_registry_set_protocols (bg_plugin_registry_t *reg, const char *plugin_name, const char *protocols)
	Set protocols for a plugin.
void	bg_plugin_registry_set_priority (bg_plugin_registry_t *reg, const char *plugin_name, int priority)
	Set priority for a plugin.
bg_cfg_section_t *	bg_plugin_registry_get_section (bg_plugin_registry_t *reg, const char *plugin_name)
	Get the config section belonging to a plugin.
void	bg_plugin_registry_set_parameter_info (bg_plugin_registry_t *reg, uint32_t type_mask, uint32_t flag_mask, bg_parameter_info_t *ret)
	Set a parameter info for selecting and configuring plugins.
void	bg_plugin_registry_set_parameter_info_input (bg_plugin_registry_t *reg, uint32_t type_mask, uint32_t flag_mask, bg_parameter_info_t *ret)
	Set a parameter info for selecting and configuring input plugins.
void	bg_plugin_registry_set_parameter_input (void *data, const char *name, const bg_parameter_value_t *val)
	Set a parameter of an input plugin.
bg_parameter_info_t *	bg_plugin_registry_create_encoder_parameters (bg_plugin_registry_t *reg, uint32_t stream_type_mask, uint32_t flag_mask)
	Create a parameter array for encoders.
const char *	bg_encoder_section_get_plugin (bg_plugin_registry_t *plugin_reg, bg_cfg_section_t *s, bg_stream_type_t stream_type, int stream_mask)
	Get the name for an encoding plugin.
void	bg_encoder_section_get_plugin_config (bg_plugin_registry_t *plugin_reg, bg_cfg_section_t *s, bg_stream_type_t stream_type, int stream_mask, bg_cfg_section_t **section_ret, const bg_parameter_info_t **params_ret)
	Get the plugin configuration for an encoding plugin.
void	bg_encoder_section_get_stream_config (bg_plugin_registry_t *plugin_reg, bg_cfg_section_t *s, bg_stream_type_t stream_type, int stream_mask, bg_cfg_section_t **section_ret, const bg_parameter_info_t **params_ret)
	Get the stream configuration for an encoding plugin.
bg_cfg_section_t *	bg_encoder_section_get_from_registry (bg_plugin_registry_t *plugin_reg, const bg_parameter_info_t *parameters, uint32_t type_mask, uint32_t flag_mask)
	Get an encoder configuration section from a registry.
void	bg_encoder_section_store_in_registry (bg_plugin_registry_t *plugin_reg, bg_cfg_section_t *s, const bg_parameter_info_t *parameters, uint32_t type_mask, uint32_t flag_mask)
	Store an encoder configuration in a registry.
void	bg_plugin_registry_add_device (bg_plugin_registry_t *reg, const char *plugin_name, const char *device, const char *name)
	Add a device to a plugin.
void	bg_plugin_registry_set_device_name (bg_plugin_registry_t *reg, const char *plugin_name, const char *device, const char *name)
	Change the name of a device.
void	bg_plugin_registry_find_devices (bg_plugin_registry_t *reg, const char *plugin_name)
	Let a plugin rescan for devices.
void	bg_plugin_registry_remove_device (bg_plugin_registry_t *reg, const char *plugin_name, const char *device, const char *name)
	Remove a device.
gavl_video_frame_t *	bg_plugin_registry_load_image (bg_plugin_registry_t *reg, const char *filename, gavl_video_format_t *format, bg_metadata_t *m)
	Load an image.
void	bg_plugin_registry_save_image (bg_plugin_registry_t *reg, const char *filename, gavl_video_frame_t *frame, const gavl_video_format_t *format, const bg_metadata_t *m)
	Save an image.
bg_plugin_handle_t *	bg_plugin_load (bg_plugin_registry_t *reg, const bg_plugin_info_t *info)
	Load a plugin.
bg_plugin_handle_t *	bg_ov_plugin_load (bg_plugin_registry_t *reg, const bg_plugin_info_t *info, const char *window_id)
	Load a video output plugin.
void	bg_plugin_lock (bg_plugin_handle_t *h)
	Lock a plugin.
void	bg_plugin_unlock (bg_plugin_handle_t *h)
	Unlock a plugin.
void	bg_plugin_ref (bg_plugin_handle_t *h)
	Increase the reference count.
void	bg_plugin_unref (bg_plugin_handle_t *h)
	Decrease the reference count.
void	bg_plugin_unref_nolock (bg_plugin_handle_t *h)
	Decrease the reference count without locking.
bg_plugin_info_t *	bg_plugin_info_create (const bg_plugin_common_t *plugin, void *plugin_priv, const char *module_filename)
	Create a plugin info from a plugin.
bg_plugin_handle_t *	bg_plugin_handle_create ()
	Create an empty plugin handle.

---

Detailed Description

Database of all installed plugins.

The plugin registry keeps informations about all installed plugins. Furthermore, it manages default plugins and some other settings. Available plugins are cached in the file $HOME/.gmerlin/plugins.xml, which is used by all applications. Application specific data are stored in a bg_cfg_section_t.

It allows you to search for plugins according to certain criteria. You get detailed information about plugins in bg_plugin_info_t structs.

---

Typedef Documentation

typedef struct bg_plugin_info_s bg_plugin_info_t

Typedef for plugin info.

typedef struct bg_plugin_registry_s bg_plugin_registry_t

Opaque handle for a plugin registry.

You don't want to know, what's inside here.

typedef struct bg_plugin_handle_s bg_plugin_handle_t

Typedef for plugin handle.

---

Enumeration Type Documentation

enum bg_plugin_api_t

Identifiers for plugin APIs.

Enumerator:

BG_PLUGIN_API_GMERLIN	Always 0 so native plugins can leave this empty.
BG_PLUGIN_API_LADSPA	Ladspa API.
BG_PLUGIN_API_LV	Libvisual.
BG_PLUGIN_API_FREI0R	frei0r

enum bg_stream_type_t

Identifiers for stream types.

---

Function Documentation

bg_plugin_registry_t* bg_plugin_registry_create

(

bg_cfg_section_t *

section

)

Create a plugin registry.

Parameters:

section

A configuration section

The configuration section will be owned exclusively by the plugin registry, applications should not touch it.

bg_plugin_registry_t* bg_plugin_registry_create_with_options	(	bg_cfg_section_t *	section,
		const bg_plugin_registry_options_t *	opt
	)

Create a plugin registry with options.

Parameters:

section

A configuration section Parameters: opt  The options structure The configuration section will be owned exclusively by the plugin registry, applications should not touch it.

void bg_plugin_registry_scan_devices	(	bg_plugin_registry_t *	plugin_reg,
		uint32_t	type_mask,
		uint32_t	flag_mask
	)

Scan for pluggable devices.

Parameters:

plugin_reg

A plugin registry Parameters: type_mask  Mask of all types you want to have the devices scanned for Parameters: flag_mask  Mask of all flags you want to have the devices scanned for Some plugins offer a list of supported devices as parameters. To update these (e.g. if pluggable devices are among them), call this function right after you created the plugin registry

void bg_plugin_registry_destroy

(

bg_plugin_registry_t *

reg

)

Destroy a plugin registry.

Parameters:

reg

A plugin registry

int bg_plugin_registry_get_num_plugins	(	bg_plugin_registry_t *	reg,
		uint32_t	type_mask,
		uint32_t	flag_mask
	)

Count plugins.

Parameters:

reg

A plugin registry Parameters: type_mask  Mask of all types you want to have Parameters: flag_mask  Mask of all flags you want to have Returns: Number of available plugins matching type_mask and flag_mask

const bg_plugin_info_t* bg_plugin_find_by_index	(	bg_plugin_registry_t *	reg,
		int	index,
		uint32_t	type_mask,
		uint32_t	flag_mask
	)

Find a plugin by index.

Parameters:

reg

A plugin registry Parameters: index  Index Parameters: type_mask  Mask of all types you want to have Parameters: flag_mask  Mask of all flags you want to have Returns: A plugin info or NULL This function should be called after bg_plugin_registry_get_num_plugins to get a particular plugin

const bg_plugin_info_t* bg_plugin_find_by_name	(	bg_plugin_registry_t *	reg,
		const char *	name
	)

Find a plugin by it's unique short name.

Parameters:

reg

A plugin registry Parameters: name  The name Returns: A plugin info or NULL

const bg_plugin_info_t* bg_plugin_find_by_filename	(	bg_plugin_registry_t *	reg,
		const char *	filename,
		int	type_mask
	)

Find a plugin by the file extension.

Parameters:

reg

A plugin registry Parameters: filename  The file, whose extension should match Parameters: type_mask  Mask of plugin types to be returned Returns: A plugin info or NULL This function returns the first plugin matching type_mask, whose extensions match filename.

const bg_plugin_info_t* bg_plugin_find_by_protocol	(	bg_plugin_registry_t *	reg,
		const char *	protocol
	)

Find an input plugin for a network protocol.

Parameters:

reg

A plugin registry Parameters: protocol  The network protocol (e.g. http) Returns: A plugin info or NULL

char** bg_plugin_registry_get_plugins	(	bg_plugin_registry_t *	reg,
		uint32_t	type_mask,
		uint32_t	flag_mask
	)

Get a list of plugins.

Parameters:

reg

A plugin registry Parameters: type_mask  Mask of all returned plugin types Parameters: flag_mask  Mask of all returned plugin flags Returns: A NULL-terminated list of plugin names. This functions returns plugin names suitable for adding to GUI menus. Use bg_plugin_find_by_name to get the corresponding plugin infos. Use bg_plugin_registry_free_plugins to free the returned list.

void bg_plugin_registry_free_plugins

(

char **

plugins

)

Free a plugin list.

Parameters:

plugins

List returned by bg_plugin_registry_get_plugins

int bg_input_plugin_load	(	bg_plugin_registry_t *	reg,
		const char *	location,
		const bg_plugin_info_t *	info,
		bg_plugin_handle_t **	ret,
		bg_input_callbacks_t *	callbacks,
		int	prefer_edl
	)

Load and open an input plugin.

Parameters:

reg

A plugin registry Parameters: location  Filename or URL Parameters: info  Plugin to use (can be NULL for autodetection) Parameters: ret  Will return the plugin handle. Parameters: callbacks  Input callbacks (only for authentication) Parameters: prefer_edl  If 1 EDLs are preferred over raw streams Returns: 1 on success, 0 on error. This is a convenience function to load an input file. If info is NULL, the plugin will be autodetected. The handle is stored in ret. If ret is non-null before the call, the old plugin will be unrefed.

int bg_input_plugin_load_edl	(	bg_plugin_registry_t *	reg,
		const bg_edl_t *	edl,
		const bg_plugin_info_t *	info,
		bg_plugin_handle_t **	ret,
		bg_input_callbacks_t *	callbacks
	)

Load and open an edl decoder.

Parameters:

reg

A plugin registry Parameters: edl  The edl to open Parameters: info  Plugin to use (can be NULL for autodetection) Parameters: ret  Will return the plugin handle. Parameters: callbacks  Input callbacks (only for authentication) Returns: 1 on success, 0 on error. This is a convenience function to load an input file. If info is NULL, the plugin will be autodetected. The handle is stored in ret. If ret is non-null before the call, the old plugin will be unrefed.

void bg_plugin_registry_set_extensions	(	bg_plugin_registry_t *	reg,
		const char *	plugin_name,
		const char *	extensions
	)

Set file extensions for a plugin.

Parameters:

reg

A plugin registry Parameters: plugin_name  Name of the plugin Parameters: extensions  Space separated list of file extensions The extensions will be saved in the plugin file

void bg_plugin_registry_set_protocols	(	bg_plugin_registry_t *	reg,
		const char *	plugin_name,
		const char *	protocols
	)

Set protocols for a plugin.

Parameters:

reg

A plugin registry Parameters: plugin_name  Name of the plugin Parameters: protocols  Space separated list of protocols The protocols will be saved in the plugin file

void bg_plugin_registry_set_priority	(	bg_plugin_registry_t *	reg,
		const char *	plugin_name,
		int	priority
	)

Set priority for a plugin.

Parameters:

reg

A plugin registry Parameters: plugin_name  Name of the plugin Parameters: priority  Priority (BG_PLUGIN_PRIORITY_MIN..BG_PLUGIN_PRIORITY_MAX, should be 1..10) The priority will be saved in the plugin file

bg_cfg_section_t* bg_plugin_registry_get_section	(	bg_plugin_registry_t *	reg,
		const char *	plugin_name
	)

Get the config section belonging to a plugin.

Parameters:

reg

A plugin registry Parameters: plugin_name  Short name of the plugin Returns: The config section belonging to the plugin or NULL

void bg_plugin_registry_set_parameter_info	(	bg_plugin_registry_t *	reg,
		uint32_t	type_mask,
		uint32_t	flag_mask,
		bg_parameter_info_t *	ret
	)

Set a parameter info for selecting and configuring plugins.

Parameters:

reg

A plugin registry Parameters: type_mask  Mask of all returned types Parameters: flag_mask  Mask of all returned flags Parameters: ret  Where the parameter info will be copied

void bg_plugin_registry_set_parameter_info_input	(	bg_plugin_registry_t *	reg,
		uint32_t	type_mask,
		uint32_t	flag_mask,
		bg_parameter_info_t *	ret
	)

Set a parameter info for selecting and configuring input plugins.

Parameters:

reg

A plugin registry Parameters: type_mask  Mask of all returned types Parameters: flag_mask  Mask of all returned flags Parameters: ret  Where the parameter info will be copied

void bg_plugin_registry_set_parameter_input	(	void *	data,
		const char *	name,
		const bg_parameter_value_t *	val
	)

Set a parameter of an input plugin.

Parameters:

data

A plugin registry cast to void Parameters: name  Name Parameters: val  Value

bg_parameter_info_t* bg_plugin_registry_create_encoder_parameters	(	bg_plugin_registry_t *	reg,
		uint32_t	stream_type_mask,
		uint32_t	flag_mask
	)

Create a parameter array for encoders.

Parameters:

reg

A plugin registry Parameters: type_mask  Mask of all stream types to be encoded Parameters: flag_mask  Mask of all returned plugin flags Returns: Parameter array for setting up encoders Free the returned parameters with bg_parameter_info_destroy_array If you create a config section from the returned parameters (with bg_cfg_section_create_from_parameters or bg_cfg_section_create_items) the resulting encoding section will contain the complete encoder setup. It can be manipulated through the bg_encoder_section_*() functions.

const char* bg_encoder_section_get_plugin	(	bg_plugin_registry_t *	plugin_reg,
		bg_cfg_section_t *	s,
		bg_stream_type_t	stream_type,
		int	stream_mask
	)

Get the name for an encoding plugin.

Parameters:

plugin_ref

A plugin registry Parameters: s  An encoder section (see bg_plugin_registry_create_encoder_parameters) Parameters: stream_type  The stream type to encode Parameters: stream_mask  The mask passed to bg_plugin_registry_create_encoder_parameters Returns: Returns the plugin name or NULL if the stream will be encoded by the video encoder

void bg_encoder_section_get_plugin_config	(	bg_plugin_registry_t *	plugin_reg,
		bg_cfg_section_t *	s,
		bg_stream_type_t	stream_type,
		int	stream_mask,
		bg_cfg_section_t **	section_ret,
		const bg_parameter_info_t **	params_ret
	)

Get the plugin configuration for an encoding plugin.

Parameters:

plugin_ref

A plugin registry Parameters: s  An encoder section (see bg_plugin_registry_create_encoder_parameters) Parameters: stream_type  The stream type to encode Parameters: stream_mask  The mask passed to bg_plugin_registry_create_encoder_parameters Parameters: section_ret  If non-null returns the config section for the plugin Parameters: params_ret  If non-null returns the parameters for the plugin

void bg_encoder_section_get_stream_config	(	bg_plugin_registry_t *	plugin_reg,
		bg_cfg_section_t *	s,
		bg_stream_type_t	stream_type,
		int	stream_mask,
		bg_cfg_section_t **	section_ret,
		const bg_parameter_info_t **	params_ret
	)

Get the stream configuration for an encoding plugin.

Parameters:

plugin_ref

A plugin registry Parameters: s  An encoder section (see bg_plugin_registry_create_encoder_parameters) Parameters: stream_type  The stream type to encode Parameters: stream_mask  The mask passed to bg_plugin_registry_create_encoder_parameters Parameters: section_ret  If non-null returns the config section for the stream Parameters: params_ret  If non-null returns the parameters for the stream

bg_cfg_section_t* bg_encoder_section_get_from_registry	(	bg_plugin_registry_t *	plugin_reg,
		const bg_parameter_info_t *	parameters,
		uint32_t	type_mask,
		uint32_t	flag_mask
	)

Get an encoder configuration section from a registry.

Parameters:

plugin_ref

A plugin registry Parameters: type_mask  The stream mask passed to bg_plugin_registry_create_encoder_parameters Parameters: flag_mask  The mask passed to bg_plugin_registry_create_encoder_parameters Returns: The encoder section with the values from the registry

void bg_encoder_section_store_in_registry	(	bg_plugin_registry_t *	plugin_reg,
		bg_cfg_section_t *	s,
		const bg_parameter_info_t *	parameters,
		uint32_t	type_mask,
		uint32_t	flag_mask
	)

Store an encoder configuration in a registry.

Parameters:

plugin_ref

A plugin registry Parameters: s  The encoder section to store Parameters: type_mask  The stream mask passed to bg_plugin_registry_create_encoder_parameters Parameters: flag_mask  The mask passed to bg_plugin_registry_create_encoder_parameters Returns: The encoder section with the values from the registry

void bg_plugin_registry_add_device	(	bg_plugin_registry_t *	reg,
		const char *	plugin_name,
		const char *	device,
		const char *	name
	)

Add a device to a plugin.

Parameters:

reg

A plugin registry Parameters: plugin_name  Name of the plugin Parameters: device  Device file Parameters: name  Name for the device

void bg_plugin_registry_set_device_name	(	bg_plugin_registry_t *	reg,
		const char *	plugin_name,
		const char *	device,
		const char *	name
	)

Change the name of a device.

Parameters:

reg

A plugin registry Parameters: plugin_name  Name of the plugin Parameters: device  Device file name Parameters: name  New name for the device Usually, plugins are quite smart in getting the name (Vendor, Model etc) of devices from the OS. In the case, you want to change names of a device use this function

void bg_plugin_registry_find_devices	(	bg_plugin_registry_t *	reg,
		const char *	plugin_name
	)

Let a plugin rescan for devices.

Parameters:

reg

A plugin registry Parameters: plugin_name  Name of the plugin This will let the plugin rescan for devices. Call this, after you changed your hardware.

void bg_plugin_registry_remove_device	(	bg_plugin_registry_t *	reg,
		const char *	plugin_name,
		const char *	device,
		const char *	name
	)

Remove a device.

Parameters:

reg

A plugin registry Parameters: plugin_name  Name of the plugin Parameters: device  Device file name Parameters: name  New name for the device Remove a device from the list of devices. Call this if a plugin detected a device multiple times.

gavl_video_frame_t* bg_plugin_registry_load_image	(	bg_plugin_registry_t *	reg,
		const char *	filename,
		gavl_video_format_t *	format,
		bg_metadata_t *	m
	)

Load an image.

Parameters:

reg

A plugin registry Parameters: filename  Image filename Parameters: format  Returns format of the image Returns: The frame, which contains the image Use gavl_video_frame_destroy to free the return value

void bg_plugin_registry_save_image	(	bg_plugin_registry_t *	reg,
		const char *	filename,
		gavl_video_frame_t *	frame,
		const gavl_video_format_t *	format,
		const bg_metadata_t *	m
	)

Save an image.

Parameters:

reg

A plugin registry Parameters: filename  Image filename Parameters: frame  The frame, which contains the image Parameters: format  Returns format of the image

bg_plugin_handle_t* bg_plugin_load	(	bg_plugin_registry_t *	reg,
		const bg_plugin_info_t *	info
	)

Load a plugin.

Parameters:

reg

A plugin registry Parameters: info  The plugin info Load a plugin and return handle with reference count of 1

bg_plugin_handle_t* bg_ov_plugin_load	(	bg_plugin_registry_t *	reg,
		const bg_plugin_info_t *	info,
		const char *	window_id
	)

Load a video output plugin.

Parameters:

reg

A plugin registry Parameters: info  The plugin info Parameters: window_id  The window ID or NULL Load a video output plugin for embedding into an already existing window and return handle with reference count of 1

void bg_plugin_lock

(

bg_plugin_handle_t *

h

)

Lock a plugin.

Parameters:

h

A plugin handle

void bg_plugin_unlock

(

bg_plugin_handle_t *

h

)

Unlock a plugin.

Parameters:

h

A plugin handle

void bg_plugin_ref

(

bg_plugin_handle_t *

h

)

Increase the reference count.

Parameters:

h

A plugin handle

void bg_plugin_unref

(

bg_plugin_handle_t *

h

)

Decrease the reference count.

Parameters:

h

A plugin handle

If the reference count gets zero, the plugin will be destroyed

void bg_plugin_unref_nolock

(

bg_plugin_handle_t *

h

)

Decrease the reference count without locking.

Parameters:

h

A plugin handle

Use this *only* if you know for sure, that the plugin is already locked and no other thread waits for the plugin to be unlocked. If the reference count gets zero, the plugin will be destroyed

bg_plugin_info_t* bg_plugin_info_create	(	const bg_plugin_common_t *	plugin,
		void *	plugin_priv,
		const char *	module_filename
	)

Create a plugin info from a plugin.

Parameters:

plugin

A plugin Parameters: plugin_priv  Handle returned by the create() method Parameters: module_filename  Module filename or NULL Returns: A newly allocated plugin info Use this function only if you create a plugin handle outside a plugin registry. Free the returned info with bg_plugin_info_destroy

bg_plugin_handle_t* bg_plugin_handle_create

(

)

Create an empty plugin handle.

Returns:

A newly allocated plugin handle

Use this function only if you create a plugin handle outside a plugin registry. Free the returned info with bg_plugin_unref