#include <EnvelopeHandle.h>

Inheritance diagram for EnvelopeHandle:

Collaboration diagram for EnvelopeHandle:

Public Member Functions
	EnvelopeHandle (Envelope *pEnvelope, std::weak_ptr< const Channel > wChannel)

	EnvelopeHandle (EnvelopeHandle &&)=default

EnvelopeHandle &	operator= (EnvelopeHandle &&)=default

virtual	~EnvelopeHandle ()

std::shared_ptr< const Track >	FindTrack () const override

Envelope *	GetEnvelope () const

void	Enter (bool forward, AudacityProject *) override

Result	Click (const TrackPanelMouseEvent &event, AudacityProject *pProject) override

Result	Drag (const TrackPanelMouseEvent &event, AudacityProject *pProject) override

HitTestPreview	Preview (const TrackPanelMouseState &state, AudacityProject *pProject) override

Result	Release (const TrackPanelMouseEvent &event, AudacityProject pProject, wxWindow pParent) override

Result	Cancel (AudacityProject *pProject) override

bool	StopsOnKeystroke () override

Public Member Functions inherited from UIHandle
virtual	~UIHandle ()=0

virtual void	Enter (bool forward, AudacityProject *pProject)

virtual bool	HasRotation () const

virtual bool	Rotate (bool forward)

virtual bool	HasEscape (AudacityProject *pProject) const

virtual bool	Escape (AudacityProject *pProject)

virtual bool	HandlesRightClick ()
	Whether the handle has any special right-button handling. More...

virtual Result	Click (const TrackPanelMouseEvent &event, AudacityProject *pProject)=0

virtual Result	Drag (const TrackPanelMouseEvent &event, AudacityProject *pProject)=0

virtual HitTestPreview	Preview (const TrackPanelMouseState &state, AudacityProject *pProject)=0

virtual Result	Release (const TrackPanelMouseEvent &event, AudacityProject pProject, wxWindow pParent)=0

virtual Result	Cancel (AudacityProject *pProject)=0

virtual bool	StopsOnKeystroke ()

virtual void	OnProjectChange (AudacityProject *pProject)

virtual std::shared_ptr< const Track >	FindTrack () const =0

virtual bool	IsDragging () const

Result	GetChangeHighlight () const

void	SetChangeHighlight (Result val)

Public Member Functions inherited from TrackPanelDrawable
virtual	~TrackPanelDrawable ()=0

virtual void	Draw (TrackPanelDrawingContext &context, const wxRect &rect, unsigned iPass)

virtual wxRect	DrawingArea (TrackPanelDrawingContext &context, const wxRect &rect, const wxRect &panelRect, unsigned iPass)

Static Public Member Functions
static UIHandlePtr	HitAnywhere (std::weak_ptr< EnvelopeHandle > &holder, Envelope *envelope, std::weak_ptr< const Channel > wChannel, bool timeTrack)

static UIHandlePtr	TimeTrackHitTest (std::weak_ptr< EnvelopeHandle > &holder, const wxMouseState &state, const wxRect &rect, const AudacityProject *pProject, const std::shared_ptr< TimeTrack > &tt)

static UIHandlePtr	WaveChannelHitTest (std::weak_ptr< EnvelopeHandle > &holder, const wxMouseState &state, const wxRect &rect, const AudacityProject *pProject, const std::shared_ptr< WaveChannel > &wt)

Static Public Member Functions inherited from UIHandle
static UIHandle::Result	NeedChangeHighlight (const UIHandle &, const UIHandle &)

static std::shared_ptr< const Track >	TrackFromChannel (const std::shared_ptr< const Channel > &pChannel)
	A frequent convenience in the definition of UIHandles. More...

Static Public Member Functions inherited from TrackPanelDrawable
static wxRect	MaximizeWidth (const wxRect &rect, const wxRect &panelRect)

static wxRect	MaximizeHeight (const wxRect &rect, const wxRect &panelRect)

Private Member Functions
	EnvelopeHandle (const EnvelopeHandle &)=delete

EnvelopeHandle &	operator= (const EnvelopeHandle &)=delete

