PluginRegistrationDialog Class Reference

#include <PluginRegistrationDialog.h>

Inheritance diagram for PluginRegistrationDialog:

Collaboration diagram for PluginRegistrationDialog:

Public Member Functions
	PluginRegistrationDialog (wxWindow *parent, int defaultEffectCategory=-1)
Public Member Functions inherited from wxDialogWrapper
	wxDialogWrapper ()
	wxDialogWrapper (wxWindow *parent, wxWindowID id, const TranslatableString &title, const wxPoint &pos=wxDefaultPosition, const wxSize &size=wxDefaultSize, long style=wxDEFAULT_DIALOG_STYLE, const TranslatableString &name=XO("Dialog"))
bool	Create (wxWindow *parent, wxWindowID id, const TranslatableString &title, const wxPoint &pos=wxDefaultPosition, const wxSize &size=wxDefaultSize, long style=wxDEFAULT_DIALOG_STYLE, const TranslatableString &name=XO("Dialog"))
void	SetTitle (const TranslatableString &title)
void	SetLabel (const TranslatableString &title)
void	SetName (const TranslatableString &title)
void	SetName ()
Public Member Functions inherited from wxTabTraversalWrapper< wxDialog >
	wxTabTraversalWrapper (Args &&... args)
	wxTabTraversalWrapper (const wxTabTraversalWrapper &)=delete
	wxTabTraversalWrapper (wxTabTraversalWrapper &&)=delete
wxTabTraversalWrapper &	operator= (const wxTabTraversalWrapper &)=delete
wxTabTraversalWrapper &	operator= (wxTabTraversalWrapper &&)=delete

Private Member Functions
void	Populate ()
void	PopulateOrExchange (ShuttleGui &S)
	Defines the dialog and does data exchange with it. More...
void	ReloadModel ()
void	OnSearchTextChanged (wxCommandEvent &evt)
void	OnStateFilterValueChanged (wxCommandEvent &evt)
void	OnTypeFilterValueChanged (wxCommandEvent &evt)
void	OnCategoryFilterValueChanged (wxCommandEvent &evt)
void	OnOK (wxCommandEvent &evt)
void	OnCancel (wxCommandEvent &evt)
void	OnRescan (wxCommandEvent &evt)
void	OnGetMoreEffects (wxCommandEvent &evt)

Private Attributes
wxArrayString	mPluginProviderIDs
wxDataViewCtrl *	mPluginList {}
wxObjectDataPtr< PluginDataModel >	mPluginsModel

Detailed Description

Definition at line 20 of file PluginRegistrationDialog.h.

Constructor & Destructor Documentation

PluginRegistrationDialog()

PluginRegistrationDialog::PluginRegistrationDialog	(	wxWindow *	parent,
		int	defaultEffectCategory = -1
	)

Parameters

defaultCategory

- sets the default effect plugins filter. Could be one of EffectType or set to -1 to disable it.

Definition at line 75 of file PluginRegistrationDialog.cpp.

:  wxDialogWrapper(parent,
            wxID_ANY,
            XO("Manage Plugins"),
            wxDefaultPosition, wxDefaultSize,
            wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER)
{
   mPluginsModel = safenew PluginDataModel(defaultEffectCategory);
   SetName();
   Populate();
}

References mPluginsModel, Populate(), safenew, and wxDialogWrapper::SetName().

Here is the call graph for this function:

Member Function Documentation

OnCancel()

void PluginRegistrationDialog::OnCancel ( wxCommandEvent &  evt )

private

Definition at line 393 of file PluginRegistrationDialog.cpp.

{
   EndModal(wxID_CANCEL);
}

OnCategoryFilterValueChanged()

void PluginRegistrationDialog::OnCategoryFilterValueChanged ( wxCommandEvent &  evt )

private

Definition at line 273 of file PluginRegistrationDialog.cpp.

{
   const auto index = evt.GetInt();
   if(index >= 0 && index < CategoryFilterValues.size())
      mPluginsModel->SetFilterCategory(CategoryFilterValues[index].first);
}

References CategoryFilterValues, and mPluginsModel.

OnGetMoreEffects()

void PluginRegistrationDialog::OnGetMoreEffects ( wxCommandEvent &  evt )

private

Definition at line 345 of file PluginRegistrationDialog.cpp.

{
   OpenInDefaultBrowser("https://www.musehub.com");
}

References BasicUI::OpenInDefaultBrowser().

Here is the call graph for this function:

OnOK()

void PluginRegistrationDialog::OnOK ( wxCommandEvent &  evt )

