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
48
49

use crate::host::HostHandlers;
use clack_common::extensions::*;
use std::ffi::{CStr, c_void};
use std::marker::PhantomData;
use std::ptr::NonNull;

/// A collection of all extensions supported for a given [`HostHandlers`] type.
///
/// Host can declare the different extensions they support by using the
/// [`register`](HostExtensions::register) method on this struct, during a call to
/// [`declare_extensions`](HostHandlers::declare_extensions).
pub struct HostExtensions<'a, H: ?Sized> {
    found: Option<NonNull<c_void>>,
    requested: &'a CStr,
    plugin_type: PhantomData<H>,
}

impl<'a, H: HostHandlers> HostExtensions<'a, H> {
    #[inline]
    pub(crate) fn new(requested: &'a CStr) -> Self {
        Self {
            found: None,
            requested,
            plugin_type: PhantomData,
        }
    }

    #[inline]
    pub(crate) fn found(&self) -> *const c_void {
        self.found
            .map(|p| p.as_ptr())
            .unwrap_or(core::ptr::null_mut())
    }

    /// Adds a given extension implementation to the list of extensions this plugin supports.
    pub fn register<E: ExtensionImplementation<H, ExtensionSide = HostExtensionSide>>(
        &mut self,
    ) -> &mut Self {
        if self.found.is_some() {
            return self;
        }

        if E::IDENTIFIERS.contains(&self.requested) {
            self.found = Some(E::IMPLEMENTATION.as_ptr())
        }

        self
    }
}