Struct gstreamer::caps::Caps[−][src]

pub struct Caps { /* fields omitted */ }

Implementations

Creates a new crate::Caps that is empty. That is, the returned crate::Caps contains no media formats. The crate::Caps is guaranteed to be writable. Caller is responsible for unreffing the returned caps.

Returns

the new crate::Caps

`pub fn new_any() -> Self`[src]

Creates a new crate::Caps that indicates that it is compatible with any media format.

Returns

the new crate::Caps

`pub fn new_simple( name: &str, values: &[(&str, &(dyn ToSendValue + Sync))] ) -> Self`[src]

Creates a new crate::Caps that contains one crate::Structure. The structure is defined by the arguments, which have the same format as crate::Structure::new(). Caller is responsible for unreffing the returned caps.

`media_type`

the media type of the structure

`fieldname`

first field to set

Returns

the new crate::Caps

`pub fn from_iter<'a, I>(iter: I) -> Self where I: IntoIterator<Item = &'a StructureRef>,` [src]

`pub fn from_iter_with_features<'a, 'b, I>(iter: I) -> Self where I: IntoIterator<Item = (&'a StructureRef, &'b CapsFeaturesRef)>,` [src]

`pub fn fixate(&mut self)`[src]

Modifies the given self into a representation with only fixed values. First the caps will be truncated and then the first structure will be fixated with [crate::Structure::fixate()].

This function takes ownership of self and will call gst_caps_make_writable() on it so you must not use self afterwards unless you keep an additional reference to it with gst_caps_ref().

Note that it is not guaranteed that the returned caps have exactly one structure. If self are empty caps then then returned caps will be the empty too and contain no structure at all.

Calling this function with any caps is not allowed.

Returns

the fixated caps

`pub fn merge(&mut self, other: Self)`[src]

Appends the structures contained in caps2 to self if they are not yet expressed by self. The structures in caps2 are not copied – they are transferred to a writable copy of self, and then caps2 is freed. If either caps is ANY, the resulting caps will be ANY.

`caps2`

the crate::Caps to merge in

Returns

the merged caps.

`pub fn merge_structure(&mut self, structure: Structure)`[src]

Appends structure to self if its not already expressed by self.

`structure`

the crate::Structure to merge

Returns

the merged caps.

`pub fn merge_structure_full( &mut self, structure: Structure, features: Option<CapsFeatures> )`[src]

Appends structure with features to self if its not already expressed by self.

`structure`

the crate::Structure to merge

`features`

the crate::CapsFeatures to merge

Returns

the merged caps.

`pub fn normalize(&mut self)`[src]

Returns a crate::Caps that represents the same set of formats as self, but contains no lists. Each list is expanded into separate GstStructures.

This function takes ownership of self and will call gst_caps_make_writable() on it so you must not use self afterwards unless you keep an additional reference to it with gst_caps_ref().

Returns

the normalized crate::Caps

`pub fn simplify(&mut self)`[src]

Converts the given self into a representation that represents the same set of formats, but in a simpler form. Component structures that are identical are merged. Component structures that have values that can be merged are also merged.

This function takes ownership of self and will call gst_caps_make_writable() on it if necessary, so you must not use self afterwards unless you keep an additional reference to it with gst_caps_ref().

This method does not preserve the original order of self.

Returns

The simplified caps.

`pub fn truncate(&mut self)`[src]

Discard all but the first structure from self. Useful when fixating.

This function takes ownership of self and will call gst_caps_make_writable() on it if necessary, so you must not use self afterwards unless you keep an additional reference to it with gst_caps_ref().

Note that it is not guaranteed that the returned caps have exactly one structure. If self is any or empty caps then then returned caps will be the same and contain no structure at all.