Struct gstreamer_app::AppSink[][src]

pub struct AppSink(_);

Appsink is a sink plugin that supports many different methods for making the application get a handle on the GStreamer data in a pipeline. Unlike most GStreamer elements, Appsink provides external API functions.

appsink can be used by linking to the gstappsink.h header file to access the methods or by using the appsink action signals and properties.

The normal way of retrieving samples from appsink is by using the Self::pull_sample() and Self::pull_preroll() methods. These methods block until a sample becomes available in the sink or when the sink is shut down or reaches EOS. There are also timed variants of these methods, Self::try_pull_sample() and Self::try_pull_preroll(), which accept a timeout parameter to limit the amount of time to wait.

Appsink will internally use a queue to collect buffers from the streaming thread. If the application is not pulling samples fast enough, this queue will consume a lot of memory over time. The “max-buffers” property can be used to limit the queue size. The “drop” property controls whether the streaming thread blocks or if older buffers are dropped when the maximum queue size is reached. Note that blocking the streaming thread can negatively affect real-time performance and should be avoided.

If a blocking behaviour is not desirable, setting the “emit-signals” property to true will make appsink emit the “new-sample” and “new-preroll” signals when a sample can be pulled without blocking.

The “caps” property on appsink can be used to control the formats that appsink can receive. This property can contain non-fixed caps, the format of the pulled samples can be obtained by getting the sample caps.

If one of the pull-preroll or pull-sample methods return None, the appsink is stopped or in the EOS state. You can check for the EOS state with the “eos” property or with the Self::is_eos() method.

The eos signal can also be used to be informed when the EOS state is reached to avoid polling.

Implements

gst::prelude::ElementExt, gst::prelude::ObjectExt, trait@glib::object::ObjectExt, gst::prelude::URIHandlerExt

Implementations

impl AppSink[src]

pub fn is_buffer_list_support(&self) -> bool[src]

This is supported on crate feature v1_12 only.

Check if self supports buffer lists.

Returns

true if self supports buffer lists.

pub fn caps(&self) -> Option<Caps>[src]

Get the configured caps on self.

Returns

the crate::gst::Caps accepted by the sink. gst_caps_unref() after usage.

pub fn is_drop(&self) -> bool[src]

Check if self will drop old buffers when the maximum amount of queued buffers is reached.

Returns

true if self is dropping old buffers when the queue is filled.

pub fn emits_signals(&self) -> bool[src]

Check if appsink will emit the “new-preroll” and “new-sample” signals.

Returns

true if self is emitting the “new-preroll” and “new-sample” signals.

pub fn max_buffers(&self) -> u32[src]

Get the maximum amount of buffers that can be queued in self.

Returns

The maximum amount of buffers that can be queued.

pub fn is_wait_on_eos(&self) -> bool[src]

Check if self will wait for all buffers to be consumed when an EOS is received.

Returns

true if self will wait for all buffers to be consumed when an EOS is received.

pub fn is_eos(&self) -> bool[src]

Check if self is EOS, which is when no more samples can be pulled because an EOS event was received.

This function also returns true when the appsink is not in the PAUSED or PLAYING state.

Returns

true if no more samples can be pulled and the appsink is EOS.

pub fn pull_preroll(&self) -> Result<Sample, BoolError>[src]

Get the last preroll sample in self. This was the sample that caused the appsink to preroll in the PAUSED state.

This function is typically used when dealing with a pipeline in the PAUSED state. Calling this function after doing a seek will give the sample right after the seek position.

Calling this function will clear the internal reference to the preroll buffer.

Note that the preroll sample will also be returned as the first sample when calling Self::pull_sample().

If an EOS event was received before any buffers, this function returns None. Use gst_app_sink_is_eos () to check for the EOS condition.

This function blocks until a preroll sample or EOS is received or the appsink element is set to the READY/NULL state.

Returns

a crate::gst::Sample or NULL when the appsink is stopped or EOS. Call gst_sample_unref() after usage.

pub fn pull_sample(&self) -> Result<Sample, BoolError>[src]

This function blocks until a sample or EOS becomes available or the appsink element is set to the READY/NULL state.

This function will only return samples when the appsink is in the PLAYING state. All rendered buffers will be put in a queue so that the application can pull samples at its own rate. Note that when the application does not pull samples fast enough, the queued buffers could consume a lot of memory, especially when dealing with raw video frames.

If an EOS event was received before any buffers, this function returns None. Use gst_app_sink_is_eos () to check for the EOS condition.

Returns

a crate::gst::Sample or NULL when the appsink is stopped or EOS. Call gst_sample_unref() after usage.

pub fn set_buffer_list_support(&self, enable_lists: bool)[src]

This is supported on crate feature v1_12 only.

Instruct self to enable or disable buffer list support.

