#include <WaveformVZoomHandle.h>

Inheritance diagram for WaveformVZoomHandle:

Collaboration diagram for WaveformVZoomHandle:

Public Member Functions
	WaveformVZoomHandle (const std::shared_ptr< WaveChannel > &pChannel, const wxRect &rect, int y)

WaveformVZoomHandle &	operator= (const WaveformVZoomHandle &)=default

	~WaveformVZoomHandle () override

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

void	Enter (bool forward, AudacityProject *) override

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

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

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 void	DoZoom (AudacityProject *pProject, WaveChannel &wc, WaveChannelViewConstants::ZoomActions ZoomKind, const wxRect &rect, int zoomStart, int zoomEnd, bool fixedMousePoint)

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
	WaveformVZoomHandle (const WaveformVZoomHandle &)

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

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

Private Attributes
std::weak_ptr< WaveChannel >	mpChannel

int	mZoomStart {}

int	mZoomEnd {}

wxRect	mRect {}

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 20 of file WaveformVZoomHandle.h.

Constructor & Destructor Documentation

◆ WaveformVZoomHandle() [1/2]

WaveformVZoomHandle::WaveformVZoomHandle ( const WaveformVZoomHandle & )

private

◆ WaveformVZoomHandle() [2/2]

WaveformVZoomHandle::WaveformVZoomHandle	(	const std::shared_ptr< WaveChannel > &	pChannel,
		const wxRect &	rect,
		int	y
	)

explicit

Definition at line 25 of file WaveformVZoomHandle.cpp.

      : mpChannel{ pChannel } , mZoomStart(y), mZoomEnd(y), mRect(rect)
{
}

◆ ~WaveformVZoomHandle()

WaveformVZoomHandle::~WaveformVZoomHandle ( )

overridedefault

Member Function Documentation

◆ Cancel()

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

overridevirtual

Implements UIHandle.

Definition at line 85 of file WaveformVZoomHandle.cpp.

{
   // Cancel is implemented!  And there is no initial state to restore,
   // so just return a code.
   return RefreshCode::RefreshAll;
}

References RefreshCode::RefreshAll.

◆ Click()

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

overridevirtual

Implements UIHandle.

Definition at line 50 of file WaveformVZoomHandle.cpp.

{
   return RefreshCode::RefreshNone;
}

References RefreshCode::RefreshNone.

◆ DoZoom()

void WaveformVZoomHandle::DoZoom	(	AudacityProject *	pProject,
		WaveChannel &	wc,
		WaveChannelViewConstants::ZoomActions	ZoomKind,
		const wxRect &	rect,
		int	zoomStart,
		int	zoomEnd,
		bool	fixedMousePoint
	)

static

Definition at line 113 of file WaveformVZoomHandle.cpp.

{
   using namespace WaveChannelViewConstants;
   static const float ZOOMLIMIT = 0.001f;
 
   int height = rect.height;
   int ypos = rect.y;
 
   // Ensure start and end are in order (swap if not).
   if (zoomEnd < zoomStart)
      std::swap( zoomStart, zoomEnd );
 
   float min, max, minBand = 0;
   const double rate = wc.GetRate();
   const float halfrate = rate / 2;
   float maxFreq = 8000.0;
 
 
   float top=2.0;
   float half=0.5;
   auto &cache = WaveformScale::Get(wc);
 
   {
      cache.GetDisplayBounds(min, max);
      auto &waveSettings = WaveformSettings::Get(wc);
      const bool linear = waveSettings.isLinear();
      if( !linear ){
         top = (LINEAR_TO_DB(2.0) + waveSettings.dBRange) / waveSettings.dBRange;
         half = (LINEAR_TO_DB(0.5) + waveSettings.dBRange) / waveSettings.dBRange;
      }
   }
 
 
   // Compute min and max.
   switch(ZoomKind)
   {
   default:
      // If we have covered all the cases, this won't happen.
      // In release builds Audacity will ignore the zoom.
      wxFAIL_MSG("Zooming Case not implemented by Audacity");
      break;
   case kZoomReset:
   case kZoom1to1:
      {
         // Zoom out full
         min = -1.0;
         max = 1.0;
      }
      break;
   case kZoomHalfWave:
      {
         // Zoom to show fractionally more than the top half of the wave.
         min = -0.01f;
         max = 1.0;
      }
      break;
   case kZoomInByDrag:
      {
         const float tmin = min, tmax = max;
         const float p1 = (zoomStart - ypos) / (float)height;
         const float p2 = (zoomEnd - ypos) / (float)height;
         max = (tmax * (1.0 - p1) + tmin * p1);
         min = (tmax * (1.0 - p2) + tmin * p2);
 
         // Waveform view - allow zooming down to a range of ZOOMLIMIT
         if (max - min < ZOOMLIMIT) {     // if user attempts to go smaller...
            float c = (min + max) / 2;    // ...set centre of view to centre of dragged area and top/bottom to ZOOMLIMIT/2 above/below
            min = c - ZOOMLIMIT / 2.0;
            max = c + ZOOMLIMIT / 2.0;
         }
      }
      break;
   case kZoomIn:
      {
         const float zoomFactor = 0.5f;
         const float currentRange = max - min;
         const float nextRange = std::max(zoomFactor * currentRange, ZOOMLIMIT);
 
         const float center = min + (currentRange / 2.0);
         min = center - (nextRange / 2.0);
         max = center + (nextRange / 2.0);
      }
      break;
   case kZoomOut:
      {
         const float zoomFactor = 2.0f;
         const float currentRange = max - min;
         const float nextRange = zoomFactor * currentRange;
 
         const float center = min + (currentRange / 2.0);
         min = std::max(-top, center - (0.5f * nextRange));
         max = std::min(top, center + (0.5f * nextRange));
      }
      break;
   }
 
   // Now actually apply the zoom.
   cache.SetDisplayBounds(min, max);
 
   zoomEnd = zoomStart = 0;
   if( pProject )
      ProjectHistory::Get( *pProject ).ModifyState(true);
}

