clack-host 0.2.0

Low-level, safe Rust wrappers to create audio plugin hosts using the CLAP audio plugin API.
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

use clack_common::entry::EntryDescriptor;
use clack_common::factory::{Factory, RawFactoryPointer};
use clack_common::utils::ClapVersion;
use clack_plugin::entry::{Entry, EntryFactories};
use std::sync::Arc;

trait DynEntry: Send + Sync + 'static {
    fn declare_factories<'a>(&'a self, builder: &mut EntryFactories<'a>);
}

impl<E: Entry> DynEntry for E {
    #[inline]
    fn declare_factories<'a>(&'a self, builder: &mut EntryFactories<'a>) {
        <E as Entry>::declare_factories(self, builder);
    }
}

#[derive(Clone)]
pub(crate) struct ClackEntry {
    inner: Arc<dyn DynEntry>,
}

impl ClackEntry {
    pub const DUMMY_DESCRIPTOR: EntryDescriptor = EntryDescriptor {
        clap_version: ClapVersion::CURRENT.to_raw(),
        init: None,
        deinit: None,
        get_factory: None,
    };

    #[inline]
    pub fn new<E: Entry>(entry: E) -> Self {
        Self {
            inner: Arc::new(entry),
        }
    }

    pub fn get_factory<'a, F: Factory<'a>>(&'a self) -> Option<F> {
        let mut builder = EntryFactories::new(F::IDENTIFIERS);
        self.inner.declare_factories(&mut builder);

        let found = builder.found()?;

        // SAFETY: The Clack APIs guarantee this pointer is valid and match the given type
        unsafe { Some(F::from_raw(RawFactoryPointer::from_raw(found.cast()))) }
    }
}