lv2_raw 0.3.0

Exposes the raw LV2 interface (C) to Rust. Also attempts to implement some idiomatic Rust concepts (e.g. iterators).
Documentation
  • Coverage
  • 44.05%
    148 out of 336 items documented0 out of 60 items with examples
  • Size
  • Source code size: 74.72 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 13.92 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 17s Average build duration of successful builds.
  • all releases: 12s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • Homepage
  • mlm-games/lv2_raw
    1 0 0
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • mlm-games

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,

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)] structs
  • 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 on stackoverflow.

The lv2 crate 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).