register
Description:
public void 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 silently 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 list_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: merge_use_first and 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 |