For backwards-compatibility reasons applications need to opt in to indicate that they will be able to handle buffer lists.

enable_lists

enable or disable buffer list support

pub fn set_caps(&self, caps: Option<&Caps>)[src]

Set the capabilities on the appsink element. This function takes a copy of the caps structure. After calling this method, the sink will only accept caps that match caps. If caps is non-fixed, or incomplete, you must check the caps on the samples to get the actual used caps.

caps

caps to set

pub fn set_drop(&self, drop: bool)[src]

Instruct self to drop old buffers when the maximum amount of queued buffers is reached.

drop

the new state

pub fn set_emit_signals(&self, emit: bool)[src]

Make appsink emit the “new-preroll” and “new-sample” signals. This option is by default disabled because signal emission is expensive and unneeded when the application prefers to operate in pull mode.

emit

the new state

pub fn set_max_buffers(&self, max: u32)[src]

Set the maximum amount of buffers that can be queued in self. After this amount of buffers are queued in appsink, any more buffers will block upstream elements until a sample is pulled from self.

max

the maximum number of buffers to queue

pub fn set_wait_on_eos(&self, wait: bool)[src]

Instruct self to wait for all buffers to be consumed when an EOS is received.

wait

the new state

pub fn try_pull_preroll(&self, timeout: ClockTime) -> Option<Sample>[src]

This is supported on crate feature v1_10 only.

Get the last preroll sample in self. This was the sample that caused the appsink to preroll in the PAUSED state.

This function is typically used when dealing with a pipeline in the PAUSED state. Calling this function after doing a seek will give the sample right after the seek position.

Calling this function will clear the internal reference to the preroll buffer.

Note that the preroll sample will also be returned as the first sample when calling Self::pull_sample().

If an EOS event was received before any buffers or the timeout expires, this function returns None. Use gst_app_sink_is_eos () to check for the EOS condition.

This function blocks until a preroll sample or EOS is received, the appsink element is set to the READY/NULL state, or the timeout expires.

timeout

the maximum amount of time to wait for the preroll sample

Returns

a crate::gst::Sample or NULL when the appsink is stopped or EOS or the timeout expires. Call gst_sample_unref() after usage.

pub fn try_pull_sample(&self, timeout: ClockTime) -> Option<Sample>[src]

This is supported on crate feature v1_10 only.

This function blocks until a sample or EOS becomes available or the appsink element is set to the READY/NULL state or the timeout expires.

This function will only return samples when the appsink is in the PLAYING state. All rendered buffers will be put in a queue so that the application can pull samples at its own rate. Note that when the application does not pull samples fast enough, the queued buffers could consume a lot of memory, especially when dealing with raw video frames.

If an EOS event was received before any buffers or the timeout expires, this function returns None. Use gst_app_sink_is_eos () to check for the EOS condition.

timeout

the maximum amount of time to wait for a sample

Returns

a crate::gst::Sample or NULL when the appsink is stopped or EOS or the timeout expires. Call gst_sample_unref() after usage.

pub fn is_buffer_list(&self) -> bool[src]

pub fn set_buffer_list(&self, buffer_list: bool)[src]

pub fn connect_eos<F: Fn(&AppSink) + Send + 'static>(
    &self,
    f: F
) -> SignalHandlerId
[src]

Signal that the end-of-stream has been reached. This signal is emitted from the streaming thread.

pub fn connect_new_preroll<F: Fn(&AppSink) -> Result<FlowSuccess, FlowError> + Send + 'static>(
    &self,
    f: F
) -> SignalHandlerId
[src]

Signal that a new preroll sample is available.

This signal is emitted from the streaming thread and only when the “emit-signals” property is true.

The new preroll sample can be retrieved with the “pull-preroll” action signal or Self::pull_preroll() either from this signal callback or from any other thread.

Note that this signal is only emitted when the “emit-signals” property is set to true, which it is not by default for performance reasons.

pub fn connect_new_sample<F: Fn(&AppSink) -> Result<FlowSuccess, FlowError> + Send + 'static>(
    &self,
    f: F
) -> SignalHandlerId
[src]

Signal that a new sample is available.

This signal is emitted from the streaming thread and only when the “emit-signals” property is true.

The new sample can be retrieved with the “pull-sample” action signal or Self::pull_sample() either from this signal callback or from any other thread.

Note that this signal is only emitted when the “emit-signals” property is set to true, which it is not by default for performance reasons.

pub fn connect_buffer_list_notify<F: Fn(&AppSink) + Send + Sync + 'static>(
    &self,
    f: F
) -> SignalHandlerId
[src]

pub fn connect_caps_notify<F: Fn(&AppSink) + Send + Sync + 'static>(
    &self,
    f: F
) -> SignalHandlerId
[src]