private

Definition at line 350 of file PluginRegistrationDialog.cpp.

{
   auto result = ProgressResult::Success;
   {
      // Make sure the progress dialog is deleted before we call EndModal() or
      // we will leave the project window in an unusable state on OSX.
      // See bug #1192.
      std::unique_ptr<ProgressDialog> dialog;
      wxArrayString last3;
      auto updateProgress = [&](int num, int denom, const wxString& msg)
      {
         last3.insert(last3.begin(), msg);
         if(last3.size() > 3)
            last3.pop_back();
         if(!dialog)
         {
            dialog = std::make_unique<ProgressDialog>(
               Verbatim( GetTitle() ),
               TranslatableString {},
               pdlgHideStopButton
            );
            dialog->CenterOnParent();
         }
         result = dialog->Update(
            num,
            denom,
            TranslatableString(wxJoin(last3, '\n'), {})
         );
         return result == ProgressResult::Success;
      };
      auto onError = [](const TranslatableString& error) {
         AudacityMessageBox(error);
      };
 
      mPluginsModel->ApplyChanges(updateProgress, onError);
   }
   if(result == ProgressResult::Success)
      EndModal(wxID_OK);
   else
      ReloadModel();
 
}

References AudacityMessageBox(), mPluginsModel, pdlgHideStopButton, ReloadModel(), BasicUI::Success, and Verbatim().

Here is the call graph for this function:

OnRescan()

void PluginRegistrationDialog::OnRescan ( wxCommandEvent &  evt )

private

Definition at line 280 of file PluginRegistrationDialog.cpp.

{
   wxTheApp->CallAfter([self = wxWeakRef(this)] {
      std::set<PluginPath> disabledPlugins;
      std::vector<wxString> failedPlugins;
 
      auto& pm = PluginManager::Get();
 
      // Record list of plugins that are currently disabled
      for (auto& plug : pm.AllPlugins())
      {
         PluginType plugType = plug.GetPluginType();
         if (plugType != PluginTypeEffect && plugType != PluginTypeStub)
            continue;
 
         if (!plug.IsEnabled())
            disabledPlugins.insert(plug.GetPath());
      }
 
      //PluginManager::ClearEffectPlugins() removes all effects
      //making all pointers cached in PluginDataModel invalid.
      //Reset model pointer before clearing effects so that
      //nothing attempts to access it.
      if(self)
         self->mPluginList->AssociateModel(nullptr);
 
      pm.ClearEffectPlugins();
 
      auto newPlugins = PluginManager::Get().CheckPluginUpdates();
      if (!newPlugins.empty())
      {
         PluginStartupRegistration reg(newPlugins);
         reg.Run();
 
         failedPlugins = reg.GetFailedPluginsPaths();
      }
 
      // Disable all plugins which were previously disabled
      for (auto& plug : pm.AllPlugins())
      {
         PluginType plugType = plug.GetPluginType();
         if (plugType != PluginTypeEffect && plugType != PluginTypeStub)
            continue;
 
         const auto& path = plug.GetPath();
         if (disabledPlugins.find(path) != disabledPlugins.end())
            plug.SetEnabled(false);
      }
 
      pm.Save();
      pm.NotifyPluginsChanged();
 
      if(self)
      {
         self->ReloadModel();
         if (!failedPlugins.empty())
         {
            auto dialog = safenew IncompatiblePluginsDialog(self.get(), wxID_ANY, ScanType::Manual, failedPlugins);
            dialog->ShowModal();
            self->Refresh();
         }
      }
   });
}

References PluginManager::CheckPluginUpdates(), PluginManager::Get(), Manual, PluginTypeEffect, PluginTypeStub, anonymous_namespace{CompareAudioCommand.cpp}::reg, and safenew.

Here is the call graph for this function:

OnSearchTextChanged()

void PluginRegistrationDialog::OnSearchTextChanged ( wxCommandEvent &  evt )

private

Definition at line 252 of file PluginRegistrationDialog.cpp.

{
   mPluginsModel->SetFilterExpr(evt.GetString().Trim().Trim(true));
}

References mPluginsModel.

Referenced by PopulateOrExchange().

Here is the caller graph for this function:

OnStateFilterValueChanged()

void PluginRegistrationDialog::OnStateFilterValueChanged ( wxCommandEvent &  evt )

private

Definition at line 257 of file PluginRegistrationDialog.cpp.

{
   const auto index = evt.GetInt();
 
   mPluginsModel->SetFilterState(
      index == 2 ? 1 : (index == 1 ? 0 : -1)
   );
}

