Blame docs/gst/html/GstPluginFeature.html

Packit Service 963350
Packit Service 963350
<html>
Packit Service 963350
<head>
Packit Service 963350
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
Packit Service 963350
<title>GstPluginfeature: GStreamer 1.0 Core Reference Manual</title>
Packit Service 963350
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
Packit Service 963350
<link rel="home" href="index.html" title="GStreamer 1.0 Core Reference Manual">
Packit Service 963350
<link rel="up" href="libgstreamer.html" title="GStreamer Core Library">
Packit Service 963350
<link rel="prev" href="GstPlugin.html" title="GstPlugin">
Packit Service 963350
<link rel="next" href="gstreamer-GstPoll.html" title="GstPoll">
Packit Service 963350
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
Packit Service 963350
<link rel="stylesheet" href="style.css" type="text/css">
Packit Service 963350
</head>
Packit Service 963350
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Packit Service 963350
Packit Service 963350
Packit Service 963350
Top  | 
Packit Service 963350
                  Description  | 
Packit Service 963350
                  Object Hierarchy
Packit Service 963350
Packit Service 963350
Home
Packit Service 963350
Up
Packit Service 963350
Prev
Packit Service 963350
Next
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

GstPluginfeature

Packit Service 963350

GstPluginfeature — Base class for contents of a GstPlugin

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Functions

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
gboolean
Packit Service 963350
Packit Service 963350
Packit Service 963350
(*GstPluginFeatureFilter) ()
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
void
Packit Service 963350
Packit Service 963350
Packit Service 963350
gst_plugin_feature_set_rank ()
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
#define
Packit Service 963350
Packit Service 963350
gst_plugin_feature_set_name()
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
guint
Packit Service 963350
Packit Service 963350
Packit Service 963350
gst_plugin_feature_get_rank ()
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
#define
Packit Service 963350
Packit Service 963350
gst_plugin_feature_get_name()
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
GstPlugin *
Packit Service 963350
Packit Service 963350
Packit Service 963350
gst_plugin_feature_get_plugin ()
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
const gchar *
Packit Service 963350
Packit Service 963350
Packit Service 963350
gst_plugin_feature_get_plugin_name ()
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
GstPluginFeature *
Packit Service 963350
Packit Service 963350
Packit Service 963350
gst_plugin_feature_load ()
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
GList *
Packit Service 963350
Packit Service 963350
Packit Service 963350
gst_plugin_feature_list_copy ()
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
void
Packit Service 963350
Packit Service 963350
Packit Service 963350
gst_plugin_feature_list_free ()
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
#define
Packit Service 963350
Packit Service 963350
GST_PLUGIN_FEATURE_LIST_DEBUG()
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
gboolean
Packit Service 963350
Packit Service 963350
Packit Service 963350
gst_plugin_feature_check_version ()
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
gint
Packit Service 963350
Packit Service 963350
Packit Service 963350
gst_plugin_feature_rank_compare_func ()
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Types and Values

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
 
Packit Service 963350
GstPluginFeature
Packit Service 963350
Packit Service 963350
Packit Service 963350
enum
Packit Service 963350
GstRank
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Object Hierarchy

Packit Service 963350
    GObject
Packit Service 963350
    ╰── GInitiallyUnowned
Packit Service 963350
        ╰── GstObject
Packit Service 963350
            ╰── GstPluginFeature
Packit Service 963350
                ├── GstElementFactory
Packit Service 963350
                ├── GstTracerFactory
Packit Service 963350
                ├── GstTypeFindFactory
Packit Service 963350
                ├── GstDeviceProviderFactory
Packit Service 963350
                ╰── GstDynamicTypeFactory
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Includes

Packit Service 963350
#include <gst/gst.h>
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Description

Packit Service 963350

This is a base class for anything that can be added to a GstPlugin.

Packit Service 963350
Packit Service 963350
Packit Service 963350

Functions

Packit Service 963350
Packit Service 963350