pub fn connect_drop_notify<F: Fn(&AppSink) + Send + Sync + 'static>(
    &self,
    f: F
) -> SignalHandlerId
[src]

pub fn connect_emit_signals_notify<F: Fn(&AppSink) + Send + Sync + 'static>(
    &self,
    f: F
) -> SignalHandlerId
[src]

pub fn connect_eos_notify<F: Fn(&AppSink) + Send + Sync + 'static>(
    &self,
    f: F
) -> SignalHandlerId
[src]

pub fn connect_max_buffers_notify<F: Fn(&AppSink) + Send + Sync + 'static>(
    &self,
    f: F
) -> SignalHandlerId
[src]

pub fn connect_wait_on_eos_notify<F: Fn(&AppSink) + Send + Sync + 'static>(
    &self,
    f: F
) -> SignalHandlerId
[src]

impl AppSink[src]

pub fn set_callbacks(&self, callbacks: AppSinkCallbacks)[src]

Set callbacks which will be executed for each new preroll, new sample and eos. This is an alternative to using the signals, it has lower overhead and is thus less expensive, but also less flexible.

If callbacks are installed, no signals will be emitted for performance reasons.

Before 1.16.3 it was not possible to change the callbacks in a thread-safe way.

callbacks

the callbacks

user_data

a user_data argument for the callbacks

notify

a destroy notify function

pub fn stream(&self) -> AppSinkStream[src]

Trait Implementations

impl Clone for AppSink[src]

fn clone(&self) -> AppSink[src]

Returns a copy of the value. Read more

fn clone_from(&mut self, source: &Self)1.0.0[src]

Performs copy-assignment from source. Read more

impl Debug for AppSink[src]

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

Formats the value using the given formatter. Read more

impl Hash for AppSink[src]

fn hash<__H: Hasher>(&self, state: &mut __H)[src]

Feeds this value into the given Hasher. Read more

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher
1.3.0[src]

Feeds a slice of this type into the given Hasher. Read more

impl Ord for AppSink[src]

fn cmp(&self, other: &AppSink) -> Ordering[src]

This method returns an Ordering between self and other. Read more

#[must_use]
fn max(self, other: Self) -> Self
1.21.0[src]

Compares and returns the maximum of two values. Read more

#[must_use]
fn min(self, other: Self) -> Self
1.21.0[src]

Compares and returns the minimum of two values. Read more

#[must_use]
fn clamp(self, min: Self, max: Self) -> Self
1.50.0[src]

Restrict a value to a certain interval. Read more

impl ParentClassIs for AppSink[src]

impl<T: ObjectType> PartialEq<T> for AppSink[src]

fn eq(&self, other: &T) -> bool[src]

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

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

This method tests for !=.

impl<T: ObjectType> PartialOrd<T> for AppSink[src]

fn partial_cmp(&self, other: &T) -> Option<Ordering>[src]

This method returns an ordering between self and other values if one exists. Read more

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

This method tests less than (for self and other) and is used by the < operator. Read more

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

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more

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

This method tests greater than (for self and other) and is used by the > operator. Read more

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

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

impl StaticType for AppSink[src]

fn static_type() -> Type[src]

Returns the type identifier of Self.

impl Eq for AppSink[src]

impl IsA<Element> for AppSink[src]

impl IsA<Object> for AppSink[src]

impl IsA<URIHandler> for AppSink[src]

impl Send for AppSink[src]

impl StructuralEq for AppSink[src]

impl Sync for AppSink[src]

Auto Trait Implementations

impl RefUnwindSafe for AppSink

impl Unpin for AppSink

impl UnwindSafe for AppSink

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

pub fn type_id(&self) -> TypeId[src]

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

pub fn borrow(&self) -> &T[src]

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

pub fn borrow_mut(&mut self) -> &mut T[src]

Mutably borrows from an owned value. Read more

impl<T> Cast for T where
    T: ObjectType
[src]

fn upcast<T>(self) -> T where
    Self: IsA<T>,
    T: ObjectType
[src]

Upcasts an object to a superclass or interface T. Read more

fn upcast_ref<T>(&self) -> &T where
    Self: IsA<T>,
    T: ObjectType
[src]

Upcasts an object to a reference of its superclass or interface T. Read more

fn downcast<T>(self) -> Result<T, Self> where
    Self: CanDowncast<T>,
    T: ObjectType
[src]

Tries to downcast to a subclass or interface implementor T. Read more

fn downcast_ref<T>(&self) -> Option<&T> where
    Self: CanDowncast<T>,
    T: ObjectType
[src]

Tries to downcast to a reference of its subclass or interface implementor T. Read more

fn dynamic_cast<T>(self) -> Result<T, Self> where
    T: ObjectType
[src]

