oscy 0.1.1

Minimalistic Rust library for audio oscillators supporting common waveform shapes.
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
62

# oscy

[![Crates.io](https://img.shields.io/crates/v/oscy)](https://crates.io/crates/oscy)
[![Docs.rs](https://docs.rs/oscy/badge.svg)](https://docs.rs/oscy)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Changelog](https://img.shields.io/badge/changelog-md-blue)](CHANGELOG.md)

A Rust library for audio oscillators and waveform generation.

## Oscillators

| Oscillator | Description |
|------------|-------------|
| `NaiveOsc` | Simple oscillator without anti-aliasing. Fast but produces aliasing at higher frequencies. |
| `PolyBlepOsc` | Band-limited oscillator using polyBLEP for reduced aliasing. |
| More | Additional implementations planned. |

## Usage

### Filling an audio buffer

```rust
use oscy::{poly_blep::PolyBlepOsc, Oscillator, Waveform};

let mut osc = PolyBlepOsc::new(44100.0, 440.0, Waveform::Saw);
let mut buffer = [0.0f32; 512];
osc.fill(&mut buffer);
```

### Using as an iterator

```rust
use oscy::{poly_blep::PolyBlepOsc, Waveform};

let osc = PolyBlepOsc::new(44100.0, 440.0, Waveform::Square);
let samples: Vec<f32> = osc.take(1024).collect();
```

### Naive vs PolyBLEP

Use `NaiveOsc` when performance is critical and aliasing is acceptable (e.g., low frequencies, or when followed by filtering). Use `PolyBlepOsc` for cleaner sound at higher frequencies.

```rust
use oscy::{naive::NaiveOsc, poly_blep::PolyBlepOsc, Oscillator, Waveform};

// Naive: simple and fast, but aliases
let mut naive = NaiveOsc::new(44100.0, 2000.0, Waveform::Saw);

// PolyBLEP: smooths discontinuities to reduce aliasing
let mut blep = PolyBlepOsc::new(44100.0, 2000.0, Waveform::Saw);
```

## Supported waveforms

- Sine
- Saw
- Square
- Triangle

## License

MIT License - see [LICENSE](LICENSE) for details.