:right-sidebar: True

DebugCategory
===================================================================

.. currentmodule:: gi.repository.Gst





.. class:: DebugCategory(*args, **kwargs)
   :no-contents-entry:






This is the struct that describes the categories. Once initialized with
``GST_DEBUG_CATEGORY_INIT``, its values can't be changed anymore.




Methods
-------

.. rst-class:: interim-class

.. class:: DebugCategory
   :no-index:


   .. method:: free() -> None

      Removes and frees the category and all associated resources.





      .. deprecated:: Unknown

         This function can easily cause memory corruption, don't use it.






   .. method:: get_color() -> int

      Returns the color of a debug category used when printing output in this
      category.









   .. method:: get_description() -> str

      Returns the description of a debug category.









   .. method:: get_name() -> str

      Returns the name of a debug category.









   .. method:: get_threshold() -> ~gi.repository.Gst.DebugLevel

      Returns the threshold of a :obj:`~gi.repository.Gst.DebugCategory`\.









   .. method:: reset_threshold() -> None

      Resets the threshold of the category to the default level. Debug information
      will only be output if the threshold is lower or equal to the level of the
      debugging message.
      Use this function to set the threshold back to where it was after using
      :func:`~gi.repository.Gst.DebugCategory.set_threshold`.









   .. method:: set_threshold(level: ~gi.repository.Gst.DebugLevel) -> None

      Sets the threshold of the category to the given level. Debug information will
      only be output if the threshold is lower or equal to the level of the
      debugging message.

          Do not use this function in production code, because other functions may
          change the threshold of categories as side effect. It is however a nice
          function to use when debugging (even from gdb).






      :param level: the :obj:`~gi.repository.Gst.DebugLevel` threshold to set.














Fields
------

.. rst-class:: interim-class

.. class:: DebugCategory
   :no-index:
   

   .. attribute:: color

      






   .. attribute:: description

      






   .. attribute:: name

      






   .. attribute:: threshold