sim-lib-plugin-clap 0.1.0

Modeled CLAP-shaped plugin adapters for SIM audio graph processors (no native CLAP hosting).
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

use sim_kernel::{Cx, Lib, LibManifest, Linker, LoadCx, Result, Symbol};
use sim_lib_core::{SurfaceField, SurfacePackLib, SurfacePackSpec, SurfaceValueSpec, install_once};

const CLAP_PLUGIN_LIB_ID: &str = "plugin-clap";

/// Host-registered lib exporting the CLAP adapter cards, built on the shared
/// [`SurfacePackLib`] substrate.
pub struct ClapPluginLib;

impl Lib for ClapPluginLib {
    fn manifest(&self) -> LibManifest {
        clap_plugin_pack().manifest()
    }

    fn load(&self, cx: &mut LoadCx, linker: &mut Linker<'_>) -> Result<()> {
        clap_plugin_pack().load(cx, linker)
    }
}

/// Installs [`ClapPluginLib`] into `cx`, idempotently.
///
/// Repeated calls are a no-op via the shared `install_once` guard.
pub fn install_clap_plugin_lib(cx: &mut Cx) -> Result<()> {
    install_once(cx, &ClapPluginLib)?;
    Ok(())
}

/// Returns the qualified [`Symbol`]s of the cards exported by the CLAP plugin
/// lib (the event, parameter-map, host/export processor, and fixture cards).
pub fn clap_plugin_symbols() -> Vec<Symbol> {
    [
        "ClapEvent",
        "ClapParamMap",
        "ClapHostProcessor",
        "ClapExportedProcessor",
        "ClapGainFixture",
        "ClapSynthFixture",
    ]
    .into_iter()
    .map(|name| Symbol::qualified(CLAP_PLUGIN_LIB_ID, name))
    .collect()
}

fn clap_plugin_pack() -> SurfacePackLib {
    SurfacePackLib {
        spec: SurfacePackSpec {
            lib_id: Symbol::new(CLAP_PLUGIN_LIB_ID),
            values: clap_plugin_symbols()
                .into_iter()
                .map(|symbol| SurfaceValueSpec {
                    symbol: symbol.clone(),
                    fields: vec![
                        (Symbol::new("symbol"), SurfaceField::Symbol(symbol)),
                        (
                            Symbol::new("layer"),
                            SurfaceField::Str(CLAP_PLUGIN_LIB_ID.to_owned()),
                        ),
                        (
                            Symbol::new("kind"),
                            SurfaceField::Str("clap-plugin-adapter".to_owned()),
                        ),
                        (
                            Symbol::new("role"),
                            SurfaceField::Str("CLAP-shaped host and export adapter".to_owned()),
                        ),
                    ],
                })
                .collect(),
        },
    }
}