Inheritance diagram for EffectBassTreble::Editor:

Collaboration diagram for EffectBassTreble::Editor:

Public Member Functions
	Editor (const EffectUIServices &services, EffectSettingsAccess &access, const BassTrebleSettings &settings)

virtual	~Editor ()=default

bool	ValidateUI () override
	Get settings data from the panel; may make error dialogs and return false. More...

bool	UpdateUI () override
	Update appearance of the panel for changes in settings. More...

void	PopulateOrExchange (ShuttleGui &S)

void	OnBassText (wxCommandEvent &evt)

void	OnTrebleText (wxCommandEvent &evt)

void	OnGainText (wxCommandEvent &evt)

void	OnBassSlider (wxCommandEvent &evt)

void	OnTrebleSlider (wxCommandEvent &evt)

void	OnGainSlider (wxCommandEvent &evt)

void	OnLinkCheckbox (wxCommandEvent &evt)

void	UpdateGain (double oldVal, int control)

void	EnableApplyFromValidate ()

bool	EnableApplyFromTransferDataFromWindow ()

Public Member Functions inherited from EffectEditor
	EffectEditor (const EffectUIServices &services, EffectSettingsAccess &access)

virtual	~EffectEditor ()

virtual bool	ValidateUI ()=0
	Get settings data from the panel; may make error dialogs and return false. More...

virtual bool	UpdateUI ()
	Update appearance of the panel for changes in settings. More...

virtual bool	IsGraphicalUI ()

virtual void	Disconnect ()
	On the first call only, may disconnect from further event handling. More...

virtual void	OnClose ()

Public Member Functions inherited from Observer::Publisher< EffectSettingChanged >
	Publisher (ExceptionPolicy *pPolicy=nullptr, Alloc a={})
	Constructor supporting type-erased custom allocation/deletion. More...

	Publisher (Publisher &&)=default

Publisher &	operator= (Publisher &&)=default

Subscription	Subscribe (Callback callback)
	Connect a callback to the Publisher; later-connected are called earlier. More...

Subscription	Subscribe (Object &obj, Return(Object::*callback)(Args...))
	Overload of Subscribe takes an object and pointer-to-member-function. More...

Public Attributes
wxWeakRef< wxWindow >	mUIParent {}

BassTrebleSettings	mSettings

wxSlider *	mBassS

wxSlider *	mTrebleS

wxSlider *	mGainS

wxTextCtrl *	mBassT

wxTextCtrl *	mTrebleT

wxTextCtrl *	mGainT

wxCheckBox *	mLinkCheckBox

Additional Inherited Members
Public Types inherited from Observer::Publisher< EffectSettingChanged >
using	message_type = EffectSettingChanged

using	CallbackReturn = std::conditional_t< true, void, bool >

using	Callback = std::function< CallbackReturn(const EffectSettingChanged &) >
	Type of functions that can be connected to the Publisher. More...

Static Public Member Functions inherited from EffectEditor
static bool	EnableApply (wxWindow *parent, bool enable=true)
	Enable or disable the Apply button of the dialog that contains parent. More...

static bool	EnablePreview (wxWindow *parent, bool enable=true)

Static Public Attributes inherited from EffectEditor
static constexpr int	kPlayID = 20102

Static Public Attributes inherited from Observer::Publisher< EffectSettingChanged >
static constexpr bool	notifies_all

Protected Member Functions inherited from EffectEditor
template<typename EventTag , typename Class , typename Event >
void	BindTo (wxEvtHandler &src, const EventTag &eventType, void(Class::*pmf)(Event &))

Protected Member Functions inherited from Observer::Publisher< EffectSettingChanged >
CallbackReturn	Publish (const EffectSettingChanged &message)
	Send a message to connected callbacks. More...

Protected Attributes inherited from EffectEditor
const EffectUIServices &	mUIServices

EffectSettingsAccess &	mAccess

bool	mUIClosed { false }

Detailed Description

Definition at line 35 of file BassTreble.cpp.

Constructor & Destructor Documentation

◆ Editor()

EffectBassTreble::Editor::Editor	(	const EffectUIServices &	services,
		EffectSettingsAccess &	access,
		const BassTrebleSettings &	settings
	)

inline

