# cloudseedcore-rs
[](https://crates.io/crates/cloudseedcore-rs)
[](https://docs.rs/cloudseedcore-rs)
This crate provides safe Rust bindings to the [CloudSeedCore](https://github.com/GhostNoteAudio/CloudSeedCore/) Reverb algorithm.
The specific version vendored is commit [`b46bd7e`](https://github.com/talaviram/CloudSeedCore/tree/b46bd7e0b9467c31d6b95444bfc290169932eaa1)
on talaviram's fork, which fixes some cross-platform compatibility issues.
Building this crate requires a C++14 toolchain.
The C++ bindings are created using [cxx](https://github.com/dtolnay/cxx).
## Hear it
Output of one of the test cases, wide pulse with the Dark Plate preset applied:
https://github.com/user-attachments/assets/fb64421c-4911-4527-8389-5030926e4b85
## Example usage
```rs
use cloudseedcore_rs::{ReverbController, ParamId}
// create the reverb instance
let sample_rate = 48_000;
let block_size = 512;
let mut reverb = ReverbController::new(sample_rate, block_size);
// load the "Dark Plate" preset
reverb.set_program(&cloudseedcore_rs::DARK_PLATE);
// only output wet signal
reverb.set_parameter(ParamId::DryOut, 0.0);
// process stereo audio
// assuming you have four sample buffers of size block_size, two for input, two for output:
reverb.process(&in_left, &in_right, &mut out_left, &mut out_right, block_size);
// to persist the reverb's parameter state,
// you can get them as an array of f32 like so:
let state = reverb.get_program().to_array();
```
## License
This crate is MIT licensed.
Any code under `vendor/CloudSeedCore` falls under the original MIT license,
reproduced within that directory.