bool	ForwardEventToEnvelopes (const wxMouseEvent &event, const ViewInfo &viewInfo)

Static Private Member Functions
static UIHandlePtr	HitEnvelope (std::weak_ptr< EnvelopeHandle > &holder, const wxMouseState &state, const wxRect &rect, const AudacityProject pProject, Envelope envelope, std::weak_ptr< const Channel > wChannel, float zoomMin, float zoomMax, bool dB, float dBRange, bool timeTrack)

Private Attributes
wxRect	mRect {}

bool	mLog {}

float	mLower {}

float	mUpper {}

double	mdBRange {}

Envelope *	mEnvelope {}

std::weak_ptr< const Channel >	mwChannel

std::unique_ptr< EnvelopeEditor >	mpEnvelopeEditor

bool	mTimeTrack {}

Additional Inherited Members
Public Types inherited from UIHandle
using	Result = unsigned

using	Cell = TrackPanelCell

Protected Attributes inherited from UIHandle
Result	mChangeHighlight { 0 }

Detailed Description

Definition at line 28 of file EnvelopeHandle.h.

Constructor & Destructor Documentation

◆ EnvelopeHandle() [1/3]

EnvelopeHandle::EnvelopeHandle ( const EnvelopeHandle & )

privatedelete

◆ EnvelopeHandle() [2/3]

EnvelopeHandle::EnvelopeHandle	(	Envelope *	pEnvelope,
		std::weak_ptr< const Channel >	wChannel
	)

Definition at line 35 of file EnvelopeHandle.cpp.

   : mEnvelope{ pEnvelope }
   , mwChannel{ move(wChannel) }
{
}

◆ EnvelopeHandle() [3/3]

EnvelopeHandle::EnvelopeHandle ( EnvelopeHandle && )

default

◆ ~EnvelopeHandle()

EnvelopeHandle::~EnvelopeHandle ( )

virtual

Definition at line 49 of file EnvelopeHandle.cpp.

50{}

Member Function Documentation

◆ Cancel()

UIHandle::Result EnvelopeHandle::Cancel ( AudacityProject * pProject )

overridevirtual

Implements UIHandle.

Definition at line 294 of file EnvelopeHandle.cpp.

{
   ProjectHistory::Get( *pProject ).RollbackState();
   mpEnvelopeEditor.reset();
   return RefreshCode::RefreshCell;
}

References ProjectHistory::Get(), mpEnvelopeEditor, RefreshCode::RefreshCell, and ProjectHistory::RollbackState().

Referenced by Drag(), and Release().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Click()

UIHandle::Result EnvelopeHandle::Click	(	const TrackPanelMouseEvent &	event,
		AudacityProject *	pProject
	)

overridevirtual

Implements UIHandle.

Definition at line 182 of file EnvelopeHandle.cpp.

{
   using namespace RefreshCode;
   const bool unsafe = ProjectAudioIO::Get( *pProject ).IsAudioActive();
   if ( unsafe )
      return Cancelled;
 
   const wxMouseEvent &event = evt.event;
   const auto &viewInfo = ViewInfo::Get( *pProject );
   const auto pView = std::static_pointer_cast<ChannelView>(evt.pCell);
   const auto pChannel = pView ? pView->FindChannel().get() : nullptr;
 
   mpEnvelopeEditor.reset();
 
   unsigned result = Cancelled;
   if (const auto pWt = dynamic_cast<WaveChannel*>(pChannel)) {
      auto &wt = *pWt;
      if (!mEnvelope)
         result = Cancelled;
      else {
         mLog = !WaveformSettings::Get(wt).isLinear();
         auto &cache = WaveformScale::Get(wt);
         cache.GetDisplayBounds(mLower, mUpper);
         mdBRange = WaveformSettings::Get(wt).dBRange;
         mpEnvelopeEditor = std::make_unique<EnvelopeEditor>(*mEnvelope, true);
         result = RefreshNone;
      }
   }
   else if (const auto pTt = dynamic_cast<TimeTrack*>(pChannel)) {
      auto &tt = *pTt;
      if (!mEnvelope)
         result = Cancelled;
      else {
         GetTimeTrackData( *pProject, tt, mdBRange, mLog, mLower, mUpper);
         mpEnvelopeEditor = std::make_unique<EnvelopeEditor>(*mEnvelope, false);
 
         result = RefreshNone;
      }
   }
 
   if (result & Cancelled)
      return result;
 
   mRect = evt.rect;
 
   const bool needUpdate = ForwardEventToEnvelopes(event, viewInfo);
   return needUpdate ? RefreshCell : RefreshNone;
}

