2000-12-28 22:12:02 +00:00
|
|
|
/* GStreamer
|
|
|
|
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
|
|
|
|
* 2000 Wim Taymans <wtay@chello.be>
|
|
|
|
*
|
|
|
|
* gstplugin.h: Header for plugin subsystem
|
2000-01-30 09:03:00 +00:00
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Library 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
|
|
|
|
* Library General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Library General Public
|
|
|
|
* License along with this library; if not, write to the
|
|
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
|
* Boston, MA 02111-1307, USA.
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
#ifndef __GST_PLUGIN_H__
|
|
|
|
#define __GST_PLUGIN_H__
|
|
|
|
|
2001-10-17 10:21:27 +00:00
|
|
|
#include <gst/gstconfig.h>
|
2000-01-30 09:03:00 +00:00
|
|
|
|
2005-09-16 11:24:10 +00:00
|
|
|
#include <time.h> /* time_t */
|
2005-11-30 19:01:53 +00:00
|
|
|
#include <sys/types.h> /* off_t */
|
2005-10-15 00:22:02 +00:00
|
|
|
#include <sys/stat.h> /* off_t */
|
2001-10-17 10:21:27 +00:00
|
|
|
#include <gmodule.h>
|
2005-09-15 20:56:30 +00:00
|
|
|
#include <gst/gstobject.h>
|
2005-09-20 09:08:25 +00:00
|
|
|
#include <gst/gstmacros.h>
|
2009-06-07 20:46:54 +00:00
|
|
|
#include <gst/gststructure.h>
|
2000-12-28 22:12:02 +00:00
|
|
|
|
2004-03-15 14:43:35 +00:00
|
|
|
G_BEGIN_DECLS
|
2002-07-08 19:07:30 +00:00
|
|
|
|
2005-09-15 00:13:26 +00:00
|
|
|
typedef struct _GstPlugin GstPlugin;
|
|
|
|
typedef struct _GstPluginClass GstPluginClass;
|
Add API for making a GStreamer plugin 'dependent' on external files, directories or environment variables, so that GS...
Original commit message from CVS:
* docs/gst/gstreamer-sections.txt::
* gst/gst_private.h: (GstPluginDep), (_GstPluginPrivate):
* gst/gstplugin.c: (gst_plugin_init), (gst_plugin_finalize),
(gst_plugin_class_init), (gst_plugin_list_free),
(gst_plugin_ext_dep_get_env_vars_hash),
(_priv_plugin_deps_env_vars_changed),
(gst_plugin_ext_dep_extract_env_vars_paths),
(gst_plugin_ext_dep_get_hash_from_stat_entry),
(gst_plugin_ext_dep_direntry_matches),
(gst_plugin_ext_dep_scan_dir_and_match_names),
(gst_plugin_ext_dep_scan_path_with_filenames),
(gst_plugin_ext_dep_get_stat_hash),
(_priv_plugin_deps_files_changed), (gst_plugin_ext_dep_free),
(gst_plugin_ext_dep_strv_equal), (gst_plugin_ext_dep_equals),
(gst_plugin_add_dependency), (gst_plugin_add_dependency_simple):
* gst/gstplugin.h: (GstPluginPrivate), (GstPluginFlags),
(GST_PLUGIN_DEPENDENCY_FLAG_NONE),
(GST_PLUGIN_DEPENDENCY_FLAG_RECURSE),
(GST_PLUGIN_DEPENDENCY_FLAG_PATHS_ARE_DEFAULT_ONLY),
(GST_PLUGIN_DEPENDENCY_FLAG_FILE_NAME_IS_SUFFIX),
(GstPluginDependencyFlags), (GstPluginFilter):
* gst/gstregistry.c: (gst_registry_scan_path_level):
* gst/gstregistrybinary.c: (gst_registry_binary_save_feature),
(gst_registry_binary_save_plugin_dep),
(gst_registry_binary_save_plugin),
(gst_registry_binary_load_feature),
(gst_registry_binary_load_plugin_dep_strv),
(gst_registry_binary_load_plugin_dep),
(gst_registry_binary_load_plugin):
* gst/gstregistrybinary.h: (GST_MAGIC_BINARY_VERSION_STR),
(GstBinaryPluginElement), (_GstBinaryDep), (GstBinaryDep):
* gst/gstregistryxml.c: (gst_registry_xml_save_plugin):
Add API for making a GStreamer plugin 'dependent' on external files,
directories or environment variables, so that GStreamer knows when
it needs to re-load GStreamer plugins that wrap other plugin systems.
Fixes bug #350477.
API: add gst_plugin_add_dependency()
API: add gst_plugin_add_dependency_simple()
2009-01-06 17:58:59 +00:00
|
|
|
typedef struct _GstPluginPrivate GstPluginPrivate;
|
2005-09-15 00:13:26 +00:00
|
|
|
typedef struct _GstPluginDesc GstPluginDesc;
|
|
|
|
|
2005-09-25 12:11:39 +00:00
|
|
|
/**
|
|
|
|
* gst_plugin_error_quark:
|
|
|
|
*
|
|
|
|
* Get the error quark.
|
|
|
|
*
|
|
|
|
* Returns: The error quark used in GError messages
|
|
|
|
*/
|
2004-03-15 14:43:35 +00:00
|
|
|
GQuark gst_plugin_error_quark (void);
|
2005-09-25 12:11:39 +00:00
|
|
|
/**
|
|
|
|
* GST_PLUGIN_ERROR:
|
|
|
|
*
|
|
|
|
* The error message category quark
|
|
|
|
*/
|
2002-05-20 23:11:10 +00:00
|
|
|
#define GST_PLUGIN_ERROR gst_plugin_error_quark ()
|
|
|
|
|
2005-09-25 12:11:39 +00:00
|
|
|
/**
|
|
|
|
* GstPluginError:
|
|
|
|
* @GST_PLUGIN_ERROR_MODULE: The plugin could not be loaded
|
|
|
|
* @GST_PLUGIN_ERROR_DEPENDENCIES: The plugin has unresolved dependencies
|
|
|
|
* @GST_PLUGIN_ERROR_NAME_MISMATCH: The plugin has already be loaded from a different file
|
|
|
|
*
|
|
|
|
* The plugin loading errors
|
|
|
|
*/
|
2002-05-20 23:11:10 +00:00
|
|
|
typedef enum
|
|
|
|
{
|
|
|
|
GST_PLUGIN_ERROR_MODULE,
|
2003-10-31 19:32:47 +00:00
|
|
|
GST_PLUGIN_ERROR_DEPENDENCIES,
|
|
|
|
GST_PLUGIN_ERROR_NAME_MISMATCH
|
2004-03-15 14:43:35 +00:00
|
|
|
} GstPluginError;
|
2002-05-20 23:11:10 +00:00
|
|
|
|
2009-11-25 15:27:30 +00:00
|
|
|
/**
|
|
|
|
* GstPluginFlags:
|
|
|
|
* @GST_PLUGIN_FLAG_CACHED: Temporarily loaded plugins
|
|
|
|
* @GST_PLUGIN_FLAG_BLACKLISTED: The plugin won't be scanned (again)
|
|
|
|
*
|
|
|
|
* The plugin loading state
|
|
|
|
*/
|
2005-09-15 00:13:26 +00:00
|
|
|
typedef enum
|
|
|
|
{
|
2009-01-23 21:15:43 +00:00
|
|
|
GST_PLUGIN_FLAG_CACHED = (1<<0),
|
|
|
|
GST_PLUGIN_FLAG_BLACKLISTED = (1<<1)
|
2005-09-15 00:13:26 +00:00
|
|
|
} GstPluginFlags;
|
2000-01-30 09:03:00 +00:00
|
|
|
|
Add API for making a GStreamer plugin 'dependent' on external files, directories or environment variables, so that GS...
Original commit message from CVS:
* docs/gst/gstreamer-sections.txt::
* gst/gst_private.h: (GstPluginDep), (_GstPluginPrivate):
* gst/gstplugin.c: (gst_plugin_init), (gst_plugin_finalize),
(gst_plugin_class_init), (gst_plugin_list_free),
(gst_plugin_ext_dep_get_env_vars_hash),
(_priv_plugin_deps_env_vars_changed),
(gst_plugin_ext_dep_extract_env_vars_paths),
(gst_plugin_ext_dep_get_hash_from_stat_entry),
(gst_plugin_ext_dep_direntry_matches),
(gst_plugin_ext_dep_scan_dir_and_match_names),
(gst_plugin_ext_dep_scan_path_with_filenames),
(gst_plugin_ext_dep_get_stat_hash),
(_priv_plugin_deps_files_changed), (gst_plugin_ext_dep_free),
(gst_plugin_ext_dep_strv_equal), (gst_plugin_ext_dep_equals),
(gst_plugin_add_dependency), (gst_plugin_add_dependency_simple):
* gst/gstplugin.h: (GstPluginPrivate), (GstPluginFlags),
(GST_PLUGIN_DEPENDENCY_FLAG_NONE),
(GST_PLUGIN_DEPENDENCY_FLAG_RECURSE),
(GST_PLUGIN_DEPENDENCY_FLAG_PATHS_ARE_DEFAULT_ONLY),
(GST_PLUGIN_DEPENDENCY_FLAG_FILE_NAME_IS_SUFFIX),
(GstPluginDependencyFlags), (GstPluginFilter):
* gst/gstregistry.c: (gst_registry_scan_path_level):
* gst/gstregistrybinary.c: (gst_registry_binary_save_feature),
(gst_registry_binary_save_plugin_dep),
(gst_registry_binary_save_plugin),
(gst_registry_binary_load_feature),
(gst_registry_binary_load_plugin_dep_strv),
(gst_registry_binary_load_plugin_dep),
(gst_registry_binary_load_plugin):
* gst/gstregistrybinary.h: (GST_MAGIC_BINARY_VERSION_STR),
(GstBinaryPluginElement), (_GstBinaryDep), (GstBinaryDep):
* gst/gstregistryxml.c: (gst_registry_xml_save_plugin):
Add API for making a GStreamer plugin 'dependent' on external files,
directories or environment variables, so that GStreamer knows when
it needs to re-load GStreamer plugins that wrap other plugin systems.
Fixes bug #350477.
API: add gst_plugin_add_dependency()
API: add gst_plugin_add_dependency_simple()
2009-01-06 17:58:59 +00:00
|
|
|
/**
|
|
|
|
* GstPluginDependencyFlags:
|
|
|
|
* @GST_PLUGIN_DEPENDENCY_FLAG_NONE : no special flags
|
|
|
|
* @GST_PLUGIN_DEPENDENCY_FLAG_RECURSE : recurse into subdirectories
|
|
|
|
* @GST_PLUGIN_DEPENDENCY_FLAG_PATHS_ARE_DEFAULT_ONLY : use paths
|
|
|
|
* argument only if none of the environment variables is set
|
|
|
|
* @GST_PLUGIN_DEPENDENCY_FLAG_FILE_NAME_IS_SUFFIX : interpret
|
|
|
|
* filename argument as filter suffix and check all matching files in
|
|
|
|
* the directory
|
|
|
|
*
|
|
|
|
* Flags used in connection with gst_plugin_add_dependency().
|
|
|
|
*
|
|
|
|
* Since: 0.10.22
|
|
|
|
*/
|
|
|
|
typedef enum {
|
|
|
|
GST_PLUGIN_DEPENDENCY_FLAG_NONE = 0,
|
|
|
|
GST_PLUGIN_DEPENDENCY_FLAG_RECURSE = (1 << 0),
|
|
|
|
GST_PLUGIN_DEPENDENCY_FLAG_PATHS_ARE_DEFAULT_ONLY = (1 << 1),
|
|
|
|
GST_PLUGIN_DEPENDENCY_FLAG_FILE_NAME_IS_SUFFIX = (1 << 2)
|
|
|
|
} GstPluginDependencyFlags;
|
|
|
|
|
2005-09-25 12:11:39 +00:00
|
|
|
/**
|
|
|
|
* GstPluginInitFunc:
|
2009-11-25 14:44:05 +00:00
|
|
|
* @plugin: The plugin object
|
2005-09-25 12:11:39 +00:00
|
|
|
*
|
|
|
|
* A plugin should provide a pointer to a function of this type in the
|
|
|
|
* plugin_desc struct.
|
2009-11-25 14:44:05 +00:00
|
|
|
* This function will be called by the loader at startup. One would then
|
|
|
|
* register each #GstPluginFeature.
|
2005-09-25 12:11:39 +00:00
|
|
|
*
|
2005-10-15 15:30:24 +00:00
|
|
|
* Returns: %TRUE if plugin initialised successfully
|
2005-09-25 12:11:39 +00:00
|
|
|
*/
|
2004-03-15 14:43:35 +00:00
|
|
|
typedef gboolean (*GstPluginInitFunc) (GstPlugin *plugin);
|
2003-10-07 21:58:42 +00:00
|
|
|
|
2009-05-07 14:37:37 +00:00
|
|
|
/**
|
|
|
|
* GstPluginInitFullFunc:
|
2009-11-25 14:44:05 +00:00
|
|
|
* @plugin: The plugin object
|
2009-11-27 12:17:35 +00:00
|
|
|
* @user_data: extra data
|
2009-05-07 14:37:37 +00:00
|
|
|
*
|
|
|
|
* A plugin should provide a pointer to a function of either #GstPluginInitFunc
|
|
|
|
* or this type in the plugin_desc struct.
|
2009-11-25 14:44:05 +00:00
|
|
|
* The function will be called by the loader at startup. One would then
|
|
|
|
* register each #GstPluginFeature. This version allows
|
2009-05-07 14:37:37 +00:00
|
|
|
* user data to be passed to init function (useful for bindings).
|
|
|
|
*
|
|
|
|
* Returns: %TRUE if plugin initialised successfully
|
|
|
|
*
|
|
|
|
* Since: 0.10.24
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
typedef gboolean (*GstPluginInitFullFunc) (GstPlugin *plugin, gpointer user_data);
|
|
|
|
|
2005-09-25 12:11:39 +00:00
|
|
|
/**
|
|
|
|
* GstPluginDesc:
|
|
|
|
* @major_version: the major version number of core that plugin was compiled for
|
|
|
|
* @minor_version: the minor version number of core that plugin was compiled for
|
|
|
|
* @name: a unique name of the plugin
|
|
|
|
* @description: description of plugin
|
|
|
|
* @plugin_init: pointer to the init function of this plugin.
|
|
|
|
* @version: version of the plugin
|
|
|
|
* @license: effective license of plugin
|
|
|
|
* @source: source module plugin belongs to
|
|
|
|
* @package: shipped package plugin belongs to
|
|
|
|
* @origin: URL to provider of plugin
|
|
|
|
* @_gst_reserved: private, for later expansion
|
2005-10-15 15:30:24 +00:00
|
|
|
*
|
2007-01-30 15:04:33 +00:00
|
|
|
* A plugin should export a variable of this type called plugin_desc. The plugin
|
|
|
|
* loader will use the data provided there to initialize the plugin.
|
2005-09-25 12:11:39 +00:00
|
|
|
*
|
2007-01-30 15:04:33 +00:00
|
|
|
* The @licence parameter must be one of: LGPL, GPL, QPL, GPL/QPL, MPL,
|
2007-09-24 17:41:25 +00:00
|
|
|
* BSD, MIT/X11, Proprietary, unknown.
|
2005-09-25 12:11:39 +00:00
|
|
|
*/
|
2004-03-15 14:43:35 +00:00
|
|
|
struct _GstPluginDesc {
|
2005-09-25 12:11:39 +00:00
|
|
|
gint major_version;
|
|
|
|
gint minor_version;
|
2007-10-09 14:18:39 +00:00
|
|
|
const gchar *name;
|
2010-03-03 10:45:38 +00:00
|
|
|
const gchar *description;
|
2005-09-25 12:11:39 +00:00
|
|
|
GstPluginInitFunc plugin_init;
|
2007-10-09 14:18:39 +00:00
|
|
|
const gchar *version;
|
|
|
|
const gchar *license;
|
|
|
|
const gchar *source;
|
|
|
|
const gchar *package;
|
|
|
|
const gchar *origin;
|
2004-12-07 18:50:39 +00:00
|
|
|
|
2003-12-09 02:39:31 +00:00
|
|
|
gpointer _gst_reserved[GST_PADDING];
|
2000-01-30 09:03:00 +00:00
|
|
|
};
|
|
|
|
|
2005-09-15 00:13:26 +00:00
|
|
|
|
|
|
|
#define GST_TYPE_PLUGIN (gst_plugin_get_type())
|
|
|
|
#define GST_IS_PLUGIN(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_PLUGIN))
|
|
|
|
#define GST_IS_PLUGIN_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_PLUGIN))
|
|
|
|
#define GST_PLUGIN_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_PLUGIN, GstPluginClass))
|
|
|
|
#define GST_PLUGIN(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_PLUGIN, GstPlugin))
|
|
|
|
#define GST_PLUGIN_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_PLUGIN, GstPluginClass))
|
2006-06-12 09:11:44 +00:00
|
|
|
#define GST_PLUGIN_CAST(obj) ((GstPlugin*)(obj))
|
2005-09-15 00:13:26 +00:00
|
|
|
|
2005-09-25 12:11:39 +00:00
|
|
|
/**
|
|
|
|
* GstPlugin:
|
|
|
|
*
|
|
|
|
* The plugin object
|
|
|
|
*/
|
2004-03-15 14:43:35 +00:00
|
|
|
struct _GstPlugin {
|
2005-09-15 20:56:30 +00:00
|
|
|
GstObject object;
|
2005-09-15 00:13:26 +00:00
|
|
|
|
2005-09-20 06:28:33 +00:00
|
|
|
/*< private >*/
|
2004-03-15 14:43:35 +00:00
|
|
|
GstPluginDesc desc;
|
2000-01-30 09:03:00 +00:00
|
|
|
|
2005-09-15 00:13:26 +00:00
|
|
|
GstPluginDesc *orig_desc;
|
|
|
|
|
|
|
|
unsigned int flags;
|
|
|
|
|
2004-03-15 14:43:35 +00:00
|
|
|
gchar * filename;
|
2005-10-08 13:57:17 +00:00
|
|
|
gchar * basename; /* base name (non-dir part) of plugin path */
|
2003-10-31 19:32:47 +00:00
|
|
|
|
2004-12-07 18:50:39 +00:00
|
|
|
GModule * module; /* contains the module if plugin is loaded */
|
2003-10-31 19:32:47 +00:00
|
|
|
|
2005-10-15 00:22:02 +00:00
|
|
|
off_t file_size;
|
2005-09-15 00:13:26 +00:00
|
|
|
time_t file_mtime;
|
2005-10-08 13:57:17 +00:00
|
|
|
gboolean registered; /* TRUE when the registry has seen a filename
|
|
|
|
* that matches the plugin's basename */
|
2005-09-15 00:13:26 +00:00
|
|
|
|
Add API for making a GStreamer plugin 'dependent' on external files, directories or environment variables, so that GS...
Original commit message from CVS:
* docs/gst/gstreamer-sections.txt::
* gst/gst_private.h: (GstPluginDep), (_GstPluginPrivate):
* gst/gstplugin.c: (gst_plugin_init), (gst_plugin_finalize),
(gst_plugin_class_init), (gst_plugin_list_free),
(gst_plugin_ext_dep_get_env_vars_hash),
(_priv_plugin_deps_env_vars_changed),
(gst_plugin_ext_dep_extract_env_vars_paths),
(gst_plugin_ext_dep_get_hash_from_stat_entry),
(gst_plugin_ext_dep_direntry_matches),
(gst_plugin_ext_dep_scan_dir_and_match_names),
(gst_plugin_ext_dep_scan_path_with_filenames),
(gst_plugin_ext_dep_get_stat_hash),
(_priv_plugin_deps_files_changed), (gst_plugin_ext_dep_free),
(gst_plugin_ext_dep_strv_equal), (gst_plugin_ext_dep_equals),
(gst_plugin_add_dependency), (gst_plugin_add_dependency_simple):
* gst/gstplugin.h: (GstPluginPrivate), (GstPluginFlags),
(GST_PLUGIN_DEPENDENCY_FLAG_NONE),
(GST_PLUGIN_DEPENDENCY_FLAG_RECURSE),
(GST_PLUGIN_DEPENDENCY_FLAG_PATHS_ARE_DEFAULT_ONLY),
(GST_PLUGIN_DEPENDENCY_FLAG_FILE_NAME_IS_SUFFIX),
(GstPluginDependencyFlags), (GstPluginFilter):
* gst/gstregistry.c: (gst_registry_scan_path_level):
* gst/gstregistrybinary.c: (gst_registry_binary_save_feature),
(gst_registry_binary_save_plugin_dep),
(gst_registry_binary_save_plugin),
(gst_registry_binary_load_feature),
(gst_registry_binary_load_plugin_dep_strv),
(gst_registry_binary_load_plugin_dep),
(gst_registry_binary_load_plugin):
* gst/gstregistrybinary.h: (GST_MAGIC_BINARY_VERSION_STR),
(GstBinaryPluginElement), (_GstBinaryDep), (GstBinaryDep):
* gst/gstregistryxml.c: (gst_registry_xml_save_plugin):
Add API for making a GStreamer plugin 'dependent' on external files,
directories or environment variables, so that GStreamer knows when
it needs to re-load GStreamer plugins that wrap other plugin systems.
Fixes bug #350477.
API: add gst_plugin_add_dependency()
API: add gst_plugin_add_dependency_simple()
2009-01-06 17:58:59 +00:00
|
|
|
GstPluginPrivate *priv;
|
|
|
|
gpointer _gst_reserved[GST_PADDING - 1];
|
2001-04-22 12:30:14 +00:00
|
|
|
};
|
2000-01-30 09:03:00 +00:00
|
|
|
|
2005-09-15 00:13:26 +00:00
|
|
|
struct _GstPluginClass {
|
2005-09-15 20:56:30 +00:00
|
|
|
GstObjectClass object_class;
|
2005-09-15 00:13:26 +00:00
|
|
|
|
2005-09-20 06:28:33 +00:00
|
|
|
/*< private >*/
|
2005-11-29 18:57:59 +00:00
|
|
|
gpointer _gst_reserved[GST_PADDING];
|
2005-09-15 00:13:26 +00:00
|
|
|
};
|
|
|
|
|
2005-09-25 12:11:39 +00:00
|
|
|
/**
|
|
|
|
* GST_PLUGIN_DEFINE:
|
|
|
|
* @major: major version number of the gstreamer-core that plugin was compiled for
|
|
|
|
* @minor: minor version number of the gstreamer-core that plugin was compiled for
|
|
|
|
* @name: short, but unique name of the plugin
|
|
|
|
* @description: information about the purpose of the plugin
|
|
|
|
* @init: function pointer to the plugin_init method with the signature of <code>static gboolean plugin_init (GstPlugin * plugin)</code>.
|
|
|
|
* @version: full version string (e.g. VERSION from config.h)
|
|
|
|
* @license: under which licence the package has been released, e.g. GPL, LGPL.
|
|
|
|
* @package: the package-name (e.g. PACKAGE_NAME from config.h)
|
|
|
|
* @origin: a description from where the package comes from (e.g. the homepage URL)
|
|
|
|
*
|
|
|
|
* This macro needs to be used to define the entry point and meta data of a
|
|
|
|
* plugin. One would use this macro to export a plugin, so that it can be used
|
2009-01-25 20:11:32 +00:00
|
|
|
* by other applications.
|
|
|
|
*
|
|
|
|
* The macro uses a define named PACKAGE for the #GstPluginDesc,source field.
|
2005-09-25 12:11:39 +00:00
|
|
|
*/
|
2003-12-22 01:39:35 +00:00
|
|
|
#define GST_PLUGIN_DEFINE(major,minor,name,description,init,version,license,package,origin) \
|
2009-11-09 18:52:42 +00:00
|
|
|
G_BEGIN_DECLS \
|
2004-12-07 18:50:39 +00:00
|
|
|
GST_PLUGIN_EXPORT GstPluginDesc gst_plugin_desc = { \
|
2001-08-21 20:16:48 +00:00
|
|
|
major, \
|
|
|
|
minor, \
|
|
|
|
name, \
|
2007-10-10 10:53:39 +00:00
|
|
|
(gchar *) description, \
|
2003-10-31 19:32:47 +00:00
|
|
|
init, \
|
|
|
|
version, \
|
2004-12-07 18:50:39 +00:00
|
|
|
license, \
|
2005-09-03 17:00:52 +00:00
|
|
|
PACKAGE, \
|
2003-10-31 19:32:47 +00:00
|
|
|
package, \
|
|
|
|
origin, \
|
2003-12-22 01:39:35 +00:00
|
|
|
GST_PADDING_INIT \
|
2009-11-09 18:52:42 +00:00
|
|
|
}; \
|
|
|
|
G_END_DECLS
|
2003-12-22 01:39:35 +00:00
|
|
|
|
2005-09-25 12:11:39 +00:00
|
|
|
/**
|
|
|
|
* GST_PLUGIN_DEFINE_STATIC:
|
|
|
|
* @major: major version number of the gstreamer-core that plugin was compiled for
|
|
|
|
* @minor: minor version number of the gstreamer-core that plugin was compiled for
|
|
|
|
* @name: short, but unique name of the plugin
|
|
|
|
* @description: information about the purpose of the plugin
|
|
|
|
* @init: function pointer to the plugin_init method with the signature of <code>static gboolean plugin_init (GstPlugin * plugin)</code>.
|
|
|
|
* @version: full version string (e.g. VERSION from config.h)
|
|
|
|
* @license: under which licence the package has been released, e.g. GPL, LGPL.
|
|
|
|
* @package: the package-name (e.g. PACKAGE_NAME from config.h)
|
|
|
|
* @origin: a description from where the package comes from (e.g. the homepage URL)
|
|
|
|
*
|
|
|
|
* This macro needs to be used to define the entry point and meta data of a
|
|
|
|
* local plugin. One would use this macro to define a local plugin that can only
|
|
|
|
* be used by the own application.
|
2008-01-09 18:23:39 +00:00
|
|
|
*
|
2009-01-25 20:11:32 +00:00
|
|
|
* The macro uses a define named PACKAGE for the #GstPluginDesc.source field.
|
|
|
|
*
|
2008-01-09 18:23:39 +00:00
|
|
|
* Deprecated: Use gst_plugin_register_static() instead. This macro was
|
|
|
|
* deprecated because it uses constructors, which is a compiler feature not
|
|
|
|
* available on all compilers.
|
2009-01-25 20:11:32 +00:00
|
|
|
*
|
2005-09-25 12:11:39 +00:00
|
|
|
*/
|
2008-01-17 22:22:58 +00:00
|
|
|
/* We don't have deprecation guards here on purpose, it's enough to have
|
|
|
|
* deprecation guards around _gst_plugin_register_static(), and will result in
|
|
|
|
* much better error messages when compiling with -DGST_DISABLE_DEPRECATED */
|
2003-12-04 10:02:41 +00:00
|
|
|
#define GST_PLUGIN_DEFINE_STATIC(major,minor,name,description,init,version,license,package,origin) \
|
2002-11-29 19:08:47 +00:00
|
|
|
static void GST_GNUC_CONSTRUCTOR \
|
|
|
|
_gst_plugin_static_init__ ##init (void) \
|
2001-08-21 20:16:48 +00:00
|
|
|
{ \
|
|
|
|
static GstPluginDesc plugin_desc_ = { \
|
|
|
|
major, \
|
|
|
|
minor, \
|
2004-12-07 18:50:39 +00:00
|
|
|
name, \
|
2007-10-10 10:53:39 +00:00
|
|
|
(gchar *) description, \
|
2004-12-07 18:50:39 +00:00
|
|
|
init, \
|
2003-10-31 19:32:47 +00:00
|
|
|
version, \
|
2004-12-07 18:50:39 +00:00
|
|
|
license, \
|
2005-09-03 17:00:52 +00:00
|
|
|
PACKAGE, \
|
2003-10-31 19:32:47 +00:00
|
|
|
package, \
|
|
|
|
origin, \
|
2003-12-09 02:39:31 +00:00
|
|
|
GST_PADDING_INIT \
|
2001-08-21 20:16:48 +00:00
|
|
|
}; \
|
|
|
|
_gst_plugin_register_static (&plugin_desc_); \
|
2004-12-07 18:50:39 +00:00
|
|
|
}
|
2001-08-21 20:16:48 +00:00
|
|
|
|
2005-09-25 12:11:39 +00:00
|
|
|
/**
|
|
|
|
* GST_LICENSE_UNKNOWN:
|
|
|
|
*
|
|
|
|
* To be used in GST_PLUGIN_DEFINE or GST_PLUGIN_DEFINE_STATIC if usure about
|
|
|
|
* the licence.
|
|
|
|
*/
|
2003-10-31 19:32:47 +00:00
|
|
|
#define GST_LICENSE_UNKNOWN "unknown"
|
2001-08-21 20:16:48 +00:00
|
|
|
|
2003-11-13 02:47:03 +00:00
|
|
|
|
2003-04-14 18:53:03 +00:00
|
|
|
/* function for filters */
|
2005-09-25 12:11:39 +00:00
|
|
|
/**
|
|
|
|
* GstPluginFilter:
|
|
|
|
* @plugin: the plugin to check
|
|
|
|
* @user_data: the user_data that has been passed on e.g. gst_registry_plugin_filter()
|
|
|
|
*
|
|
|
|
* A function that can be used with e.g. gst_registry_plugin_filter()
|
|
|
|
* to get a list of plugins that match certain criteria.
|
|
|
|
*
|
|
|
|
* Returns: TRUE for a positive match, FALSE otherwise
|
|
|
|
*/
|
2004-03-15 14:43:35 +00:00
|
|
|
typedef gboolean (*GstPluginFilter) (GstPlugin *plugin,
|
|
|
|
gpointer user_data);
|
2003-04-14 18:53:03 +00:00
|
|
|
|
2004-03-15 14:43:35 +00:00
|
|
|
GType gst_plugin_get_type (void);
|
2005-09-15 00:13:26 +00:00
|
|
|
|
2008-01-09 18:23:39 +00:00
|
|
|
#ifndef GST_DISABLE_DEPRECATED
|
2004-12-07 18:50:39 +00:00
|
|
|
void _gst_plugin_register_static (GstPluginDesc *desc);
|
2008-01-09 18:23:39 +00:00
|
|
|
#endif
|
|
|
|
|
2008-01-17 22:17:15 +00:00
|
|
|
gboolean gst_plugin_register_static (gint major_version,
|
|
|
|
gint minor_version,
|
|
|
|
const gchar *name,
|
2010-03-03 10:45:38 +00:00
|
|
|
const gchar *description,
|
2008-01-17 22:17:15 +00:00
|
|
|
GstPluginInitFunc init_func,
|
|
|
|
const gchar *version,
|
|
|
|
const gchar *license,
|
|
|
|
const gchar *source,
|
|
|
|
const gchar *package,
|
|
|
|
const gchar *origin);
|
2004-03-15 14:43:35 +00:00
|
|
|
|
2009-05-07 14:37:37 +00:00
|
|
|
gboolean gst_plugin_register_static_full (gint major_version,
|
|
|
|
gint minor_version,
|
|
|
|
const gchar *name,
|
2010-03-03 10:45:38 +00:00
|
|
|
const gchar *description,
|
2009-05-07 14:37:37 +00:00
|
|
|
GstPluginInitFullFunc init_full_func,
|
|
|
|
const gchar *version,
|
|
|
|
const gchar *license,
|
|
|
|
const gchar *source,
|
|
|
|
const gchar *package,
|
|
|
|
const gchar *origin,
|
|
|
|
gpointer user_data);
|
|
|
|
|
2004-03-15 14:43:35 +00:00
|
|
|
G_CONST_RETURN gchar* gst_plugin_get_name (GstPlugin *plugin);
|
|
|
|
G_CONST_RETURN gchar* gst_plugin_get_description (GstPlugin *plugin);
|
|
|
|
G_CONST_RETURN gchar* gst_plugin_get_filename (GstPlugin *plugin);
|
2004-12-07 18:50:39 +00:00
|
|
|
G_CONST_RETURN gchar* gst_plugin_get_version (GstPlugin *plugin);
|
2004-03-15 14:43:35 +00:00
|
|
|
G_CONST_RETURN gchar* gst_plugin_get_license (GstPlugin *plugin);
|
2005-09-03 17:00:52 +00:00
|
|
|
G_CONST_RETURN gchar* gst_plugin_get_source (GstPlugin *plugin);
|
2004-03-15 14:43:35 +00:00
|
|
|
G_CONST_RETURN gchar* gst_plugin_get_package (GstPlugin *plugin);
|
2004-12-07 18:50:39 +00:00
|
|
|
G_CONST_RETURN gchar* gst_plugin_get_origin (GstPlugin *plugin);
|
2009-06-07 20:46:54 +00:00
|
|
|
G_CONST_RETURN GstStructure* gst_plugin_get_cache_data (GstPlugin * plugin);
|
|
|
|
void gst_plugin_set_cache_data (GstPlugin * plugin, GstStructure *cache_data);
|
|
|
|
|
2004-03-15 14:43:35 +00:00
|
|
|
GModule * gst_plugin_get_module (GstPlugin *plugin);
|
|
|
|
gboolean gst_plugin_is_loaded (GstPlugin *plugin);
|
|
|
|
|
|
|
|
gboolean gst_plugin_name_filter (GstPlugin *plugin, const gchar *name);
|
|
|
|
|
2004-12-07 18:50:39 +00:00
|
|
|
GstPlugin * gst_plugin_load_file (const gchar *filename, GError** error);
|
2004-03-15 14:43:35 +00:00
|
|
|
|
2005-09-15 00:13:26 +00:00
|
|
|
GstPlugin * gst_plugin_load (GstPlugin *plugin);
|
2005-09-18 06:59:25 +00:00
|
|
|
GstPlugin * gst_plugin_load_by_name (const gchar *name);
|
2005-09-15 00:13:26 +00:00
|
|
|
|
Add API for making a GStreamer plugin 'dependent' on external files, directories or environment variables, so that GS...
Original commit message from CVS:
* docs/gst/gstreamer-sections.txt::
* gst/gst_private.h: (GstPluginDep), (_GstPluginPrivate):
* gst/gstplugin.c: (gst_plugin_init), (gst_plugin_finalize),
(gst_plugin_class_init), (gst_plugin_list_free),
(gst_plugin_ext_dep_get_env_vars_hash),
(_priv_plugin_deps_env_vars_changed),
(gst_plugin_ext_dep_extract_env_vars_paths),
(gst_plugin_ext_dep_get_hash_from_stat_entry),
(gst_plugin_ext_dep_direntry_matches),
(gst_plugin_ext_dep_scan_dir_and_match_names),
(gst_plugin_ext_dep_scan_path_with_filenames),
(gst_plugin_ext_dep_get_stat_hash),
(_priv_plugin_deps_files_changed), (gst_plugin_ext_dep_free),
(gst_plugin_ext_dep_strv_equal), (gst_plugin_ext_dep_equals),
(gst_plugin_add_dependency), (gst_plugin_add_dependency_simple):
* gst/gstplugin.h: (GstPluginPrivate), (GstPluginFlags),
(GST_PLUGIN_DEPENDENCY_FLAG_NONE),
(GST_PLUGIN_DEPENDENCY_FLAG_RECURSE),
(GST_PLUGIN_DEPENDENCY_FLAG_PATHS_ARE_DEFAULT_ONLY),
(GST_PLUGIN_DEPENDENCY_FLAG_FILE_NAME_IS_SUFFIX),
(GstPluginDependencyFlags), (GstPluginFilter):
* gst/gstregistry.c: (gst_registry_scan_path_level):
* gst/gstregistrybinary.c: (gst_registry_binary_save_feature),
(gst_registry_binary_save_plugin_dep),
(gst_registry_binary_save_plugin),
(gst_registry_binary_load_feature),
(gst_registry_binary_load_plugin_dep_strv),
(gst_registry_binary_load_plugin_dep),
(gst_registry_binary_load_plugin):
* gst/gstregistrybinary.h: (GST_MAGIC_BINARY_VERSION_STR),
(GstBinaryPluginElement), (_GstBinaryDep), (GstBinaryDep):
* gst/gstregistryxml.c: (gst_registry_xml_save_plugin):
Add API for making a GStreamer plugin 'dependent' on external files,
directories or environment variables, so that GStreamer knows when
it needs to re-load GStreamer plugins that wrap other plugin systems.
Fixes bug #350477.
API: add gst_plugin_add_dependency()
API: add gst_plugin_add_dependency_simple()
2009-01-06 17:58:59 +00:00
|
|
|
void gst_plugin_add_dependency (GstPlugin * plugin,
|
|
|
|
const gchar ** env_vars,
|
|
|
|
const gchar ** paths,
|
|
|
|
const gchar ** names,
|
|
|
|
GstPluginDependencyFlags flags);
|
|
|
|
|
|
|
|
void gst_plugin_add_dependency_simple (GstPlugin * plugin,
|
|
|
|
const gchar * env_vars,
|
|
|
|
const gchar * paths,
|
|
|
|
const gchar * names,
|
|
|
|
GstPluginDependencyFlags flags);
|
|
|
|
|
2005-09-18 06:59:25 +00:00
|
|
|
void gst_plugin_list_free (GList *list);
|
2000-11-04 18:54:07 +00:00
|
|
|
|
2002-07-08 19:07:30 +00:00
|
|
|
G_END_DECLS
|
2004-03-15 14:43:35 +00:00
|
|
|
|
2000-01-30 09:03:00 +00:00
|
|
|
#endif /* __GST_PLUGIN_H__ */
|