CapsFeatures

#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".

Constructors

this this(GstCapsFeatures* gstCapsFeatures): Sets our main struct and passes it to the parent class.
this this(): Creates a new, empty #GstCapsFeatures.
this this(GQuark feature1, void* varargs): Creates a new #GstCapsFeatures with the given features.
this this(string feature1, void* varargs): Creates a new #GstCapsFeatures with the given features.

Members

Functions

add void add(string feature): Adds @feature to @features.
addId void addId(GQuark feature): Adds @feature to @features.
contains bool contains(string feature): Check if @features contains @feature.
containsId bool containsId(GQuark feature): Check if @features contains @feature.
copy CapsFeatures copy(): Duplicates a #GstCapsFeatures and all its values.
free void free(): Frees a #GstCapsFeatures and all its values. The caps features must not have a parent when this function is called.
getCapsFeaturesStruct GstCapsFeatures* getCapsFeaturesStruct(): Get the main Gtk struct
getNth string getNth(uint i): Returns the @i-th feature of @features.
getNthId GQuark getNthId(uint i): Returns the @i-th feature of @features.
getSize uint getSize(): Returns the number of features in @features.
getStruct void* getStruct(): the main Gtk struct as a void*
isAny bool isAny(): Check if @features is %GST_CAPS_FEATURES_ANY.
isEqual bool isEqual(CapsFeatures features2): Check if @features1 and @features2 are equal.
remove void remove(string feature): Removes @feature from @features.
removeId void removeId(GQuark feature): Removes @feature from @features.
setParentRefcount bool setParentRefcount(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 section of the design documents.
toString string toString(): Converts @features to a human-readable string representation.

Static functions

fromString CapsFeatures fromString(string features): Creates a #GstCapsFeatures from a string representation.
getType GType getType()
newAny newAny(): Creates a new, ANY #GstCapsFeatures. This will be equal to any other #GstCapsFeatures but caps with these are unfixed.

Variables

gstCapsFeatures GstCapsFeatures* gstCapsFeatures;: the main Gtk struct