1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156

// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// from gst-gir-files (https://gitlab.freedesktop.org/gstreamer/gir-files-rs.git)
// DO NOT EDIT

use glib::translate::*;

glib::wrapper! {
    /// [`crate::AudioStreamAlign`] provides a helper object that helps tracking audio
    /// stream alignment and discontinuities, and detects discontinuities if
    /// possible.
    ///
    /// See [`Self::new()`] for a description of its parameters and
    /// [`Self::process()`] for the details of the processing.
    #[derive(Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
    pub struct AudioStreamAlign(Boxed<ffi::GstAudioStreamAlign>);

    match fn {
        copy => |ptr| ffi::gst_audio_stream_align_copy(ptr),
        free => |ptr| ffi::gst_audio_stream_align_free(ptr),
        type_ => || ffi::gst_audio_stream_align_get_type(),
    }
}

impl AudioStreamAlign {
    /// Allocate a new [`crate::AudioStreamAlign`] with the given configuration. All
    /// processing happens according to sample rate `rate`, until
    /// [`Self::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 [`Self::set_alignment_threshold()`] and
    /// [`Self::set_discont_wait()`].
    /// ## `rate`
    /// a sample rate
    /// ## `alignment_threshold`
    /// a alignment threshold in nanoseconds
    /// ## `discont_wait`
    /// discont wait in nanoseconds
    ///
    /// # Returns
    ///
    /// a new [`crate::AudioStreamAlign`]. free with [`Self::free()`].
    #[doc(alias = "gst_audio_stream_align_new")]
    pub fn new(
        rate: i32,
        alignment_threshold: gst::ClockTime,
        discont_wait: gst::ClockTime,
    ) -> AudioStreamAlign {
        assert_initialized_main_thread!();
        unsafe {
            from_glib_full(ffi::gst_audio_stream_align_new(
                rate,
                alignment_threshold.into_glib(),
                discont_wait.into_glib(),
            ))
        }
    }

    #[doc(alias = "gst_audio_stream_align_get_alignment_threshold")]
    #[doc(alias = "get_alignment_threshold")]
    pub fn alignment_threshold(&self) -> gst::ClockTime {
        unsafe {
            from_glib(ffi::gst_audio_stream_align_get_alignment_threshold(
                mut_override(self.to_glib_none().0),
            ))
        }
    }

    #[doc(alias = "gst_audio_stream_align_get_discont_wait")]
    #[doc(alias = "get_discont_wait")]
    pub fn discont_wait(&self) -> gst::ClockTime {
        unsafe {
            from_glib(ffi::gst_audio_stream_align_get_discont_wait(mut_override(
                self.to_glib_none().0,
            )))
        }
    }

    #[doc(alias = "gst_audio_stream_align_get_rate")]
    #[doc(alias = "get_rate")]
    pub fn rate(&self) -> i32 {
        unsafe { ffi::gst_audio_stream_align_get_rate(mut_override(self.to_glib_none().0)) }
    }

    #[doc(alias = "gst_audio_stream_align_get_samples_since_discont")]
    #[doc(alias = "get_samples_since_discont")]
    pub fn samples_since_discont(&self) -> u64 {
        unsafe {
            ffi::gst_audio_stream_align_get_samples_since_discont(mut_override(
                self.to_glib_none().0,
            ))
        }
    }

    #[doc(alias = "gst_audio_stream_align_get_timestamp_at_discont")]
    #[doc(alias = "get_timestamp_at_discont")]
    pub fn timestamp_at_discont(&self) -> gst::ClockTime {
        unsafe {
            from_glib(ffi::gst_audio_stream_align_get_timestamp_at_discont(
                mut_override(self.to_glib_none().0),
            ))
        }
    }

    /// Marks the next buffer as discontinuous and resets timestamp tracking.
    #[doc(alias = "gst_audio_stream_align_mark_discont")]
    pub fn mark_discont(&mut self) {
        unsafe {
            ffi::gst_audio_stream_align_mark_discont(self.to_glib_none_mut().0);
        }
    }

    /// Sets `alignment_treshold` as new alignment threshold for the following processing.
    /// ## `alignment_threshold`
    /// a new alignment threshold
    #[doc(alias = "gst_audio_stream_align_set_alignment_threshold")]
    pub fn set_alignment_threshold(&mut self, alignment_threshold: gst::ClockTime) {
        unsafe {
            ffi::gst_audio_stream_align_set_alignment_threshold(
                self.to_glib_none_mut().0,
                alignment_threshold.into_glib(),
            );
        }
    }

    /// Sets `alignment_treshold` as new discont wait for the following processing.
    /// ## `discont_wait`
    /// a new discont wait
    #[doc(alias = "gst_audio_stream_align_set_discont_wait")]
    pub fn set_discont_wait(&mut self, discont_wait: gst::ClockTime) {
        unsafe {
            ffi::gst_audio_stream_align_set_discont_wait(
                self.to_glib_none_mut().0,
                discont_wait.into_glib(),
            );
        }
    }

    /// 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
    #[doc(alias = "gst_audio_stream_align_set_rate")]
    pub fn set_rate(&mut self, rate: i32) {
        unsafe {
            ffi::gst_audio_stream_align_set_rate(self.to_glib_none_mut().0, rate);
        }
    }
}

unsafe impl Send for AudioStreamAlign {}
unsafe impl Sync for AudioStreamAlign {}