Tries to cast to an object of type T. This handles upcasting, downcasting and casting between interface and interface implementors. All checks are performed at runtime, while downcast and upcast will do many checks at compile-time already. Read more

fn dynamic_cast_ref<T>(&self) -> Option<&T> where
    T: ObjectType
[src]

Tries to cast to reference to an object of type T. This handles upcasting, downcasting and casting between interface and interface implementors. All checks are performed at runtime, while downcast and upcast will do many checks at compile-time already. Read more

unsafe fn unsafe_cast<T>(self) -> T where
    T: ObjectType
[src]

Casts to T unconditionally. Read more

unsafe fn unsafe_cast_ref<T>(&self) -> &T where
    T: ObjectType
[src]

Casts to &T unconditionally. Read more

impl<O> ElementExt for O where
    O: IsA<Element>, 
[src]

pub fn abort_state(&self)[src]

Abort the state change of the element. This function is used by elements that do asynchronous state changes and find out something is wrong. Read more

pub fn add_pad<P>(&self, pad: &P) -> Result<(), BoolError> where
    P: IsA<Pad>, 
[src]

Adds a pad (link point) to self. pad’s parent will be set to self; see crate::prelude::GstObjectExt::set_parent() for refcounting information. Read more

pub fn change_state(
    &self,
    transition: StateChange
) -> Result<StateChangeSuccess, StateChangeError>
[src]

Perform transition on self. Read more

pub fn continue_state(
    &self,
    ret: impl Into<StateChangeReturn>
) -> Result<StateChangeSuccess, StateChangeError>
[src]

Commit the state change of the element and proceed to the next pending state if any. This function is used by elements that do asynchronous state changes. The core will normally call this method automatically when an element returned crate::StateChangeReturn::Success from the state change function. Read more

pub fn create_all_pads(&self)[src]

pub fn foreach_pad<P>(&self, func: P) -> bool where
    P: FnMut(&Element, &Pad) -> bool
[src]

This is supported on crate feature v1_14 only.

pub fn foreach_sink_pad<P>(&self, func: P) -> bool where
    P: FnMut(&Element, &Pad) -> bool
[src]

This is supported on crate feature v1_14 only.

pub fn foreach_src_pad<P>(&self, func: P) -> bool where
    P: FnMut(&Element, &Pad) -> bool
[src]

This is supported on crate feature v1_14 only.

pub fn base_time(&self) -> ClockTime[src]

pub fn bus(&self) -> Option<Bus>[src]

pub fn clock(&self) -> Option<Clock>[src]

pub fn compatible_pad<P>(&self, pad: &P, caps: Option<&Caps>) -> Option<Pad> where
    P: IsA<Pad>, 
[src]

pub fn compatible_pad_template(
    &self,
    compattempl: &PadTemplate
) -> Option<PadTemplate>
[src]

pub fn context(&self, context_type: &str) -> Option<Context>[src]

pub fn contexts(&self) -> Vec<Context, Global>[src]

pub fn factory(&self) -> Option<ElementFactory>[src]

pub fn request_pad_simple(&self, name: &str) -> Option<Pad>[src]

pub fn start_time(&self) -> ClockTime[src]

pub fn state(
    &self,
    timeout: ClockTime
) -> (Result<StateChangeSuccess, StateChangeError>, State, State)
[src]

pub fn static_pad(&self, name: &str) -> Option<Pad>[src]

pub fn is_locked_state(&self) -> bool[src]

pub fn lost_state(&self)[src]

pub fn no_more_pads(&self)[src]

pub fn provide_clock(&self) -> Option<Clock>[src]

pub fn release_request_pad<P>(&self, pad: &P) where
    P: IsA<Pad>, 
[src]

pub fn remove_pad<P>(&self, pad: &P) -> Result<(), BoolError> where
    P: IsA<Pad>, 
[src]

pub fn request_pad(
    &self,
    templ: &PadTemplate,
    name: Option<&str>,
    caps: Option<&Caps>
) -> Option<Pad>
[src]

pub fn set_base_time(&self, time: ClockTime)[src]

pub fn set_bus(&self, bus: Option<&Bus>)[src]

pub fn set_clock<P>(&self, clock: Option<&P>) -> Result<(), BoolError> where
    P: IsA<Clock>, 
[src]

pub fn set_context(&self, context: &Context)[src]

pub fn set_locked_state(&self, locked_state: bool) -> bool[src]

pub fn set_start_time(&self, time: ClockTime)[src]

pub fn set_state(
    &self,
    state: State
) -> Result<StateChangeSuccess, StateChangeError>
[src]

pub fn sync_state_with_parent(&self) -> Result<(), BoolError>[src]

pub fn connect_no_more_pads<F>(&self, f: F) -> SignalHandlerId where
    F: 'static + Fn(&O) + Send + Sync
