rill-graph 0.5.0-beta.1

Real-time audio graph with block processing
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

//! # Rill Graph — Static DAG Signal Graph
//!
//! This crate provides an immutable signal graph with static topology.
//! Build once with `GraphBuilder`. The graph is a pure topology description
//! — processing is driven by port-level methods (`pre_process`,
//! `snapshot_feedback`, `propagate`) called from external code.
//!
//! ## Key Features
//!
//! - **Static DAG topology** — connections are fixed after build
//! - **Kahn's algorithm** — automatic topological sort with cycle detection
//! - **Auto FanOut/FanIn** — connections classified by topology (user never chooses)
//! - **Port-owned routing** — downstream connections and feedback state live on ports
//! - **Copy-based buffer routing** — separate input/output buffer pools (zero-copy planned)
//! - **Safe Rust** — no `unsafe` code

#![warn(missing_docs)]
#![deny(unsafe_code)]

mod graph;

/// Node factory and registry for constructing nodes by type name.
pub mod registry;

/// Graph serialization (JSON / CBOR). Feature-gated behind `serialization`.
#[cfg(feature = "serialization")]
pub mod serialization;

/// DOT graph visualization (Graphviz). Feature-gated behind `dot`.
#[cfg(feature = "dot")]
pub mod dot;

pub use graph::{SignalGraph, BuildError, GraphBuilder, GraphResource};
pub use registry::{NodeConstructor, NodeRegistry, RegistryError};

/// Prelude for convenient imports
pub mod prelude {
    pub use crate::{SignalGraph, GraphBuilder, NodeConstructor, NodeRegistry, RegistryError};
    pub use rill_core::prelude::*;
}