Definition at line 38 of file BassTreble.cpp.

      : EffectEditor{ services, access }
      , mSettings{ settings }
   {}

◆ ~Editor()

virtual EffectBassTreble::Editor::~Editor ( )

virtualdefault

Member Function Documentation

◆ EnableApplyFromTransferDataFromWindow()

bool EffectBassTreble::Editor::EnableApplyFromTransferDataFromWindow ( )

inline

Definition at line 79 of file BassTreble.cpp.

   {
      return EnableApply(
         mUIParent, mUIParent->TransferDataFromWindow());
   }

References EffectEditor::EnableApply(), and mUIParent.

Here is the call graph for this function:

◆ EnableApplyFromValidate()

void EffectBassTreble::Editor::EnableApplyFromValidate ( )

inline

Definition at line 74 of file BassTreble.cpp.

   {
      EnableApply(mUIParent, mUIParent->Validate());
   }

References EffectEditor::EnableApply(), and mUIParent.

Here is the call graph for this function:

◆ OnBassSlider()

void EffectBassTreble::Editor::OnBassSlider ( wxCommandEvent & evt )

Definition at line 261 of file BassTreble.cpp.

{
   auto& ms = mSettings;
 
   double oldBass = ms.mBass;
   ms.mBass = (double) evt.GetInt() / Bass.scale;
   mBassT->GetValidator()->TransferToWindow();
 
   if (ms.mLink)
      UpdateGain(oldBass, kBass);
 
   EnableApplyFromValidate();
 
   ValidateUI();
   Publish(EffectSettingChanged{});
}

References BassTrebleBase::Bass, kBass, EffectParameter< Structure, Member, Type, Value >::scale, and BasicEffectUIServices::ValidateUI().

Referenced by PopulateOrExchange().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ OnBassText()

void EffectBassTreble::Editor::OnBassText ( wxCommandEvent & evt )

Definition at line 206 of file BassTreble.cpp.

{
   auto& ms = mSettings;
 
   double oldBass = ms.mBass;
 
   if (!EnableApplyFromTransferDataFromWindow())
   {
      return;
   }
 
   if (ms.mLink)
      UpdateGain(oldBass, kBass);
 
   mBassS->SetValue((int) (ms.mBass * Bass.scale));
 
   ValidateUI();
   Publish(EffectSettingChanged{});
}

References BassTrebleBase::Bass, kBass, EffectParameter< Structure, Member, Type, Value >::scale, and BasicEffectUIServices::ValidateUI().

Referenced by PopulateOrExchange().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ OnGainSlider()

void EffectBassTreble::Editor::OnGainSlider ( wxCommandEvent & evt )

Definition at line 295 of file BassTreble.cpp.

{
   auto& ms = mSettings;
 
   ms.mGain = (double) evt.GetInt() / Gain.scale;
   mGainT->GetValidator()->TransferToWindow();
 
   EnableApplyFromValidate();
 
   ValidateUI();
   Publish(EffectSettingChanged{});
}

References BassTrebleBase::Gain, EffectParameter< Structure, Member, Type, Value >::scale, and BasicEffectUIServices::ValidateUI().

Referenced by PopulateOrExchange().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ OnGainText()

void EffectBassTreble::Editor::OnGainText ( wxCommandEvent & evt )

Definition at line 246 of file BassTreble.cpp.

{
   auto& ms = mSettings;
 
   if (!EnableApplyFromTransferDataFromWindow())
   {
      return;
   }
 
   mGainS->SetValue((int) (ms.mGain * Gain.scale));
 
   ValidateUI();
   Publish(EffectSettingChanged{});
}

References BassTrebleBase::Gain, EffectParameter< Structure, Member, Type, Value >::scale, and BasicEffectUIServices::ValidateUI().

Referenced by PopulateOrExchange().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ OnLinkCheckbox()

void EffectBassTreble::Editor::OnLinkCheckbox ( wxCommandEvent & evt )

Definition at line 308 of file BassTreble.cpp.

{
   auto& ms = mSettings;
 
   ms.mLink = mLinkCheckBox->GetValue();
 
   ValidateUI();
   Publish(EffectSettingChanged{});
}

References BasicEffectUIServices::ValidateUI().

Referenced by PopulateOrExchange().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ OnTrebleSlider()

void EffectBassTreble::Editor::OnTrebleSlider ( wxCommandEvent & evt )

