Klasse CapsFeatures

Alle implementierten Schnittstellen:
PointerInterface

public class CapsFeatures extends Record
#GstCapsFeatures can optionally be set on a #GstCaps to add requirements
for additional features for a specific #GstStructure. Caps structures with
the same name but with a non-equal set of caps features are not compatible.
If a pad supports multiple sets of features it has to add multiple equal
structures with different feature sets to the caps.

Empty #GstCapsFeatures are equivalent with the #GstCapsFeatures that only
contain #GST_CAPS_FEATURE_MEMORY_SYSTEM_MEMORY. ANY #GstCapsFeatures as
created by gst_caps_features_new_any() are equal to any other #GstCapsFeatures
and can be used to specify that any #GstCapsFeatures would be supported, e.g.
for elements that don't touch buffer memory. #GstCaps with ANY #GstCapsFeatures
are considered non-fixed and during negotiation some #GstCapsFeatures have
to be selected.

Examples for caps features would be the requirement of a specific #GstMemory
types or the requirement of having a specific #GstMeta on the buffer. Features
are given as a string of the format `memory:GstMemoryTypeName` or
`meta:GstMetaAPIName`.

https://gstreamer.freedesktop.org/documentation/gstreamer/gi-index.html

  • Konstruktordetails

    • CapsFeatures

      public CapsFeatures(PointerContainer pointer)
    • CapsFeatures

      public CapsFeatures(@Nonnull Str feature1, Object... _ellipsis)
      Creates a new #GstCapsFeatures with the given features.
      The last argument must be %NULL.
      Parameter:
      feature1 - name of first feature to set
      _ellipsis - additional features
    • CapsFeatures

      public CapsFeatures(String feature1, Object... _ellipsis)
      Creates a new #GstCapsFeatures with the given features.
      The last argument must be %NULL.
      Parameter:
      feature1 - name of first feature to set
      _ellipsis - additional features
  • Methodendetails

    • getClassHandler

      public static ClassHandler getClassHandler()
    • newAnyCapsFeatures

      public static CapsFeatures newAnyCapsFeatures()
      Creates a new, ANY #GstCapsFeatures. This will be equal
      to any other #GstCapsFeatures but caps with these are
      unfixed.
      Gibt zurück:
      a new, ANY #GstCapsFeatures
    • newEmptyCapsFeatures

      public static CapsFeatures newEmptyCapsFeatures()
      Creates a new, empty #GstCapsFeatures.
      Gibt zurück:
      a new, empty #GstCapsFeatures
    • newIdCapsFeatures

      @Deprecated public static CapsFeatures newIdCapsFeatures(int feature1, Object... _ellipsis)
      Veraltet.
      Creates a new #GstCapsFeatures with the given features.
      The last argument must be 0.
      Parameter:
      feature1 - name of first feature to set
      _ellipsis - additional features
      Gibt zurück:
      a new, empty #GstCapsFeatures
    • newIdStrCapsFeatures

      public static CapsFeatures newIdStrCapsFeatures(@Nonnull IdStr feature1, Object... _ellipsis)
      Creates a new #GstCapsFeatures with the given features.
      The last argument must be 0.
      Parameter:
      feature1 - name of first feature to set
      _ellipsis - additional features
      Gibt zurück:
      a new, empty #GstCapsFeatures
    • newSingleCapsFeatures

      public static CapsFeatures newSingleCapsFeatures(@Nonnull Str feature)
      Creates a new #GstCapsFeatures with a single feature.
      Parameter:
      feature - The feature
      Gibt zurück:
      a new #GstCapsFeatures
    • newSingleCapsFeatures

      public static CapsFeatures newSingleCapsFeatures(String feature)
      Creates a new #GstCapsFeatures with a single feature.
      Parameter:
      feature - The feature
      Gibt zurück:
      a new #GstCapsFeatures
    • newSingleStaticStrCapsFeatures

      public static CapsFeatures newSingleStaticStrCapsFeatures(@Nonnull Str feature)
      Creates a new #GstCapsFeatures with a single feature.

      @feature needs to be valid for the remaining lifetime of the process, e.g. has
      to be a static string.
      Parameter:
      feature - The feature
      Gibt zurück:
      a new #GstCapsFeatures
    • newSingleStaticStrCapsFeatures

      public static CapsFeatures newSingleStaticStrCapsFeatures(String feature)
      Creates a new #GstCapsFeatures with a single feature.

      @feature needs to be valid for the remaining lifetime of the process, e.g. has
      to be a static string.
      Parameter:
      feature - The feature
      Gibt zurück:
      a new #GstCapsFeatures
    • newStaticStrCapsFeatures

      public static CapsFeatures newStaticStrCapsFeatures(@Nonnull Str feature1, Object... _ellipsis)
      Creates a new #GstCapsFeatures with the given features.
      The last argument must be %NULL.

      @feature1 and all other features need to be valid for the remaining lifetime
      of the process, e.g. have to be a static string.
      Parameter:
      feature1 - name of first feature to set
      _ellipsis - additional features
      Gibt zurück:
      a new, empty #GstCapsFeatures
    • newStaticStrCapsFeatures

      public static CapsFeatures newStaticStrCapsFeatures(String feature1, Object... _ellipsis)
      Creates a new #GstCapsFeatures with the given features.
      The last argument must be %NULL.

      @feature1 and all other features need to be valid for the remaining lifetime
      of the process, e.g. have to be a static string.
      Parameter:
      feature1 - name of first feature to set
      _ellipsis - additional features
      Gibt zurück:
      a new, empty #GstCapsFeatures
    • add

      public void add(@Nonnull Str feature)
      Adds @feature to @features.
      Parameter:
      feature - a feature.
    • add

      public void add(String feature)
      Adds @feature to @features.
      Parameter:
      feature - a feature.
    • addId

      @Deprecated public void addId(int feature)
      Veraltet.
      Adds @feature to @features.
      Parameter:
      feature - a feature.
    • addIdStr

      public void addIdStr(@Nonnull IdStr feature)
      Adds @feature to @features.
      Parameter:
      feature - a feature.
    • addStaticStr

      public void addStaticStr(@Nonnull Str feature)
      Adds @feature to @features.

      @feature needs to be valid for the remaining lifetime of the process, e.g. has
      to be a static string.
      Parameter:
      feature - a feature.
    • addStaticStr

      public void addStaticStr(String feature)
      Adds @feature to @features.

      @feature needs to be valid for the remaining lifetime of the process, e.g. has
      to be a static string.
      Parameter:
      feature - a feature.
    • contains

      public boolean contains(@Nonnull Str feature)
      Checks if @features contains @feature.
      Parameter:
      feature - a feature
      Gibt zurück:
      %TRUE if @features contains @feature.
    • contains

      public boolean contains(String feature)
      Checks if @features contains @feature.
      Parameter:
      feature - a feature
      Gibt zurück:
      %TRUE if @features contains @feature.
    • containsId

      @Deprecated public boolean containsId(int feature)
      Veraltet.
      Checks if @features contains @feature.
      Parameter:
      feature - a feature
      Gibt zurück:
      %TRUE if @features contains @feature.
    • containsIdStr

      public boolean containsIdStr(@Nonnull IdStr feature)
      Checks if @features contains @feature.
      Parameter:
      feature - a feature
      Gibt zurück:
      %TRUE if @features contains @feature.
    • copy

      public CapsFeatures copy()
      Duplicates a #GstCapsFeatures and all its values.
      Gibt zurück:
      a new #GstCapsFeatures.
    • free

      public void free()
      Frees a #GstCapsFeatures and all its values. The caps features must not
      have a parent when this function is called.
    • getNth

      public Str getNth(int i)
      Returns the @i-th feature of @features.
      Parameter:
      i - index of the feature
      Gibt zurück:
      The @i-th feature of @features.
    • getNthId

      @Deprecated public int getNthId(int i)
      Veraltet.
      Returns the @i-th feature of @features.
      Parameter:
      i - index of the feature
      Gibt zurück:
      The @i-th feature of @features.
    • getNthIdStr

      public IdStr getNthIdStr(int i)
      Returns the @i-th feature of @features.
      Parameter:
      i - index of the feature
      Gibt zurück:
      The @i-th feature of @features.
    • getSize

      public int getSize()
      Returns the number of features in @features.
      Gibt zurück:
      The number of features in @features.
    • isAny

      public boolean isAny()
      Checks if @features is %GST_CAPS_FEATURES_ANY.
      Gibt zurück:
      %TRUE if @features is %GST_CAPS_FEATURES_ANY.
    • isEqual

      public boolean isEqual(@Nonnull CapsFeatures features2)
      Checks if @features1 and @features2 are equal.
      Parameter:
      features2 - a #GstCapsFeatures.
      Gibt zurück:
      %TRUE if @features1 and @features2 are equal.
    • remove

      public void remove(@Nonnull Str feature)
      Removes @feature from @features.
      Parameter:
      feature - a feature.
    • remove

      public void remove(String feature)
      Removes @feature from @features.
      Parameter:
      feature - a feature.
    • removeId

      @Deprecated public void removeId(int feature)
      Veraltet.
      Removes @feature from @features.
      Parameter:
      feature - a feature.
    • removeIdStr

      public void removeIdStr(@Nonnull IdStr feature)
      Removes @feature from @features.
      Parameter:
      feature - a feature.
    • setParentRefcount

      public boolean setParentRefcount(@Nonnull Int refcount)
      Sets the parent_refcount field of #GstCapsFeatures. This field is used to
      determine whether a caps features is mutable or not. This function should only be
      called by code implementing parent objects of #GstCapsFeatures, as described in
      [the MT refcounting design document](additional/design/MT-refcounting.md).
      Parameter:
      refcount - a pointer to the parent's refcount
      Gibt zurück:
      %TRUE if the parent refcount could be set.
    • toStr

      public Str toStr()
      Converts @features to a human-readable string representation.

      For debugging purposes its easier to do something like this:

      ``` C
      GST_LOG ("features is %" GST_PTR_FORMAT, features);
      ```

      This prints the features in human readable form.
      Gibt zurück:
      a pointer to string allocated by g_malloc().
    • fromString

      public static CapsFeatures fromString(@Nonnull Str features)
      Creates a #GstCapsFeatures from a string representation.
      Parameter:
      features - a string representation of a #GstCapsFeatures.
      Gibt zurück:
      a new #GstCapsFeatures or %NULL when the string could not be parsed.
    • getTypeID

      public static long getTypeID()
    • getParentTypeID

      public static long getParentTypeID()
    • getTypeSize

      public static TypeSystem.TypeSize getTypeSize()
    • getParentTypeSize

      public static TypeSystem.TypeSize getParentTypeSize()
    • getInstanceSize

      public static int getInstanceSize()