README.md

Pure Data Externals in Pure Rust

Does not require any C, builds entirely with Cargo.

Requirements

• Rust and Cargo, at least rust 1.34
• Pure Data, to run, not to build.

Crates/Subdirs

• pd-sys The basic generated bindings to m_pd.h, all you need to roll your own interface to puredata.
• external The Rust specific wrappers and ease of use methods for creating externals.
• macros The macros that generate all the guts for externals you don't want to have to deal with yourself, used the examples.
• macros/examples See below.
• utils Utilities for building and packaging externals.

Examples

The examples can all be built with cargo build but you can also use cargo-make for more helpful features. See utils/README.md for more details on the cargo-make setup.

• helloworld based on the HOWTO my first external: helloworld example
• counter based on the HOWTO a simple external: counter example
• complex_counter based on the HOWTO a complex external: counter example
• xfade based on the, misnamed, HOWTO a signal-external pan~ example

cd macros/examples/helloworld && cargo build

or

cd macros/examples/helloworld && cargo make run

If you want to see what code the macro actually produces, use cargo-expand.

TODO

• Documentation
• Expose pointer methods
• Support more creation argument configurations
• Clean up macros
• crates.io release

References

• Pure Data
• HOWTO write an External for Pure Data

Links

• kmtr pd_ext_rust: another Pure Data External solution for rust, requires C.
• RustAudio