Definition at line 278 of file BassTreble.cpp.

{
   auto& ms = mSettings;
 
   double oldTreble = ms.mTreble;
   ms.mTreble = (double) evt.GetInt() / Treble.scale;
   mTrebleT->GetValidator()->TransferToWindow();
 
   if (ms.mLink)
      UpdateGain(oldTreble, kTreble);
 
   EnableApplyFromValidate();
 
   ValidateUI();
   Publish(EffectSettingChanged{});
}

References kTreble, EffectParameter< Structure, Member, Type, Value >::scale, BassTrebleBase::Treble, and BasicEffectUIServices::ValidateUI().

Referenced by PopulateOrExchange().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ OnTrebleText()

void EffectBassTreble::Editor::OnTrebleText ( wxCommandEvent & evt )

Definition at line 226 of file BassTreble.cpp.

{
   auto& ms = mSettings;
 
   double oldTreble = ms.mTreble;
 
   if (!EnableApplyFromTransferDataFromWindow())
   {
      return;
   }
 
   if (ms.mLink)
      UpdateGain(oldTreble, kTreble);
 
   mTrebleS->SetValue((int) (ms.mTreble * Treble.scale));
 
   ValidateUI();
   Publish(EffectSettingChanged{});
}

References kTreble, EffectParameter< Structure, Member, Type, Value >::scale, BassTrebleBase::Treble, and BasicEffectUIServices::ValidateUI().

Referenced by PopulateOrExchange().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ PopulateOrExchange()

void EffectBassTreble::Editor::PopulateOrExchange ( ShuttleGui & S )

Definition at line 106 of file BassTreble.cpp.

{
   mUIParent = S.GetParent();
   auto& ms = mSettings;
 
   S.SetBorder(5);
   S.AddSpace(0, 5);
 
   S.StartStatic(XO("Tone controls"));
   {
      S.StartMultiColumn(3, wxEXPAND);
      {
         S.SetStretchyCol(2);
 
         // Bass control
         mBassT = S
            .Name(XO("Bass (dB):"))
            .Validator<FloatingPointValidator<double>>(
               1, &ms.mBass, NumValidatorStyle::DEFAULT, Bass.min, Bass.max)
            .AddTextBox(XXO("Ba&ss (dB):"), L"", 10);
         BindTo(*mBassT, wxEVT_TEXT, &Editor::OnBassText);
 
         mBassS = S
            .Name(XO("Bass"))
            .Style(wxSL_HORIZONTAL)
            .AddSlider( {}, 0, Bass.max * Bass.scale, Bass.min * Bass.scale);
         BindTo(*mBassS, wxEVT_SLIDER, &Editor::OnBassSlider);
 
         // Treble control
         mTrebleT = S
            .Validator<FloatingPointValidator<double>>(
               1, &ms.mTreble, NumValidatorStyle::DEFAULT, Treble.min, Treble.max)
            .AddTextBox(XXO("&Treble (dB):"), L"", 10);
         BindTo(*mTrebleT, wxEVT_TEXT, &Editor::OnTrebleText);
 
         mTrebleS = S
            .Name(XO("Treble"))
            .Style(wxSL_HORIZONTAL)
            .AddSlider( {}, 0, Treble.max * Treble.scale, Treble.min * Treble.scale);
         BindTo(*mTrebleS, wxEVT_SLIDER, &Editor::OnTrebleSlider);
      }
      S.EndMultiColumn();
   }
   S.EndStatic();
 
   S.StartStatic(XO("Output"));
   {
      S.StartMultiColumn(3, wxEXPAND);
      {
         S.SetStretchyCol(2);
 
         // Gain control
         mGainT = S
            .Validator<FloatingPointValidator<double>>(
               1, &ms.mGain, NumValidatorStyle::DEFAULT, Gain.min, Gain.max)
            .AddTextBox(XXO("&Volume (dB):"), L"", 10);
         BindTo(*mGainT, wxEVT_TEXT, &Editor::OnGainText);
 
         mGainS = S
            .Name(XO("Level"))
            .Style(wxSL_HORIZONTAL)
            .AddSlider( {}, 0, Gain.max * Gain.scale, Gain.min * Gain.scale);
         BindTo(*mGainS, wxEVT_SLIDER, &Editor::OnGainSlider);
      }
      S.EndMultiColumn();
 
      S.StartMultiColumn(2, wxCENTER);
      {
         // Link checkbox
         mLinkCheckBox =
         S
            .AddCheckBox(XXO("&Link Volume control to Tone controls"),
               Link.def);
         BindTo(*mLinkCheckBox, wxEVT_CHECKBOX, &Editor::OnLinkCheckbox);
      }
      S.EndMultiColumn();
   }
   S.EndStatic();
}