GstPluginFeatureFilter ()

Packit Service 963350
gboolean
Packit Service 963350
(*GstPluginFeatureFilter) (GstPluginFeature *feature,
Packit Service 963350
                           gpointer user_data);
Packit Service 963350

A function that can be used with e.g. gst_registry_feature_filter()

Packit Service 963350
to get a list of pluginfeature that match certain criteria.

Packit Service 963350
Packit Service 963350

Parameters

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

feature

Packit Service 963350

the pluginfeature to check

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350

user_data

Packit Service 963350

the user_data that has been passed on e.g.

Packit Service 963350
gst_registry_feature_filter()

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Returns

Packit Service 963350

TRUE for a positive match, FALSE otherwise

Packit Service 963350
Packit Service 963350
Packit Service 963350

Packit Service 963350
Packit Service 963350

gst_plugin_feature_set_rank ()

Packit Service 963350
void
Packit Service 963350
gst_plugin_feature_set_rank (GstPluginFeature *feature,
Packit Service 963350
                             guint rank);
Packit Service 963350

Specifies a rank for a plugin feature, so that autoplugging uses

Packit Service 963350
the most appropriate feature.

Packit Service 963350
Packit Service 963350

Parameters

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

feature

Packit Service 963350

feature to rank

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350

rank

Packit Service 963350

rank value - higher number means more priority rank

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Packit Service 963350
Packit Service 963350

gst_plugin_feature_set_name()

Packit Service 963350
#define                 gst_plugin_feature_set_name(feature,name) gst_object_set_name(GST_OBJECT_CAST(feature),name)
Packit Service 963350
Packit Service 963350

Sets the name of the plugin feature, getting rid of the old name if there was one.

Packit Service 963350
Packit Service 963350

Parameters

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

feature

Packit Service 963350

a GstPluginFeature to set the name of.

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350

name

Packit Service 963350

the new name

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Packit Service 963350
Packit Service 963350

gst_plugin_feature_get_rank ()

Packit Service 963350
guint
Packit Service 963350
gst_plugin_feature_get_rank (GstPluginFeature *feature);
Packit Service 963350

Gets the rank of a plugin feature.

Packit Service 963350
Packit Service 963350

Parameters

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

feature

Packit Service 963350

a feature

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Returns

Packit Service 963350

The rank of the feature

Packit Service 963350
Packit Service 963350
Packit Service 963350

Packit Service 963350
Packit Service 963350

gst_plugin_feature_get_name()

Packit Service 963350
#define                 gst_plugin_feature_get_name(feature)      GST_OBJECT_NAME(feature)
Packit Service 963350
Packit Service 963350

Returns the name of feature

Packit Service 963350
.
Packit Service 963350
For a nameless plugin feature, this returns NULL.

Packit Service 963350
Packit Service 963350

Parameters

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

feature

Packit Service 963350

a GstPluginFeature to get the name of feature

Packit Service 963350
.

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Returns

Packit Service 963350

the name of feature

Packit Service 963350
. MT safe. 

Packit Service 963350

[transfer none][nullable]

Packit Service 963350
Packit Service 963350
Packit Service 963350

Packit Service 963350
Packit Service 963350

gst_plugin_feature_get_plugin ()

Packit Service 963350
GstPlugin *
Packit Service 963350
gst_plugin_feature_get_plugin (GstPluginFeature *feature);
Packit Service 963350

Get the plugin that provides this feature.

Packit Service 963350
Packit Service 963350

Parameters

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

feature

Packit Service 963350

a feature

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Returns

Packit Service 963350

the plugin that provides this

Packit Service 963350
feature, or NULL.  Unref with gst_object_unref() when no
Packit Service 963350
longer needed. 

Packit Service 963350

[transfer full][nullable]

Packit Service 963350
Packit Service 963350
Packit Service 963350

Packit Service 963350
Packit Service 963350

gst_plugin_feature_get_plugin_name ()

