# Raw Rust Bindings for the LV2 Audio Plugin API
This crate provides low-level, unsafe FFI bindings for the LV2 audio plugin C-API.
It is designed to be a direct, one-to-one translation of the C interface, intended for developers who need raw access to the LV2 ABI. This includes #[repr(C)] structs, C-compatible function signatures, and re-implementations of C header helper functions.
Forked initially for fixing an error regarding a personal project, and now maintaining the crate.
## Features
- **Default (root):** hand-written, idiomatic names + helpers (`LV2Descriptor`, `LV2Handle`, `uri`,
iterators on sequences/objects, etc.).
- **`sys` (feature):** complete LV2 1.18 C ABI at `lv2_raw::sys` (`LV2_Descriptor`, `LV2_Handle`,
`LV2_URID_Map`, worker/state/options/log/forge/etc.), generated by bindgen as a single
platform-agnostic file. Use as follows:
```toml
lv2_raw = { version = "0.4", features = ["sys"] }
```
```rust
use lv2_raw::sys as lv2_sys;
```
## Credits
Credits to podli for the original translation, all the credits below from the original readme still apply here
# Original readme
# Exposes the raw LV2 interface (C language) to Rust
LV2 docs: http://lv2plug.in/
The documentation of this crate is copied from the original C files, whose
copyright holders include Steve Harris, Lars Luthman, Gabriel M. Beddingfield, David Robillard, Richard W.E. Furse, Paul Barton-Davis, Stefan Westerfeld, and possibly others.
## Note
The objective of this crate is to translate the C interface as closely as
possible to Rust, declaring e.g.
* type aliases for raw pointers
* `[repr(C)] struct`s
* `extern "C" fn` declarations passed to the host in the LV2Descriptor struct
The original (C language) LV2 package defines contains some "helper" functions, which are
defined in C-headers, i.e. there is no compiled library file which this crate
could link to. These functions are also declared and defined here. Let us know if
you think that's not right. See also [this question](http://stackoverflow.com/questions/40944524/how-does-one-design-a-plugin-interface-for-digital-audio-workstation-hosts-in-pu) on stackoverflow.
The [lv2 crate](https://crates.io/crates/lv2) is one attempt to provide a more
idiomatic Rust interface to LV2.
Roadmap:
- Figure out division line between low- and high-level crate
- Preliminary goal: provide all functionality of LV2 while keeping it low-level
- Find out how much abstraction is useful/affordable in audio applications (i.e. real-time).