audio-automation 0.3.0

Generic automation system for audio parameters - works with any audio framework
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
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

# audio-automation

[![CI](https://github.com/PoHsuanLai/audio-automation/workflows/CI/badge.svg)](https://github.com/PoHsuanLai/audio-automation/actions)
[![Crates.io](https://img.shields.io/crates/v/audio-automation.svg)](https://crates.io/crates/audio-automation)
[![docs.rs](https://docs.rs/audio-automation/badge.svg)](https://docs.rs/audio-automation)
[![License](https://img.shields.io/crates/l/audio-automation.svg)](LICENSE-MIT)

Time-based parameter automation with interpolation curves for audio applications.

`#![no_std]` compatible (requires `alloc`). Works on embedded, WASM, and standard targets.

![Automation Curves](plots/complex.png)

## Usage

```rust
use audio_automation::prelude::*;

#[derive(Debug, Clone, serde::Serialize, serde::Deserialize)]
enum Param { Volume, Cutoff }

let env = AutomationEnvelope::new(Param::Volume)
    .with_point(AutomationPoint::new(0.0, 0.0))
    .with_point(AutomationPoint::with_curve(4.0, 1.0, CurveType::Exponential))
    .with_range(0.0, 1.0);

let value = env.get_value_at(2.0).unwrap();
```

## Presets

```rust
// Fade in over 4 beats
let fade = AutomationEnvelope::fade_in(Param::Volume, 4.0, CurveType::SCurve);

// Pulse: 1 beat attack, 2 beat sustain, 1 beat release
let pulse = AutomationEnvelope::pulse(Param::Volume, 1.0, 2.0, 1.0, CurveType::Linear);

// 2 Hz LFO tremolo
let tremolo = AutomationEnvelope::lfo(Param::Volume, 2.0, 4.0, 0.5, 1.0);
```

## Multiple Parameters

```rust
let clip = AutomationClip::new("Intro", 8.0)
    .with_envelope("volume",
        AutomationEnvelope::fade_in(Param::Volume, 4.0, CurveType::Linear))
    .with_envelope("cutoff",
        AutomationEnvelope::new(Param::Cutoff)
            .with_point(AutomationPoint::new(0.0, 0.0))
            .with_point(AutomationPoint::new(8.0, 1.0)));
```

## Curve Types

`Linear`, `Exponential`, `Logarithmic`, `SCurve`, `Stepped`, `Bezier`, `Elastic`, `Bounce`, `Back`, `Circular`, and polynomial easing variants (`QuadIn/Out/InOut`, `CubicIn/Out/InOut`, `QuartIn/Out/InOut`, `QuintIn/Out/InOut`).

## License

MIT or Apache-2.0