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.CapsFeatures.newAny 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.

class CapsFeatures : Boxed {

static gst.caps_features.CapsFeatures newAny();

static gst.caps_features.CapsFeatures newEmpty();

static gst.caps_features.CapsFeatures newSingle(string feature);

void add(string feature);

void addId(glib.types.Quark feature);

bool contains(string feature);

bool containsId(glib.types.Quark feature);

gst.caps_features.CapsFeatures copy();

string getNth(uint i);

glib.types.Quark getNthId(uint i);

uint getSize();

bool isAny();

bool isEqual(gst.caps_features.CapsFeatures features2);

void remove(string feature);

void removeId(glib.types.Quark feature);

string toString_();

static gst.caps_features.CapsFeatures fromString(string features);

}

Members

Functions

add void add(string feature): Adds feature to features.
addId void addId(glib.types.Quark feature): Adds feature to features.
contains bool contains(string feature): Checks if features contains feature.
containsId bool containsId(glib.types.Quark feature): Checks if features contains feature.
copy gst.caps_features.CapsFeatures copy(): Duplicates a #GstCapsFeatures and all its values.
getNth string getNth(uint i): Returns the i-th feature of features.
getNthId glib.types.Quark getNthId(uint i): Returns the i-th feature of features.
getSize uint getSize(): Returns the number of features in features.
isAny bool isAny(): Checks if features is GST_CAPS_FEATURES_ANY.
isEqual bool isEqual(gst.caps_features.CapsFeatures features2): Checks if features1 and features2 are equal.
remove void remove(string feature): Removes feature from features.
removeId void removeId(glib.types.Quark feature): Removes feature from features.
toString_ string toString_(): Converts features to a human-readable string representation.

Static functions

fromString gst.caps_features.CapsFeatures fromString(string features): Creates a #GstCapsFeatures from a string representation.
newAny gst.caps_features.CapsFeatures newAny(): Creates a new, ANY #GstCapsFeatures. This will be equal to any other #GstCapsFeatures but caps with these are unfixed.
newEmpty gst.caps_features.CapsFeatures newEmpty(): Creates a new, empty #GstCapsFeatures.
newSingle gst.caps_features.CapsFeatures newSingle(string feature): Creates a new #GstCapsFeatures with a single feature.

Inherited Members

From Boxed

cInstancePtr void* cInstancePtr;: Pointer to the C boxed value
getType GType getType(): Get the GType of this boxed type.
gType GType gType [@property getter]: Boxed GType property.
self Boxed self(): Convenience method to return this cast to a type. For use in D with statements.
copy_ void* copy_(): Make a copy of the wrapped C boxed data.
boxedCopy void* boxedCopy(void* cBoxed): Copy a C boxed value using g_boxed_copy.
boxedFree void boxedFree(void* cBoxed): Free a C boxed value using g_boxed_free.

gst caps_features classes

CapsFeatures