References ProjectHistory::Get(), WaveformSettings::Get(), WaveformScale::Get(), WaveChannel::GetRate(), WaveChannelViewConstants::kZoom1to1, WaveChannelViewConstants::kZoomHalfWave, WaveChannelViewConstants::kZoomIn, WaveChannelViewConstants::kZoomInByDrag, WaveChannelViewConstants::kZoomOut, WaveChannelViewConstants::kZoomReset, LINEAR_TO_DB, min(), ProjectHistory::ModifyState(), and anonymous_namespace{NoteTrack.cpp}::swap().

Referenced by WaveformVRulerControls::DoHandleWheelRotation(), and Release().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Drag()

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

overridevirtual

Implements UIHandle.

Definition at line 56 of file WaveformVZoomHandle.cpp.

{
   using namespace RefreshCode;
   const auto pChannel = mpChannel.lock();
   if (!pChannel)
      return Cancelled;
   return WaveChannelVZoomHandle::DoDrag(evt, pProject, mZoomStart, mZoomEnd, false);
}

References Cancelled, WaveChannelVZoomHandle::DoDrag(), mpChannel, mZoomEnd, and mZoomStart.

Here is the call graph for this function:

◆ Draw()

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

overrideprivatevirtual

Reimplemented from TrackPanelDrawable.

Definition at line 92 of file WaveformVZoomHandle.cpp.

{
   const auto pChannel = mpChannel.lock();
   if (!pChannel)
      return;
   return WaveChannelVZoomHandle::DoDraw(
      context, rect, iPass, mZoomStart, mZoomEnd, false);
}

References WaveChannelVZoomHandle::DoDraw(), mpChannel, mZoomEnd, and mZoomStart.

Here is the call graph for this function:

◆ DrawingArea()

wxRect WaveformVZoomHandle::DrawingArea	(	TrackPanelDrawingContext &	,
		const wxRect &	rect,
		const wxRect &	panelRect,
		unsigned	iPass
	)

overrideprivatevirtual

Reimplemented from TrackPanelDrawable.

Definition at line 103 of file WaveformVZoomHandle.cpp.

{
   return WaveChannelVZoomHandle::DoDrawingArea(rect, panelRect, iPass);
}

References WaveChannelVZoomHandle::DoDrawingArea().

Here is the call graph for this function:

◆ Enter()

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

overridevirtual

Reimplemented from UIHandle.

Definition at line 38 of file WaveformVZoomHandle.cpp.

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

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

◆ FindTrack()

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

overridevirtual

Returns: pointer to associated track, if any

Implements UIHandle.

Definition at line 33 of file WaveformVZoomHandle.cpp.

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

References mpChannel, and UIHandle::TrackFromChannel().

Here is the call graph for this function:

◆ HandlesRightClick()

bool WaveformVZoomHandle::HandlesRightClick ( )

overridevirtual

Whether the handle has any special right-button handling.

If not, then Click() will not be called for right click. Default is always false

Reimplemented from UIHandle.

Definition at line 45 of file WaveformVZoomHandle.cpp.

{
   return true;
}

◆ operator=()

WaveformVZoomHandle & WaveformVZoomHandle::operator= ( const WaveformVZoomHandle & )

default

◆ Preview()

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

overridevirtual

Implements UIHandle.

Definition at line 66 of file WaveformVZoomHandle.cpp.

{
   return WaveChannelVZoomHandle::HitPreview(false);
}

References WaveChannelVZoomHandle::HitPreview().

Here is the call graph for this function:

◆ Release()

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

overridevirtual

Implements UIHandle.

Definition at line 72 of file WaveformVZoomHandle.cpp.

{
   const auto pChannel = mpChannel.lock();
   if (!pChannel)
      return RefreshCode::Cancelled;
   return WaveChannelVZoomHandle::DoRelease(
      evt, pProject, pParent, *pChannel, mRect,
      DoZoom, WaveformVRulerMenuTable::Instance(),
      mZoomStart, mZoomEnd);
}

References RefreshCode::Cancelled, WaveChannelVZoomHandle::DoRelease(), DoZoom(), WaveformVRulerMenuTable::Instance(), mpChannel, mRect, mZoomEnd, and mZoomStart.

Here is the call graph for this function:

Member Data Documentation

◆ mpChannel

std::weak_ptr<WaveChannel> WaveformVZoomHandle::mpChannel

private

Definition at line 71 of file WaveformVZoomHandle.h.

Referenced by Drag(), Draw(), FindTrack(), and Release().

◆ mRect

wxRect WaveformVZoomHandle::mRect {}

private

Definition at line 74 of file WaveformVZoomHandle.h.

Referenced by Release().

◆ mZoomEnd

int WaveformVZoomHandle::mZoomEnd {}

private

Definition at line 73 of file WaveformVZoomHandle.h.

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

◆ mZoomStart

int WaveformVZoomHandle::mZoomStart {}

private

Definition at line 73 of file WaveformVZoomHandle.h.

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

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

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ WaveformVZoomHandle() [1/2]

◆ WaveformVZoomHandle() [2/2]

◆ ~WaveformVZoomHandle()

Member Function Documentation

◆ Cancel()

◆ Click()

◆ DoZoom()

◆ Drag()

◆ Draw()

◆ DrawingArea()

◆ Enter()

◆ FindTrack()

◆ HandlesRightClick()

◆ operator=()

◆ Preview()

◆ Release()

Member Data Documentation

◆ mpChannel

◆ mRect

◆ mZoomEnd

◆ mZoomStart