feat(vst): stand up VST3 instrument spike (S1) — skeleton, IPlugView↔LICE editor, REAPER bridge read

Vendor Steinberg VST3 SDK (v3.7.9_build_61); add reasampler_vst.vst3 as a second, additive build artifact with pure editor-geometry + bridge-marshal helpers under CTest.
2026-07-26 15:29:54 -04:00
parent 5595ba42f9
commit 3c2a7c45b2
17 changed files with 1256 additions and 0 deletions
@@ -0,0 +1,45 @@
+// vst_entry.cpp — the VST3 module class factory (Phase S1). Enumerates the one class
+// this module offers (the ReaSampler instrument) via the SDK's factory macros. The
+// Windows module exports — GetPluginFactory (here, via BEGIN_FACTORY) and
+// InitDll/ExitDll (from the SDK's dllmain.cpp) — are how REAPER discovers and loads a
+// VST3.
+//
+// VERIFIED (corrects §1a's "experienced estimate" flags on export names + macros,
+// against vendor/vst3sdk/public.sdk/source/main/):
+//   * Windows exports: InitDll / ExitDll (SMTG_EXPORT_SYMBOL, in dllmain.cpp) +
+//     GetPluginFactory (SMTG_EXPORT_SYMBOL IPluginFactory* PLUGIN_API, emitted by the
+//     BEGIN_FACTORY macro). The plug-in must provide InitModule/DeinitModule — supplied
+//     here by linking moduleinit.cpp (the SDK's default one-time init/term).
+//   * Factory macros: BEGIN_FACTORY(vendor,url,email,flags) / DEF_CLASS2(...) /
+//     END_FACTORY — exact spellings from pluginfactory.h.
+//   * Instrument subcategory string: "Instrument|Synth|Sampler"
+//     (PlugType::kInstrumentSynthSampler, ivstaudioprocessor.h).
+//   * classFlags = 0 for a SingleComponentEffect (non-distributable), matching the
+//     AGain example.
+
+#include "public.sdk/source/main/pluginfactory.h"
+
+#include "pluginterfaces/vst/ivstaudioprocessor.h"  // kVstAudioEffectClass, PlugType
+
+#include "reasampler_processor.h"
+#include "reasampler_vst.h"
+
+// A concrete version string for PClassInfo2. Phase V owns the real version scheme; the
+// spike ships a fixed 0.1.0.
+#define REASAMPLER_VST_VERSION "0.1.0.0"
+
+BEGIN_FACTORY(reasampler::vst::kVendorName, reasampler::vst::kVendorUrl,
+              reasampler::vst::kVendorEmail, Steinberg::PFactoryInfo::kNoFlags)
+
+DEF_CLASS2(INLINE_UID(REASAMPLER_PROC_UID_1, REASAMPLER_PROC_UID_2,
+                      REASAMPLER_PROC_UID_3, REASAMPLER_PROC_UID_4),
+           Steinberg::PClassInfo::kManyInstances,       // cardinality
+           kVstAudioEffectClass,                        // component category (fixed)
+           reasampler::vst::kPluginName,                // plug-in display name
+           0,                                           // single-component => 0
+           Steinberg::Vst::PlugType::kInstrumentSynthSampler,  // subcategory
+           REASAMPLER_VST_VERSION,                      // plug-in version
+           kVstVersionString,                           // VST3 SDK version (fixed)
+           reasampler::vst::ReaSamplerProcessor::createInstance)
+
+END_FACTORY