Packit Service 963350
const gchar *
Packit Service 963350
gst_plugin_feature_get_plugin_name (GstPluginFeature *feature);
Packit Service 963350

Get the name of the plugin that provides this feature.

Packit Service 963350
Packit Service 963350

Parameters

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

feature

Packit Service 963350

a feature

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Returns

Packit Service 963350

the name of the plugin that provides this

Packit Service 963350
feature, or NULL if the feature is not associated with a
Packit Service 963350
plugin. 

Packit Service 963350

[nullable]

Packit Service 963350
Packit Service 963350

Since: 1.2

Packit Service 963350
Packit Service 963350

Packit Service 963350
Packit Service 963350

gst_plugin_feature_load ()

Packit Service 963350
GstPluginFeature *
Packit Service 963350
gst_plugin_feature_load (GstPluginFeature *feature);
Packit Service 963350

Loads the plugin containing feature

Packit Service 963350
 if it's not already loaded. feature
Packit Service 963350
 is
Packit Service 963350
unaffected; use the return value instead.

Packit Service 963350

Normally this function is used like this:

Packit Service 963350
Packit Service 963350
  
Packit Service 963350
    
Packit Service 963350
      
Packit Service 963350
        
1
Packit Service 963350
2
Packit Service 963350
3
Packit Service 963350
4
Packit Service 963350
5
Packit Service 963350
6
Packit Service 963350
        
GstPluginFeature *loaded_feature;
Packit Service 963350
Packit Service 963350
loaded_feature = gst_plugin_feature_load (feature);
Packit Service 963350
// presumably, we're no longer interested in the potentially-unloaded feature
Packit Service 963350
gst_object_unref (feature);
Packit Service 963350
feature = loaded_feature;
Packit Service 963350
      
Packit Service 963350
    
Packit Service 963350
  
Packit Service 963350
Packit Service 963350
Packit Service 963350

Packit Service 963350
Packit Service 963350

Parameters

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

feature

Packit Service 963350

the plugin feature to check.

Packit Service 963350
[transfer none]
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Returns

Packit Service 963350

a reference to the loaded

Packit Service 963350
feature, or NULL on error. 

Packit Service 963350

[transfer full][nullable]

Packit Service 963350
Packit Service 963350
Packit Service 963350

Packit Service 963350
Packit Service 963350

gst_plugin_feature_list_copy ()

Packit Service 963350
GList *
Packit Service 963350
gst_plugin_feature_list_copy (GList *list);
Packit Service 963350

Copies the list of features. Caller should call gst_plugin_feature_list_free

Packit Service 963350
Packit Service 963350
when done with the list.

Packit Service 963350
Packit Service 963350

Parameters

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

list

Packit Service 963350

list

Packit Service 963350
of GstPluginFeature. 

Packit Service 963350
[transfer none][element-type Gst.PluginFeature]
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Returns

Packit Service 963350

a copy of list

Packit Service 963350
,
Packit Service 963350
with each feature's reference count incremented. 

Packit Service 963350

[transfer full][element-type Gst.PluginFeature]

Packit Service 963350
Packit Service 963350
Packit Service 963350

Packit Service 963350
Packit Service 963350

gst_plugin_feature_list_free ()

Packit Service 963350
void
Packit Service 963350
gst_plugin_feature_list_free (GList *list);
Packit Service 963350

Unrefs each member of list

Packit Service 963350
, then frees the list.

Packit Service 963350
Packit Service 963350

Parameters

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

list

Packit Service 963350

list

Packit Service 963350
of GstPluginFeature. 

Packit Service 963350
[transfer full][element-type Gst.PluginFeature]
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Packit Service 963350
Packit Service 963350

GST_PLUGIN_FEATURE_LIST_DEBUG()

Packit Service 963350
#define GST_PLUGIN_FEATURE_LIST_DEBUG(list) gst_plugin_feature_list_debug(list)
Packit Service 963350
Packit Service 963350

