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

use crate::extensions::wrapper::HostWrapper;
use crate::host::{HostExtensions, HostHandlers, HostInfo, SharedHandler};
use clack_common::utils::ClapVersion;
use clap_sys::host::clap_host;
use std::ffi::{CStr, c_void};

pub(crate) struct RawHostDescriptor {
    raw: clap_host,
    _host_info: HostInfo,
}

impl RawHostDescriptor {
    pub(crate) fn new<H: HostHandlers>(host_info: HostInfo) -> Self {
        let mut raw = clap_host {
            clap_version: ClapVersion::CURRENT.to_raw(),
            host_data: core::ptr::null_mut(),
            name: core::ptr::null_mut(),
            vendor: core::ptr::null_mut(),
            url: core::ptr::null_mut(),
            version: core::ptr::null_mut(),
            get_extension: Some(get_extension::<H>),
            request_restart: Some(request_restart::<H>),
            request_process: Some(request_process::<H>),
            request_callback: Some(request_callback::<H>),
        };

        host_info.write_to_raw(&mut raw);

        Self {
            raw,
            _host_info: host_info,
        }
    }

    #[inline]
    pub(crate) fn raw(&self) -> *const clap_host {
        &self.raw
    }

    #[inline]
    pub(crate) fn set_wrapper<H: HostHandlers>(&mut self, wrapper: &HostWrapper<H>) {
        self.raw.host_data = wrapper as *const _ as *mut _
    }
}

#[allow(clippy::missing_safety_doc)]
unsafe extern "C" fn get_extension<H: HostHandlers>(
    host: *const clap_host,
    identifier: *const std::os::raw::c_char,
) -> *const c_void {
    let identifier = CStr::from_ptr(identifier);
    let mut builder = HostExtensions::new(identifier);

    HostWrapper::<H>::handle(host, |h| {
        H::declare_extensions(&mut builder, h.shared());
        Ok(())
    });
    builder.found()
}

#[allow(clippy::missing_safety_doc)]
unsafe extern "C" fn request_restart<H: HostHandlers>(host: *const clap_host) {
    HostWrapper::<H>::handle(host, |h| {
        h.shared().request_restart();
        Ok(())
    });
}

#[allow(clippy::missing_safety_doc)]
unsafe extern "C" fn request_process<H: HostHandlers>(host: *const clap_host) {
    HostWrapper::<H>::handle(host, |h| {
        h.shared().request_process();
        Ok(())
    });
}

#[allow(clippy::missing_safety_doc)]
unsafe extern "C" fn request_callback<H: HostHandlers>(host: *const clap_host) {
    HostWrapper::<H>::handle(host, |h| {
        h.shared().request_callback();
        Ok(())
    });
}