[src]

pub fn connect_pad_added<F>(&self, f: F) -> SignalHandlerId where
    F: 'static + Fn(&O, &Pad) + Send + Sync
[src]

pub fn connect_pad_removed<F>(&self, f: F) -> SignalHandlerId where
    F: 'static + Fn(&O, &Pad) + Send + Sync
[src]

impl<O> ElementExtManual for O where
    O: IsA<Element>, 
[src]

pub fn element_class(&self) -> &Class<Element>[src]

pub fn current_state(&self) -> State[src]

pub fn pending_state(&self) -> State[src]

pub fn query(&self, query: &mut QueryRef) -> bool[src]

pub fn send_event(&self, event: Event) -> bool[src]

pub fn metadata<'a>(&self, key: &str) -> Option<&'a str>[src]

pub fn pad_template(&self, name: &str) -> Option<PadTemplate>[src]

pub fn pad_template_list(&self) -> Vec<PadTemplate, Global>[src]

pub fn set_element_flags(&self, flags: ElementFlags)[src]

pub fn unset_element_flags(&self, flags: ElementFlags)[src]

pub fn element_flags(&self) -> ElementFlags[src]

pub fn message_full<T>(
    &self,
    type_: ElementMessageType,
    code: T,
    message: Option<&str>,
    debug: Option<&str>,
    file: &str,
    function: &str,
    line: u32
) where
    T: MessageErrorDomain
[src]

pub fn message_full_with_details<T>(
    &self,
    type_: ElementMessageType,
    code: T,
    message: Option<&str>,
    debug: Option<&str>,
    file: &str,
    function: &str,
    line: u32,
    structure: Structure
) where
    T: MessageErrorDomain
[src]

This is supported on crate feature v1_10 only.

pub fn post_message(&self, message: Message) -> Result<(), BoolError>[src]

pub fn post_error_message(&self, msg: ErrorMessage)[src]

pub fn iterate_pads(&self) -> Iterator<Pad>[src]

pub fn iterate_sink_pads(&self) -> Iterator<Pad>[src]

pub fn iterate_src_pads(&self) -> Iterator<Pad>[src]

pub fn pads(&self) -> Vec<Pad, Global>[src]

pub fn sink_pads(&self) -> Vec<Pad, Global>[src]

pub fn src_pads(&self) -> Vec<Pad, Global>[src]

pub fn num_pads(&self) -> u16[src]

pub fn num_sink_pads(&self) -> u16[src]

pub fn num_src_pads(&self) -> u16[src]

pub fn add_property_deep_notify_watch(
    &self,
    property_name: Option<&str>,
    include_value: bool
) -> NotifyWatchId
[src]

This is supported on crate feature v1_10 only.

pub fn add_property_notify_watch(
    &self,
    property_name: Option<&str>,
    include_value: bool
) -> NotifyWatchId
[src]

This is supported on crate feature v1_10 only.

pub fn remove_property_notify_watch(&self, watch_id: NotifyWatchId)[src]

This is supported on crate feature v1_10 only.

pub fn query_convert<V, U>(&self, src_val: V) -> Option<U> where
    U: SpecificFormattedValue,
    V: Into<GenericFormattedValue>, 
[src]

pub fn query_convert_generic<V>(
    &self,
    src_val: V,
    dest_format: Format
) -> Option<GenericFormattedValue> where
    V: Into<GenericFormattedValue>, 
[src]

pub fn query_duration<T>(&self) -> Option<T> where
    T: SpecificFormattedValue
[src]

pub fn query_duration_generic(
    &self,
    format: Format
) -> Option<GenericFormattedValue>
[src]

pub fn query_position<T>(&self) -> Option<T> where
    T: SpecificFormattedValue
[src]

pub fn query_position_generic(
    &self,
    format: Format
) -> Option<GenericFormattedValue>
[src]

pub fn seek<V>(
    &self,
    rate: f64,
    flags: SeekFlags,
    start_type: SeekType,
    start: V,
    stop_type: SeekType,
    stop: V
) -> Result<(), BoolError> where
    V: Into<GenericFormattedValue>, 
[src]

pub fn seek_simple<V>(
    &self,
    seek_flags: SeekFlags,
    seek_pos: V
) -> Result<(), BoolError> where
    V: Into<GenericFormattedValue>, 
[src]

pub fn call_async<F>(&self, func: F) where
    F: FnOnce(&O) + Send + 'static, 
[src]

This is supported on crate feature v1_10 only.

pub fn call_async_future<F, T>(
    &self,
    func: F
) -> Pin<Box<dyn Future<Output = T> + 'static + Send, Global>> where
    F: FnOnce(&O) -> T + Send + 'static,
    T: Send + 'static, 
[src]

