:right-sidebar: True

PadLinkCheck
===================================================================

.. currentmodule:: gi.repository.Gst





.. class:: PadLinkCheck
   :no-contents-entry:






The amount of checking to be done when linking pads. ``GST_PAD_LINK_CHECK_CAPS``
and ``GST_PAD_LINK_CHECK_TEMPLATE_CAPS`` are mutually exclusive. If both are
specified, expensive but safe ``GST_PAD_LINK_CHECK_CAPS`` are performed.

> Only disable some of the checks if you are 100% certain you know the link
> will not fail because of hierarchy/caps compatibility failures. If uncertain,
> use the default checks (:const:`~gi.repository.Gst.PadLinkCheck.DEFAULT`) or the regular methods
> for linking the pads.













Fields
------

.. rst-class:: interim-class

.. class:: PadLinkCheck
   :no-index:
   

   .. attribute:: CAPS

      Check if the pads are compatible by comparing the
      caps returned by :func:`~gi.repository.Gst.Pad.query_caps`.







   .. attribute:: DEFAULT

      The default checks done when linking
      pads (i.e. the ones used by :func:`~gi.repository.Gst.Pad.link`).







   .. attribute:: HIERARCHY

      Check the pads have same parents/grandparents.
      Could be omitted if it is already known that the two elements that own the
      pads are in the same bin.







   .. attribute:: NOTHING

      Don't check hierarchy or caps compatibility.







   .. attribute:: NO_RECONFIGURE

      Disables pushing a reconfigure event when pads are
      linked.







   .. attribute:: TEMPLATE_CAPS

      Check if the pads are compatible by using
      their template caps. This is much faster than ``GST_PAD_LINK_CHECK_CAPS``, but
      would be unsafe e.g. if one pad has ``%GST_CAPS_ANY``.