References Cancelled, WaveformSettings::dBRange, TrackPanelMouseEvent::event, ForwardEventToEnvelopes(), ProjectAudioIO::Get(), ViewInfo::Get(), WaveformSettings::Get(), WaveformScale::Get(), anonymous_namespace{EnvelopeHandle.cpp}::GetTimeTrackData(), ProjectAudioIO::IsAudioActive(), WaveformSettings::isLinear(), mdBRange, mEnvelope, mLog, mLower, mpEnvelopeEditor, mRect, mUpper, TrackPanelMouseEvent::pCell, TrackPanelMouseEvent::rect, RefreshCode::RefreshCell, and RefreshCode::RefreshNone.

Here is the call graph for this function:

◆ Drag()

UIHandle::Result EnvelopeHandle::Drag	(	const TrackPanelMouseEvent &	event,
		AudacityProject *	pProject
	)

overridevirtual

Implements UIHandle.

Definition at line 232 of file EnvelopeHandle.cpp.

{
   using namespace RefreshCode;
   const wxMouseEvent &event = evt.event;
   const auto &viewInfo = ViewInfo::Get( *pProject );
   const bool unsafe = ProjectAudioIO::Get( *pProject ).IsAudioActive();
   if (unsafe) {
      this->Cancel(pProject);
      return RefreshCell | Cancelled;
   }
 
   const bool needUpdate = ForwardEventToEnvelopes(event, viewInfo);
   return needUpdate ? RefreshCell : RefreshNone;
}

References Cancel(), Cancelled, TrackPanelMouseEvent::event, ForwardEventToEnvelopes(), ProjectAudioIO::Get(), ViewInfo::Get(), ProjectAudioIO::IsAudioActive(), RefreshCode::RefreshCell, and RefreshCode::RefreshNone.

Here is the call graph for this function:

◆ Enter()

void EnvelopeHandle::Enter	(	bool	forward,
		AudacityProject *
	)

overridevirtual

Reimplemented from UIHandle.

Definition at line 42 of file EnvelopeHandle.cpp.

{
#ifdef EXPERIMENTAL_TRACK_PANEL_HIGHLIGHTING
   mChangeHighlight = RefreshCode::RefreshCell;
#endif
}

References UIHandle::mChangeHighlight, and RefreshCode::RefreshCell.

◆ FindTrack()

std::shared_ptr< const Track > EnvelopeHandle::FindTrack ( ) const

overridevirtual

Returns: pointer to associated track, if any

Implements UIHandle.

Definition at line 52 of file EnvelopeHandle.cpp.

{
   return TrackFromChannel(mwChannel.lock());
}

References mwChannel, and UIHandle::TrackFromChannel().

Here is the call graph for this function:

◆ ForwardEventToEnvelopes()

bool EnvelopeHandle::ForwardEventToEnvelopes	(	const wxMouseEvent &	event,
		const ViewInfo &	viewInfo
	)

private

The Envelope class actually handles things at the mouse event level, so we have to forward the events over. Envelope will then tell us whether or not we need to redraw.

Definition at line 301 of file EnvelopeHandle.cpp.

{
 
   // AS: I'm not sure why we can't let the Envelope take care of
   //  redrawing itself.  ?
   return mpEnvelopeEditor && mpEnvelopeEditor->MouseEvent(
      event, mRect, viewInfo, mLog, mdBRange, mLower, mUpper);
}

References mdBRange, mLog, mLower, mpEnvelopeEditor, mRect, and mUpper.

Referenced by Click(), Drag(), and Release().

Here is the caller graph for this function:

◆ GetEnvelope()

Envelope * EnvelopeHandle::GetEnvelope ( ) const

