Add noise generators and improve their distribution

The commit improves and expands the noise generation capabilities by adding new
types and fixing distribution issues in existing ones. Key changes:

- Add more generators: Gaussian, triangular, blue, brownian, violet, velvet
- Fix white noise uniform distribution
- Fix pink noise sampling rate issues
- Make noise generators properly deterministic with seeds
- Add comprehensive tests for noise generator properties
- Improve documentation with detailed usage guidance

This provides a complete suite of high-quality noise generators for audio
synthesis, testing, and dithering applications.

Author: roderickvd

CHANGELOG.md

@@ -32,6 +32,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   `OutputStreamConfig::buffer_size()` and `OutputStreamConfig::sample_format()` getters to access
   an `OutputStreamConfig`'s channel count, sample rate, buffer size and sample format values.
 - Added `Source::limit()` method for limiting the maximum amplitude of a source.
+- Added more noise generators: `gaussian_white`, `triangular_white`, `blue`, `brownian`, `violet`,
+  and `velvet`.
 
 ### Changed
 - Breaking: `OutputStreamBuilder` should now be used to initialize an audio output stream.
@@ -48,6 +50,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
             functions from `dasp_sample` crate. For example `DaspSample::from_sample(sample)`.
 - `OutputStreamConfig` is now public.
 - Update `cpal` to [0.16](https://github.com/RustAudio/cpal/blob/master/CHANGELOG.md#version-0160-2025-06-07).
+- docs.rs will now document all features, including those that are not enabled by default.
+- `PinkNoise` is not deterministically seekable, so will now return `Err` when seeking.
 
 ### Fixed
 - `ChannelVolume` no longer clips/overflows when converting from many channels to
@@ -61,6 +65,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `LoopedDecoder::size_hint` now correctly indicates an infinite stream.
 - Symphonia decoder `total_duration` for Vorbis now return the correct value (#696).
 - Symphonia decoder for MP4 now seeks correctly (#577).
+- White noise was not correctly uniformly distributed
+- Pink noise was not correctly distributed on sampling rates other than 44100 Hz
 
 ### Deprecated
 - Deprecated `Sample::zero_value()` function in favor of `Sample::ZERO_VALUE` constant

Cargo.lock

@@ -19,10 +19,8 @@ minimp3_fixed = { version = "0.5.4", optional = true }
 symphonia = { version = "0.5.4", optional = true, default-features = false }
 crossbeam-channel = { version = "0.5.15", optional = true }
 
-rand = { version = "0.9.0", features = [
-    "small_rng",
-    "os_rng",
-], optional = true }
+rand = { version = "0.9", features = ["small_rng"], optional = true }
+rand_distr = { version = "0.5", optional = true }
 tracing = { version = "0.1.40", optional = true }
 
 atomic_float = { version = "1.1.0", optional = true }
@@ -40,7 +38,7 @@ wav = ["hound"]
 mp3 = ["symphonia-mp3"]
 minimp3 = ["dep:minimp3_fixed"]
 
-noise = ["rand"]
+noise = ["rand", "rand_distr"]
 
 wasm-bindgen = ["cpal/wasm-bindgen"]
 cpal-shared-stdcxx = ["cpal/oboe-shared-stdcxx"]
@@ -64,6 +62,9 @@ symphonia-wav = ["symphonia/wav", "symphonia/pcm", "symphonia/adpcm"]
 symphonia-alac = ["symphonia/isomp4", "symphonia/alac"]
 symphonia-aiff = ["symphonia/aiff", "symphonia/pcm"]
 
+[package.metadata.docs.rs]
+all-features = true
+
 [dev-dependencies]
 quickcheck = "1"
 rstest = "0.18.2"

Cargo.toml

@@ -3,7 +3,9 @@
 use std::error::Error;
 
 fn main() -> Result<(), Box<dyn Error>> {
-    use rodio::source::{pink, white, Source};
+    use rodio::source::{
+        blue, brownian, gaussian_white, pink, triangular_white, velvet, violet, white, Source,
+    };
     use std::thread;
     use std::time::Duration;
 
@@ -19,12 +21,58 @@ fn main() -> Result<(), Box<dyn Error>> {
 
     thread::sleep(interval_duration);
 
+    stream_handle.mixer().add(
+        gaussian_white(48000)
+            .amplify(0.1)
+            .take_duration(noise_duration),
+    );
+    println!("Playing Gaussian white noise");
+
+    thread::sleep(interval_duration);
+
+    stream_handle.mixer().add(
+        triangular_white(48000)
+            .amplify(0.1)
+            .take_duration(noise_duration),
+    );
+    println!("Playing triangular white noise");
+
+    thread::sleep(interval_duration);
+
     stream_handle
         .mixer()
         .add(pink(48000).amplify(0.1).take_duration(noise_duration));
     println!("Playing pink noise");
 
     thread::sleep(interval_duration);
 
+    stream_handle
+        .mixer()
+        .add(blue(48000).amplify(0.1).take_duration(noise_duration));
+    println!("Playing blue noise");
+
+    thread::sleep(interval_duration);
+
+    stream_handle
+        .mixer()
+        .add(violet(48000).amplify(0.1).take_duration(noise_duration));
+    println!("Playing violet noise");
+
+    thread::sleep(interval_duration);
+
+    stream_handle
+        .mixer()
+        .add(brownian(48000).amplify(0.1).take_duration(noise_duration));
+    println!("Playing brownian noise");
+
+    thread::sleep(interval_duration);
+
+    stream_handle
+        .mixer()
+        .add(velvet(48000).amplify(0.1).take_duration(noise_duration));
+    println!("Playing velvet noise");
+
+    thread::sleep(interval_duration);
+
     Ok(())
 }

examples/noise_generator.rs

@@ -87,7 +87,11 @@ mod zero;
 #[cfg(feature = "noise")]
 mod noise;
 #[cfg(feature = "noise")]
-pub use self::noise::{pink, white, PinkNoise, WhiteNoise};
+pub use self::noise::{
+    blue, brownian, gaussian_white, pink, triangular_white, velvet, violet, white, BlueNoise,
+    BrownianNoise, GaussianWhiteNoise, NoiseGenerator, PinkNoise, TriangularWhiteNoise,
+    VelvetNoise, VioletNoise, WhiteNoise,
+};
 
 /// A source of samples.
 ///