MeterPanel.h

Go to the documentation of this file.

/**********************************************************************
 
  Audacity: A Digital Audio Editor
 
  MeterPanel.h
 
  Dominic Mazzoni
 
  VU Meter, for displaying recording/playback level
 
  This is a bunch of common code that can display many different
  forms of VU meters and other displays.
 
**********************************************************************/
 
#ifndef __AUDACITY_METER_PANEL__
#define __AUDACITY_METER_PANEL__
 
#include <atomic>
#include <wx/setup.h> // for wxUSE_* macros
#include <wx/brush.h> // member variable
#include <wx/defs.h>
#include <wx/timer.h> // member variable
 
#include "ASlider.h"
#include "LockFreeQueue.h"
#include "MeterPanelBase.h" // to inherit
#include "Observer.h"
#include "Prefs.h"
#include "Ruler.h" // member variable
#include "SampleFormat.h"
 
class AudacityProject;
struct AudioIOEvent;
 
// Increase this when we add support for multichannel meters
// (most of the code is already there)
const int kMaxMeterBars = 2;
 
struct MeterBar {
   bool   vert;
   wxRect b;         // Bevel around bar
   wxRect r;         // True bar drawing area
   float  peak;
   float  rms;
   float  peakHold;
   double peakHoldTime;
   wxRect rClip;
   bool   clipping;
   bool   isclipping; //ANSWER-ME: What's the diff between these bools?! "clipping" vs "isclipping" is not clear.
   int    tailPeakCount;
   float  peakPeakHold;
};
 
class MeterUpdateMsg
{
   public:
   int numFrames;
   float peak[kMaxMeterBars];
   float rms[kMaxMeterBars];
   bool clipping[kMaxMeterBars];
   int headPeakCount[kMaxMeterBars];
   int tailPeakCount[kMaxMeterBars];
 
   /* neither constructor nor destructor do anything */
   MeterUpdateMsg() { }
   ~MeterUpdateMsg() { }
   /* for debugging purposes, printing the values out is really handy */
   wxString toString();
   wxString toStringIfClipped();
};
 
//
// The MeterPanel passes itself messages via this queue so that it can
// communicate between the audio thread and the GUI thread.
// This class uses lock-free synchronization with atomics.
//
using MeterUpdateQueue = LockFreeQueue<MeterUpdateMsg>;
 
class MeterAx;
 
