rodio/source/
amplify.rs

1use std::time::Duration;
2
3use crate::{Sample, Source};
4
5use super::SeekError;
6
7/// Internal function that builds a `Amplify` object.
8pub fn amplify<I>(input: I, factor: f32) -> Amplify<I>
9where
10    I: Source,
11    I::Item: Sample,
12{
13    Amplify { input, factor }
14}
15
16/// Filter that modifies each sample by a given value.
17#[derive(Clone, Debug)]
18pub struct Amplify<I> {
19    input: I,
20    factor: f32,
21}
22
23impl<I> Amplify<I> {
24    /// Modifies the amplification factor.
25    #[inline]
26    pub fn set_factor(&mut self, factor: f32) {
27        self.factor = factor;
28    }
29
30    /// Returns a reference to the inner source.
31    #[inline]
32    pub fn inner(&self) -> &I {
33        &self.input
34    }
35
36    /// Returns a mutable reference to the inner source.
37    #[inline]
38    pub fn inner_mut(&mut self) -> &mut I {
39        &mut self.input
40    }
41
42    /// Returns the inner source.
43    #[inline]
44    pub fn into_inner(self) -> I {
45        self.input
46    }
47}
48
49impl<I> Iterator for Amplify<I>
50where
51    I: Source,
52    I::Item: Sample,
53{
54    type Item = I::Item;
55
56    #[inline]
57    fn next(&mut self) -> Option<I::Item> {
58        self.input.next().map(|value| value.amplify(self.factor))
59    }
60
61    #[inline]
62    fn size_hint(&self) -> (usize, Option<usize>) {
63        self.input.size_hint()
64    }
65}
66
67impl<I> ExactSizeIterator for Amplify<I>
68where
69    I: Source + ExactSizeIterator,
70    I::Item: Sample,
71{
72}
73
74impl<I> Source for Amplify<I>
75where
76    I: Source,
77    I::Item: Sample,
78{
79    #[inline]
80    fn current_frame_len(&self) -> Option<usize> {
81        self.input.current_frame_len()
82    }
83
84    #[inline]
85    fn channels(&self) -> u16 {
86        self.input.channels()
87    }
88
89    #[inline]
90    fn sample_rate(&self) -> u32 {
91        self.input.sample_rate()
92    }
93
94    #[inline]
95    fn total_duration(&self) -> Option<Duration> {
96        self.input.total_duration()
97    }
98
99    #[inline]
100    fn try_seek(&mut self, pos: Duration) -> Result<(), SeekError> {
101        self.input.try_seek(pos)
102    }
103}