References mPluginsModel.

OnTypeFilterValueChanged()

void PluginRegistrationDialog::OnTypeFilterValueChanged ( wxCommandEvent &  evt )

private

Definition at line 266 of file PluginRegistrationDialog.cpp.

{
   const auto index = evt.GetInt();
   if(index >= 0 && index < mPluginProviderIDs.size())
      mPluginsModel->SetFilterType(mPluginProviderIDs[index]);
}

References mPluginProviderIDs, and mPluginsModel.

Populate()

void PluginRegistrationDialog::Populate ( )

private

Definition at line 87 of file PluginRegistrationDialog.cpp.

{
   //------------------------- Main section --------------------
   ShuttleGui S(this, eIsCreating);
   PopulateOrExchange(S);
   // ----------------------- End of main section --------------
}

References eIsCreating, PopulateOrExchange(), and S.

Referenced by PluginRegistrationDialog().

Here is the call graph for this function:

Here is the caller graph for this function:

PopulateOrExchange()

void PluginRegistrationDialog::PopulateOrExchange ( ShuttleGui &  S )

private

Defines the dialog and does data exchange with it.

Definition at line 96 of file PluginRegistrationDialog.cpp.

{
   constexpr int Margin = 12;
 
   static const std::unordered_map<TranslatableString, TranslatableString> extraProviders = {
      { XO("Builtin Effects"), XO("Native Audacity") }
   };
 
   TranslatableStrings pluginProviderNames;
   pluginProviderNames.push_back(XO("All"));
   mPluginProviderIDs.clear();
   mPluginProviderIDs.push_back({});
   auto& moduleManager = ModuleManager::Get();
   for(auto& [name, provider] : moduleManager.Providers())
   {
      //Use same name as in prefs
      auto familySymbol = provider->GetOptionalFamilySymbol();
      if(!familySymbol.empty())
         pluginProviderNames.push_back(familySymbol.Msgid());
      else
      {
         auto it = extraProviders.find(provider->GetSymbol().Msgid());
         if(it != extraProviders.end())
            pluginProviderNames.push_back(it->second);
         else
            continue;
      }
      mPluginProviderIDs.push_back(PluginManager::GetID(provider.get()));
   }
 
   S.Prop(1).StartPanel(wxEXPAND);
   {
      S.StartVerticalLay(true);
      {
         S.AddSpace(1, Margin);
         S.StartHorizontalLay(wxEXPAND, 0);
         {
            S.AddSpace(Margin, 1);
            S.StartHorizontalLay(wxALIGN_LEFT, 0);
            {
               TranslatableStrings categoryFilterNames;
               std::transform(
                  CategoryFilterValues.begin(),
                  CategoryFilterValues.end(),
                  std::back_inserter(categoryFilterNames),
                  [](const auto& p) { return p.second; });
               const auto selectedCategory =
                  std::distance(
                     CategoryFilterValues.begin(),
                     std::find_if(
                        CategoryFilterValues.begin(),
                        CategoryFilterValues.end(),
                        [category = mPluginsModel->GetFilterCategory()](const auto& p) {
                           return p.first == category;
                        }
                     ));
               S
                  .Id(ID_FilterState)
                  .AddChoice(XXO("&Show:"), ShowFilterValues, 0)
                     ->SetMinSize(wxSize(120, -1));
               S
                  .Id(ID_FilterType)
                  .AddChoice(XXO("&Type:"), pluginProviderNames, 0)
                     ->SetMinSize(wxSize(120, -1));
               S
                  .Id(ID_FilterCategory)
                  .AddChoice(XXO("C&ategory:"), categoryFilterNames, selectedCategory)
                     ->SetMinSize(wxSize(120, -1));
            }
            S.EndHorizontalLay();
            S.AddSpace(1, 1, 1);
            S.StartHorizontalLay(wxALIGN_CENTRE, 0);
            {
               const auto searchCtrl = S
                  .MinSize({240, -1})
                  .AddTextBox(XXO("Searc&h:"), wxEmptyString, 0);
               if(searchCtrl != nullptr)
                  searchCtrl->Bind(wxEVT_TEXT, &PluginRegistrationDialog::OnSearchTextChanged, this);
            }
            S.EndHorizontalLay();
            S.AddSpace(Margin, 1);
         }
         S.EndHorizontalLay();
 
         {
            const auto pluginsList = safenew PluginDataViewCtrl(
               S.GetParent(), ID_List, wxDefaultPosition, wxDefaultSize,
                wxDV_MULTIPLE | wxDV_HORIZ_RULES | wxDV_VERT_RULES,
               wxDefaultValidator,
               _("Plugin")
            );
            mPluginList = pluginsList;
            mPluginList->AssociateModel(mPluginsModel.get());
            mPluginList->SetMinSize({728, 288});
            mPluginList->GetColumn(PluginDataModel::ColumnName)->SetSortOrder(true);
            mPluginsModel->Resort();
         }
 
         S.SetBorder(Margin);
         S.Id(ID_List)
            .Prop(1)
            .AddWindow(mPluginList, wxEXPAND);
         S.SetBorder(2);
 
         S.AddSpace(1, Margin);
 
         S.StartHorizontalLay(wxALIGN_LEFT | wxEXPAND, 0);
         {
            S.AddSpace(Margin, 1);
            S.Id(ID_Rescan).AddButton(XXO("&Rescan"));
#if defined(__WXMSW__) || defined(__WXMAC__)
            S.Id(ID_GetMoreEffects).AddButton(XXO("&Get more effects..."));
#endif
            S.AddSpace(1, 1, 1);
 
            S.Id(wxID_OK).AddButton(XXO("&OK"));
            S.Id(wxID_CANCEL).AddButton(XXO("&Cancel"));
            S.AddSpace(Margin, 1);
         }
         S.EndHorizontalLay();
         S.AddSpace(1, Margin);
      }
      S.EndVerticalLay();
   }
   S.EndStatic();
 
   wxRect r = wxGetClientDisplayRect();
 
   Layout();
   Fit();
 
   wxSize sz = GetSize();
   sz.SetWidth(wxMin(sz.GetWidth(), r.GetWidth()));
   sz.SetHeight(wxMin(sz.GetHeight(), r.GetHeight()));
   SetMinSize(sz);
 
   mPluginList->GetColumn(PluginDataModel::ColumnName)->SetWidth(200);
   mPluginList->GetColumn(PluginDataModel::ColumnType)->SetWidth(80);
   mPluginList->GetColumn(PluginDataModel::ColumnPath)->SetWidth(350);
 
   // Parent window is usually not there yet, so centre on screen rather than on parent.
   CenterOnScreen();
 
}

