rill-patchbay 0.3.0

The world where Automata live - control system for Rill
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

//! # Rill Patchbay — Маршрутизация событий и автоматизация
//!
//! `rill-patchbay` является эволюцией `rill-automation` из версии 0.2.0,
//! объединённой с функциональностью маппинга из `rill-control`.
//!
//! ## Основные компоненты
//!
//! - **Автоматы** — генеративные источники сигналов (LFO, огибающие, секвенсоры)
//! - **Сервоприводы** — связь автоматов с параметрами узлов
//! - **Маппинги** — связь внешних событий (MIDI/OSC) с параметрами
//! - **Сенсоры** — источники событий из внешнего мира
//! - **Менеджер** — центральный координатор для двухпоточной архитектуры
//!
//! ## Архитектура
//!
//! ```text
//! ┌─────────────────────────────────────────────────────────────┐
//! │                     ПОТОК УПРАВЛЕНИЯ                         │
//! │                                                              │
//! │  ┌─────────────────────────────────────────────────────┐   │
//! │  │               PatchbayManager                         │   │
//! │  │  ┌────────────┐  ┌────────────┐  ┌────────────┐     │   │
//! │  │  │  Automata  │  │  Servos    │  │  Mappings  │     │   │
//! │  │  └────────────┘  └────────────┘  └────────────┘     │   │
//! │  │                    │                │                │   │
//! │  │                    ▼                ▼                │   │
//! │  │              ┌──────────────────────────┐           │   │
//! │  │              │   RtQueue<ParameterCommand>│         │   │
//! │  │              └──────────────────────────┘           │   │
//! │  └─────────────────────────────────────────────────────┘   │
//! │                              │                               │
//! │                              │ неблокирующая очередь         │
//! │                              ▼                               │
//! │  ┌─────────────────────────────────────────────────────┐   │
//! │  │                  АУДИОПОТОК                          │   │
//! │  │              (rill-graph / rill-io)                  │   │
//! │  └─────────────────────────────────────────────────────┘   │
//! └─────────────────────────────────────────────────────────────┘
//! ```

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

// =============================================================================
// Внешние зависимости
// =============================================================================

// Реэкспорты из rill-core
pub use rill_core::prelude::*;
pub use rill_core::queues::RtQueue;
pub use rill_core::{NodeId, ParamValue, ParameterId, PortId};

// =============================================================================
// Публичные модули
// =============================================================================

/// Автоматы — генеративные источники управления
pub mod automaton;

/// Управление и маппинг событий
pub mod control;

/// Менеджер патчбэя — центральный координатор
pub mod manager;

/// Сенсоры — источники событий из внешнего мира
pub mod sensor;

/// Утилиты и вспомогательные функции
pub mod utils;

// =============================================================================
// Реэкспорты для удобства
// =============================================================================

// Selective re-exports
pub use automaton::{
    EnvelopeAutomaton, EnvelopeStage, EnvelopeType, FunctionAutomaton, LfoAutomaton, LfoWaveform,
    PlayMode, Range, SequencerAutomaton, StatefulFunctionAutomaton, Step, SyncMode,
};
pub use control::{
    midi_cc, osc_address, AnyServo, Automaton, BoxedServo, ControlEvent, EventPattern, Mapping,
    NoAction, ParameterCommand, ParameterMapping, PatchbayControl, Servo, Target, Transform,
};
pub use manager::PatchbayManager;

// =============================================================================
// Прелюдия для удобного импорта
// =============================================================================

/// Прелюдия для удобного импорта основных типов
pub mod prelude {
    // Основные типы
    pub use crate::automaton::*;
    pub use crate::control::*;
    pub use crate::manager::*;
    pub use crate::utils::*;

    // Реэкспорты из rill-core
    pub use rill_core::prelude::*;
    pub use rill_core::queues::RtQueue;
    pub use rill_core::{NodeId, ParameterId, PortId};
}

// =============================================================================
// Тесты
// =============================================================================

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_basic_imports() {
        // Просто проверяем, что всё импортируется
        let _ = automaton::LfoWaveform::Sine;
        let _ = control::Transform::Linear;
        let _ = manager::PatchbayConfig::default();
    }
}