This is supported on crate feature v1_10 only.

pub fn current_running_time(&self) -> ClockTime[src]

pub fn current_clock_time(&self) -> ClockTime[src]

impl<T> From<T> for T[src]

pub fn from(t: T) -> T[src]

Performs the conversion.

impl<O> GObjectExtManualGst for O where
    O: IsA<Object>, 
[src]

pub fn set_property_from_str(&self, name: &str, value: &str)[src]

impl<O> GstObjectExt for O where
    O: IsA<Object>, 
[src]

pub fn add_control_binding<P>(&self, binding: &P) -> Result<(), BoolError> where
    P: IsA<ControlBinding>, 
[src]

Attach the crate::ControlBinding to the object. If there already was a crate::ControlBinding for this property it will be replaced. Read more

pub fn default_error(&self, error: &Error, debug: Option<&str>)[src]

A default error function that uses g_printerr() to display the error message and the optional debug string.. Read more

pub fn control_binding(&self, property_name: &str) -> Option<ControlBinding>[src]

Gets the corresponding crate::ControlBinding for the property. This should be unreferenced again after use. Read more

pub fn control_rate(&self) -> ClockTime[src]

Obtain the control-rate for this self. Audio processing crate::Element objects will use this rate to sub-divide their processing loop and call Self::sync_values() in between. The length of the processing segment should be up to control-rate nanoseconds. Read more

pub fn name(&self) -> GString[src]

Returns a copy of the name of self. Caller should g_free() the return value after usage. For a nameless object, this returns None, which you can safely g_free() as well. Read more

pub fn parent(&self) -> Option<Object>[src]

Returns the parent of self. This function increases the refcount of the parent object so you should [Self::unref()] it after usage. Read more

pub fn path_string(&self) -> GString[src]

Generates a string describing the path of self in the object hierarchy. Only useful (or used) for debugging. Read more

pub fn value(&self, property_name: &str, timestamp: ClockTime) -> Option<Value>[src]

Gets the value for the given controlled property at the requested time. Read more

pub fn has_active_control_bindings(&self) -> bool[src]

Check if the self has active controlled properties. Read more

pub fn has_ancestor<P>(&self, ancestor: &P) -> bool where
    P: IsA<Object>, 
[src]

Check if self has an ancestor ancestor somewhere up in the hierarchy. One can e.g. check if a crate::Element is inside a crate::Pipeline. Read more

pub fn has_as_ancestor<P>(&self, ancestor: &P) -> bool where
    P: IsA<Object>, 
[src]

Check if self has an ancestor ancestor somewhere up in the hierarchy. One can e.g. check if a crate::Element is inside a crate::Pipeline. Read more

pub fn has_as_parent<P>(&self, parent: &P) -> bool where
    P: IsA<Object>, 
[src]

Check if parent is the parent of self. E.g. a crate::Element can check if it owns a given crate::Pad. Read more

pub fn remove_control_binding<P>(&self, binding: &P) -> bool where
    P: IsA<ControlBinding>, 
[src]

Removes the corresponding crate::ControlBinding. If it was the last ref of the binding, it will be disposed. Read more

pub fn set_control_binding_disabled(&self, property_name: &str, disabled: bool)[src]

This function is used to disable the control bindings on a property for some time, i.e. Self::sync_values() will do nothing for the property. Read more

pub fn set_control_bindings_disabled(&self, disabled: bool)[src]

This function is used to disable all controlled properties of the self for some time, i.e. Self::sync_values() will do nothing. Read more

pub fn set_control_rate(&self, control_rate: ClockTime)[src]

Change the control-rate for this self. Audio processing crate::Element objects will use this rate to sub-divide their processing loop and call Self::sync_values() in between. The length of the processing segment should be up to control-rate nanoseconds. Read more

pub fn set_parent<P>(&self, parent: &P) -> Result<(), BoolError> where
    P: IsA<Object>, 
[src]

Sets the parent of self to parent. The object’s reference count will be incremented, and any floating reference will be removed (see [crate::Object::ref_sink()]). Read more

pub fn suggest_next_sync(&self) -> ClockTime[src]

Returns a suggestion for timestamps where buffers should be split to get best controller results. Read more

pub fn sync_values(&self, timestamp: ClockTime) -> Result<(), BoolError>[src]

Sets the properties of the object, according to the GstControlSources that (maybe) handle them and for the given timestamp. Read more

pub fn unparent(&self)[src]

Clear the parent of self, removing the associated reference. This function decreases the refcount of self. Read more

pub fn connect_parent_notify<F>(&self, f: F) -> SignalHandlerId where
    F: 'static + Fn(&O) + Send + Sync
[src]

impl<O> GstObjectExtManual for O where
    O: IsA<Object>, 
[src]

