mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-07-04 05:35:53 +00:00
Code Issues 1 Projects Releases Wiki Activity

ges-meta-container: Minor documentation fixes

Browse source
This commit is contained in:
Alexandru Băluț 2019-01-04 05:31:39 +01:00 committed by Thibault Saunier
parent 9a20b4cfe9
commit fd7e6aa204
1 changed files with 63 additions and 48 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

111
ges/ges-meta-container.c
View file

@ -37,7 +37,8 @@ static GQuark ges_meta_key;
G_DEFINE_INTERFACE_WITH_CODE (GESMetaContainer, ges_meta_container, G_DEFINE_INTERFACE_WITH_CODE (GESMetaContainer, ges_meta_container,
G_TYPE_OBJECT, ges_meta_key = G_TYPE_OBJECT, ges_meta_key =
g_quark_from_static_string ("ges-meta-container-data");); g_quark_from_static_string ("ges-meta-container-data");
);
enum enum
{ {
@ -289,9 +290,9 @@ ges_meta_container_set_ ## name (GESMetaContainer *container, \
* *
* Sets the value of a given meta item * Sets the value of a given meta item
* *
* Return: %TRUE if the meta could be added, %FALSE otherwize * Return: %TRUE if the meta could be added, %FALSE otherwise
*/ */
CREATE_SETTER (boolean, gboolean, G_TYPE_BOOLEAN, boolean) CREATE_SETTER (boolean, gboolean, G_TYPE_BOOLEAN, boolean);
/** /**
* ges_meta_container_set_int: * ges_meta_container_set_int:
@ -301,9 +302,9 @@ CREATE_SETTER (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
* *
* Sets the value of a given meta item * Sets the value of a given meta item
* *
* Return: %TRUE if the meta could be added, %FALSE otherwize * Return: %TRUE if the meta could be added, %FALSE otherwise
*/ */
CREATE_SETTER (int, gint, G_TYPE_INT, int) CREATE_SETTER (int, gint, G_TYPE_INT, int);
/** /**
* ges_meta_container_set_uint: * ges_meta_container_set_uint:
@ -313,9 +314,9 @@ CREATE_SETTER (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
* *
* Sets the value of a given meta item * Sets the value of a given meta item
* *
* Return: %TRUE if the meta could be added, %FALSE otherwize * Return: %TRUE if the meta could be added, %FALSE otherwise
*/ */
CREATE_SETTER (uint, guint, G_TYPE_UINT, uint) CREATE_SETTER (uint, guint, G_TYPE_UINT, uint);
/** /**
* ges_meta_container_set_int64: * ges_meta_container_set_int64:
@ -325,9 +326,9 @@ CREATE_SETTER (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
* *
* Sets the value of a given meta item * Sets the value of a given meta item
* *
* Return: %TRUE if the meta could be added, %FALSE otherwize * Return: %TRUE if the meta could be added, %FALSE otherwise
*/ */
CREATE_SETTER (int64, gint64, G_TYPE_INT64, int64) CREATE_SETTER (int64, gint64, G_TYPE_INT64, int64);
/** /**
* ges_meta_container_set_uint64: * ges_meta_container_set_uint64:
@ -337,9 +338,9 @@ CREATE_SETTER (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
* *
* Sets the value of a given meta item * Sets the value of a given meta item
* *
* Return: %TRUE if the meta could be added, %FALSE otherwize * Return: %TRUE if the meta could be added, %FALSE otherwise
*/ */
CREATE_SETTER (uint64, guint64, G_TYPE_UINT64, uint64) CREATE_SETTER (uint64, guint64, G_TYPE_UINT64, uint64);
/** /**
* ges_meta_container_set_float: * ges_meta_container_set_float:
@ -349,9 +350,9 @@ CREATE_SETTER (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
* *
* Sets the value of a given meta item * Sets the value of a given meta item
* *
* Return: %TRUE if the meta could be added, %FALSE otherwize * Return: %TRUE if the meta could be added, %FALSE otherwise
*/ */
CREATE_SETTER (float, float, G_TYPE_FLOAT, float) CREATE_SETTER (float, float, G_TYPE_FLOAT, float);
/** /**
* ges_meta_container_set_double: * ges_meta_container_set_double:
@ -361,9 +362,9 @@ CREATE_SETTER (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
* *
* Sets the value of a given meta item * Sets the value of a given meta item
* *
* Return: %TRUE if the meta could be added, %FALSE otherwize * Return: %TRUE if the meta could be added, %FALSE otherwise
*/ */
CREATE_SETTER (double, double, G_TYPE_DOUBLE, double) CREATE_SETTER (double, double, G_TYPE_DOUBLE, double);
/** /**
* ges_meta_container_set_date: * ges_meta_container_set_date:
@ -373,9 +374,9 @@ CREATE_SETTER (double, double, G_TYPE_DOUBLE, double)
* *
* Sets the value of a given meta item * Sets the value of a given meta item
* *
* Return: %TRUE if the meta could be added, %FALSE otherwize * Return: %TRUE if the meta could be added, %FALSE otherwise
*/ */
CREATE_SETTER (date, const GDate *, G_TYPE_DATE, boxed) CREATE_SETTER (date, const GDate *, G_TYPE_DATE, boxed);
/** /**
* ges_meta_container_set_date_time: * ges_meta_container_set_date_time:
@ -385,9 +386,9 @@ CREATE_SETTER (date, const GDate *, G_TYPE_DATE, boxed)
* *
* Sets the value of a given meta item * Sets the value of a given meta item
* *
* Return: %TRUE if the meta could be added, %FALSE otherwize * Return: %TRUE if the meta could be added, %FALSE otherwise
*/ */
CREATE_SETTER (date_time, const GstDateTime *, GST_TYPE_DATE_TIME, boxed) CREATE_SETTER (date_time, const GstDateTime *, GST_TYPE_DATE_TIME, boxed);
/** /**
* ges_meta_container_set_string: * ges_meta_container_set_string:
@ -397,20 +398,21 @@ CREATE_SETTER (date_time, const GstDateTime *, GST_TYPE_DATE_TIME, boxed)
* *
* Sets the value of a given meta item * Sets the value of a given meta item
* *
* Return: %TRUE if the meta could be added, %FALSE otherwize * Return: %TRUE if the meta could be added, %FALSE otherwise
*/ */
CREATE_SETTER (string, const gchar *, G_TYPE_STRING, string) CREATE_SETTER (string, const gchar *, G_TYPE_STRING, string);
/** /**
* ges_meta_container_set_meta: * ges_meta_container_set_meta:
* @container: Target container * @container: Target container
* @meta_item: Name of the meta item to set * @meta_item: Name of the meta item to set
* @value: (allow-none): Value to set * @value: (allow-none): Value to set
*
* Sets the value of a given meta item * Sets the value of a given meta item
* *
* Return: %TRUE if the meta could be added, %FALSE otherwize * Return: %TRUE if the meta could be added, %FALSE otherwise
*/ */
gboolean gboolean
ges_meta_container_set_meta (GESMetaContainer * container, ges_meta_container_set_meta (GESMetaContainer * container,
const gchar * meta_item, const GValue * value) const gchar * meta_item, const GValue * value)
{ {
@ -507,7 +509,7 @@ ges_meta_container_register_meta_ ## name (GESMetaContainer *container,\
} }
/** /**
* register_meta_: * ges_meta_container_register_meta_boolean:
* @container: Target container * @container: Target container
* @flags: The #GESMetaFlag to be used * @flags: The #GESMetaFlag to be used
* @meta_item: Name of the meta item to set * @meta_item: Name of the meta item to set
@ -517,9 +519,9 @@ ges_meta_container_register_meta_ ## name (GESMetaContainer *container,\
* metadatas, which means that the type of the registered will be the only * metadatas, which means that the type of the registered will be the only
* type accepted for this meta on that particular @container. * type accepted for this meta on that particular @container.
* *
* Return: %TRUE if the meta could be register, %FALSE otherwize * Return: %TRUE if the meta could be registered, %FALSE otherwise
*/ */
CREATE_REGISTER_STATIC (boolean, gboolean, G_TYPE_BOOLEAN, boolean) CREATE_REGISTER_STATIC (boolean, gboolean, G_TYPE_BOOLEAN, boolean);
/** /**
* ges_meta_container_register_meta_int: * ges_meta_container_register_meta_int:
@ -532,9 +534,9 @@ CREATE_REGISTER_STATIC (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
* metadatas, which means that the type of the registered will be the only * metadatas, which means that the type of the registered will be the only
* type accepted for this meta on that particular @container. * type accepted for this meta on that particular @container.
* *
* Return: %TRUE if the meta could be register, %FALSE otherwize * Return: %TRUE if the meta could be registered, %FALSE otherwise
*/ */
CREATE_REGISTER_STATIC (int, gint, G_TYPE_INT, int) CREATE_REGISTER_STATIC (int, gint, G_TYPE_INT, int);
/** /**
* ges_meta_container_register_meta_uint: * ges_meta_container_register_meta_uint:
@ -547,9 +549,9 @@ CREATE_REGISTER_STATIC (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
* metadatas, which means that the type of the registered will be the only * metadatas, which means that the type of the registered will be the only
* type accepted for this meta on that particular @container. * type accepted for this meta on that particular @container.
* *
* Return: %TRUE if the meta could be register, %FALSE otherwize * Return: %TRUE if the meta could be registered, %FALSE otherwise
*/ */
CREATE_REGISTER_STATIC (uint, guint, G_TYPE_UINT, uint) CREATE_REGISTER_STATIC (uint, guint, G_TYPE_UINT, uint);
/** /**
* ges_meta_container_register_meta_int64: * ges_meta_container_register_meta_int64:
@ -562,9 +564,9 @@ CREATE_REGISTER_STATIC (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
* metadatas, which means that the type of the registered will be the only * metadatas, which means that the type of the registered will be the only
* type accepted for this meta on that particular @container. * type accepted for this meta on that particular @container.
* *
* Return: %TRUE if the meta could be register, %FALSE otherwize * Return: %TRUE if the meta could be registered, %FALSE otherwise
*/ */
CREATE_REGISTER_STATIC (int64, gint64, G_TYPE_INT64, int64) CREATE_REGISTER_STATIC (int64, gint64, G_TYPE_INT64, int64);
/** /**
* ges_meta_container_register_meta_uint64: * ges_meta_container_register_meta_uint64:
@ -577,9 +579,9 @@ CREATE_REGISTER_STATIC (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
* metadatas, which means that the type of the registered will be the only * metadatas, which means that the type of the registered will be the only
* type accepted for this meta on that particular @container. * type accepted for this meta on that particular @container.
* *
* Return: %TRUE if the meta could be register, %FALSE otherwize * Return: %TRUE if the meta could be registered, %FALSE otherwise
*/ */
CREATE_REGISTER_STATIC (uint64, guint64, G_TYPE_UINT64, uint64) CREATE_REGISTER_STATIC (uint64, guint64, G_TYPE_UINT64, uint64);
/** /**
* ges_meta_container_register_meta_float: * ges_meta_container_register_meta_float:
@ -592,9 +594,9 @@ CREATE_REGISTER_STATIC (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
* metadatas, which means that the type of the registered will be the only * metadatas, which means that the type of the registered will be the only
* type accepted for this meta on that particular @container. * type accepted for this meta on that particular @container.
* *
* Return: %TRUE if the meta could be register, %FALSE otherwize * Return: %TRUE if the meta could be registered, %FALSE otherwise
*/ */
CREATE_REGISTER_STATIC (float, float, G_TYPE_FLOAT, float) CREATE_REGISTER_STATIC (float, float, G_TYPE_FLOAT, float);
/** /**
* ges_meta_container_register_meta_double: * ges_meta_container_register_meta_double:
@ -607,9 +609,9 @@ CREATE_REGISTER_STATIC (boolean, gboolean, G_TYPE_BOOLEAN, boolean)
* metadatas, which means that the type of the registered will be the only * metadatas, which means that the type of the registered will be the only
* type accepted for this meta on that particular @container. * type accepted for this meta on that particular @container.
* *
* Return: %TRUE if the meta could be register, %FALSE otherwize * Return: %TRUE if the meta could be registered, %FALSE otherwise
*/ */
CREATE_REGISTER_STATIC (double, double, G_TYPE_DOUBLE, double) CREATE_REGISTER_STATIC (double, double, G_TYPE_DOUBLE, double);
/** /**
* ges_meta_container_register_meta_date: * ges_meta_container_register_meta_date:
@ -622,9 +624,9 @@ CREATE_REGISTER_STATIC (double, double, G_TYPE_DOUBLE, double)
* metadatas, which means that the type of the registered will be the only * metadatas, which means that the type of the registered will be the only
* type accepted for this meta on that particular @container. * type accepted for this meta on that particular @container.
* *
* Return: %TRUE if the meta could be register, %FALSE otherwize * Return: %TRUE if the meta could be registered, %FALSE otherwise
*/ */
CREATE_REGISTER_STATIC (date, const GDate *, G_TYPE_DATE, boxed) CREATE_REGISTER_STATIC (date, const GDate *, G_TYPE_DATE, boxed);
/** /**
* ges_meta_container_register_meta_date_time: * ges_meta_container_register_meta_date_time:
@ -637,10 +639,10 @@ CREATE_REGISTER_STATIC (date, const GDate *, G_TYPE_DATE, boxed)
* metadatas, which means that the type of the registered will be the only * metadatas, which means that the type of the registered will be the only
* type accepted for this meta on that particular @container. * type accepted for this meta on that particular @container.
* *
* Return: %TRUE if the meta could be register, %FALSE otherwize * Return: %TRUE if the meta could be registered, %FALSE otherwise
*/ */
CREATE_REGISTER_STATIC (date_time, const GstDateTime *, GST_TYPE_DATE_TIME, CREATE_REGISTER_STATIC (date_time, const GstDateTime *, GST_TYPE_DATE_TIME,
boxed) boxed);
/** /**
* ges_meta_container_register_meta_string: * ges_meta_container_register_meta_string:
@ -653,9 +655,9 @@ CREATE_REGISTER_STATIC (date_time, const GstDateTime *, GST_TYPE_DATE_TIME,
* metadatas, which means that the type of the registered will be the only * metadatas, which means that the type of the registered will be the only
* type accepted for this meta on that particular @container. * type accepted for this meta on that particular @container.
* *
* Return: %TRUE if the meta could be register, %FALSE otherwize * Return: %TRUE if the meta could be registered, %FALSE otherwise
*/ */
CREATE_REGISTER_STATIC (string, const gchar *, G_TYPE_STRING, string) CREATE_REGISTER_STATIC (string, const gchar *, G_TYPE_STRING, string);
/** /**
* ges_meta_container_register_meta: * ges_meta_container_register_meta:
@ -668,9 +670,9 @@ CREATE_REGISTER_STATIC (string, const gchar *, G_TYPE_STRING, string)
* metadatas, which means that the type of the registered will be the only * metadatas, which means that the type of the registered will be the only
* type accepted for this meta on that particular @container. * type accepted for this meta on that particular @container.
* *
* Return: %TRUE if the static meta could be added, %FALSE otherwize * Return: %TRUE if the static meta could be added, %FALSE otherwise
*/ */
gboolean gboolean
ges_meta_container_register_meta (GESMetaContainer * container, ges_meta_container_register_meta (GESMetaContainer * container,
GESMetaFlag flags, const gchar * meta_item, const GValue * value) GESMetaFlag flags, const gchar * meta_item, const GValue * value)
{ {
@ -735,33 +737,40 @@ ges_meta_container_get_ ## name (GESMetaContainer *container, \
* @container: Target container * @container: Target container
* @meta_item: Name of the meta item to get * @meta_item: Name of the meta item to get
* @dest: (out): Destination to which value of meta item will be copied * @dest: (out): Destination to which value of meta item will be copied
*
* Gets the value of a given meta item, returns NULL if @meta_item * Gets the value of a given meta item, returns NULL if @meta_item
* can not be found. * can not be found.
*/ */
CREATE_GETTER (boolean, gboolean *); CREATE_GETTER (boolean, gboolean *);
/** /**
* ges_meta_container_get_int: * ges_meta_container_get_int:
* @container: Target container * @container: Target container
* @meta_item: Name of the meta item to get * @meta_item: Name of the meta item to get
* @dest: (out): Destination to which value of meta item will be copied * @dest: (out): Destination to which value of meta item will be copied
*
* Gets the value of a given meta item, returns NULL if @meta_item * Gets the value of a given meta item, returns NULL if @meta_item
* can not be found. * can not be found.
*/ */
CREATE_GETTER (int, gint *); CREATE_GETTER (int, gint *);
/** /**
* ges_meta_container_get_uint: * ges_meta_container_get_uint:
* @container: Target container * @container: Target container
* @meta_item: Name of the meta item to get * @meta_item: Name of the meta item to get
* @dest: (out): Destination to which value of meta item will be copied * @dest: (out): Destination to which value of meta item will be copied
*
* Gets the value of a given meta item, returns NULL if @meta_item * Gets the value of a given meta item, returns NULL if @meta_item
* can not be found. * can not be found.
*/ */
CREATE_GETTER (uint, guint *); CREATE_GETTER (uint, guint *);
/** /**
* ges_meta_container_get_double: * ges_meta_container_get_double:
* @container: Target container * @container: Target container
* @meta_item: Name of the meta item to get * @meta_item: Name of the meta item to get
* @dest: (out): Destination to which value of meta item will be copied * @dest: (out): Destination to which value of meta item will be copied
*
* Gets the value of a given meta item, returns NULL if @meta_item * Gets the value of a given meta item, returns NULL if @meta_item
* can not be found. * can not be found.
*/ */
@ -772,6 +781,7 @@ CREATE_GETTER (double, gdouble *);
* @container: Target container * @container: Target container
* @meta_item: Name of the meta item to get * @meta_item: Name of the meta item to get
* @dest: (out): Destination to which value of meta item will be copied * @dest: (out): Destination to which value of meta item will be copied
*
* Gets the value of a given meta item, returns %FALSE if @meta_item * Gets the value of a given meta item, returns %FALSE if @meta_item
* can not be found. * can not be found.
*/ */
@ -802,7 +812,8 @@ ges_meta_container_get_int64 (GESMetaContainer * container,
* @container: Target container * @container: Target container
* @meta_item: Name of the meta item to get * @meta_item: Name of the meta item to get
* @dest: (out): Destination to which value of meta item will be copied * @dest: (out): Destination to which value of meta item will be copied
* Gets the value of a given meta item, returns NULL if @meta_item *
* Gets the value of a given meta item, returns %FALSE if @meta_item
* can not be found. * can not be found.
*/ */
gboolean gboolean
@ -832,7 +843,8 @@ ges_meta_container_get_uint64 (GESMetaContainer * container,
* @container: Target container * @container: Target container
* @meta_item: Name of the meta item to get * @meta_item: Name of the meta item to get
* @dest: (out): Destination to which value of meta item will be copied * @dest: (out): Destination to which value of meta item will be copied
* Gets the value of a given meta item, returns FALSE if @meta_item *
* Gets the value of a given meta item, returns %FALSE if @meta_item
* can not be found. * can not be found.
*/ */
gboolean gboolean
@ -861,6 +873,7 @@ ges_meta_container_get_float (GESMetaContainer * container,
* ges_meta_container_get_string: * ges_meta_container_get_string:
* @container: Target container * @container: Target container
* @meta_item: Name of the meta item to get * @meta_item: Name of the meta item to get
*
* Gets the value of a given meta item, returns NULL if @meta_item * Gets the value of a given meta item, returns NULL if @meta_item
* can not be found. * can not be found.
*/ */
@ -906,6 +919,7 @@ ges_meta_container_get_meta (GESMetaContainer * container, const gchar * key)
* @container: Target container * @container: Target container
* @meta_item: Name of the meta item to get * @meta_item: Name of the meta item to get
* @dest: (out): Destination to which value of meta item will be copied * @dest: (out): Destination to which value of meta item will be copied
*
* Gets the value of a given meta item, returns NULL if @meta_item * Gets the value of a given meta item, returns NULL if @meta_item
* can not be found. * can not be found.
*/ */
@ -916,6 +930,7 @@ CREATE_GETTER (date, GDate **);
* @container: Target container * @container: Target container
* @meta_item: Name of the meta item to get * @meta_item: Name of the meta item to get
* @dest: (out): Destination to which value of meta item will be copied * @dest: (out): Destination to which value of meta item will be copied
*
* Gets the value of a given meta item, returns NULL if @meta_item * Gets the value of a given meta item, returns NULL if @meta_item
* can not be found. * can not be found.
*/ */