Struct gstreamer::caps::Caps

pub struct Caps { /* fields omitted */ }

Implementations

impl Caps

pub unsafe fn from_glib_none(ptr: *const GstCaps) -> Self

pub unsafe fn from_glib_full(ptr: *const GstCaps) -> Self

pub unsafe fn from_glib_borrow(ptr: *const GstCaps) -> Borrowed<Self>

pub unsafe fn replace_ptr(&mut self, ptr: *mut GstCaps)

pub fn make_mut(&mut self) -> &mut CapsRef

pub fn get_mut(&mut self) -> Option<&mut CapsRef>

pub fn is_writable(&self) -> bool

pub unsafe fn into_ptr(self) -> *mut GstCaps

impl Caps

pub fn builder(name: &str) -> Builder<NoFeature>

pub fn builder_full() -> BuilderFull<SomeFeatures>

pub fn builder_full_with_features(
    features: CapsFeatures
) -> BuilderFull<SomeFeatures>

pub fn builder_full_with_any_features() -> BuilderFull<AnyFeatures>

pub fn new_empty() -> Self

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

Returns

the new Caps

pub fn new_any() -> Self

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

Returns

the new Caps

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

Creates a new Caps that contains one Structure. The structure is defined by the arguments, which have the same format as 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 Caps

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

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

pub fn fixate(&mut self)

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 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 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)

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 Caps to merge in

Returns

the merged caps.

pub fn merge_structure(&mut self, structure: Structure)

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

structure

the Structure to merge

Returns

the merged caps.

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

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

structure

the Structure to merge

features

the CapsFeatures to merge

Returns

the merged caps.

pub fn normalize(&mut self)

Returns a 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 Caps::ref.

Returns

the normalized Caps

pub fn simplify(&mut self)

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 Caps::ref.

This method does not preserve the original order of self.

Returns

The simplified caps.

pub fn truncate(&mut self)

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

Returns

truncated caps

Methods from Deref<Target = CapsRef>

pub unsafe fn as_ptr(&self) -> *const GstCaps

pub unsafe fn as_mut_ptr(&self) -> *mut GstCaps

pub fn copy(&self) -> Caps

pub fn get_structure(&self, idx: u32) -> Option<&StructureRef>

pub fn get_features(&self, idx: u32) -> Option<&CapsFeaturesRef>

pub fn get_size(&self) -> u32

pub fn iter(&self) -> Iter<'_>

pub fn iter_with_features(&self) -> IterFeatures<'_>

pub fn can_intersect(&self, other: &Self) -> bool

pub fn intersect(&self, other: &Self) -> Caps

pub fn intersect_with_mode(&self, other: &Self, mode: CapsIntersectMode) -> Caps

pub fn is_always_compatible(&self, other: &Self) -> bool

pub fn is_any(&self) -> bool

pub fn is_empty(&self) -> bool

pub fn is_fixed(&self) -> bool

pub fn is_equal_fixed(&self, other: &Self) -> bool

pub fn is_strictly_equal(&self, other: &Self) -> bool

pub fn is_subset(&self, superset: &Self) -> bool

pub fn is_subset_structure(&self, structure: &StructureRef) -> bool

pub fn is_subset_structure_full(
    &self,
    structure: &StructureRef,
    features: Option<&CapsFeaturesRef>
) -> bool

pub fn subtract(&self, other: &Self) -> Caps

Trait Implementations

impl AsRef<CapsRef> for Caps

fn as_ref(&self) -> &CapsRef

Performs the conversion.

impl Borrow<CapsRef> for Caps

fn borrow(&self) -> &CapsRef

Immutably borrows from an owned value.

impl Clone for Caps

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Caps

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for Caps

type Target = CapsRef

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'de> Deserialize<'de> for Caps

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for Caps

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for Caps

fn drop(&mut self)

Executes the destructor for this type.

impl Eq for Caps

impl FromGlibContainerAsVec<*mut GstCaps, *const *mut GstCaps> for Caps

unsafe fn from_glib_none_num_as_vec(
    ptr: *const *mut GstCaps,
    num: usize
) -> Vec<Self>

unsafe fn from_glib_container_num_as_vec(
    _: *const *mut GstCaps,
    _: usize
) -> Vec<Self>

unsafe fn from_glib_full_num_as_vec(
    _: *const *mut GstCaps,
    _: usize
) -> Vec<Self>

impl FromGlibContainerAsVec<*mut GstCaps, *mut *mut GstCaps> for Caps

unsafe fn from_glib_none_num_as_vec(
    ptr: *mut *mut GstCaps,
    num: usize
) -> Vec<Self>

unsafe fn from_glib_container_num_as_vec(
    ptr: *mut *mut GstCaps,
    num: usize
) -> Vec<Self>

unsafe fn from_glib_full_num_as_vec(
    ptr: *mut *mut GstCaps,
    num: usize
) -> Vec<Self>

