TrackUtilities Namespace Reference

Enumerations
enum	MoveChoice { OnMoveUpID , OnMoveDownID , OnMoveTopID , OnMoveBottomID }

Functions
AUDACITY_DLL_API void	DoMoveTrack (AudacityProject &project, Track &target, MoveChoice choice)
	Move a track up, down, to top or to bottom. More...
AUDACITY_DLL_API void	DoTrackMute (AudacityProject &project, Track &track, bool exclusive)
	"exclusive" mute means mute the chosen track and unmute all others. More...
AUDACITY_DLL_API void	DoTrackSolo (AudacityProject &project, Track &track, bool exclusive)
AUDACITY_DLL_API void	DoRemoveTrack (AudacityProject &project, Track &toRemove)
AUDACITY_DLL_API void	DoRemoveTracks (AudacityProject &)

Enumeration Type Documentation

MoveChoice

enum TrackUtilities::MoveChoice

Enumerator
OnMoveUpID
OnMoveDownID
OnMoveTopID
OnMoveBottomID

Definition at line 19 of file TrackUtilities.h.

                   {
      OnMoveUpID, OnMoveDownID, OnMoveTopID, OnMoveBottomID
   };

Function Documentation

DoMoveTrack()

void TrackUtilities::DoMoveTrack	(	AudacityProject &	project,
		Track &	target,
		MoveChoice	choice
	)

Move a track up, down, to top or to bottom.

Definition at line 175 of file TrackUtilities.cpp.

{
   auto &tracks = TrackList::Get( project );
 
   TranslatableString longDesc, shortDesc;
 
   switch (choice)
   {
   case OnMoveTopID:
      /* i18n-hint: Past tense of 'to move', as in 'moved audio track up'.*/
      longDesc = XO("Moved '%s' to Top");
      shortDesc = XO("Move Track to Top");
 
      // TODO: write TrackList::Rotate to do this in one step and avoid emitting
      // an event for each swap
      while (tracks.CanMoveUp(target))
         tracks.Move(target, true);
 
      break;
   case OnMoveBottomID:
      /* i18n-hint: Past tense of 'to move', as in 'moved audio track up'.*/
      longDesc = XO("Moved '%s' to Bottom");
      shortDesc = XO("Move Track to Bottom");
 
      // TODO: write TrackList::Rotate to do this in one step and avoid emitting
      // an event for each swap
      while (tracks.CanMoveDown(target))
         tracks.Move(target, false);
 
      break;
   default:
      bool bUp = (OnMoveUpID == choice);
 
      tracks.Move(target, bUp);
      longDesc =
         /* i18n-hint: Past tense of 'to move', as in 'moved audio track up'.*/
         bUp? XO("Moved '%s' Up")
         : XO("Moved '%s' Down");
      shortDesc =
         /* i18n-hint: Past tense of 'to move', as in 'moved audio track up'.*/
         bUp? XO("Move Track Up")
         : XO("Move Track Down");
 
   }
 
   longDesc.Format(target.GetName());
 
   ProjectHistory::Get( project ).PushState(longDesc, shortDesc);
}

References TranslatableString::Format(), ProjectHistory::Get(), TrackList::Get(), Track::GetName(), OnMoveBottomID, OnMoveTopID, OnMoveUpID, project, ProjectHistory::PushState(), tracks, and XO().

Referenced by TrackMenuTable::OnMoveTrack(), anonymous_namespace{TrackMenus.cpp}::OnTrackMoveBottom(), anonymous_namespace{TrackMenus.cpp}::OnTrackMoveDown(), anonymous_namespace{TrackMenus.cpp}::OnTrackMoveTop(), and anonymous_namespace{TrackMenus.cpp}::OnTrackMoveUp().

Here is the call graph for this function:

Here is the caller graph for this function:

DoRemoveTrack()

void TrackUtilities::DoRemoveTrack	(	AudacityProject &	project,
		Track &	toRemove
	)

Definition at line 143 of file TrackUtilities.cpp.

{
   auto &tracks = TrackList::Get(project);
   auto &trackFocus = TrackFocus::Get(project);
 
   const auto iter = tracks.Find(&toRemove);
 
   // If it was focused, then NEW focus is the next or, if
   // unavailable, the previous track. (The NEW focus is set
   // after the track has been removed.)
   bool toRemoveWasFocused = trackFocus.Get() == *iter;
   std::optional<decltype(iter)> newFocus{};
   if (toRemoveWasFocused) {
      auto iterNext = iter,
         iterPrev = iter;
      newFocus.emplace(++iterNext);
      if (!**newFocus)
         newFocus.emplace(--iterPrev);
   }
 
   wxString name = toRemove.GetName();
 
   tracks.Remove(**iter);
 
   if (toRemoveWasFocused)
      trackFocus.Set(**newFocus);
 
   ProjectHistory::Get(project).PushState(
      XO("Removed track '%s'.").Format(name),
      XO("Track Remove"));
}

References TrackFocus::Get(), ProjectHistory::Get(), TrackList::Get(), Track::GetName(), name, project, ProjectHistory::PushState(), tracks, and XO().

Referenced by CloseButtonHandle::CommitChanges(), and anonymous_namespace{TrackMenus.cpp}::OnTrackClose().

Here is the call graph for this function:

Here is the caller graph for this function:

DoRemoveTracks()

void TrackUtilities::DoRemoveTracks

(

AudacityProject &

project

)

