GstPadTemplate
Describe the media type of a pad.
Padtemplates describe the possible media types a pad or an elementfactory can
handle.
Pad and PadTemplates have #GstCaps attached to it to describe the media type they
are capable of dealing with. gst_pad_template_get_caps() is used to get the
caps of a padtemplate. It's not possible to modify the caps of a padtemplate after
creation.
Padtemplates can be created with gst_pad_template_new() or with the convenient
GST_PAD_TEMPLATE_FACTORY() macro. A padtemplate can be used to create a pad or
to add to an elementfactory.
The following code example shows the code to create a pad from a padtemplate.
Create a pad from a padtemplate
GstStaticPadTemplate my_template =
GST_STATIC_PAD_TEMPLATE (
"sink", /* the name of the pad */
GST_PAD_SINK, /* the direction of the pad */
GST_PAD_ALWAYS, /* when this pad will be present */
GST_STATIC_CAPS ( /* the capabilities of the padtemplate */
"audio/x-raw-int, "
"channels = (int) [ 1, 6 ]"
)
)
void
my_method (void)
{
GstPad *pad;
pad = gst_pad_new_from_template (GST_PAD_TEMPLATE_GET (my_template_factory), "sink");
...
}
The following example shows you how to add the padtemplate to an elementfactory:
gboolean
my_factory_init (GstPlugin *plugin)
{
GstElementFactory *factory;
factory = gst_element_factory_new ("my_factory", GST_TYPE_MYFACTORY, &gst_myfactory_details);
g_return_val_if_fail (factory != NULL, FALSE);
gst_element_factory_add_pad_template (factory, GST_PAD_TEMPLATE_GET (my_template_factory));
gst_plugin_add_feature (plugin, GST_PLUGIN_FEATURE (factory));
return TRUE;
}
#GstPad, #GstElementFactory
The padtemplate object.
This signal is fired when an element creates a pad from this
template.
@gstpadtemplate: the object which received the signal.
@arg1: The pad that was created.
@name_template:
@direction:
@presence:
@static_caps:
@obj:
Get the nametemplate of the padtemplate.
@templ: the template to query
Get the direction of the padtemplate.
@templ: the template to query
Get the presence of the padtemplate.
@templ: the template to query
Get a handle to the padtemplate #GstCaps
@templ: the template to query
Check if the properties of the padtemplate are fixed
@templ: the template to query
Flags for the padtemplate
@GST_PAD_TEMPLATE_FIXED: the padtemplate has no variable properties
@GST_PAD_TEMPLATE_FLAG_LAST: first flag that can be used by subclasses.
@name_template:
@direction:
@presence:
@caps:
@Returns:
@Varargs:
@pad_template:
@Returns:
@templ:
@templ:
@Returns: