:right-sidebar: True

TagMergeMode
===================================================================

.. currentmodule:: gi.repository.Gst





.. class:: TagMergeMode
   :no-contents-entry:






The different tag merging modes are basically replace, overwrite and append,
but they can be seen from two directions. Given two taglists: (A) the tags
already in the element and (B) the ones that are supplied to the element (
e.g. via :func:`~gi.repository.Gst.TagSetter.merge_tags` / :func:`~gi.repository.Gst.TagSetter.add_tags` or a
:const:`~gi.repository.Gst.EventType.TAG`), how are these tags merged?
In the table below this is shown for the cases that a tag exists in the list
(A) or does not exists (!A) and combinations thereof.

.. list-table::

    * - merge mode
      - A + B
      - A + !B
      - !A + B
      - !A + !B
    * - -----------
      - -----
      - ------
      - ------
      - -------
    * - REPLACE_ALL
      - B
      - ø
      - B
      - ø
    * - REPLACE
      - B
      - A
      - B
      - ø
    * - APPEND
      - A, B
      - A
      - B
      - ø
    * - PREPEND
      - B, A
      - A
      - B
      - ø
    * - KEEP
      - A
      - A
      - B
      - ø
    * - KEEP_ALL
      - A
      - A
      - ø
      - ø












Fields
------

.. rst-class:: interim-class

.. class:: TagMergeMode
   :no-index:
   

   .. attribute:: APPEND

      The type of the None singleton.







   .. attribute:: COUNT

      The type of the None singleton.







   .. attribute:: KEEP

      The type of the None singleton.







   .. attribute:: KEEP_ALL

      The type of the None singleton.







   .. attribute:: PREPEND

      The type of the None singleton.







   .. attribute:: REPLACE

      The type of the None singleton.







   .. attribute:: REPLACE_ALL

      The type of the None singleton.







   .. attribute:: UNDEFINED

      The type of the None singleton.