Struct gstreamer::element_factory::ElementBuilder

pub struct ElementBuilder<'a> { /* private fields */ }

Builder for Elements.

Implementations

impl<'a> ElementBuilder<'a>

pub fn name(self, name: impl Into<GString>) -> Self

Sets the name property to the given name.

pub fn name_if_some(self, name: Option<impl Into<GString>>) -> Self

Sets the name property to the given name if it is Some.

pub fn property(self, name: &'a str, value: impl Into<Value> + 'a) -> Self

Sets property name to the given value value.

Overrides any default or previously defined value for name.

pub fn property_if( self, name: &'a str, value: impl Into<Value> + 'a, predicate: bool, ) -> Self

Sets property name to the given inner value if the predicate evaluates to true.

This has no effect if the predicate evaluates to false, i.e. default or previous value for name is kept.

pub fn property_if_some( self, name: &'a str, value: Option<impl Into<Value> + 'a>, ) -> Self

Sets property name to the given inner value if value is Some.

This has no effect if the value is None, i.e. default or previous value for name is kept.

pub fn property_from_iter<V: ValueType + Into<Value> + FromIterator<SendValue>>( self, name: &'a str, iter: impl IntoIterator<Item = impl ToSendValue>, ) -> Self

Sets property name using the given ValueType V built from iter’s the Items.

Overrides any default or previously defined value for name.

pub fn property_if_not_empty<V: ValueType + Into<Value> + FromIterator<SendValue>>( self, name: &'a str, iter: impl IntoIterator<Item = impl ToSendValue>, ) -> Self

Sets property name using the given ValueType V built from iter’s Items, if iter` is not empty.

This has no effect if iter is empty, i.e. previous value for name is unchanged.

pub fn property_from_str(self, name: &'a str, value: &'a str) -> Self

Sets property name to the given string value value.

pub fn property_from_str_if_some( self, name: &'a str, value: Option<&'a str>, ) -> Self

Sets property name to the given string value value if it is Some.

pub fn build(self) -> Result<Element, BoolError>

Builds the element with the provided properties.

This fails if there is no such element factory or the element factory can’t be loaded.

Panics

This panics if the element is not instantiable, doesn’t have all the given properties or property values of the wrong type are provided.