// yabridge: a Wine VST bridge
// Copyright (C) 2020 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 "../../common.h"
#include "../base.h"
#include "../message.h"
#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wnon-virtual-dtor"
/**
* Wraps around `IConnectionPoint` for serialization purposes. This is
* instantiated as part of `Vst3PluginProxy`. Because we use this giant
* monolithic proxy class we can easily directly connect different objects by
* checking if they're a `Vst3PluginProxy` and then fetching that object's
* instance ID (if the host doesn't place a proxy object here).
*/
class YaConnectionPoint : public Steinberg::Vst::IConnectionPoint {
public:
/**
* These are the arguments for creating a `YaConnectionPoint`.
*/
struct ConstructArgs {
ConstructArgs();
/**
* Check whether an existing implementation implements
* `IConnectionPoint` and read arguments from it.
*/
ConstructArgs(Steinberg::IPtr object);
/**
* Whether the object supported this interface.
*/
bool supported;
template
void serialize(S& s) {
s.value1b(supported);
}
};
protected:
/**
* These are the arguments for constructing a
* `Vst3ConnectionPointProxyImpl`.
*
* It's defined here to work around circular includes.
*/
struct Vst3ConnectionPointProxyConstructArgs {
Vst3ConnectionPointProxyConstructArgs();
/**
* Read from an existing object. We will try to mimic this object, so
* we'll support any interfaces this object also supports.
*
* This is not necessary in this case since the object has to support
* `IConnectionPoint`, but let's stay consistent with the overall style
* here.
*/
Vst3ConnectionPointProxyConstructArgs(Steinberg::IPtr object,
size_t owner_instance_id);
/**
* The unique instance identifier of the proxy object instance this
* connection proxy has been passed to and thus belongs to. This way we
* can refer to the correct 'actual' `IConnectionPoint` instance when
* the plugin calls `notify()` on this proxy object.
*/
native_size_t owner_instance_id;
ConstructArgs connection_point_args;
template
void serialize(S& s) {
s.value8b(owner_instance_id);
s.object(connection_point_args);
}
};
public:
/**
* Instantiate this instance with arguments read from another interface
* implementation.
*/
YaConnectionPoint(const ConstructArgs&& args);
inline bool supported() const { return arguments.supported; }
/**
* Message to pass through a call to `IConnectionPoint::connect(other)` to
* the Wine plugin host. If the host directly connects two objects, then
* we'll connect them directly as well. Otherwise all messages have to be
* routed through the host.
*/
struct Connect {
using Response = UniversalTResult;
native_size_t instance_id;
/**
* The other object this object should be connected to. When connecting
* two `Vst3PluginProxy` objects, we can directly connect the underlying
* objects on the Wine side using their instance IDs. Otherwise we'll
* create a proxy object for the connection proxy provided by the host
* that the plugin can use to send messages to.
*/
std::variant
other;
template
void serialize(S& s) {
s.value8b(instance_id);
s.ext(other,
bitsery::ext::StdVariant{
[](S& s, native_size_t& other_instance_id) {
s.value8b(other_instance_id);
},
[](S& s, Vst3ConnectionPointProxyConstructArgs& args) {
s.object(args);
}});
}
};
virtual tresult PLUGIN_API connect(IConnectionPoint* other) override = 0;
/**
* Message to pass through a call to `IConnectionPoint::disconnect(other)`
* to the Wine plugin host.
*/
struct Disconnect {
using Response = UniversalTResult;
native_size_t instance_id;
/**
* If we connected two objects directly, then this is the instance ID of
* that object. Otherwise we'll just destroy the smart pointer pointing
* to our `IConnectionPoint` proxy object.
*/
std::optional other_instance_id;
template
void serialize(S& s) {
s.value8b(instance_id);
s.ext(other_instance_id, bitsery::ext::StdOptional{},
[](S& s, native_size_t& instance_id) {
s.value8b(instance_id);
});
}
};
virtual tresult PLUGIN_API disconnect(IConnectionPoint* other) override = 0;
/**
* Message to pass through a call to `IConnectionPoint::notify(message)` to
* the Wine plugin host. Since `IAttributeList` does not have any way to
* iterate over all values, we only support messages sent by plugins using
* our own implementation of the interface, since there's no way to
* serialize them otherwise. Additionally, plugins may store the `IMessage`
* pointer for later usage, so we have to pass through a pointer to the
* original message so it has the same lifetime as the original message.
* This `IConnectionPoint::notify()` implementation is also only used with
* hosts that do not connect objects directly and use connection proxies
* instead.
*/
struct Notify {
using Response = UniversalTResult;
native_size_t instance_id;
YaMessagePtr message_ptr;
template
void serialize(S& s) {
s.value8b(instance_id);
s.object(message_ptr);
}
};
virtual tresult PLUGIN_API
notify(Steinberg::Vst::IMessage* message) override = 0;
protected:
ConstructArgs arguments;
};
#pragma GCC diagnostic pop