/********************************************************************/
class AUDACITY_DLL_API MeterPanel final
   : public MeterPanelBase, private PrefsListener
   , public NonInterferingBase
{
   DECLARE_DYNAMIC_CLASS(MeterPanel)
 
 public:
   // These should be kept in the same order as they appear
   // in the menu
   enum Style {
      AutomaticStereo,
      HorizontalStereo,
      VerticalStereo,
      MixerTrackCluster, // Doesn't show menu, icon, or L/R labels, but otherwise like VerticalStereo.
      HorizontalStereoCompact, // Thinner.
      VerticalStereoCompact, // Narrower.
   };
 
 
   MeterPanel(AudacityProject *,
         wxWindow* parent, wxWindowID id,
         bool isInput,
         const wxPoint& pos = wxDefaultPosition,
         const wxSize& size = wxDefaultSize,
         Style style = HorizontalStereo,
         float fDecayRate = 60.0f);
 
   void SetFocusFromKbd() override;
 
   void Clear() override;
 
   Style GetStyle() const { return mStyle; }
   Style GetDesiredStyle() const { return mDesiredStyle; }
   void SetStyle(Style newStyle);
 
   void Reset(double sampleRate, bool resetClipping) override;
 
   void UpdateDisplay(unsigned numChannels,
                      int numFrames, const float *sampleData) override;
 
   // Vaughan, 2010-11-29: This not currently used. See comments in MixerTrackCluster::UpdateMeter().
   //void UpdateDisplay(int numChannels, int numFrames,
   //                     // Need to make these double-indexed max and min arrays if we handle more than 2 channels.
   //                     float* maxLeft, float* rmsLeft,
   //                     float* maxRight, float* rmsRight,
   //                     const size_t kSampleCount);
 
   bool IsMeterDisabled() const override;
 
   float GetMaxPeak() const override;
   float GetPeakHold() const;
 
   bool IsMonitoring() const;
   bool IsActive() const;
 
   bool IsClipping() const override;
 
   void StartMonitoring();
   void StopMonitoring();
 
   // These exist solely for the purpose of resetting the toolbars
   struct State{ bool mSaved, mMonitoring, mActive; };
   State SaveState();
   void RestoreState(const State &state);
   void SetMixer(wxCommandEvent& event);
 
   int GetDBRange() const override { return mDB ? mDBRange : -1; }
 
   bool ShowDialog();
   void Increase(float steps);
   void Decrease(float steps);
   void UpdateSliderControl();
 
   void ShowMenu(const wxPoint & pos);
 
   void SetName(const TranslatableString& name);
 
 private:
   void UpdatePrefs() override;
   void UpdateSelectedPrefs( int ) override;
 
 private:
   //
   // Event handlers
   //
   void OnErase(wxEraseEvent &evt);
   void OnPaint(wxPaintEvent &evt);
   void OnSize(wxSizeEvent &evt);
   void OnMouse(wxMouseEvent &evt);
   void OnKeyDown(wxKeyEvent &evt);
   void OnCharHook(wxKeyEvent &evt);
   void OnContext(wxContextMenuEvent &evt);
   void OnSetFocus(wxFocusEvent &evt);
   void OnKillFocus(wxFocusEvent &evt);
 
   void OnAudioIOStatus(AudioIOEvent);
   void OnAudioCapture(AudioIOEvent);
 
   void OnMeterUpdate(wxTimerEvent &evt);
   void OnTipTimeout(wxTimerEvent& evt);
 
   void HandleLayout(wxDC &dc);
   void SetActiveStyle(Style style);
   void SetBarAndClip(int iBar, bool vert);
   void DrawMeterBar(wxDC &dc, MeterBar *meterBar);
   void ResetBar(MeterBar *bar, bool resetClipping);
   void RepaintBarsNow();
   wxFont GetFont() const;
 
   //
   // Pop-up menu
   //
   void OnMonitor(wxCommandEvent &evt);
   void OnPreferences(wxCommandEvent &evt);
 
   wxString Key(const wxString & key) const;
 
   Observer::Subscription mAudioIOStatusSubscription;
   Observer::Subscription mAudioCaptureSubscription;
 
   AudacityProject *mProject;
   MeterUpdateQueue mQueue;
   wxTimer          mTimer;
   wxTimer          mTipTimer;
 
   int       mWidth;
   int       mHeight;
 
   int       mRulerWidth{};
   int       mRulerHeight{};
 
   bool      mIsInput;
 
   Style     mStyle{};
   Style     mDesiredStyle;
   bool      mGradient;
   bool      mDB;
   int       mDBRange;
   bool      mDecay;
   float     mDecayRate{}; // dB/sec
   bool      mClip;
   int       mNumPeakSamplesToClip;
   double    mPeakHoldDuration;
   double    mT;
   double    mRate;
   long      mMeterRefreshRate{};
   long      mMeterDisabled{}; //is used as a bool, needs long for easy gPrefs...
 
   bool      mMonitoring;
 
   bool      mActive;
 
   unsigned  mNumBars;
   MeterBar  mBar[kMaxMeterBars]{};
 
   bool      mLayoutValid;
 
   std::unique_ptr<wxBitmap> mBitmap;
   wxPoint   mLeftTextPos;
   wxPoint   mRightTextPos;
   wxSize    mLeftSize;
   wxSize    mRightSize;
   wxPen     mPen;
   wxPen     mPeakPeakPen;
   wxBrush   mBrush;
   wxBrush   mRMSBrush;
   wxBrush   mClipBrush;
   wxBrush   mBkgndBrush;
   wxBrush   mDisabledBkgndBrush;
   wxBrush   mMeterBkgndBrush;
   Ruler     mRuler;
   wxString  mLeftText;
   wxString  mRightText;
 
   std::unique_ptr<LWSlider> mSlider;
   wxPoint mSliderPos;
   wxSize mSliderSize;
 
   bool mEnabled{ true };
 
   bool mIsFocused{};
   wxRect mFocusRect;
 
   friend class MeterAx;
 
   DECLARE_EVENT_TABLE()
};
 
#endif // __AUDACITY_METER_PANEL__