#wav #wave #audio


Overlay one audio sample array onto another

4 releases

0.1.3 Mar 19, 2023
0.1.2 Mar 18, 2023
0.1.1 Mar 17, 2023
0.1.0 Mar 17, 2023

#154 in Audio

Download history 69/week @ 2023-03-14 11/week @ 2023-03-21

80 downloads per month

MIT license

176 lines

Audio Overlay

Overlay audio samples from one array onto another. You can optionally expand the destination array.

The overlay function can be used for i8, i16, i32, i64, f32, and f64.


Read this.


Example implementation here. This example relies on two crates that aren't dependencies of audio_overlay: hound (to open .wav files and convert them into vecs) and rodio (to play the audio sample buffer).

use rodio::{OutputStream, Sink};
use rodio::buffer::SamplesBuffer;
use hound;
use audio_overlay::overlay;

fn main()
    // Set the framerate.
    let framerate: u32 = 44100;

    // Load the audio clips.
    // Source: https://archive.org/download/NasaApollo11OnboardRecordings/11_highlight_2.ogg
    let src: Vec<i16> = hound::WavReader::open("src.wav").unwrap().samples::<i16>().map(|s| s.unwrap()).collect::<Vec<i16>>();
    // Source: https://archive.org/download/airship1904/airship1904.ogg
    let mut dst: Vec<i16> = hound::WavReader::open("dst.wav").unwrap().samples::<i16>().map(|s| s.unwrap()).collect::<Vec<i16>>();

    // Overlay the audio clips. The src clip will start 1.0 seconds after dst begins.
    overlay(src.as_slice(), &mut dst, 1.0, framerate, true);

    // Play the audio clips. Source: https://docs.rs/rodio/latest/rodio
    let (_stream, stream_handle) = OutputStream::try_default().unwrap();
    let source = SamplesBuffer::new(1, framerate, dst);
    let sink = Sink::try_new(&stream_handle).unwrap();

No runtime deps