Debug the plugin feature names in list

Packit Service 963350
.

Packit Service 963350
Packit Service 963350

Parameters

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

list

Packit Service 963350

a GList of

Packit Service 963350
plugin features. 

Packit Service 963350
[transfer none][element-type Gst.PluginFeature]
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Packit Service 963350
Packit Service 963350

gst_plugin_feature_check_version ()

Packit Service 963350
gboolean
Packit Service 963350
gst_plugin_feature_check_version (GstPluginFeature *feature,
Packit Service 963350
                                  guint min_major,
Packit Service 963350
                                  guint min_minor,
Packit Service 963350
                                  guint min_micro);
Packit Service 963350

Checks whether the given plugin feature is at least

Packit Service 963350
 the required version

Packit Service 963350
Packit Service 963350

Parameters

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

feature

Packit Service 963350

a feature

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350

min_major

Packit Service 963350

minimum required major version

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350

min_minor

Packit Service 963350

minimum required minor version

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350

min_micro

Packit Service 963350

minimum required micro version

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Returns

Packit Service 963350

TRUE if the plugin feature has at least

Packit Service 963350
the required version, otherwise FALSE.

Packit Service 963350
Packit Service 963350
Packit Service 963350

Packit Service 963350
Packit Service 963350

gst_plugin_feature_rank_compare_func ()

Packit Service 963350
gint
Packit Service 963350
gst_plugin_feature_rank_compare_func (gconstpointer p1,
Packit Service 963350
                                      gconstpointer p2);
Packit Service 963350

Compares the two given GstPluginFeature instances. This function can be

Packit Service 963350
used as a GCompareFunc when sorting by rank and then by name.

Packit Service 963350
Packit Service 963350

Parameters

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

p1

Packit Service 963350

a GstPluginFeature

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350

p2

Packit Service 963350

a GstPluginFeature

Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Returns

Packit Service 963350

negative value if the rank of p1 > the rank of p2 or the ranks are

Packit Service 963350
equal but the name of p1 comes before the name of p2; zero if the rank
Packit Service 963350
and names are equal; positive value if the rank of p1 < the rank of p2 or the
Packit Service 963350
ranks are equal but the name of p2 comes before the name of p1

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Types and Values

Packit Service 963350
Packit Service 963350

GstPluginFeature

Packit Service 963350
typedef struct _GstPluginFeature GstPluginFeature;
Packit Service 963350

Opaque GstPluginFeature structure.

Packit Service 963350
Packit Service 963350

Packit Service 963350
Packit Service 963350

enum GstRank

Packit Service 963350

Element priority ranks. Defines the order in which the autoplugger (or

Packit Service 963350
similar rank-picking mechanisms, such as e.g. gst_element_make_from_uri())
Packit Service 963350
will choose this element over an alternative one with the same function.

Packit Service 963350

These constants serve as a rough guidance for defining the rank of a

Packit Service 963350
GstPluginFeature. Any value is valid, including values bigger than
Packit Service 963350
GST_RANK_PRIMARY
Packit Service 963350
.

Packit Service 963350
Packit Service 963350

Members

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

GST_RANK_NONE

Packit Service 963350
Packit Service 963350

will be chosen last or not at all

Packit Service 963350
Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350

GST_RANK_MARGINAL

Packit Service 963350
Packit Service 963350

unlikely to be chosen

Packit Service 963350
Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350

GST_RANK_SECONDARY

Packit Service 963350
Packit Service 963350

likely to be chosen

Packit Service 963350
Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350

GST_RANK_PRIMARY

Packit Service 963350
Packit Service 963350

will be chosen first

Packit Service 963350
Packit Service 963350
 
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

See Also

Packit Service 963350

GstPlugin

Packit Service 963350
Packit Service 963350
Packit Service 963350
Packit Service 963350

Generated by GTK-Doc V1.27
Packit Service 963350
</body>
Packit Service 963350
</html>