mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-11-27 04:01:08 +00:00
Code Issues 1 Projects Releases Wiki Activity

element: add gst_element_class_{set,add}_static_metadata()

Browse source 
Add gst_element_class_{add,set}_metadata() variants for static strings,
so we can avoid unnecessary g_strdup()s.

API: gst_element_class_add_static_metadata()
API: gst_element_class_set_static_metadata()
This commit is contained in:
Tim-Philipp Müller 2012-04-09 12:47:58 +01:00
parent 0cfc3cf8a2
commit bca1ae8fb0
4 changed files with 84 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
docs/gst/gstreamer-sections.txt
View file

@ -697,7 +697,9 @@ gst_element_class_add_pad_template
gst_element_class_get_pad_template
gst_element_class_get_pad_template_list
gst_element_class_set_metadata
gst_element_class_set_static_metadata
gst_element_class_add_metadata
gst_element_class_add_static_metadata
<SUBSECTION element-pads>
gst_element_add_pad

73
gst/gstelement.c
View file

@ -1229,6 +1229,34 @@ gst_element_class_add_metadata (GstElementClass * klass,
key, G_TYPE_STRING, value, NULL);
}
/**
* gst_element_class_add_static_metadata:
* @klass: class to set metadata for
* @key: the key to set
* @value: the value to set
*
* Set @key with @value as metadata in @klass.
*
* Same as gst_element_class_add_metadata(), but @value must be a static string
* or an inlined string, as it will not be copied. (GStreamer plugins will
* be made resident once loaded, so this function can be used even from
* dynamically loaded plugins.)
*/
void
gst_element_class_add_static_metadata (GstElementClass * klass,
const gchar * key, const gchar * value)
{
GValue val = G_VALUE_INIT;
g_return_if_fail (GST_IS_ELEMENT_CLASS (klass));
g_return_if_fail (key != NULL);
g_return_if_fail (value != NULL);
g_value_init (&val, G_TYPE_STRING);
g_value_set_static_string (&val, value);
gst_structure_take_value ((GstStructure *) klass->metadata, key, &val);
}
/**
* gst_element_class_set_metadata:
* @klass: class to set metadata for
@ -1258,6 +1286,51 @@ gst_element_class_set_metadata (GstElementClass * klass,
GST_ELEMENT_METADATA_AUTHOR, G_TYPE_STRING, author, NULL);
}
/**
* gst_element_class_set_static_metadata:
* @klass: class to set metadata for
* @longname: The long English name of the element. E.g. "File Sink"
* @classification: String describing the type of element, as an unordered list
* separated with slashes ('/'). See draft-klass.txt of the design docs
* for more details and common types. E.g: "Sink/File"
* @description: Sentence describing the purpose of the element.
* E.g: "Write stream to a file"
* @author: Name and contact details of the author(s). Use \n to separate
* multiple author metadata. E.g: "Joe Bloggs &lt;joe.blogs at foo.com&gt;"
*
* Sets the detailed information for a #GstElementClass.
* <note>This function is for use in _class_init functions only.</note>
*
* Same as gst_element_class_set_metadata(), but @longname, @classification,
* @description, and @author must be static strings or inlined strings, as
* they will not be copied. (GStreamer plugins will be made resident once
* loaded, so this function can be used even from dynamically loaded plugins.)
*/
void
gst_element_class_set_static_metadata (GstElementClass * klass,
const gchar * longname, const gchar * classification,
const gchar * description, const gchar * author)
{
GstStructure *s = (GstStructure *) klass->metadata;
GValue val = G_VALUE_INIT;
g_return_if_fail (GST_IS_ELEMENT_CLASS (klass));
g_value_init (&val, G_TYPE_STRING);
g_value_set_static_string (&val, longname);
gst_structure_set_value (s, GST_ELEMENT_METADATA_LONGNAME, &val);
g_value_set_static_string (&val, classification);
gst_structure_set_value (s, GST_ELEMENT_METADATA_KLASS, &val);
g_value_set_static_string (&val, description);
gst_structure_set_value (s, GST_ELEMENT_METADATA_DESCRIPTION, &val);
g_value_set_static_string (&val, author);
gst_structure_take_value (s, GST_ELEMENT_METADATA_AUTHOR, &val);
}
/**
* gst_element_class_get_metadata:
* @klass: class to get metadata for

7
gst/gstelement.h
View file

@ -669,8 +669,15 @@ void gst_element_class_set_metadata (GstElementClass
const gchar *classification,
const gchar *description,
const gchar *author);
void gst_element_class_set_static_metadata (GstElementClass *klass,
const gchar *longname,
const gchar *classification,
const gchar *description,
const gchar *author);
void gst_element_class_add_metadata (GstElementClass * klass,
const gchar * key, const gchar * value);
void gst_element_class_add_static_metadata (GstElementClass * klass,
const gchar * key, const gchar * value);
const gchar * gst_element_class_get_metadata (GstElementClass * klass,
const gchar * key);

3
win32/common/libgstreamer.def
View file

@ -321,10 +321,12 @@ EXPORTS
gst_element_change_state
gst_element_class_add_metadata
gst_element_class_add_pad_template
gst_element_class_add_static_metadata
gst_element_class_get_metadata
gst_element_class_get_pad_template
gst_element_class_get_pad_template_list
gst_element_class_set_metadata
gst_element_class_set_static_metadata
gst_element_continue_state
gst_element_create_all_pads
gst_element_factory_can_sink_all_caps
@ -1112,7 +1114,6 @@ EXPORTS
gst_task_pool_push
gst_task_set_lock
gst_task_set_pool
gst_task_set_priority
gst_task_set_state
gst_task_set_thread_callbacks
gst_task_start