waveform 0.2.2

Audio waveform image renderers
Documentation 
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

# waveform

[crates.io](https://crates.io/crates/waveform), [Documentation](https://docs.rs/waveform/) [![Build Status](https://travis-ci.org/tdgne/waveform-rs.svg?branch=master)](https://travis-ci.org/tdgne/waveform-rs)

waveform is a set of waveform image renderers written in Rust.

It is speed-oriented for heavy use.

## Features

* Generation of bicolored raster images (outputs are either returned as `Vec<u8>`s or written into a slice)
  * `RGBA` format images
  * Gray scale (`Scalar`) images for use as masks etc.
* Fast rendering from binned min/max amplitudes
* Multilevel binning for rendering in various resolutions
* Time-range specification in either seconds (`f64`) or samples (`usize`)

## Some TODOs

* Cached rendering
* Guarantee thread safety (it probably is...)
* Memory/time optimizations

Requests and contributions are welcome!

## Screenshot

```sh
# Demonstrates rendering using a single BinnedWaveformRenderer.
cargo run --features "example-gui" --example binned
```

```sh
# The same but by using a MultiWaveformRenderer, which is
# a combination of multiple BinnedWaveformRenderers.
cargo run --features "example-gui" --example multi
```

![examples/waveform.rs](https://user-images.githubusercontent.com/29127111/27250722-dd579ff6-5370-11e7-99c2-7dc3e7705c14.png)