From 042f0a192f862ac8f672aed03c3c6ea241f796f1 Mon Sep 17 00:00:00 2001 From: Robin Gareus Date: Mon, 5 Oct 2020 16:38:12 +0200 Subject: [PATCH] VST3: Add PreSonus Plug-In Extensions --- libs/vst3/pslextensions/README | 6 + libs/vst3/pslextensions/ipslcontextinfo.h | 210 +++++++++++++++++++ libs/vst3/pslextensions/ipsleditcontroller.h | 108 ++++++++++ libs/vst3/pslextensions/ipslgainreduction.h | 53 +++++ libs/vst3/pslextensions/ipslhostcommands.h | 121 +++++++++++ libs/vst3/pslextensions/ipslviewembedding.h | 53 +++++ libs/vst3/pslextensions/ipslviewscaling.h | 67 ++++++ libs/vst3/vst3.h | 11 +- 8 files changed, 627 insertions(+), 2 deletions(-) create mode 100644 libs/vst3/pslextensions/README create mode 100644 libs/vst3/pslextensions/ipslcontextinfo.h create mode 100644 libs/vst3/pslextensions/ipsleditcontroller.h create mode 100644 libs/vst3/pslextensions/ipslgainreduction.h create mode 100644 libs/vst3/pslextensions/ipslhostcommands.h create mode 100644 libs/vst3/pslextensions/ipslviewembedding.h create mode 100644 libs/vst3/pslextensions/ipslviewscaling.h diff --git a/libs/vst3/pslextensions/README b/libs/vst3/pslextensions/README new file mode 100644 index 0000000000..23dce3fdbb --- /dev/null +++ b/libs/vst3/pslextensions/README @@ -0,0 +1,6 @@ +PreSonus Plug-In Extensions +--------------------------- + +https://www.presonussoftware.com/en_US/developer +https://www.presonussoftware.com/developer/pslextensions.zip +downloaded 2020-10-05 diff --git a/libs/vst3/pslextensions/ipslcontextinfo.h b/libs/vst3/pslextensions/ipslcontextinfo.h new file mode 100644 index 0000000000..10327ba215 --- /dev/null +++ b/libs/vst3/pslextensions/ipslcontextinfo.h @@ -0,0 +1,210 @@ +//************************************************************************************************ +// +// PreSonus Plug-In Extensions +// Written and placed in the PUBLIC DOMAIN by PreSonus Software Ltd. +// +// Filename : ipslcontextinfo.h +// Created by : PreSonus Software Ltd., 08/2013, last updated 05/2019 +// Description : Context Information Interface +// +//************************************************************************************************ +/* + DISCLAIMER: + The PreSonus Plug-In Extensions are host-specific extensions of existing proprietary technologies, + provided to the community on an AS IS basis. They are not part of any official 3rd party SDK and + PreSonus is not affiliated with the owner of the underlying technology in any way. +*/ +//************************************************************************************************ + +#ifndef _ipslcontextinfo_h +#define _ipslcontextinfo_h + +#include "pluginterfaces/vst/vsttypes.h" +#include "pluginterfaces/base/falignpush.h" + +namespace Presonus { + +//************************************************************************************************ +// IContextInfoProvider +/** Callback interface to access context information from the host. Implemented by the host + as extension of Steinberg::Vst::IComponentHandler. + + The host might not be able to report all available attributes at all times. Please check the + return value of getContextInfoValue() and getContextInfoString(). It's not required to implement + IContextInfoHandler on the plug-in side, but we recommend to do so. The host will then call + notifyContextInfoChange() during initialization to inform the plug-in about the initial state of + the available attributes. + + Usage Example: + + IComponentHandler* handler; + FUnknownPtr contextInfoProvider (handler); + + void PLUGIN_API MyEditController::notifyContextInfoChange () + { + int32 channelIndex = 0; + contextInfoProvider->getContextInfoValue (channelIndex, ContextInfo::kIndex); + + TChar channelName[128] = {0}; + contextInfoProvider->getContextInfoString (channelName, 128, ContextInfo::kName); + } +*/ +//************************************************************************************************ + +struct IContextInfoProvider: Steinberg::FUnknown +{ + /** Get context information by identifier. */ + virtual Steinberg::tresult PLUGIN_API getContextInfoValue (Steinberg::int32& value, Steinberg::FIDString id) = 0; + + /** Get context information by identifier. */ + virtual Steinberg::tresult PLUGIN_API getContextInfoString (Steinberg::Vst::TChar* string, Steinberg::int32 maxCharCount, Steinberg::FIDString id) = 0; + + static const Steinberg::FUID iid; +}; + +DECLARE_CLASS_IID (IContextInfoProvider, 0x483e61ea, 0x17994494, 0x8199a35a, 0xebb35e3c) + +//************************************************************************************************ +// IContextInfoProvider2 +/** Extension to IContextInfoProvider enabling the plug-in to modify host context information. + Values like volume or pan support both, numeric and string representation for get and set.*/ +//************************************************************************************************ + +struct IContextInfoProvider2: IContextInfoProvider +{ + using IContextInfoProvider::getContextInfoValue; + + /** Get context information by identifier (floating-point). */ + virtual Steinberg::tresult PLUGIN_API getContextInfoValue (double& value, Steinberg::FIDString id) = 0; + + /** Set context information by identifier (floating-point). */ + virtual Steinberg::tresult PLUGIN_API setContextInfoValue (Steinberg::FIDString id, double value) = 0; + + /** Set context information by identifier (integer). */ + virtual Steinberg::tresult PLUGIN_API setContextInfoValue (Steinberg::FIDString id, Steinberg::int32 value) = 0; + + /** Set context information by identifier (string). */ + virtual Steinberg::tresult PLUGIN_API setContextInfoString (Steinberg::FIDString id, Steinberg::Vst::TChar* string) = 0; + + static const Steinberg::FUID iid; +}; + +DECLARE_CLASS_IID (IContextInfoProvider2, 0x61e45968, 0x3d364f39, 0xb15e1733, 0x4944172b) + +//************************************************************************************************ +// IContextInfoProvider3 +/** Extension to IContextInfoProvider and IContextInfoProvider2 enabling the plug-in to + signal begin and end of editing for context information values. + Use IComponentHandler2::startGroupEdit() and IComponentHandler2::endGroupEdit() to signal group edits. */ +//************************************************************************************************ + +struct IContextInfoProvider3: IContextInfoProvider2 +{ + /** Begin edit of context info value, \see also IComponentHandler::beginEdit. */ + virtual Steinberg::tresult PLUGIN_API beginEditContextInfoValue (Steinberg::FIDString id) = 0; + + /** End edit of context info value, \see also IComponentHandler::endEdit. */ + virtual Steinberg::tresult PLUGIN_API endEditContextInfoValue (Steinberg::FIDString id) = 0; + + static const Steinberg::FUID iid; +}; + +DECLARE_CLASS_IID (IContextInfoProvider3, 0x4e31fdf8, 0x6f4448d4, 0xb4ec1461, 0x68a4150f) + +//************************************************************************************************ +// IContextInfoHandler +/** Notification interface for context information changes. Implemented by the plug-in as extension of + Steinberg::Vst::IEditController. */ +//************************************************************************************************ + +struct IContextInfoHandler: Steinberg::FUnknown +{ + /** Called by the host if context information has changed. */ + virtual void PLUGIN_API notifyContextInfoChange () = 0; + + static const Steinberg::FUID iid; +}; + +DECLARE_CLASS_IID (IContextInfoHandler, 0xc3b17bc0, 0x2c174494, 0x80293402, 0xfbc4bbf8) + +//************************************************************************************************ +// IContextInfoHandler2 +/** Replacement of IContextInfoHandler passing additional information about what changed on the host-side. + This interface will be preferred if implemented by the plug-in. It is required to + receive certain notifications like volume, pan, etc. */ +//************************************************************************************************ + +struct IContextInfoHandler2: Steinberg::FUnknown +{ + /** Called by the host if context information has changed. + The identifier (id) is empty for the inital update. */ + virtual void PLUGIN_API notifyContextInfoChange (Steinberg::FIDString id) = 0; + + static const Steinberg::FUID iid; +}; + +DECLARE_CLASS_IID (IContextInfoHandler2, 0x31e29a7a, 0xe55043ad, 0x8b95b9b8, 0xda1fbe1e) + +//************************************************************************************************ +// Context Information Attributes +//************************************************************************************************ + +namespace ContextInfo +{ + /** Channel types. */ + enum ChannelType + { + kTrack = 0, ///< audio track + kBus, ///< audio bus + kFX, ///< FX channel + kSynth, ///< output of virtual instrument + kIn, ///< input from audio driver + kOut ///< output to audio driver (main or sub-out) + }; + + /** Channel index mode. */ + enum ChannelIndexMode + { + kFlatIndex = 0, ///< channel indices are contiguous (example: track 1, track 2, bus 3, bus 4) + kPerTypeIndex ///< channel indices restarts at zero for each type (example: track 1, track 2, bus 1, bus 2) + }; + + // per instance + const Steinberg::FIDString kID = "id"; ///< (R) channel identifier, use to compare identity (string) + const Steinberg::FIDString kName = "name"; ///< (R/W) channel name, can be displayed to the user (string) + const Steinberg::FIDString kType = "type"; ///< (R) channel type (int32, see ChannelType enumeration) + const Steinberg::FIDString kMain = "main"; ///< (R) channel is main output (int32, 0: false, 1: true) + const Steinberg::FIDString kIndex = "index"; ///< (R) channel index (int32, starts at zero) + const Steinberg::FIDString kColor = "color"; ///< (R/W) channel color (int32: RGBA, starts with red value in lowest byte) + const Steinberg::FIDString kVisibility = "visibility"; ///< (R) channel visibility (int32, 0: false, 1: true) + const Steinberg::FIDString kSelected = "selected"; ///< (R/W) selection state, channel is selected exlusively and scrolled into view on write (int32, 0: false, 1: true) + const Steinberg::FIDString kMultiSelect = "multiselect"; ///< (W) select channel without unselecting others (int32, 0: false, 1: true) + const Steinberg::FIDString kFocused = "focused"; ///< (R) focus for user input when multiple channels are selected (int32, 0: false, 1: true) + + const Steinberg::FIDString kRegionName = "regionName"; ///< (R) name of region/event for region/event-based effects (string) + const Steinberg::FIDString kRegionSelected = "regionSelected"; ///< (R) selection state of region/event for region/event-based effects (int32, 0: false, 1: true) + + // per instance (requires IContextInfoHandler2 on plug-in side) + const Steinberg::FIDString kVolume = "volume"; ///< (R/W) volume factor [float, 0. = -oo dB, 1. = 0dB, etc.], also available as string + const Steinberg::FIDString kMaxVolume = "maxVolume"; ///< (R) maximum volume factor [float, 1. = 0dB], also available as string + const Steinberg::FIDString kPan = "pan"; ///< (R/W) stereo panning [float, < 0.5 = (L), 0.5 = (C), > 0.5 = (R)], also available as string + const Steinberg::FIDString kMute = "mute"; ///< (R/W) mute (int32, 0: false, 1: true) + const Steinberg::FIDString kSolo = "solo"; ///< (R/W) solo (int32, 0: false, 1: true) + const Steinberg::FIDString kSendCount = "sendcount"; ///< (R) send count [int] + const Steinberg::FIDString kSendLevel = "sendlevel"; ///< (R/W) send level factor, index is appended to id (e.g. "sendlevel0" for first), also available as string + const Steinberg::FIDString kMaxSendLevel = "maxSendlevel"; ///< (R) maximum send level factor, also available as string + + // global + const Steinberg::FIDString kActiveDocumentID = "activeDocumentID"; ///< (R) active document identifier, use to get identity of the active document (string) + const Steinberg::FIDString kDocumentID = "documentID"; ///< (R) document identifier, use to compare identity (string) + const Steinberg::FIDString kDocumentName = "documentName"; ///< (R) document name, can be displayed to user (string) + const Steinberg::FIDString kDocumentFolder = "documentFolder"; ///< (R) document folder (string) + const Steinberg::FIDString kAudioFolder = "audioFolder"; ///< (R) folder for audio files (string) + const Steinberg::FIDString kIndexMode = "indexMode"; ///< (R) channel index mode (default is flat, see ChannelIndexMode enumeration) +} + +} // namespace Presonus + +#include "pluginterfaces/base/falignpop.h" + +#endif // _ipslcontextinfo_h diff --git a/libs/vst3/pslextensions/ipsleditcontroller.h b/libs/vst3/pslextensions/ipsleditcontroller.h new file mode 100644 index 0000000000..5879e8c77b --- /dev/null +++ b/libs/vst3/pslextensions/ipsleditcontroller.h @@ -0,0 +1,108 @@ +//************************************************************************************************ +// +// PreSonus Plug-In Extensions +// Written and placed in the PUBLIC DOMAIN by PreSonus Software Ltd. +// +// Filename : ipsleditcontroller.h +// Created by : PreSonus Software Ltd., 02/2017, last updated 10/2017 +// Description : Plug-in Edit Controller Extension Interface +// +//************************************************************************************************ +/* + DISCLAIMER: + The PreSonus Plug-In Extensions are host-specific extensions of existing proprietary technologies, + provided to the community on an AS IS basis. They are not part of any official 3rd party SDK and + PreSonus is not affiliated with the owner of the underlying technology in any way. +*/ +//************************************************************************************************ + +#ifndef _ipsleditcontroller_h +#define _ipsleditcontroller_h + +#include "pluginterfaces/vst/vsttypes.h" +#include "pluginterfaces/base/funknown.h" +#include "pluginterfaces/base/falignpush.h" + +namespace Steinberg { +namespace Vst { +class IEditController; }} + +namespace Presonus { + +/** Parameter extra flags. Used with IEditControllerExtra. */ +enum ParamExtraFlags +{ + kParamFlagMicroEdit = 1<<0 ///< parameter should be displayed in host micro view +}; + +/** Automation mode. Used with IEditControllerExtra. */ +enum AutomationMode +{ + kAutomationNone = 0, ///< no automation data available + kAutomationOff, ///< data available, but mode is set to off + kAutomationRead, ///< data + read mode + kAutomationTouch, ///< data + touch mode + kAutomationLatch, ///< data + latch mode + kAutomationWrite ///< data + write mode +}; + +/** Slave mode. Used with ISlaveControllerHandler. */ +enum SlaveMode +{ + kSlaveModeNormal, ///< plug-in used in different location following given master + kSlaveModeLowLatencyClone ///< plug-in used as hidden slave for low latency processing following given master +}; + +//************************************************************************************************ +// IEditControllerExtra +/** Extension to Steinberg::Vst::IEditController with additonal flags and notifications + not available in the standard edit controller interface. */ +//************************************************************************************************ + +struct IEditControllerExtra: Steinberg::FUnknown +{ + /** Get extra flags for given parameter (see ParamExtraFlags). */ + virtual Steinberg::int32 PLUGIN_API getParamExtraFlags (Steinberg::Vst::ParamID id) = 0; + + /** Set automation mode for given parameter (see AutomationMode). */ + virtual Steinberg::tresult PLUGIN_API setParamAutomationMode (Steinberg::Vst::ParamID id, Steinberg::int32 automationMode) = 0; + + static const Steinberg::FUID iid; +}; + +DECLARE_CLASS_IID (IEditControllerExtra, 0x50553fd9, 0x1d2c4c24, 0xb410f484, 0xc5fb9f3f) + +//************************************************************************************************ +// ISlaveControllerHandler +/** Extension to Steinberg::Vst::IEditController used to notify the plug-in about slave instances. + + The host might decide to use "cloned" (slave) instances in various scenarios, e.g. to process + audio paths with different latencies simultaneously or to synchronize grouped plug-in instances + between multiple mixer channels - see SlaveMode. In this case multiple plug-in instances are active + at the same time even though it looks like one to the user, i.e. only the editor of the master + instance is visible and can be used to change parameters. The edit controller implementation has + to synchronize parameter changes between instances that aren't visible to the host internally. +*/ +//************************************************************************************************ + +struct ISlaveControllerHandler: Steinberg::FUnknown +{ + /** Add slave edit controller. Implementation must sync non-automatable parameters between + this instance (master) and given slave instance internally, i.e. when the master (this) + changes update all connected slaves. + */ + virtual Steinberg::tresult PLUGIN_API addSlave (Steinberg::Vst::IEditController* slave, Steinberg::int32 slaveMode) = 0; + + /** Remove slave edit controller. */ + virtual Steinberg::tresult PLUGIN_API removeSlave (Steinberg::Vst::IEditController* slave) = 0; + + static const Steinberg::FUID iid; +}; + +DECLARE_CLASS_IID (ISlaveControllerHandler, 0xd93894bd, 0x67454c29, 0x977ae2f5, 0xdb380434) + +} // namespace Presonus + +#include "pluginterfaces/base/falignpop.h" + +#endif // _ipsleditcontroller_h diff --git a/libs/vst3/pslextensions/ipslgainreduction.h b/libs/vst3/pslextensions/ipslgainreduction.h new file mode 100644 index 0000000000..098080e254 --- /dev/null +++ b/libs/vst3/pslextensions/ipslgainreduction.h @@ -0,0 +1,53 @@ +//************************************************************************************************ +// +// PreSonus Plug-In Extensions +// Written and placed in the PUBLIC DOMAIN by PreSonus Software Ltd. +// +// Filename : ipslgainreduction.h +// Created by : PreSonus Software Ltd., 03/2015 +// Description : Plug-in Gain Reduction Interface +// +//************************************************************************************************ +/* + DISCLAIMER: + The PreSonus Plug-In Extensions are host-specific extensions of existing proprietary technologies, + provided to the community on an AS IS basis. They are not part of any official 3rd party SDK and + PreSonus is not affiliated with the owner of the underlying technology in any way. +*/ +//************************************************************************************************ + +#ifndef _ipslgainreduction_h +#define _ipslgainreduction_h + +#include "pluginterfaces/base/funknown.h" +#include "pluginterfaces/base/falignpush.h" + +namespace Presonus { + +//************************************************************************************************ +// IGainReductionInfo +/** Interface to report gain reduction imposed to the audio signal by the plug-in to the + host for display in the UI. Implemented by the VST3 edit controller class. +*/ +//************************************************************************************************ + +struct IGainReductionInfo: Steinberg::FUnknown +{ + /** Get current gain reduction for display. The returned value in dB is either 0.0 (no reduction) + or negative. The host calls this function periodically while the plug-in is active. + The value is used AS IS for UI display purposes, without imposing additional ballistics or + presentation latency compensation. Be sure to return zero if processing is bypassed internally. + For multiple reduction stages, please report the sum in dB here. + */ + virtual double PLUGIN_API getGainReductionValueInDb () = 0; + + static const Steinberg::FUID iid; +}; + +DECLARE_CLASS_IID (IGainReductionInfo, 0x8e3c292c, 0x95924f9d, 0xb2590b1e, 0x100e4198) + +} // namespace Presonus + +#include "pluginterfaces/base/falignpop.h" + +#endif // _ipslgainreduction_h \ No newline at end of file diff --git a/libs/vst3/pslextensions/ipslhostcommands.h b/libs/vst3/pslextensions/ipslhostcommands.h new file mode 100644 index 0000000000..c52b709b40 --- /dev/null +++ b/libs/vst3/pslextensions/ipslhostcommands.h @@ -0,0 +1,121 @@ +//************************************************************************************************ +// +// PreSonus Plug-In Extensions +// Written and placed in the PUBLIC DOMAIN by PreSonus Software Ltd. +// +// Filename : ipslhostcommands.h +// Created by : PreSonus Software Ltd., 11/2009 +// Description : Host Command Interface +// +//************************************************************************************************ +/* + DISCLAIMER: + The PreSonus Plug-In Extensions are host-specific extensions of existing proprietary technologies, + provided to the community on an AS IS basis. They are not part of any official 3rd party SDK and + PreSonus is not affiliated with the owner of the underlying technology in any way. +*/ +//************************************************************************************************ + +#ifndef _ipslhostcommands_h +#define _ipslhostcommands_h + +#include "pluginterfaces/vst/vsttypes.h" +#include "pluginterfaces/base/funknown.h" +#include "pluginterfaces/base/falignpush.h" + +namespace Steinberg { +class IPlugView; } + +namespace Presonus { + +struct ICommandList; + +//************************************************************************************************ +// IHostCommandHandler +/** Callback interface to access host-specific parameter commands to be integrated + into a context menu inside the plug-in editor. Implemented as extension of + Steinberg::Vst::IComponentHandler. + + Please note that the intention of this set of interfaces is not to allow a generic menu + implementation. This is the responsibility of a GUI toolkit. It basically provides + a way to enumerate and execute commands anonymously, i.e. the plug-in does not have to + know the exact sematics of the commands and the host does not break the consistency of + the plug-in GUI. + + Usage Example: + + IComponentHandler* handler; + FUnknownPtr commandHandler (handler); + if(commandHandler) + if(ICommandList* commandList = commandHandler->createParamCommands (kMyParamId)) + { + FReleaser commandListReleaser (commandList); + commandHandler->popupCommandMenu (commandList, xPos, yPos); + } +*/ +//************************************************************************************************ + +struct IHostCommandHandler: Steinberg::FUnknown +{ + /** Create list of currently available host commands for given parameter. + The command list has a short lifecycle, it is recreated whenever + a context menu should appear. The returned pointer can be null, otherwise + it has to be released. */ + virtual ICommandList* PLUGIN_API createParamCommands (Steinberg::Vst::ParamID tag) = 0; + + /** Helper to popup a command menu at given position. + Coordinates are relative to view or in screen coordintes if view is null. + Can be used for testing purpose, if the plug-in does not have its own context menu implementation + or if it wants to use the look & feel of the host menu. This method is not supposed + to support command lists implemented by the plug-in. */ + virtual Steinberg::tresult PLUGIN_API popupCommandMenu (ICommandList* commandList, Steinberg::int32 xPos, Steinberg::int32 yPos, Steinberg::IPlugView* view = 0) = 0; + + static const Steinberg::FUID iid; +}; + +DECLARE_CLASS_IID (IHostCommandHandler, 0xF92032CD, 0x7A84407C, 0xABE6F863, 0x058EA6C2) + +//************************************************************************************************ +// CommandInfo +/** Describes a single command. */ +//************************************************************************************************ + +struct CommandInfo +{ + Steinberg::Vst::String128 title; ///< command title (possibly localized into active host language) + Steinberg::int32 flags; ///< command flags + + enum CommandFlags + { + kCanExecute = 1<<0, ///< used to display command enabled/disabled + kIsSeparator = 1<<1, ///< not a command, it's a separator + kIsChecked = 1<<2 ///< used to display command with a check mark + }; +}; + +//************************************************************************************************ +// ICommandList +/** Describes a list of commands. */ +//************************************************************************************************ + +struct ICommandList: Steinberg::FUnknown +{ + /** Returns the number of commands. */ + virtual Steinberg::int32 PLUGIN_API getCommandCount () = 0; + + /** Get command information for a given index. */ + virtual Steinberg::tresult PLUGIN_API getCommandInfo (Steinberg::int32 index, CommandInfo& info) = 0; + + /** Execute command at given index. */ + virtual Steinberg::tresult PLUGIN_API executeCommand (Steinberg::int32 index) = 0; + + static const Steinberg::FUID iid; +}; + +DECLARE_CLASS_IID (ICommandList, 0xC5A687DB, 0x82F344E9, 0xB378254A, 0x47C4D712) + +} // namespace Presonus + +#include "pluginterfaces/base/falignpop.h" + +#endif // _ipslhostcommands_h diff --git a/libs/vst3/pslextensions/ipslviewembedding.h b/libs/vst3/pslextensions/ipslviewembedding.h new file mode 100644 index 0000000000..c01a19b593 --- /dev/null +++ b/libs/vst3/pslextensions/ipslviewembedding.h @@ -0,0 +1,53 @@ +//************************************************************************************************ +// +// PreSonus Plug-In Extensions +// Written and placed in the PUBLIC DOMAIN by PreSonus Software Ltd. +// +// Filename : ipslviewembedding.h +// Created by : PreSonus Software Ltd., 05/2012 +// Description : Plug-in View Embedding Interface +// +//************************************************************************************************ +/* + DISCLAIMER: + The PreSonus Plug-In Extensions are host-specific extensions of existing proprietary technologies, + provided to the community on an AS IS basis. They are not part of any official 3rd party SDK and + PreSonus is not affiliated with the owner of the underlying technology in any way. +*/ +//************************************************************************************************ + +#ifndef _ipslviewembedding_h +#define _ipslviewembedding_h + +#include "pluginterfaces/base/funknown.h" +#include "pluginterfaces/base/falignpush.h" + +namespace Steinberg { +class IPlugView; } + +namespace Presonus { + +//************************************************************************************************ +// IPlugInViewEmbedding +/** Support for plug-in view embedding, to be implemented by the VST3 controller class. */ +//************************************************************************************************ + +class IPlugInViewEmbedding: public Steinberg::FUnknown +{ +public: + /** Check if view embedding is supported. */ + virtual Steinberg::TBool PLUGIN_API isViewEmbeddingSupported () = 0; + + /** Inform plug-in that its view will be embedded. */ + virtual Steinberg::tresult PLUGIN_API setViewIsEmbedded (Steinberg::IPlugView* view, Steinberg::TBool embedded) = 0; + + static const Steinberg::FUID iid; +}; + +DECLARE_CLASS_IID (IPlugInViewEmbedding, 0xda57e6d1, 0x1f3242d1, 0xad9c1a82, 0xfdb95695) + +} // namespace Presonus + +#include "pluginterfaces/base/falignpop.h" + +#endif // _ipslviewembedding_h diff --git a/libs/vst3/pslextensions/ipslviewscaling.h b/libs/vst3/pslextensions/ipslviewscaling.h new file mode 100644 index 0000000000..d61de41b9b --- /dev/null +++ b/libs/vst3/pslextensions/ipslviewscaling.h @@ -0,0 +1,67 @@ +//************************************************************************************************ +// +// PreSonus Plug-In Extensions +// Written and placed in the PUBLIC DOMAIN by PreSonus Software Ltd. +// +// Filename : ipslviewscaling.h +// Created by : PreSonus Software Ltd., 03/2015 +// Description : Plug-in View DPI Scaling Interface +// +//************************************************************************************************ +/* + DISCLAIMER: + The PreSonus Plug-In Extensions are host-specific extensions of existing proprietary technologies, + provided to the community on an AS IS basis. They are not part of any official 3rd party SDK and + PreSonus is not affiliated with the owner of the underlying technology in any way. +*/ +//************************************************************************************************ + +#ifndef _ipslviewscaling_h +#define _ipslviewscaling_h + +#include "pluginterfaces/base/funknown.h" +#include "pluginterfaces/base/falignpush.h" + +namespace Presonus { + +//************************************************************************************************ +// IPlugInViewScaling +/** Support for plug-in view content scaling, to be implemented by the VST3 IPlugView class. + + On Windows, if a process is "DPI-aware" and the system DPI setting is different from the default + value of 96 DPI, the application is responsible to scale the contents of its windows accordingly, + including child windows provided by 3rd party plug-ins. + + This interface is used by the host to inform the plug-in about the current scaling factor. + The scaling factor is used to convert user space coordinates aka DIPs (device-independent pixels) + to physical pixels on screen. + + The plug-in has to be prepared to deal with the following scaling factors: + + 96 DPI = 100% scaling (factor = 1.0) + 120 DPI = 125% scaling (factor = 1.25) + 144 DPI = 150% scaling (factor = 1.5) + 192 DPI = 200% scaling (factor = 2.0) + + On Windows 8.1 or later DPI settings are per monitor. The scaling factor for a window can change + when it is moved between screens. +*/ +//************************************************************************************************ + +struct IPlugInViewScaling: Steinberg::FUnknown +{ + /** Inform the view about the current content scaling factor. The scaling factor can change + if the window is moved between screens. + */ + virtual Steinberg::tresult PLUGIN_API setContentScaleFactor (float factor) = 0; + + static const Steinberg::FUID iid; +}; + +DECLARE_CLASS_IID (IPlugInViewScaling, 0x65ed9690, 0x8ac44525, 0x8aadef7a, 0x72ea703f) + +} // namespace Presonus + +#include "pluginterfaces/base/falignpop.h" + +#endif // _ipslviewscaling_h diff --git a/libs/vst3/vst3.h b/libs/vst3/vst3.h index cd7764401a..20e5b0ea89 100644 --- a/libs/vst3/vst3.h +++ b/libs/vst3/vst3.h @@ -58,10 +58,17 @@ #include "pluginterfaces/gui/iplugview.h" //#include "pluginterfaces/gui/iplugviewcontentscalesupport.h" - //#include "pluginterfaces/base/conststringtable.cpp" //#include "pluginterfaces/base/funknown.cpp" -// + +/* PSL Extensions */ +#include "pslextensions/ipslcontextinfo.h" +#include "pslextensions/ipsleditcontroller.h" +#include "pslextensions/ipslviewembedding.h" +#include "pslextensions/ipslviewscaling.h" +//#include "pslextensions/ipslgainreduction.h" +//#include "pslextensions/ipslhostcommands.h" + #if defined(__clang__) # pragma clang diagnostic pop #elif __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6)