Top | ![]() |
![]() |
![]() |
![]() |
GObject ╰── GstObject ╰── GstPluginFeature ├── GstElementFactory ├── GstTypeFindFactory ╰── GstIndexFactory
#define GST_PLUGIN_FEATURE_NAME(feature) (GST_PLUGIN_FEATURE (feature)->name)
Get the name of the feature
gboolean (*GstPluginFeatureFilter) (GstPluginFeature *feature
,gpointer user_data
);
A function that can be used with e.g. gst_registry_feature_filter()
to get a list of pluginfeature that match certain criteria.
feature |
the pluginfeature to check |
|
user_data |
the user_data that has been passed on e.g.
|
gboolean gst_plugin_feature_type_name_filter (GstPluginFeature *feature
,GstTypeNameData *data
);
gst_plugin_feature_type_name_filter
is deprecated and should not be used in newly-written code.
Compares type and name of plugin feature. Can be used with gst_filter_run()
.
void gst_plugin_feature_set_rank (GstPluginFeature *feature
,guint rank
);
Specifies a rank for a plugin feature, so that autoplugging uses the most appropriate feature.
void gst_plugin_feature_set_name (GstPluginFeature *feature
,const gchar *name
);
Sets the name of a plugin feature. The name uniquely identifies a feature
within all features of the same type. Renaming a plugin feature is not
allowed. A copy is made of the name so you should free the supplied name
after calling this function.
guint
gst_plugin_feature_get_rank (GstPluginFeature *feature
);
Gets the rank of a plugin feature.
const gchar *
gst_plugin_feature_get_name (GstPluginFeature *feature
);
Gets the name of a plugin feature.
GstPluginFeature *
gst_plugin_feature_load (GstPluginFeature *feature
);
Loads the plugin containing feature
if it's not already loaded. feature
is
unaffected; use the return value instead.
Normally this function is used like this:
GstPluginFeature *loaded_feature; loaded_feature = gst_plugin_feature_load (feature); // presumably, we're no longer interested in the potentially-unloaded feature gst_object_unref (feature); feature = loaded_feature;
GList *
gst_plugin_feature_list_copy (GList *list
);
Copies the list of features. Caller should call gst_plugin_feature_list_free
when done with the list.
a copy of list
,
with each feature's reference count incremented.
[transfer full][element-type Gst.PluginFeature]
Since 0.10.26
void
gst_plugin_feature_list_free (GList *list
);
Unrefs each member of list
, then frees the list.
#define GST_PLUGIN_FEATURE_LIST_DEBUG(list) gst_plugin_feature_list_debug(list)
Debug the plugin feature names in list
.
Since 0.10.31
gboolean gst_plugin_feature_check_version (GstPluginFeature *feature
,guint min_major
,guint min_minor
,guint min_micro
);
Checks whether the given plugin feature is at least the required version
gint gst_plugin_feature_rank_compare_func (gconstpointer p1
,gconstpointer p2
);
Compares the two given GstPluginFeature instances. This function can be used as a GCompareFunc when sorting by rank and then by name.
negative value if the rank of p1 > the rank of p2 or the ranks are equal but the name of p1 comes before the name of p2; zero if the rank and names are equal; positive value if the rank of p1 < the rank of p2 or the ranks are equal but the name of p2 comes after the name of p1
Since 0.10.31
typedef struct { const gchar *name; GType type; } GstTypeNameData;
GstTypeNameData
is deprecated and should not be used in newly-written code.
Structure used for filtering based on name
and type
.
Element priority ranks. Defines the order in which the autoplugger (or
similar rank-picking mechanisms, such as e.g. gst_element_make_from_uri()
)
will choose this element over an alternative one with the same function.
These constants serve as a rough guidance for defining the rank of a
GstPluginFeature. Any value is valid, including values bigger than
GST_RANK_PRIMARY
.