impl FromGlibPtrArrayContainerAsVec<*mut GstCaps, *const *mut GstCaps> for Caps

unsafe fn from_glib_none_as_vec(ptr: *const *mut GstCaps) -> Vec<Self>

unsafe fn from_glib_container_as_vec(_: *const *mut GstCaps) -> Vec<Self>

unsafe fn from_glib_full_as_vec(_: *const *mut GstCaps) -> Vec<Self>

impl FromGlibPtrArrayContainerAsVec<*mut GstCaps, *mut *mut GstCaps> for Caps

unsafe fn from_glib_none_as_vec(ptr: *mut *mut GstCaps) -> Vec<Self>

unsafe fn from_glib_container_as_vec(ptr: *mut *mut GstCaps) -> Vec<Self>

unsafe fn from_glib_full_as_vec(ptr: *mut *mut GstCaps) -> Vec<Self>

impl FromGlibPtrBorrow<*const GstCaps> for Caps

unsafe fn from_glib_borrow(ptr: *const GstCaps) -> Borrowed<Self>

Safety

impl FromGlibPtrBorrow<*mut GstCaps> for Caps

unsafe fn from_glib_borrow(ptr: *mut GstCaps) -> Borrowed<Self>

Safety

impl FromGlibPtrFull<*const GstCaps> for Caps

unsafe fn from_glib_full(ptr: *const GstCaps) -> Self

Safety

impl FromGlibPtrFull<*mut GstCaps> for Caps

unsafe fn from_glib_full(ptr: *mut GstCaps) -> Self

Safety

impl FromGlibPtrNone<*const GstCaps> for Caps

unsafe fn from_glib_none(ptr: *const GstCaps) -> Self

Safety

impl FromGlibPtrNone<*mut GstCaps> for Caps

unsafe fn from_glib_none(ptr: *mut GstCaps) -> Self

Safety

impl FromStr for Caps

type Err = BoolError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, BoolError>

Parses a string s to return a value of this type.

impl<'a> FromValueOptional<'a> for Caps

unsafe fn from_value_optional(v: &'a Value) -> Option<Self>

Safety

impl GlibPtrDefault for Caps

type GlibType = *mut GstCaps

impl PartialEq<Caps> for Caps

fn eq(&self, other: &Caps) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl Send for Caps

impl Serialize for Caps

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl SetValue for Caps

unsafe fn set_value(v: &mut Value, s: &Self)

Safety

impl SetValueOptional for Caps

unsafe fn set_value_optional(v: &mut Value, s: Option<&Self>)

Safety

impl StaticType for Caps

fn static_type() -> Type

Returns the type identifier of Self.

impl Sync for Caps

impl<'a> ToGlibContainerFromSlice<'a, *const *mut GstCaps> for Caps

type Storage = (Vec<Stash<'a, *mut GstCaps, Caps>>, Option<Vec<*mut GstCaps>>)

fn to_glib_none_from_slice(
    t: &'a [Caps]
) -> (*const *mut GstCaps, Self::Storage)

fn to_glib_container_from_slice(
    _: &'a [Caps]
) -> (*const *mut GstCaps, Self::Storage)

fn to_glib_full_from_slice(_: &[Caps]) -> *const *mut GstCaps

impl<'a> ToGlibContainerFromSlice<'a, *mut *mut GstCaps> for Caps

type Storage = (Vec<Stash<'a, *mut GstCaps, Self>>, Option<Vec<*mut GstCaps>>)

fn to_glib_none_from_slice(t: &'a [Caps]) -> (*mut *mut GstCaps, Self::Storage)

fn to_glib_container_from_slice(
    t: &'a [Caps]
) -> (*mut *mut GstCaps, Self::Storage)

fn to_glib_full_from_slice(t: &[Caps]) -> *mut *mut GstCaps

impl<'a> ToGlibPtr<'a, *const GstCaps> for Caps

type Storage = &'a Self

fn to_glib_none(&'a self) -> Stash<'a, *const GstCaps, Self>

Transfer: none.

fn to_glib_full(&self) -> *const GstCaps

Transfer: full.

fn to_glib_container(&'a self) -> Stash<'a, P, Self>

Transfer: container.

impl<'a> ToGlibPtr<'a, *mut GstCaps> for Caps

type Storage = &'a Self

fn to_glib_none(&'a self) -> Stash<'a, *mut GstCaps, Self>

Transfer: none.

fn to_glib_full(&self) -> *mut GstCaps

Transfer: full.

fn to_glib_container(&'a self) -> Stash<'a, P, Self>

Transfer: container.

impl<'a> ToGlibPtrMut<'a, *mut GstCaps> for Caps

type Storage = &'a mut Self

fn to_glib_none_mut(&'a mut self) -> StashMut<'_, *mut GstCaps, Self>

Transfer: none.