rust-vst2

A library to help facilitate creating VST plugins in rust.

This library is a work in progress and as such does not yet implement all opcodes. It is enough to create basic VST plugins without an editor interface.

Please note: This api may be subject to rapid changes and the current state of this library is not final.

Library Documentation

• http://overdrivenpotato.github.io/rust-vst2

TODO

• Implement all opcodes
• Proper editor support (possibly [conrod] + [sdl2]?)
• Write more tests
• Provide better examples

Usage

To create a plugin, simply create a type which implements plugin::Plugin and std::default::Default. Then call the macro plugin_main!, which will export the necessary functions and handle dealing with the rest of the API.

Example Plugin

A simple plugin that bears no functionality. The provided Cargo.toml has a crate-type directive which builds a dynamic library, usable by any VST host.

src/lib.rs

```rust

[macro_use]

extern crate vst2;

use vst2::plugin::{Info, Plugin};

[derive(Default)]

struct BasicPlugin;

impl Plugin for BasicPlugin { fn getinfo(&self) -> Info { Info { name: "Basic Plugin".tostring(), unique_id: 1357, // Used by hosts to differentiate between plugins.

        ..Default::default()
    }
}

}

plugin_main!(BasicPlugin); // Important! ```

Cargo.toml

```toml [package] name = "basic_vst" version = "0.0.1" authors = ["Author author@example.com"]

[dependencies] vst2 = "0.0.1"

[lib] name = "basicvst" crate-type = ["dylib"] ```