EffectHostInterface.h

Go to the documentation of this file.

/*!********************************************************************
 
   Audacity: A Digital Audio Editor
 
   @file EffectHostInterface.h
 
   Paul Licameli
   split from EffectInterface.h
   
**********************************************************************/
 
#ifndef __AUDACITY_EFFECTHOSTINTERFACE_H__
#define __AUDACITY_EFFECTHOSTINTERFACE_H__
 
#include "ComponentInterfaceSymbol.h"
 
#include <functional>
#include <memory>
 
class EffectDefinitionInterface;
 
class wxDialog;
class wxWindow;
class EffectUIClientInterface;
class EffectSettings;
class EffectSettingsAccess;
class EffectUIHostInterface;
 
 
using EffectDialogFactory = std::function< wxDialog* (
   wxWindow &parent, EffectUIHostInterface &, EffectUIClientInterface &,
   EffectSettingsAccess & ) >;
 
class TrackList;
class WaveTrackFactory;
class NotifyingSelectedRegion;
class EffectProcessor;
 
/*************************************************************************************/
class AUDACITY_DLL_API EffectUIHostInterface
{
public:
   using EffectSettingsAccessPtr = std::shared_ptr<EffectSettingsAccess>;
 
   const static wxString kUserPresetIdent;
   const static wxString kFactoryPresetIdent;
   const static wxString kCurrentSettingsIdent;
   const static wxString kFactoryDefaultsIdent;
 
   EffectUIHostInterface &operator=(EffectUIHostInterface&) = delete;
   virtual ~EffectUIHostInterface();
 
   virtual const EffectDefinitionInterface& GetDefinition() const = 0;
 
 
   virtual int ShowHostInterface(
      wxWindow &parent, const EffectDialogFactory &factory,
      EffectSettingsAccess &access, bool forceModal = false
   ) = 0;
 
   virtual void Preview(EffectSettingsAccess &access, bool dryOnly) = 0;
   virtual bool SaveSettingsAsString(
      const EffectSettings &settings, wxString & parms) const = 0;
   virtual bool LoadSettingsFromString(
      const wxString & parms, EffectSettings &settings) const = 0;
   virtual bool IsBatchProcessing() const = 0;
   virtual void SetBatchProcessing() = 0;
   virtual void UnsetBatchProcessing() = 0;
 
 
   virtual bool DoEffect(
      EffectSettings &settings, 
      double projectRate, TrackList *list,
      WaveTrackFactory *factory, NotifyingSelectedRegion &selectedRegion,
      unsigned flags,
      // Prompt the user for input only if the next arguments are not all null.
      wxWindow *pParent = nullptr,
      const EffectDialogFactory &dialogFactory = {},
      const EffectSettingsAccessPtr &pAccess = nullptr
   ) = 0;
 
   virtual bool TransferDataToWindow(const EffectSettings &settings) = 0;
 
   virtual bool TransferDataFromWindow(EffectSettings &settings) = 0;
 
   virtual bool InitializeInstance(EffectSettings &settings) = 0;
};
 
#endif