tag_register
Description:
public void tag_register (
string name,
TagFlag flag,
Type type,
string nick,
string blurb,
TagMergeFunc func)
Registers a new tag type for the use with GStreamer's type system.
If a type with that name is already registered, that one is used. The old registration may have used a different type however. So don't rely
on your supplied values.
Important: if you do not supply a merge function the implication will be that there can only be one single value for this tag in a tag list and
any additional values will silenty be discarded when being added (unless
REPLACE,
REPLACE_ALL, or
PREPEND is used as merge mode, in which case the new value will
replace the old one in the list).
The merge function will be called from copy_value when it is
required that one or more values for a tag be condensed into one single value. This may happen from
get_string,
get_int,
get_double etc. What will happen exactly in that case depends on how
the tag was registered and if a merge function was supplied and if so which one.
Two default merge functions are provided: tag_merge_use_first and
tag_merge_strings_with_comma.
Parameters:
| name |
the name or identifier string |
| flag |
a flag describing the type of tag info |
| type |
the type this data is in |
| nick |
human-readable name |
| blurb |
a human-readable description about this tag |
| func |
function for merging multiple values of this tag, or NULL |