References BassTrebleBase::Bass, EffectEditor::BindTo(), EffectParameter< Structure, Member, Type, Value >::def, BassTrebleBase::Gain, BassTrebleBase::Link, EffectParameter< Structure, Member, Type, Value >::max, mBassS, mBassT, mGainS, mGainT, EffectParameter< Structure, Member, Type, Value >::min, mLinkCheckBox, mSettings, mTrebleS, mTrebleT, mUIParent, OnBassSlider(), OnBassText(), OnGainSlider(), OnGainText(), OnLinkCheckbox(), OnTrebleSlider(), OnTrebleText(), S, EffectParameter< Structure, Member, Type, Value >::scale, BassTrebleBase::Treble, XO(), and XXO().

Here is the call graph for this function:

◆ UpdateGain()

void EffectBassTreble::Editor::UpdateGain	(	double	oldVal,
		int	control
	)

Definition at line 318 of file BassTreble.cpp.

{
   auto& ms = mSettings;
 
   double newVal;
   oldVal = (oldVal > 0)? oldVal / 2.0 : oldVal / 4.0;
 
   if (control == kBass)
      newVal = (ms.mBass > 0)? ms.mBass / 2.0 : ms.mBass / 4.0;
   else
      newVal = (ms.mTreble > 0)? ms.mTreble / 2.0 : ms.mTreble / 4.0;
 
   ms.mGain -= newVal - oldVal;
   ms.mGain = std::min(Gain.max, std::max(Gain.min, ms.mGain));
 
   mGainS->SetValue(ms.mGain);
   mGainT->GetValidator()->TransferToWindow();
 
}

References BassTrebleBase::Gain, kBass, EffectParameter< Structure, Member, Type, Value >::max, EffectParameter< Structure, Member, Type, Value >::min, and min().

Here is the call graph for this function:

◆ UpdateUI()

bool EffectBassTreble::Editor::UpdateUI ( )

overridevirtual

Update appearance of the panel for changes in settings.

Default implementation does nothing, returns true

Returns: true if successful

Reimplemented from EffectEditor.

Definition at line 186 of file BassTreble.cpp.

{
   // get the settings from the MessageBuffer and write them to our local copy
   const auto& settings = mAccess.Get();
 
   mSettings = GetSettings(settings);
 
   if (! mUIParent->TransferDataToWindow())
   {
      return false;
   }
 
   mBassS->       SetValue((int)(mSettings.mBass * Bass.scale));
   mTrebleS->     SetValue((int)(mSettings.mTreble *Treble.scale));
   mGainS->       SetValue((int)(mSettings.mGain * Gain.scale));
   mLinkCheckBox->SetValue(mSettings.mLink);
 
   return true;
}

References BassTrebleBase::Bass, BassTrebleBase::Gain, EffectWithSettings< BassTrebleSettings, PerTrackEffect >::GetSettings(), EffectParameter< Structure, Member, Type, Value >::scale, settings(), and BassTrebleBase::Treble.

Here is the call graph for this function:

◆ ValidateUI()

bool EffectBassTreble::Editor::ValidateUI ( )

overridevirtual

Get settings data from the panel; may make error dialogs and return false.

Returns: true only if panel settings are acceptable

Implements EffectEditor.

Definition at line 338 of file BassTreble.cpp.

{
   // This bit was copied from the original override of the effect's TransferDataFromWindow
   if (! mUIParent->Validate() || !mUIParent->TransferDataFromWindow())
   {
      return false;
   }
 
 
   mAccess.ModifySettings
   (
      [this](EffectSettings& settings)
   {
      // pass back the modified settings to the MessageBuffer
      //
      EffectBassTreble::GetSettings(settings) = mSettings;
 
      return nullptr;
   }
   );
 
   return true;
}