inline

Definition at line 61 of file EnvelopeHandle.h.

61{ return mEnvelope; }

Referenced by anonymous_namespace{WaveformView.cpp}::DrawClipWaveform(), anonymous_namespace{TimeTrackView.cpp}::DrawHorzRulerAndCurve(), and EnvelopeEditor::DrawPoints().

Here is the caller graph for this function:

◆ HitAnywhere()

UIHandlePtr EnvelopeHandle::HitAnywhere	(	std::weak_ptr< EnvelopeHandle > &	holder,
		Envelope *	envelope,
		std::weak_ptr< const Channel >	wChannel,
		bool	timeTrack
	)

static

Definition at line 57 of file EnvelopeHandle.cpp.

{
   auto result = AssignUIHandlePtr(holder,
      std::make_shared<EnvelopeHandle>(envelope, move(wChannel)));
   result->mTimeTrack = timeTrack;
   return result;
}

References AssignUIHandlePtr().

Referenced by WaveformView::DetailedHitTest(), and HitEnvelope().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ HitEnvelope()

UIHandlePtr EnvelopeHandle::HitEnvelope	(	std::weak_ptr< EnvelopeHandle > &	holder,
		const wxMouseState &	state,
		const wxRect &	rect,
		const AudacityProject *	pProject,
		Envelope *	envelope,
		std::weak_ptr< const Channel >	wChannel,
		float	zoomMin,
		float	zoomMax,
		bool	dB,
		float	dBRange,
		bool	timeTrack
	)

staticprivate

Definition at line 126 of file EnvelopeHandle.cpp.

{
   const auto &viewInfo = ViewInfo::Get( *pProject );
 
   const double envValue =
      envelope->GetValue(viewInfo.PositionToTime(state.m_x, rect.x));
 
   // Get y position of envelope point.
   int yValue = GetWaveYPos(envValue,
      zoomMin, zoomMax,
      rect.height, dB, true, dBRange, false) + rect.y;
 
   // Get y position of center line
   int ctr = GetWaveYPos(0.0,
      zoomMin, zoomMax,
      rect.height, dB, true, dBRange, false) + rect.y;
 
   // Get y distance of mouse from center line (in pixels).
   int yMouse = abs(ctr - state.m_y);
   // Get y distance of envelope from center line (in pixels)
   yValue = abs(ctr - yValue);
 
   // JKC: It happens that the envelope is actually drawn offset from its
   // 'true' position (it is 3 pixels wide).  yMisalign is really a fudge
   // factor to allow us to hit it exactly, but I wouldn't dream of
   // calling it yFudgeFactor :)
   const int yMisalign = 2;
   // Perhaps yTolerance should be put into preferences?
   const int yTolerance = 5; // how far from envelope we may be and count as a hit.
   int distance;
 
   // For amplification using the envelope we introduced the idea of contours.
   // The contours have the same shape as the envelope, which may be partially off-screen.
   // The contours are closer in to the center line.
   // Beware very short rectangles!  Make this at least 1
   int ContourSpacing = std::max(1,
      static_cast<int>(rect.height / (2 * (zoomMax - zoomMin))));
   const int MaxContours = 2;
 
   // Adding ContourSpacing/2 selects a region either side of the contour.
   int yDisplace = yValue - yMisalign - yMouse + ContourSpacing / 2;
   if (yDisplace > (MaxContours * ContourSpacing))
      return {};
   // Subtracting the ContourSpacing/2 we added earlier ensures distance is centred on the contour.
   distance = abs((yDisplace % ContourSpacing) - ContourSpacing / 2);
   if (distance >= yTolerance)
      return {};
 
   return HitAnywhere(holder, envelope, move(wChannel), timeTrack);
}

References ViewInfo::Get(), Envelope::GetValue(), GetWaveYPos(), and HitAnywhere().

Referenced by TimeTrackHitTest(), and WaveChannelHitTest().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ operator=() [1/2]

EnvelopeHandle & EnvelopeHandle::operator= ( const EnvelopeHandle & )

privatedelete

◆ operator=() [2/2]