Definition at line 19 of file TrackUtilities.cpp.

                                                            {
   auto &tracks = TrackList::Get(project);
   auto &trackPanel = TrackPanel::Get(project);
 
   auto range = tracks.Selected();
   using Iter = decltype(range.begin());
 
   // Find the track preceding the first removed track
   std::optional<Iter> focus;
   if (!range.empty()) {
      auto iter = tracks.Find(*range.begin());
      // TrackIter allows decrement even of begin iterators
      focus.emplace(--iter);
   }
 
   while (!range.empty())
      tracks.Remove(**range.first++);
 
   if (!(focus.has_value() && **focus))
      // try to use the last track
      focus.emplace(tracks.end().advance(-1));
   assert(focus);
   Track *f = **focus;
   // Try to use the first track after the removal
   // TrackIter allows increment even of end iterators
   if (const auto nextF = * ++ *focus)
      f = nextF;
 
   // If we actually have something left, then set focus and make sure it's seen
   if (f) {
      TrackFocus::Get(project).Set(f);
      Viewport::Get(project).ShowTrack(*f);
   }
 
   ProjectHistory::Get(project)
      .PushState(XO("Removed audio track(s)"), XO("Remove Track"));
 
   trackPanel.UpdateViewIfNoTracks();
}

References TrackFocus::Get(), ProjectHistory::Get(), TrackList::Get(), Viewport::Get(), TrackPanel::Get(), project, ProjectHistory::PushState(), Viewport::ShowTrack(), tracks, and XO().

Referenced by anonymous_namespace{TrackMenus.cpp}::OnRemoveTracks(), and ProjectManager::ResetProjectToEmpty().

Here is the call graph for this function:

Here is the caller graph for this function:

DoTrackMute()

void TrackUtilities::DoTrackMute	(	AudacityProject &	project,
		Track &	track,
		bool	exclusive
	)

"exclusive" mute means mute the chosen track and unmute all others.

Definition at line 59 of file TrackUtilities.cpp.

{
   auto &tracks = TrackList::Get(project);
 
   // "exclusive" mute means mute the chosen track and unmute all others.
   if (exclusive) {
      for (auto playable : tracks.Any<PlayableTrack>()) {
         bool chosen = (&track == playable);
         playable->SetMute(chosen);
         playable->SetSolo(false);
      }
   }
   else {
      // Normal click toggles this track.
      auto pt = dynamic_cast<PlayableTrack *>(&track);
      if (!pt)
         return;
 
      bool wasMute = pt->GetMute();
      pt->SetMute(!wasMute);
 
      if (auto value = TracksBehaviorsSolo.ReadEnum();
         value == SoloBehaviorSimple)
      {
         // We also set a solo indicator if we have just one track / stereo pair playing.
         // in a group of more than one playable tracks.
         // otherwise clear solo on everything.
 
         auto range = tracks.Any<PlayableTrack>();
         auto nPlayableTracks = range.size();
         auto nPlaying = (range - &PlayableTrack::GetMute).size();
         for (auto track : range)
            track->SetSolo((nPlaying == 1) &&
               (nPlayableTracks > 1) && !track->GetMute());
      }
   }
   ProjectHistory::Get( project ).ModifyState(true);
 
   TrackFocus::Get( project ).UpdateAccessibility();
}

References TrackFocus::Get(), ProjectHistory::Get(), TrackList::Get(), PlayableTrack::GetMute(), ProjectHistory::ModifyState(), project, ClientData::Site< Host, ClientData, ObjectCopyingPolicy, Pointer, ObjectLockingPolicy, RegistryLockingPolicy >::size(), size, SoloBehaviorSimple, tracks, and TracksBehaviorsSolo.

Referenced by MuteButtonHandle::CommitChanges(), MixerTrackCluster::OnButton_Mute(), and anonymous_namespace{TrackMenus.cpp}::OnTrackMute().

Here is the call graph for this function:

Here is the caller graph for this function:

DoTrackSolo()

void TrackUtilities::DoTrackSolo	(	AudacityProject &	project,
		Track &	track,
		bool	exclusive
	)

Type of solo (standard or simple) follows the set preference, unless exclusive == true, which causes the opposite behavior.

Definition at line 101 of file TrackUtilities.cpp.

{
   auto &tracks = TrackList::Get( project );
   
   const auto pt = dynamic_cast<PlayableTrack *>(&track);
   if (!pt)
      return;
   bool bWasSolo = pt->GetSolo();
 
   bool simple = (TracksBehaviorsSolo.ReadEnum() == SoloBehaviorSimple);
   bool bSoloMultiple = !simple ^ exclusive;
 
   // Standard and Simple solo have opposite defaults:
   //   Standard - Behaves as individual buttons, shift=radio buttons
   //   Simple   - Behaves as radio buttons, shift=individual
   // In addition, Simple solo will mute/unmute tracks
   // when in standard radio button mode.
   if (bSoloMultiple)
      pt->SetSolo(!bWasSolo);
   else {
      // Normal click solo this track only, mute everything else.
      // OR unmute and unsolo everything.
      for (auto playable : tracks.Any<PlayableTrack>()) {
         bool chosen = (&track == playable);
         if (chosen) {
            playable->SetSolo(!bWasSolo);
            if (simple)
               playable->SetMute(false);
         }
         else {
            playable->SetSolo(false);
            if (simple)
               playable->SetMute(!bWasSolo);
         }
      }
   }
   ProjectHistory::Get( project ).ModifyState(true);
 
   TrackFocus::Get( project ).UpdateAccessibility();
}

References TrackFocus::Get(), ProjectHistory::Get(), TrackList::Get(), PlayableTrack::GetSolo(), ProjectHistory::ModifyState(), project, SoloBehaviorSimple, tracks, and TracksBehaviorsSolo.

Referenced by SoloButtonHandle::CommitChanges(), MixerTrackCluster::OnButton_Solo(), and anonymous_namespace{TrackMenus.cpp}::OnTrackSolo().

Here is the call graph for this function:

Here is the caller graph for this function: