// yabridge: a Wine VST 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 "../../../bitsery/ext/in-place-optional.h"
#include "../../common.h"
#include "../base.h"
#include "../context-menu-target.h"
#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wnon-virtual-dtor"
/**
* Wraps around `IContextMenu` for serialization purposes. This is instantiated
* as part of `Vst3ContextMenuProxy`.
*
* Plugins can also call context menu items created by the host, in which case
* we'll proxy that call through to the host.
*/
class YaContextMenu : public Steinberg::Vst::IContextMenu {
public:
/**
* These are the arguments for creating a `YaContextMenu`.
*/
struct ConstructArgs {
ConstructArgs() noexcept;
/**
* Check whether an existing implementation implements `IContextMenu`
* and read arguments from it.
*/
ConstructArgs(Steinberg::IPtr object) noexcept;
/**
* Whether the object supported this interface.
*/
bool supported;
/**
* The context menu items prepopulated by the host so the plugin can
* call them. These items will receive `YaContextMenuTarget` proxy
* targets in `Vst3ContextMenuProxyImpl`, so when the plugin calls them
* it will dispatch a call to the host instead.
*/
std::vector items;
template
void serialize(S& s) {
s.value1b(supported);
s.container(items, 1 << 16);
}
};
/**
* Instantiate this instance with arguments read from another interface
* implementation.
*/
YaContextMenu(ConstructArgs&& args) noexcept;
inline bool supported() const noexcept { return arguments_.supported; }
// Since we pass along a list of initial items, we don't need to proxy this
// unless the host somehow adds more items after the plugin adds an item
virtual int32 PLUGIN_API getItemCount() override = 0;
// Plugins can also call context menu items created by the host
virtual tresult PLUGIN_API
getItem(int32 index,
Steinberg::Vst::IContextMenuItem& item /*out*/,
Steinberg::Vst::IContextMenuTarget** target /*out*/) override = 0;
/**
* Message to pass through a call to `IContextMenu::addItem(item, )`
* to the corresponding context menu instance returned by the host. We'll
* create a proxy for `target` based on `item->tag` on the plugin side that
* forwards a call to the original target passed by the Windows VST3 plugin.
*/
struct AddItem {
using Response = UniversalTResult;
native_size_t owner_instance_id;
native_size_t context_menu_id;
// Steinberg seems to hav emessed up their naming scheme here, since
// this is most definitely not an interface
Steinberg::Vst::IContextMenuItem item;
/**
* Will be a nullopt if the plugin does not pass a `target` pointer. I'm
* not sure if this is optional since there are no implementations for
* this interface to be found, but I can imagine that this could be
* optional for disabled menu items or for group starts/ends.
*/
std::optional target;
template
void serialize(S& s) {
s.value8b(owner_instance_id);
s.value8b(context_menu_id);
s.object(item);
s.ext(target, bitsery::ext::InPlaceOptional{});
}
};
virtual tresult PLUGIN_API
addItem(const Steinberg::Vst::IContextMenuItem& item,
Steinberg::Vst::IContextMenuTarget* target) override = 0;
/**
* Message to pass through a call to `IContextMenu::removeItem(item,
* )` to the corresponding context menu instance returned by the
* host. We'll pass the target already stored in our `Vst3PluginProxyImpl`
* object. Not sure why it is even needed here.
*/
struct RemoveItem {
using Response = UniversalTResult;
native_size_t owner_instance_id;
native_size_t context_menu_id;
Steinberg::Vst::IContextMenuItem item;
template
void serialize(S& s) {
s.value8b(owner_instance_id);
s.value8b(context_menu_id);
s.object(item);
}
};
virtual tresult PLUGIN_API
removeItem(const Steinberg::Vst::IContextMenuItem& item,
Steinberg::Vst::IContextMenuTarget* target) override = 0;
/**
* Message to pass through a call to `IContextMenu::popup(x, y)` to the
* corresponding context menu instance returned by the host.
*/
struct Popup {
using Response = UniversalTResult;
native_size_t owner_instance_id;
native_size_t context_menu_id;
Steinberg::UCoord x;
Steinberg::UCoord y;
template
void serialize(S& s) {
s.value8b(owner_instance_id);
s.value8b(context_menu_id);
s.value4b(x);
s.value4b(y);
}
};
virtual tresult PLUGIN_API popup(Steinberg::UCoord x,
Steinberg::UCoord y) override = 0;
protected:
ConstructArgs arguments_;
};
#pragma GCC diagnostic pop
namespace Steinberg {
namespace Vst {
template
void serialize(S& s, IContextMenuItem& item) {
s.container2b(item.name);
s.value4b(item.tag);
s.value4b(item.flags);
}
} // namespace Vst
} // namespace Steinberg