// yabridge: a Wine plugin bridge // Copyright (C) 2020-2022 Robbert van der Helm // // This program is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with this program. If not, see . #pragma once #include #include #include #include #include #include #include #include #include #include #include #include "../../common/serialization/clap/plugin-factory.h" // Forward declaration to avoid circular includes class ClapBridge; /** * A proxy for a plugin's `clap_host`. * * Because the plugin may not query host extensions until `init()` is called, * the available host extensions will only be populated at that point. */ class clap_host_proxy { public: /** * Construct a host proxy based for a plugin. The available extensions will * be populated when the host calls `clap_plugin::init()` as mentioned * above. */ clap_host_proxy(ClapBridge& bridge, size_t owner_instance_id, clap::host::Host host_args); clap_host_proxy(const clap_host_proxy&) = delete; clap_host_proxy& operator=(const clap_host_proxy&) = delete; clap_host_proxy(clap_host_proxy&&) = delete; clap_host_proxy& operator=(clap_host_proxy&&) = delete; /** * Get a `clap_host` vtable that can be passed to the plugin. */ inline const clap_host_t* host_vtable() const { return &host_vtable_; } /** * The instance ID of the plugin instance this proxy belongs to. */ inline size_t owner_instance_id() const { return owner_instance_id_; } /** * The extensions supported by the host, set just before calling * `clap_plugin::init()` on the bridged plugin. We'll allow the plugin to * query these extensions through `clap_host::get_extension()`. */ clap::host::SupportedHostExtensions supported_extensions_; protected: static const void* CLAP_ABI host_get_extension(const struct clap_host* host, const char* extension_id); static void CLAP_ABI host_request_restart(const struct clap_host* host); static void CLAP_ABI host_request_process(const struct clap_host* host); static void CLAP_ABI host_request_callback(const struct clap_host* host); static bool CLAP_ABI ext_audio_ports_is_rescan_flag_supported(const clap_host_t* host, uint32_t flag); static void CLAP_ABI ext_audio_ports_rescan(const clap_host_t* host, uint32_t flags); static void CLAP_ABI ext_gui_resize_hints_changed(const clap_host_t* host); static bool CLAP_ABI ext_gui_request_resize(const clap_host_t* host, uint32_t width, uint32_t height); static bool CLAP_ABI ext_gui_request_show(const clap_host_t* host); static bool CLAP_ABI ext_gui_request_hide(const clap_host_t* host); static void CLAP_ABI ext_gui_closed(const clap_host_t* host, bool was_destroyed); static void CLAP_ABI ext_latency_changed(const clap_host_t* host); static void CLAP_ABI ext_log_log(const clap_host_t* host, clap_log_severity severity, const char* msg); static uint32_t CLAP_ABI ext_note_ports_supported_dialects(const clap_host_t* host); static void CLAP_ABI ext_note_ports_rescan(const clap_host_t* host, uint32_t flags); static void CLAP_ABI ext_params_rescan(const clap_host_t* host, clap_param_rescan_flags flags); static void CLAP_ABI ext_params_clear(const clap_host_t* host, clap_id param_id, clap_param_clear_flags flags); static void CLAP_ABI ext_params_request_flush(const clap_host_t* host); static void CLAP_ABI ext_state_mark_dirty(const clap_host_t* host); static void CLAP_ABI ext_tail_changed(const clap_host_t* host); static bool CLAP_ABI ext_thread_check_is_main_thread(const clap_host_t* host); static bool CLAP_ABI ext_thread_check_is_audio_thread(const clap_host_t* host); private: ClapBridge& bridge_; size_t owner_instance_id_; clap::host::Host host_args_; /** * The vtable for `clap_host`, requires that this object is never moved or * copied. We'll use the host data pointer instead of placing this vtable at * the start of the struct and directly casting the `clap_host_t*`. */ const clap_host_t host_vtable_; // Extensions also have vtables. Whether or not we expose these to the host // depends on whether the plugin supported this extension when the host // called `clap_plugin::init()`. const clap_host_audio_ports_t ext_audio_ports_vtable; const clap_host_gui_t ext_gui_vtable; const clap_host_latency_t ext_latency_vtable; // This is also always available regardless of the proxied host. That way we // can filter out plugin/host misbehavior messages on lower yabridge // verbosity levels. const clap_host_log_t ext_log_vtable; const clap_host_note_ports_t ext_note_ports_vtable; const clap_host_params_t ext_params_vtable; const clap_host_state_t ext_state_vtable; const clap_host_tail_t ext_tail_vtable; // This is always available regardless of the proxied host const clap_host_thread_check_t ext_thread_check_vtable; /** * Keeps track of whether there are pending host callbacks. Used to prevent * calling `clap_plugin::on_main_thread()` multiple times in a row when the * plugin calls `clap_host::request_callback()` multiple times before * `clap_plugin::on_main_thread()` is called. */ std::atomic_bool has_pending_host_callbacks_ = false; };