/* ============================================================================== This file is part of the JUCE framework. Copyright (c) Raw Material Software Limited JUCE is an open source framework subject to commercial or open source licensing. By downloading, installing, or using the JUCE framework, or combining the JUCE framework with any other source code, object code, content or any other copyrightable work, you agree to the terms of the JUCE End User Licence Agreement, and all incorporated terms including the JUCE Privacy Policy and the JUCE Website Terms of Service, as applicable, which will bind you. If you do not agree to the terms of these agreements, we will not license the JUCE framework to you, and you must discontinue the installation or download process and cease use of the JUCE framework. JUCE End User Licence Agreement: https://juce.com/legal/juce-8-licence/ JUCE Privacy Policy: https://juce.com/juce-privacy-policy JUCE Website Terms of Service: https://juce.com/juce-website-terms-of-service/ Or: You may also use this code under the terms of the AGPLv3: https://www.gnu.org/licenses/agpl-3.0.en.html THE JUCE FRAMEWORK IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, ARE DISCLAIMED. ============================================================================== */ #pragma once #ifndef DOXYGEN namespace juce { [[maybe_unused]] static Steinberg::FUID toSteinbergUID (const VST3Interface::Id& uid) { return Steinberg::FUID::fromTUID ((const char*) (uid.data())); } [[maybe_unused]] static VST3Interface::Id toVST3InterfaceId (const Steinberg::TUID uid) { VST3Interface::Id iid; std::memcpy (iid.data(), uid, iid.size()); return iid; } [[maybe_unused]] static VST3Interface::Id getVST3InterfaceId (VST3Interface::Type interfaceType) { #if JUCE_VST3_CAN_REPLACE_VST2 if (interfaceType == VST3Interface::Type::controller || interfaceType == VST3Interface::Type::component) return VST3Interface::vst2PluginId (JucePlugin_VSTUniqueID, JucePlugin_Name, interfaceType); #endif return VST3Interface::jucePluginId (JucePlugin_ManufacturerCode, JucePlugin_PluginCode, interfaceType); } [[maybe_unused]] static std::vector getAllVST3CompatibleClasses() { return { #if JUCE_VST3_CAN_REPLACE_VST2 getVST3InterfaceId (VST3Interface::Type::component), #endif #ifdef JUCE_VST3_COMPATIBLE_CLASSES JUCE_VST3_COMPATIBLE_CLASSES #endif }; } //============================================================================== // See https://steinbergmedia.github.io/vst3_dev_portal/pages/FAQ/Compatibility+with+VST+2.x+or+VST+1.html #ifdef JUCE_VST3_COMPATIBLE_CLASSES class JucePluginCompatibility final : public Steinberg::IPluginCompatibility { public: virtual ~JucePluginCompatibility() = default; JUCE_DECLARE_VST3_COM_REF_METHODS Steinberg::tresult PLUGIN_API getCompatibilityJSON (Steinberg::IBStream* stream) override { // We must avoid relying on any dependencies here including anything in juce_core std::string json = std::invoke ([] { static const auto newId = toSteinbergUID (getVST3InterfaceId (VST3Interface::Type::component)); static const auto oldIds = getAllVST3CompatibleClasses(); std::stringstream str; str << "[{" << "\"New\": \"" << VST3::UID { newId }.toString() << "\", " << "\"Old\": ["; for (size_t i = 0; i < oldIds.size(); ++i) { str << "\"" << std::hex << std::setfill ('0') << std::uppercase; for (auto byte : oldIds[i]) str << std::setw (2) << (int) byte; str.clear(); str << "\""; if (i < oldIds.size() - 1) str << ", "; } str << "]}]"; return str.str(); }); return stream->write (json.data(), (Steinberg::int32) json.size()); } Steinberg::tresult PLUGIN_API queryInterface (const Steinberg::TUID targetIID, void** obj) override { const auto result = testForMultiple (*this, targetIID, UniqueBase{}, UniqueBase{}); if (result.isOk()) return result.extract (obj); jassertfalse; // Something new? *obj = nullptr; return Steinberg::kNotImplemented; } inline static const Steinberg::FUID iid = toSteinbergUID (getVST3InterfaceId (VST3Interface::Type::compatibility)); private: std::atomic refCount { 1 }; }; #endif // JUCE_VST3_COMPATIBLE_CLASSES //============================================================================== class JucePluginFactoryBase : public Steinberg::IPluginFactory3 { public: JucePluginFactoryBase() = default; virtual ~JucePluginFactoryBase() = default; //============================================================================== JUCE_DECLARE_VST3_COM_REF_METHODS Steinberg::tresult PLUGIN_API queryInterface (const Steinberg::TUID targetIID, void** obj) final { const auto result = testForMultiple (*this, targetIID, UniqueBase{}, UniqueBase{}, UniqueBase{}, UniqueBase{}); if (result.isOk()) return result.extract (obj); jassertfalse; // Something new? *obj = nullptr; return Steinberg::kNotImplemented; } //============================================================================== Steinberg::int32 PLUGIN_API countClasses() final { return (Steinberg::int32) getClassEntries().size; } Steinberg::tresult PLUGIN_API getFactoryInfo (Steinberg::PFactoryInfo* info) final { if (info == nullptr) return Steinberg::kInvalidArgument; std::memcpy (info, &factoryInfo, sizeof (factoryInfo)); return Steinberg::kResultOk; } Steinberg::tresult PLUGIN_API getClassInfo (Steinberg::int32 index, Steinberg::PClassInfo* info) final { return getPClassInfo (index, info, &ClassEntry::info2); } Steinberg::tresult PLUGIN_API getClassInfo2 (Steinberg::int32 index, Steinberg::PClassInfo2* info) final { return getPClassInfo (index, info, &ClassEntry::info2); } Steinberg::tresult PLUGIN_API getClassInfoUnicode (Steinberg::int32 index, Steinberg::PClassInfoW* info) final { return getPClassInfo (index, info, &ClassEntry::infoW); } Steinberg::tresult PLUGIN_API setHostContext (Steinberg::FUnknown*) override { jassertfalse; return Steinberg::kNotImplemented; } Steinberg::tresult PLUGIN_API createInstance (Steinberg::FIDString cid, Steinberg::FIDString sourceIid, void** obj) override { *obj = nullptr; Steinberg::TUID tuid; std::memcpy (tuid, sourceIid, sizeof (tuid)); #if VST_VERSION >= 0x030608 auto sourceFuid = Steinberg::FUID::fromTUID (tuid); #else FUID sourceFuid; sourceFuid = tuid; #endif if (cid == nullptr || sourceIid == nullptr || ! sourceFuid.isValid()) { jassertfalse; // The host you're running in has severe implementation issues! return Steinberg::kInvalidArgument; } Steinberg::TUID iidToQuery; sourceFuid.toTUID (iidToQuery); for (auto& entry : getClassEntries()) { if (doUIDsMatch (entry.infoW.cid, cid)) { if (VSTComSmartPtr instance { createInstance (entry), IncrementRef::no }) { if (instance->queryInterface (iidToQuery, obj) == Steinberg::kResultOk) return Steinberg::kResultOk; } break; } } return Steinberg::kNoInterface; } protected: //============================================================================== struct ClassEntry { #ifndef JucePlugin_Vst3ComponentFlags #if JucePlugin_IsSynth #define JucePlugin_Vst3ComponentFlags Steinberg::Vst::kSimpleModeSupported #else #define JucePlugin_Vst3ComponentFlags 0 #endif #endif #ifndef JucePlugin_Vst3Category #if JucePlugin_IsSynth #define JucePlugin_Vst3Category Steinberg::Vst::PlugType::kInstrumentSynth #else #define JucePlugin_Vst3Category Steinberg::Vst::PlugType::kFx #endif #endif ClassEntry (VST3Interface::Type interfaceType, const char* name, bool includeFlagsAndCategory) noexcept : ClassEntry (getVST3InterfaceId (interfaceType), name, includeFlagsAndCategory) {} ClassEntry (VST3Interface::Id interfaceId, const char* name, bool includeFlagsAndCategory) noexcept : info2 ((const char*) interfaceId.data(), Steinberg::PClassInfo::kManyInstances, name, JucePlugin_Name, includeFlagsAndCategory ? JucePlugin_Vst3ComponentFlags : 0, includeFlagsAndCategory ? JucePlugin_Vst3Category : "", JucePlugin_Manufacturer, JucePlugin_VersionString, kVstVersionString) { infoW.fromAscii (info2); } Steinberg::PClassInfo2 info2; Steinberg::PClassInfoW infoW; private: JUCE_DECLARE_NON_COPYABLE (ClassEntry) }; struct ClassEntrySpan { const ClassEntry* data{}; size_t size{}; const ClassEntry* begin() const { return data; } const ClassEntry* end() const { return data + size; } }; static ClassEntrySpan getClassEntries() { static const ClassEntry classEntries[] { #ifdef JUCE_VST3_COMPATIBLE_CLASSES { VST3Interface::Type::compatibility, kPluginCompatibilityClass, false }, #endif { VST3Interface::Type::component, kVstAudioEffectClass, true }, { VST3Interface::Type::controller, kVstComponentControllerClass, true }, #if JucePlugin_Enable_ARA { VST3Interface::Type::ara, kARAMainFactoryClass, true } #endif }; return { classEntries, std::size (classEntries) }; } virtual Steinberg::FUnknown* createInstance (const ClassEntry& entry) { #ifdef JUCE_VST3_COMPATIBLE_CLASSES if (doUIDsMatch (entry.info2.cid, JucePluginCompatibility::iid.toTUID())) return new JucePluginCompatibility(); #else (void) entry; #endif jassertfalse; return {}; } private: const ClassEntry& getClassEntry (Steinberg::int32 index) const { return getClassEntries().data[index]; } //============================================================================== template Steinberg::tresult PLUGIN_API getPClassInfo (Steinberg::int32 index, PClassInfoTargetType* info, PClassInfoSourceType ClassEntry::*source) { if (info == nullptr) { jassertfalse; return Steinberg::kInvalidArgument; } JUCE_BEGIN_IGNORE_WARNINGS_GCC_LIKE ("-Wclass-memaccess") std::memcpy (info, &(getClassEntry (index).*source), sizeof (*info)); JUCE_END_IGNORE_WARNINGS_GCC_LIKE return Steinberg::kResultOk; } //============================================================================== std::atomic refCount { 1 }; const Steinberg::PFactoryInfo factoryInfo { JucePlugin_Manufacturer, JucePlugin_ManufacturerWebsite, JucePlugin_ManufacturerEmail, Steinberg::Vst::kDefaultFactoryFlags }; //============================================================================== // no leak detector here to prevent it firing on shutdown when running in hosts that // don't release the factory object correctly... JUCE_DECLARE_NON_COPYABLE (JucePluginFactoryBase) }; } // namespace juce #endif // DOXYGEN