EnvelopeHandle & EnvelopeHandle::operator= ( EnvelopeHandle && )

default

◆ Preview()

HitTestPreview EnvelopeHandle::Preview	(	const TrackPanelMouseState &	state,
		AudacityProject *	pProject
	)

overridevirtual

Implements UIHandle.

Definition at line 248 of file EnvelopeHandle.cpp.

{
   const bool unsafe = ProjectAudioIO::Get( *pProject ).IsAudioActive();
   static auto disabledCursor =
      ::MakeCursor(wxCURSOR_NO_ENTRY, DisabledCursorXpm, 16, 16);
   static auto envelopeCursor =
      ::MakeCursor(wxCURSOR_ARROW, EnvCursorXpm, 16, 16);
 
   auto message = mTimeTrack
      ? XO("Click and drag to warp playback time")
      : XO("Click and drag to edit the amplitude envelope");
 
   return {
      message,
      (unsafe
       ? &*disabledCursor
       : &*envelopeCursor)
   };
}

References ProjectAudioIO::Get(), ProjectAudioIO::IsAudioActive(), MakeCursor(), mTimeTrack, and XO().

Here is the call graph for this function:

◆ Release()

UIHandle::Result EnvelopeHandle::Release	(	const TrackPanelMouseEvent &	event,
		AudacityProject *	pProject,
		wxWindow *	pParent
	)

overridevirtual

Implements UIHandle.

Definition at line 269 of file EnvelopeHandle.cpp.

{
   const wxMouseEvent &event = evt.event;
   const auto &viewInfo = ViewInfo::Get( *pProject );
   const bool unsafe = ProjectAudioIO::Get( *pProject ).IsAudioActive();
   if (unsafe)
      return this->Cancel(pProject);
 
   const bool needUpdate = ForwardEventToEnvelopes(event, viewInfo);
 
   ProjectHistory::Get( *pProject ).PushState(
      /* i18n-hint: (verb) Audacity has just adjusted the envelope .*/
      XO("Adjusted envelope."),
      /* i18n-hint: The envelope is a curve that controls the audio loudness.*/
      XO("Envelope")
   );
 
   mpEnvelopeEditor.reset();
 
   using namespace RefreshCode;
   return needUpdate ? RefreshCell : RefreshNone;
}

References Cancel(), TrackPanelMouseEvent::event, ForwardEventToEnvelopes(), ProjectAudioIO::Get(), ProjectHistory::Get(), ViewInfo::Get(), ProjectAudioIO::IsAudioActive(), mpEnvelopeEditor, ProjectHistory::PushState(), RefreshCode::RefreshCell, RefreshCode::RefreshNone, and XO().

Here is the call graph for this function:

◆ StopsOnKeystroke()

bool EnvelopeHandle::StopsOnKeystroke ( )

inlineoverridevirtual

Reimplemented from UIHandle.

Definition at line 81 of file EnvelopeHandle.h.

81{ return true; }

◆ TimeTrackHitTest()

UIHandlePtr EnvelopeHandle::TimeTrackHitTest	(	std::weak_ptr< EnvelopeHandle > &	holder,
		const wxMouseState &	state,
		const wxRect &	rect,
		const AudacityProject *	pProject,
		const std::shared_ptr< TimeTrack > &	tt
	)

static

Definition at line 83 of file EnvelopeHandle.cpp.

{
   auto envelope = tt->GetEnvelope();
   if (!envelope)
      return {};
   bool dB;
   double dBRange;
   float zoomMin, zoomMax;
   GetTimeTrackData( *pProject, *tt, dBRange, dB, zoomMin, zoomMax);
   return EnvelopeHandle::HitEnvelope(holder, state, rect, pProject, envelope,
      std::dynamic_pointer_cast<const Channel>(tt),
      zoomMin, zoomMax, dB, dBRange, true);
}

References anonymous_namespace{EnvelopeHandle.cpp}::GetTimeTrackData(), and HitEnvelope().

Referenced by TimeTrackView::DetailedHitTest().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ WaveChannelHitTest()

