bbx_dsp 0.2.0

Block-based audio DSP graph system with oscillators, effects, modulators, and realtime-safe processing
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

# bbx_dsp

A block-based audio DSP system for building signal processing graphs.

## Features

- **Graph-based architecture**: Connect blocks to form processing chains
- **Generic sample type**: Works with f32 or f64 precision
- **Realtime-safe processing**: Stack-allocated buffers, no allocations in audio thread
- **Parameter modulation**: LFOs and envelopes can modulate block parameters
- **Topological sorting**: Automatic execution order based on connections

## Block Types

### Generators
- `OscillatorBlock` - Waveform generator (sine, square, saw, triangle, pulse, noise)

### Effectors
- `GainBlock` - Level control in dB
- `OverdriveBlock` - Asymmetric soft-clipping distortion
- `PannerBlock` - Stereo panning with constant power law
- `DcBlockerBlock` - DC offset removal
- `ChannelRouterBlock` - Channel routing and manipulation

### Modulators
- `LfoBlock` - Low-frequency oscillator for parameter modulation
- `EnvelopeBlock` - ADSR envelope generator

### I/O
- `FileInputBlock` - Read audio from files
- `FileOutputBlock` - Write audio to files (non-blocking I/O)
- `OutputBlock` - Terminal graph output

## Usage

```rust
use bbx_dsp::{graph::GraphBuilder, waveform::Waveform};

// Create a graph with 44.1kHz sample rate, 512 sample buffer, stereo output
let mut builder = GraphBuilder::<f32>::new(44100.0, 512, 2);

// Add an oscillator
let osc = builder.add_oscillator(440.0, Waveform::Sine, None);

// Build the graph (automatically adds output block)
let mut graph = builder.build();

// Process audio
let mut left = vec![0.0f32; 512];
let mut right = vec![0.0f32; 512];
let mut outputs: [&mut [f32]; 2] = [&mut left, &mut right];
graph.process_buffers(&mut outputs);
```

## License

MIT