Struct gstreamer_audio::AudioStreamAlign

pub struct AudioStreamAlign { /* private fields */ }

AudioStreamAlign provides a helper object that helps tracking audio stream alignment and discontinuities, and detects discontinuities if possible.

See new() for a description of its parameters and process() for the details of the processing.

GLib type: Boxed type with copy-on-clone semantics.

Implementations

impl AudioStreamAlign

pub fn as_ptr(&self) -> *mut GstAudioStreamAlign

Return the inner pointer to the underlying C value.

pub unsafe fn from_glib_ptr_borrow(ptr: &*mut GstAudioStreamAlign) -> &Self

Borrows the underlying C value.

pub unsafe fn from_glib_ptr_borrow_mut( ptr: &mut *mut GstAudioStreamAlign, ) -> &mut Self

Borrows the underlying C value mutably.

impl AudioStreamAlign

pub fn new( rate: i32, alignment_threshold: ClockTime, discont_wait: ClockTime, ) -> AudioStreamAlign

Allocate a new AudioStreamAlign with the given configuration. All processing happens according to sample rate rate, until set_rate() is called with a new rate. A negative rate can be used for reverse playback.

alignment_threshold gives the tolerance in nanoseconds after which a timestamp difference is considered a discontinuity. Once detected, discont_wait nanoseconds have to pass without going below the threshold again until the output buffer is marked as a discontinuity. These can later be re-configured with set_alignment_threshold() and set_discont_wait().

rate

a sample rate

alignment_threshold

a alignment threshold in nanoseconds

discont_wait

discont wait in nanoseconds

Returns

a new AudioStreamAlign. free with gst_audio_stream_align_free().

pub fn alignment_threshold(&self) -> ClockTime

Gets the currently configured alignment threshold.

Returns

The currently configured alignment threshold

pub fn discont_wait(&self) -> ClockTime

Gets the currently configured discont wait.

Returns

The currently configured discont wait

pub fn rate(&self) -> i32

Gets the currently configured sample rate.

Returns

The currently configured sample rate

pub fn samples_since_discont(&self) -> u64

Returns the number of samples that were processed since the last discontinuity was detected.

Returns

The number of samples processed since the last discontinuity.

pub fn timestamp_at_discont(&self) -> Option<ClockTime>

Timestamp that was passed when a discontinuity was detected, i.e. the first timestamp after the discontinuity.

Returns

The last timestamp at when a discontinuity was detected

pub fn mark_discont(&mut self)

Marks the next buffer as discontinuous and resets timestamp tracking.

pub fn set_alignment_threshold(&mut self, alignment_threshold: ClockTime)

Sets alignment_treshold as new alignment threshold for the following processing.

alignment_threshold

a new alignment threshold

pub fn set_discont_wait(&mut self, discont_wait: ClockTime)

Sets alignment_treshold as new discont wait for the following processing.

discont_wait

a new discont wait

pub fn set_rate(&mut self, rate: i32)

Sets rate as new sample rate for the following processing. If the sample rate differs this implicitly marks the next data as discontinuous.

rate

a new sample rate

impl AudioStreamAlign

pub fn process( &mut self, discont: bool, timestamp: ClockTime, n_samples: u32, ) -> (bool, ClockTime, ClockTime, u64)

Processes data with timestamp and n_samples, and returns the output timestamp, duration and sample position together with a boolean to signal whether a discontinuity was detected or not. All non-discontinuous data will have perfect timestamps and durations.

A discontinuity is detected once the difference between the actual timestamp and the timestamp calculated from the sample count since the last discontinuity differs by more than the alignment threshold for a duration longer than discont wait.

Note: In reverse playback, every buffer is considered discontinuous in the context of buffer flags because the last sample of the previous buffer is discontinuous with the first sample of the current one. However for this function they are only considered discontinuous in reverse playback if the first sample of the previous buffer is discontinuous with the last sample of the current one.

discont

if this data is considered to be discontinuous

timestamp

a GstClockTime of the start of the data

n_samples

number of samples to process

Returns

true if a discontinuity was detected, false otherwise.

out_timestamp

output timestamp of the data

out_duration

output duration of the data

out_sample_position

output sample position of the start of the data

Trait Implementations

impl Clone for AudioStreamAlign

fn clone(&self) -> Self

Copies the boxed type with the type-specific copy function.

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

Performs copy-assignment from source.

impl Debug for AudioStreamAlign

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

Formats the value using the given formatter.

impl From<AudioStreamAlign> for Value

fn from(o: AudioStreamAlign) -> Self

Converts to this type from the input type.

impl HasParamSpec for AudioStreamAlign

type ParamSpec = ParamSpecBoxed

type SetValue = AudioStreamAlign

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecBoxedBuilder<'_, AudioStreamAlign>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for AudioStreamAlign

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

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for AudioStreamAlign

fn cmp(&self, other: &AudioStreamAlign) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for AudioStreamAlign

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

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

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for AudioStreamAlign

fn partial_cmp(&self, other: &AudioStreamAlign) -> Option<Ordering>

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

fn lt(&self, other: &Rhs) -> bool

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

fn le(&self, other: &Rhs) -> bool

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

fn gt(&self, other: &Rhs) -> bool

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

fn ge(&self, other: &Rhs) -> bool

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

impl StaticType for AudioStreamAlign

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for AudioStreamAlign

impl Send for AudioStreamAlign

impl StructuralPartialEq for AudioStreamAlign

impl Sync for AudioStreamAlign