pub fn connect_deep_notify<F>(
    &self,
    name: Option<&str>,
    f: F
) -> SignalHandlerId where
    F: 'static + Fn(&O, &Object, &ParamSpec) + Send + Sync
[src]

pub fn set_object_flags(&self, flags: ObjectFlags)[src]

pub fn unset_object_flags(&self, flags: ObjectFlags)[src]

pub fn object_flags(&self) -> ObjectFlags[src]

pub fn g_value_array(
    &self,
    property_name: &str,
    timestamp: ClockTime,
    interval: ClockTime,
    values: &mut [Value]
) -> Result<(), BoolError>
[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

pub fn into(self) -> U[src]

Performs the conversion.

impl<T> ObjectExt for T where
    T: ObjectType
[src]

pub fn is<U>(&self) -> bool where
    U: StaticType
[src]

Returns true if the object is an instance of (can be cast to) T.

pub fn type_(&self) -> Type[src]

pub fn object_class(&self) -> &Class<Object>[src]

pub fn class(&self) -> &Class<T> where
    T: IsClass
[src]

pub fn class_of<U>(&self) -> Option<&Class<U>> where
    U: IsClass
[src]

pub fn interface<U>(&self) -> Option<InterfaceRef<'_, U>> where
    U: IsInterface
[src]

pub fn set_properties(
    &self,
    property_values: &[(&str, &dyn ToValue)]
) -> Result<(), BoolError>
[src]

pub fn set_properties_from_value(
    &self,
    property_values: &[(&str, Value)]
) -> Result<(), BoolError>
[src]

pub fn set_property<'a, N, V>(
    &self,
    property_name: N,
    value: V
) -> Result<(), BoolError> where
    V: ToValue,
    N: Into<&'a str>, 
[src]

pub fn set_property_from_value<'a, N>(
    &self,
    property_name: N,
    value: &Value
) -> Result<(), BoolError> where
    N: Into<&'a str>, 
[src]

pub fn property<'a, N>(&self, property_name: N) -> Result<Value, BoolError> where
    N: Into<&'a str>, 
[src]

pub unsafe fn set_qdata<QD>(&self, key: Quark, value: QD) where
    QD: 'static, 
[src]

Safety Read more

pub unsafe fn qdata<QD>(&self, key: Quark) -> Option<NonNull<QD>> where
    QD: 'static, 
[src]

Safety Read more

pub unsafe fn steal_qdata<QD>(&self, key: Quark) -> Option<QD> where
    QD: 'static, 
[src]

Safety Read more

pub unsafe fn set_data<QD>(&self, key: &str, value: QD) where
    QD: 'static, 
[src]

Safety Read more

pub unsafe fn data<QD>(&self, key: &str) -> Option<NonNull<QD>> where
    QD: 'static, 
[src]

Safety Read more

pub unsafe fn steal_data<QD>(&self, key: &str) -> Option<QD> where
    QD: 'static, 
[src]

Safety Read more

pub fn block_signal(&self, handler_id: &SignalHandlerId)[src]

pub fn unblock_signal(&self, handler_id: &SignalHandlerId)[src]

pub fn stop_signal_emission(&self, signal_name: &str)[src]

pub fn disconnect(&self, handler_id: SignalHandlerId)[src]

pub fn connect_notify<F>(&self, name: Option<&str>, f: F) -> SignalHandlerId where
    F: 'static + Fn(&T, &ParamSpec) + Send + Sync
[src]

pub fn connect_notify_local<F>(
    &self,
    name: Option<&str>,
    f: F
) -> SignalHandlerId where
    F: 'static + Fn(&T, &ParamSpec), 
[src]

pub unsafe fn connect_notify_unsafe<F>(
    &self,
    name: Option<&str>,
    f: F
) -> SignalHandlerId where
    F: Fn(&T, &ParamSpec), 
[src]

pub fn notify<'a, N>(&self, property_name: N) where
    N: Into<&'a str>, 
[src]

pub fn notify_by_pspec(&self, pspec: &ParamSpec)[src]

pub fn has_property<'a, N>(&self, property_name: N, type_: Option<Type>) -> bool where
    N: Into<&'a str>, 
[src]

pub fn property_type<'a, N>(&self, property_name: N) -> Option<Type> where
    N: Into<&'a str>, 
[src]

pub fn find_property<'a, N>(&self, property_name: N) -> Option<ParamSpec> where
    N: Into<&'a str>, 
[src]

pub fn list_properties(&self) -> Vec<ParamSpec, Global>[src]

pub fn connect<'a, N, F>(
    &self,
    signal_name: N,
    after: bool,
    callback: F
) -> Result<SignalHandlerId, BoolError> where
    F: Fn(&[Value]) -> Option<Value> + Send + Sync + 'static,
    N: Into<&'a str>, 