UIHandlePtr EnvelopeHandle::WaveChannelHitTest	(	std::weak_ptr< EnvelopeHandle > &	holder,
		const wxMouseState &	state,
		const wxRect &	rect,
		const AudacityProject *	pProject,
		const std::shared_ptr< WaveChannel > &	wt
	)

static

method that tells us if the mouse event landed on an envelope boundary.

Definition at line 100 of file EnvelopeHandle.cpp.

{
   auto &viewInfo = ViewInfo::Get(*pProject);
   auto time = viewInfo.PositionToTime(state.m_x, rect.GetX());
   const auto envelope = WaveChannelUtilities::GetEnvelopeAtTime(*wc, time);
   if (!envelope)
      return {};
 
   // Get envelope point, range 0.0 to 1.0
   const bool dB = !WaveformSettings::Get(*wc).isLinear();
 
   float zoomMin, zoomMax;
   auto &cache = WaveformScale::Get(*wc);
   cache.GetDisplayBounds(zoomMin, zoomMax);
 
   const float dBRange = WaveformSettings::Get(*wc).dBRange;
 
   return EnvelopeHandle::HitEnvelope(holder, state, rect, pProject, envelope,
      wc, zoomMin, zoomMax, dB, dBRange, false);
}

References WaveformSettings::dBRange, ViewInfo::Get(), WaveformSettings::Get(), WaveformScale::Get(), WaveChannelUtilities::GetEnvelopeAtTime(), HitEnvelope(), and WaveformSettings::isLinear().

Referenced by WaveformView::DetailedHitTest().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

◆ mdBRange

double EnvelopeHandle::mdBRange {}

private

Definition at line 90 of file EnvelopeHandle.h.

Referenced by Click(), and ForwardEventToEnvelopes().

◆ mEnvelope

Envelope* EnvelopeHandle::mEnvelope {}

private

Definition at line 92 of file EnvelopeHandle.h.

Referenced by Click().

◆ mLog

bool EnvelopeHandle::mLog {}

private

Definition at line 88 of file EnvelopeHandle.h.

Referenced by Click(), and ForwardEventToEnvelopes().

◆ mLower

float EnvelopeHandle::mLower {}

private

Definition at line 89 of file EnvelopeHandle.h.

Referenced by Click(), and ForwardEventToEnvelopes().

◆ mpEnvelopeEditor

std::unique_ptr<EnvelopeEditor> EnvelopeHandle::mpEnvelopeEditor

private

Definition at line 94 of file EnvelopeHandle.h.

Referenced by Cancel(), Click(), ForwardEventToEnvelopes(), and Release().

◆ mRect

wxRect EnvelopeHandle::mRect {}

private

Definition at line 87 of file EnvelopeHandle.h.

Referenced by Click(), and ForwardEventToEnvelopes().

◆ mTimeTrack

bool EnvelopeHandle::mTimeTrack {}

private

Definition at line 96 of file EnvelopeHandle.h.

Referenced by Preview().

◆ mUpper

float EnvelopeHandle::mUpper {}

private

Definition at line 89 of file EnvelopeHandle.h.

Referenced by Click(), and ForwardEventToEnvelopes().

◆ mwChannel

std::weak_ptr<const Channel> EnvelopeHandle::mwChannel

private

Definition at line 93 of file EnvelopeHandle.h.

Referenced by FindTrack().

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

Public Member Functions

Static Public Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ EnvelopeHandle() [1/3]

◆ EnvelopeHandle() [2/3]

◆ EnvelopeHandle() [3/3]

◆ ~EnvelopeHandle()

Member Function Documentation

◆ Cancel()

◆ Click()

◆ Drag()

◆ Enter()

◆ FindTrack()

◆ ForwardEventToEnvelopes()

◆ GetEnvelope()

◆ HitAnywhere()

◆ HitEnvelope()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ Preview()

◆ Release()

◆ StopsOnKeystroke()

◆ TimeTrackHitTest()

◆ WaveChannelHitTest()

Member Data Documentation

◆ mdBRange

◆ mEnvelope

◆ mLog

◆ mLower

◆ mpEnvelopeEditor

◆ mRect

◆ mTimeTrack

◆ mUpper

◆ mwChannel