Sonogram: Wave to Spectrogram converter - in Rust

Create a sonogram* from a wave form, or .wav file. This crate can take a .wav file and convert it into a spectrogram. The spectrogram can be saved as a PNG file. An example CLI progam is included that helps convert .wav files to .png spectrograms.

The code is intended to be used as a library that can be used to convert in-memory wave forms to a spectrograph.

Example output PNG:

*Note: sonogram, spectrograph, spectrogram, or power spectral density plot are common names of similar things.

Running usin the CLI

cargo run --release --bin sonogram -- --wav input.wav --png ouput.png

Completing an in-memory conversion

// You'll need to fill `waveform` with data.
let waveform: Vec<i16> = vec![];

// Build the model
let mut spectrograph = SpecOptionsBuilder::new(512, 128)
  .load_data_from_memory(waveform)
  .build();

// Compute the spectrogram giving the number of bins and the window overlap.
spectrograph.compute(2048, 0.8);

// Save the spectrogram to PNG.
let png_file = std::path::Path::new("path/to/file.png");
spectrograph.save_as_png(&png_file, false)?;

Using your own colour gradient

let mut gradient = ColourGradient::new();
gradient.add_colour(RGBAColour::new(0, 0, 0, 255));     // Black
gradient.add_colour(RGBAColour::new(55, 0, 110, 255));  // Purple
gradient.add_colour(RGBAColour::new(0, 0, 180, 255));   // Blue
gradient.add_colour(RGBAColour::new(0, 255, 255, 255)); // Cyan
gradient.add_colour(RGBAColour::new(0, 255, 0, 255));   // Green
spec_builder.set_gradient(gradient);

License

The code in this repository is based on the C++ code developed by Christian Briones.

This source is released under the GPLv3 license. Read the LICENSE file for legal information.