[src]

pub fn connect_id<F>(
    &self,
    signal_id: SignalId,
    details: Option<Quark>,
    after: bool,
    callback: F
) -> Result<SignalHandlerId, BoolError> where
    F: Fn(&[Value]) -> Option<Value> + Send + Sync + 'static, 
[src]

Same as connect but takes a SignalId instead of a signal name.

pub fn connect_local<'a, N, F>(
    &self,
    signal_name: N,
    after: bool,
    callback: F
) -> Result<SignalHandlerId, BoolError> where
    F: Fn(&[Value]) -> Option<Value> + 'static,
    N: Into<&'a str>, 
[src]

pub fn connect_local_id<F>(
    &self,
    signal_id: SignalId,
    details: Option<Quark>,
    after: bool,
    callback: F
) -> Result<SignalHandlerId, BoolError> where
    F: Fn(&[Value]) -> Option<Value> + 'static, 
[src]

Same as connect_local but takes a SignalId instead of a signal name.

pub unsafe fn connect_unsafe<'a, N, F>(
    &self,
    signal_name: N,
    after: bool,
    callback: F
) -> Result<SignalHandlerId, BoolError> where
    F: Fn(&[Value]) -> Option<Value>,
    N: Into<&'a str>, 
[src]

pub unsafe fn connect_unsafe_id<F>(
    &self,
    signal_id: SignalId,
    details: Option<Quark>,
    after: bool,
    callback: F
) -> Result<SignalHandlerId, BoolError> where
    F: Fn(&[Value]) -> Option<Value>, 
[src]

Same as connect_unsafe but takes a SignalId instead of a signal name.

pub fn emit(
    &self,
    signal_id: SignalId,
    args: &[&dyn ToValue]
) -> Result<Option<Value>, BoolError>
[src]

Emit signal by signal id.

pub fn emit_with_details(
    &self,
    signal_id: SignalId,
    details: Quark,
    args: &[&dyn ToValue]
) -> Result<Option<Value>, BoolError>
[src]

Emit signal with details by signal id.

pub fn emit_by_name<'a, N>(
    &self,
    signal_name: N,
    args: &[&dyn ToValue]
) -> Result<Option<Value>, BoolError> where
    N: Into<&'a str>, 
[src]

Emit signal by it’s name.

pub fn downgrade(&self) -> WeakRef<T>[src]

pub fn bind_property<'a, O, N, M>(
    &'a self,
    source_property: N,
    target: &'a O,
    target_property: M
) -> BindingBuilder<'a> where
    N: Into<&'a str>,
    O: ObjectType,
    M: Into<&'a str>, 
[src]

pub fn ref_count(&self) -> u32[src]

pub fn emit_with_values(
    &self,
    signal_id: SignalId,
    args: &[Value]
) -> Result<Option<Value>, BoolError>
[src]

Same as emit but takes Value for the arguments.

pub fn emit_by_name_with_values<'a, N>(
    &self,
    signal_name: N,
    args: &[Value]
) -> Result<Option<Value>, BoolError> where
    N: Into<&'a str>, 
[src]

Same as emit_by_name but takes Value for the arguments.

pub fn emit_with_details_and_values(
    &self,
    signal_id: SignalId,
    details: Quark,
    args: &[Value]
) -> Result<Option<Value>, BoolError>
[src]

Same as emit_with_details but takes Value for the arguments.

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

pub fn to_owned(&self) -> T[src]

Creates owned data from borrowed data, usually by cloning. Read more

pub fn clone_into(&self, target: &mut T)[src]

🔬 This is a nightly-only experimental API. (toowned_clone_into)

recently added

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T> ToSendValue for T where
    T: Send + ToValue + ?Sized
[src]

pub fn to_send_value(&self) -> SendValue[src]

Returns a SendValue clone of self.

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>[src]

Performs the conversion.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>[src]

Performs the conversion.

impl<O> URIHandlerExt for O where
    O: IsA<URIHandler>, 
[src]

pub fn protocols(&self) -> Vec<GString, Global>[src]

Gets the list of protocols supported by self. This list may not be modified. Read more

pub fn uri(&self) -> Option<GString>[src]

Gets the currently handled URI. Read more

pub fn uri_type(&self) -> URIType[src]

Gets the type of the given URI handler Read more

pub fn set_uri(&self, uri: &str) -> Result<(), Error>[src]

Tries to set the URI of the given handler. Read more

impl<Super, Sub> CanDowncast<Sub> for Super where
    Sub: IsA<Super>,
    Super: IsA<Super>, 
[src]

impl<'a, T, C> FromValueOptional<'a> for T where
    C: ValueTypeChecker<Error = ValueTypeMismatchOrNoneError>,
    T: FromValue<'a, Checker = C>, 
[src]