References _, CategoryFilterValues, PluginDataModel::ColumnName, PluginDataModel::ColumnPath, PluginDataModel::ColumnType, ModuleManager::Get(), PluginManager::GetID(), ID_FilterCategory, ID_FilterState, ID_FilterType, ID_GetMoreEffects, ID_List, ID_Rescan, CommonTrackInfo::Margin, mPluginList, mPluginProviderIDs, mPluginsModel, name, OnSearchTextChanged(), S, safenew, ShowFilterValues, XO(), and XXO().

Referenced by Populate().

Here is the call graph for this function:

Here is the caller graph for this function:

ReloadModel()

void PluginRegistrationDialog::ReloadModel ( )

private

Definition at line 241 of file PluginRegistrationDialog.cpp.

{
   mPluginsModel.reset(safenew PluginDataModel(
      mPluginsModel->GetFilterCategory(),
      mPluginsModel->GetFilterState(),
      mPluginsModel->GetFilterType(),
      mPluginsModel->GetFilterExpr()
   ));
   mPluginList->AssociateModel(mPluginsModel.get());
}

References mPluginList, mPluginsModel, and safenew.

Referenced by OnOK().

Here is the caller graph for this function:

Member Data Documentation

mPluginList

wxDataViewCtrl* PluginRegistrationDialog::mPluginList {}

private

Definition at line 44 of file PluginRegistrationDialog.h.

Referenced by PopulateOrExchange(), and ReloadModel().

mPluginProviderIDs

wxArrayString PluginRegistrationDialog::mPluginProviderIDs

private

Definition at line 42 of file PluginRegistrationDialog.h.

Referenced by OnTypeFilterValueChanged(), and PopulateOrExchange().

mPluginsModel

wxObjectDataPtr<PluginDataModel> PluginRegistrationDialog::mPluginsModel

private

Definition at line 45 of file PluginRegistrationDialog.h.

Referenced by OnCategoryFilterValueChanged(), OnOK(), OnSearchTextChanged(), OnStateFilterValueChanged(), OnTypeFilterValueChanged(), PluginRegistrationDialog(), PopulateOrExchange(), and ReloadModel().

---

The documentation for this class was generated from the following files:

• PluginRegistrationDialog.h
• PluginRegistrationDialog.cpp