Graphity

Model signal flow between nodes within a directed graph. This library is intended to be used for (but not limited to) sounds applications where audio signal will flow between individual node which will be generating and editing it.

Documentation:

• API reference (docs.rs)
• Repository (github.com)
• Crate (crates.io)

The library is compatible with #[no_std], allowing for use in e.g. embedded environments. However, note that it requires a global allocator with the alloc crate.

Usage

Add the following to your Cargo.toml:

[dependencies]
graphity = "2.0"

Then you need to:

1. Define your nodes by implementing the Node trait.
2. Generate a graph type to hold these nodes using a provided macro.
3. Instantiate the graph, add nodes, connect them using edges.
4. Trigger tick operation which will push signals through the graph.

In this example, we will use 3 node types and wire them up as following:

|  [1]   [2]  Generators are outputting their value
|    \   /
|     [+]     Sum adds the two inputs together
|      |
V     [3]     Echo prints its input on the stdout

The following snippet illustrates how would be such a graph modeled via this library. You can find the code in its full length under examples/:

impl Node<i32> for Echo {
    ...
}

impl Node<i32> for Generator {
   ...
}

impl Node<i32> for Sum {
   ...
}

graphity!(
    Graph<i32>;
    Generator = {Generator, GeneratorConsumer, GeneratorProducer},
    Sum = {Sum, SumConsumer, SumProducer},
    Echo = {Echo, EchoConsumer, EchoProducer},
);

fn main() {
    let mut graph = Graph::new();

    let one = graph.add_node(Generator(1));
    let two = graph.add_node(Generator(2));
    let sum = graph.add_node(Sum::default());
    let echo = graph.add_node(Echo::default());

    graph.must_add_edge(
        one.producer(GeneratorProducer),
        sum.consumer(SumConsumer::In1),
    );
    graph.must_add_edge(
        two.producer(GeneratorProducer),
        sum.consumer(SumConsumer::In2),
    );
    graph.must_add_edge(
        sum.producer(SumProducer),
        echo.consumer(EchoConsumer)
    );

    graph.tick();
}

You can find a detailed example and exhaustive API explanation in the documentation.

If you prefer tinkering with code over reading documentation, see and try included examples:

cargo run --example graph

License

Gazpatcho is distributed under the terms of the General Public License version 3. See LICENSE for details.

Changelog

Read the CHANGELOG.md to learn about changes introduced in each release.