anonymous_namespace{TransportMenus.cpp} Namespace Reference

Functions
bool	MakeReadyToPlay (AudacityProject &project)
void	DoMoveToLabel (AudacityProject &project, bool next)
bool	IsLoopingEnabled (const AudacityProject &project)
void	OnPlayOnceOrStop (const CommandContext &context)
void	OnPlayStopSelect (const CommandContext &context)
void	OnPlayDefaultOrStop (const CommandContext &context)
void	OnPause (const CommandContext &context)
void	OnRecord (const CommandContext &context)
void	OnRecord2ndChoice (const CommandContext &context)
void	OnTogglePlayRegion (const CommandContext &context)
void	OnClearPlayRegion (const CommandContext &context)
void	OnSetPlayRegionIn (const CommandContext &context)
void	OnSetPlayRegionOut (const CommandContext &context)
void	OnSetPlayRegionToSelection (const CommandContext &context)
void	OnRescanDevices (const CommandContext &WXUNUSED(context))
void	OnSoundActivated (const CommandContext &context)
void	OnToggleSoundActivated (const CommandContext &WXUNUSED(context))
void	OnTogglePlayRecording (const CommandContext &WXUNUSED(context))
void	OnToggleSWPlaythrough (const CommandContext &WXUNUSED(context))
void	OnStop (const CommandContext &context)
void	OnPlayOneSecond (const CommandContext &context)
void	OnPlayToSelection (const CommandContext &context)
void	OnPlayBeforeSelectionStart (const CommandContext &context)
void	OnPlayAfterSelectionStart (const CommandContext &context)
void	OnPlayBeforeSelectionEnd (const CommandContext &context)
void	OnPlayAfterSelectionEnd (const CommandContext &context)
void	OnPlayBeforeAndAfterSelectionStart (const CommandContext &context)
void	OnPlayBeforeAndAfterSelectionEnd (const CommandContext &context)
void	OnPlayCutPreview (const CommandContext &context)
void	OnMoveToPrevLabel (const CommandContext &context)
void	OnMoveToNextLabel (const CommandContext &context)
BaseItemSharedPtr	TransportMenu ()
BaseItemSharedPtr	ExtraTransportMenu ()
BaseItemSharedPtr	ExtraSelectionItems ()

Variables
AttachedItem	sAttachment1
AttachedItem	sAttachment2
AttachedItem	sAttachment4

Function Documentation

DoMoveToLabel()

void anonymous_namespace{TransportMenus.cpp}::DoMoveToLabel	(	AudacityProject &	project,
		bool	next
	)

Definition at line 73 of file TransportMenus.cpp.

{
   auto &tracks = TrackList::Get( project );
   auto &trackFocus = TrackFocus::Get( project );
   auto &window = ProjectWindow::Get( project );
   auto &projectAudioManager = ProjectAudioManager::Get(project);
 
   // Find the number of label tracks, and ptr to last track found
   auto trackRange = tracks.Any<LabelTrack>();
   auto lt = *trackRange.rbegin();
   auto nLabelTrack = trackRange.size();
 
   if (nLabelTrack == 0 ) {
      trackFocus.MessageForScreenReader(XO("no label track"));
   }
   else if (nLabelTrack > 1) {
      // find first label track, if any, starting at the focused track
      lt =
         *tracks.Find(trackFocus.Get()).Filter<LabelTrack>();
      if (!lt)
         trackFocus.MessageForScreenReader(
            XO("no label track at or below focused track"));
   }
 
   // If there is a single label track, or there is a label track at or below
   // the focused track
   auto &selectedRegion = ViewInfo::Get( project ).selectedRegion;
   if (lt) {
      int i;
      if (next)
         i = lt->FindNextLabel(selectedRegion);
      else
         i = lt->FindPrevLabel(selectedRegion);
 
      if (i >= 0) {
         const LabelStruct* label = lt->GetLabel(i);
         bool newDefault = projectAudioManager.Looping();
         if (ProjectAudioIO::Get( project ).IsAudioActive()) {
            TransportUtilities::DoStopPlaying(project);
            selectedRegion = label->selectedRegion;
            window.RedrawProject();
            TransportUtilities::DoStartPlaying(project, newDefault);
         }
         else {
            selectedRegion = label->selectedRegion;
            window.ScrollIntoView(selectedRegion.t0());
            window.RedrawProject();
         }
         /* i18n-hint:
            String is replaced by the name of a label,
            first number gives the position of that label in a sequence
            of labels,
            and the last number is the total number of labels in the sequence.
         */
         auto message = XO("%s %d of %d")
            .Format( label->title, i + 1, lt->GetNumLabels() );
         trackFocus.MessageForScreenReader(message);
      }
      else {
         trackFocus.MessageForScreenReader(XO("no labels in label track"));
      }
   }
}

References TransportUtilities::DoStartPlaying(), TransportUtilities::DoStopPlaying(), ClientData::Site< Host, ClientData, ObjectCopyingPolicy, Pointer, ObjectLockingPolicy, RegistryLockingPolicy >::Find(), LabelTrack::FindNextLabel(), LabelTrack::FindPrevLabel(), TrackFocus::Get(), ProjectAudioIO::Get(), ViewInfo::Get(), TrackList::Get(), ProjectAudioManager::Get(), ProjectWindow::Get(), LabelTrack::GetLabel(), LabelTrack::GetNumLabels(), label, ViewInfo::selectedRegion, ClientData::Site< Host, ClientData, ObjectCopyingPolicy, Pointer, ObjectLockingPolicy, RegistryLockingPolicy >::size(), and XO().

Referenced by OnMoveToNextLabel(), and OnMoveToPrevLabel().

Here is the call graph for this function:

Here is the caller graph for this function:

ExtraSelectionItems()

BaseItemSharedPtr anonymous_namespace{TransportMenus.cpp}::ExtraSelectionItems

(

)

Definition at line 911 of file TransportMenus.cpp.

{
   using Options = CommandManager::Options;
   static BaseItemSharedPtr items{
   Items(wxT("MoveToLabel"),
      Command(wxT("MoveToPrevLabel"), XXO("Move to Pre&vious Label"),
         OnMoveToPrevLabel,
         CaptureNotBusyFlag() | TrackPanelHasFocus(), wxT("Alt+Left")),
      Command(wxT("MoveToNextLabel"), XXO("Move to Ne&xt Label"),
         OnMoveToNextLabel,
         CaptureNotBusyFlag() | TrackPanelHasFocus(), wxT("Alt+Right"))
   ) };
   return items;
}

References CaptureNotBusyFlag(), MenuTable::Command(), MenuTable::Items(), OnMoveToNextLabel(), OnMoveToPrevLabel(), TrackPanelHasFocus(), wxT(), and XXO().

Here is the call graph for this function:

ExtraTransportMenu()

BaseItemSharedPtr anonymous_namespace{TransportMenus.cpp}::ExtraTransportMenu

(

)

Definition at line 863 of file TransportMenus.cpp.

{
   static BaseItemSharedPtr menu{
   Menu( wxT("Transport"), XXO("T&ransport"),
      // PlayStop is already in the menus.
      /* i18n-hint: (verb) Start playing audio*/
      Command( wxT("Play"), XXO("Pl&ay Once"), OnPlayOnceOrStop,
         WaveTracksExistFlag() | AudioIONotBusyFlag() ),
      /* i18n-hint: (verb) Stop playing audio*/
      Command( wxT("Stop"), XXO("Sto&p"), OnStop,
         AudioIOBusyFlag() | CanStopAudioStreamFlag() ),
      Command( wxT("PlayOneSec"), XXO("Play &One Second"), OnPlayOneSecond,
         CaptureNotBusyFlag(), wxT("1") ),
      Command( wxT("PlayToSelection"), XXO("Play to &Selection"),
         OnPlayToSelection,
         CaptureNotBusyFlag(), wxT("B") ),
      Command( wxT("PlayBeforeSelectionStart"),
         XXO("Play &Before Selection Start"), OnPlayBeforeSelectionStart,
         CaptureNotBusyFlag(), wxT("Shift+F5") ),
      Command( wxT("PlayAfterSelectionStart"),
         XXO("Play Af&ter Selection Start"), OnPlayAfterSelectionStart,
         CaptureNotBusyFlag(), wxT("Shift+F6") ),
      Command( wxT("PlayBeforeSelectionEnd"),
         XXO("Play Be&fore Selection End"), OnPlayBeforeSelectionEnd,
         CaptureNotBusyFlag(), wxT("Shift+F7") ),
      Command( wxT("PlayAfterSelectionEnd"),
         XXO("Play Aft&er Selection End"), OnPlayAfterSelectionEnd,
         CaptureNotBusyFlag(), wxT("Shift+F8") ),
      Command( wxT("PlayBeforeAndAfterSelectionStart"),
         XXO("Play Before a&nd After Selection Start"),
         OnPlayBeforeAndAfterSelectionStart, CaptureNotBusyFlag(),
         wxT("Ctrl+Shift+F5") ),
      Command( wxT("PlayBeforeAndAfterSelectionEnd"),
         XXO("Play Before an&d After Selection End"),
         OnPlayBeforeAndAfterSelectionEnd, CaptureNotBusyFlag(),
         wxT("Ctrl+Shift+F7") ),
      Command( wxT("PlayCutPreview"), XXO("Play C&ut Preview"),
         OnPlayCutPreview,
         CaptureNotBusyFlag(), wxT("C") )
   ) };
   return menu;
}

References AudioIOBusyFlag(), AudioIONotBusyFlag(), CanStopAudioStreamFlag(), CaptureNotBusyFlag(), MenuTable::Command(), MenuTable::Menu(), OnPlayAfterSelectionEnd(), OnPlayAfterSelectionStart(), OnPlayBeforeAndAfterSelectionEnd(), OnPlayBeforeAndAfterSelectionStart(), OnPlayBeforeSelectionEnd(), OnPlayBeforeSelectionStart(), OnPlayCutPreview(), OnPlayOnceOrStop(), OnPlayOneSecond(), OnPlayToSelection(), OnStop(), WaveTracksExistFlag(), wxT(), and XXO().

Here is the call graph for this function:

IsLoopingEnabled()

bool anonymous_namespace{TransportMenus.cpp}::IsLoopingEnabled

(

const AudacityProject &

project

)

Definition at line 137 of file TransportMenus.cpp.

{
   auto &playRegion = ViewInfo::Get(project).playRegion;
    return playRegion.Active();
}

References PlayRegion::Active(), ViewInfo::Get(), and ViewInfo::playRegion.

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

MakeReadyToPlay()

bool anonymous_namespace{TransportMenus.cpp}::MakeReadyToPlay

(

AudacityProject &

project

)

MakeReadyToPlay stops whatever is currently playing and pops the play button up. Then, if nothing is now playing, it pushes the play button down and enables the stop button.

Definition at line 46 of file TransportMenus.cpp.

{
   auto &toolbar = ControlToolBar::Get( project );
   wxCommandEvent evt;
 
   // If this project is playing, stop playing
   auto gAudioIO = AudioIOBase::Get();
   if (gAudioIO->IsStreamActive(
      ProjectAudioIO::Get( project ).GetAudioIOToken()
   )) {
      // Make momentary changes of button appearances
      toolbar.SetPlay(false);        //Pops
      toolbar.SetStop();         //Pushes stop down
      toolbar.OnStop(evt);
 
      using namespace std::chrono;
      std::this_thread::sleep_for(100ms);
   }
 
   // If it didn't stop playing quickly, or if some other
   // project is playing, return
   if (gAudioIO->IsBusy())
      return false;
 
   return true;
}

References AudioIOBase::Get(), ProjectAudioIO::Get(), ControlToolBar::Get(), and ProjectAudioIO::GetAudioIOToken().

Referenced by OnPlayAfterSelectionEnd(), OnPlayAfterSelectionStart(), OnPlayBeforeAndAfterSelectionEnd(), OnPlayBeforeAndAfterSelectionStart(), OnPlayBeforeSelectionEnd(), OnPlayBeforeSelectionStart(), OnPlayCutPreview(), OnPlayDefaultOrStop(), OnPlayOneSecond(), and OnPlayToSelection().

Here is the call graph for this function:

Here is the caller graph for this function:

OnClearPlayRegion()

void anonymous_namespace{TransportMenus.cpp}::OnClearPlayRegion

(

const CommandContext &

context

)

Definition at line 366 of file TransportMenus.cpp.

{
   SelectUtilities::ClearPlayRegion(context.project);
}

References SelectUtilities::ClearPlayRegion(), and CommandContext::project.

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnMoveToNextLabel()

void anonymous_namespace{TransportMenus.cpp}::OnMoveToNextLabel

(

const CommandContext &

context

)

Definition at line 699 of file TransportMenus.cpp.

{
   auto &project = context.project;
   DoMoveToLabel(project, true);
}

References DoMoveToLabel(), and CommandContext::project.

Referenced by ExtraSelectionItems().

Here is the call graph for this function:

Here is the caller graph for this function:

OnMoveToPrevLabel()

void anonymous_namespace{TransportMenus.cpp}::OnMoveToPrevLabel

(

const CommandContext &

context

)

Definition at line 693 of file TransportMenus.cpp.

{
   auto &project = context.project;
   DoMoveToLabel(project, false);
}

References DoMoveToLabel(), and CommandContext::project.

Referenced by ExtraSelectionItems().

Here is the call graph for this function:

Here is the caller graph for this function:

OnPause()

void anonymous_namespace{TransportMenus.cpp}::OnPause

(

const CommandContext &

context

)

Definition at line 185 of file TransportMenus.cpp.

{
   ProjectAudioManager::Get( context.project ).OnPause();
}

References ProjectAudioManager::Get(), ProjectAudioManager::OnPause(), and CommandContext::project.

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnPlayAfterSelectionEnd()

void anonymous_namespace{TransportMenus.cpp}::OnPlayAfterSelectionEnd

(

const CommandContext &

context

)

Definition at line 601 of file TransportMenus.cpp.

{
   auto &project = context.project;
 
   if( !MakeReadyToPlay(project) )
      return;
 
   auto &viewInfo = ViewInfo::Get( project );
   const auto &selectedRegion = viewInfo.selectedRegion;
 
   double t1 = selectedRegion.t1();
   double afterLen;
   gPrefs->Read(wxT("/AudioIO/CutPreviewAfterLen"), &afterLen, 1.0);
 
   auto playOptions = ProjectAudioIO::GetDefaultOptions(project);
 
   TransportUtilities::PlayPlayRegionAndWait(
      context, SelectedRegion(t1, t1 + afterLen),
      playOptions, PlayMode::oneSecondPlay);
}

References ViewInfo::Get(), ProjectAudioIO::GetDefaultOptions(), gPrefs, MakeReadyToPlay(), oneSecondPlay, TransportUtilities::PlayPlayRegionAndWait(), CommandContext::project, and wxT().

Referenced by ExtraTransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnPlayAfterSelectionStart()

void anonymous_namespace{TransportMenus.cpp}::OnPlayAfterSelectionStart

(

const CommandContext &

context

)

Definition at line 547 of file TransportMenus.cpp.

{
   auto &project = context.project;
 
   if( !MakeReadyToPlay(project) )
      return;
 
   auto &viewInfo = ViewInfo::Get( project );
   const auto &selectedRegion = viewInfo.selectedRegion;
 
   double t0 = selectedRegion.t0();
   double t1 = selectedRegion.t1();
   double afterLen;
   gPrefs->Read(wxT("/AudioIO/CutPreviewAfterLen"), &afterLen, 1.0);
 
   auto playOptions = ProjectAudioIO::GetDefaultOptions(project);
 
   if ( t1 - t0 > 0.0 && t1 - t0 < afterLen )
      TransportUtilities::PlayPlayRegionAndWait(
         context, SelectedRegion(t0, t1),
         playOptions, PlayMode::oneSecondPlay);
   else
      TransportUtilities::PlayPlayRegionAndWait(
         context, SelectedRegion(t0, t0 + afterLen),
         playOptions, PlayMode::oneSecondPlay);
}

References ViewInfo::Get(), ProjectAudioIO::GetDefaultOptions(), gPrefs, MakeReadyToPlay(), oneSecondPlay, TransportUtilities::PlayPlayRegionAndWait(), CommandContext::project, and wxT().

Referenced by ExtraTransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnPlayBeforeAndAfterSelectionEnd()

void anonymous_namespace{TransportMenus.cpp}::OnPlayBeforeAndAfterSelectionEnd

(

const CommandContext &

context

)

Definition at line 652 of file TransportMenus.cpp.

{
   auto &project = context.project;
 
   if (!MakeReadyToPlay(project))
      return;
 
   auto &viewInfo = ViewInfo::Get( project );
   const auto &selectedRegion = viewInfo.selectedRegion;
 
   double t0 = selectedRegion.t0();
   double t1 = selectedRegion.t1();
   double beforeLen;
   gPrefs->Read(wxT("/AudioIO/CutPreviewBeforeLen"), &beforeLen, 2.0);
   double afterLen;
   gPrefs->Read(wxT("/AudioIO/CutPreviewAfterLen"), &afterLen, 1.0);
 
   auto playOptions = ProjectAudioIO::GetDefaultOptions(project);
 
   if ( t1 - t0 > 0.0 && t1 - t0 < beforeLen )
      TransportUtilities::PlayPlayRegionAndWait(
         context, SelectedRegion(t0, t1 + afterLen),
         playOptions, PlayMode::oneSecondPlay);
   else
      TransportUtilities::PlayPlayRegionAndWait(
         context, SelectedRegion(t1 - beforeLen, t1 + afterLen),
         playOptions, PlayMode::oneSecondPlay);
}

References ViewInfo::Get(), ProjectAudioIO::GetDefaultOptions(), gPrefs, MakeReadyToPlay(), oneSecondPlay, TransportUtilities::PlayPlayRegionAndWait(), CommandContext::project, and wxT().

Referenced by ExtraTransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnPlayBeforeAndAfterSelectionStart()

void anonymous_namespace{TransportMenus.cpp}::OnPlayBeforeAndAfterSelectionStart

(

const CommandContext &

context

)

Definition at line 622 of file TransportMenus.cpp.

{
   auto &project = context.project;
 
   if (!MakeReadyToPlay(project))
      return;
 
   auto &viewInfo = ViewInfo::Get( project );
   const auto &selectedRegion = viewInfo.selectedRegion;
 
   double t0 = selectedRegion.t0();
   double t1 = selectedRegion.t1();
   double beforeLen;
   gPrefs->Read(wxT("/AudioIO/CutPreviewBeforeLen"), &beforeLen, 2.0);
   double afterLen;
   gPrefs->Read(wxT("/AudioIO/CutPreviewAfterLen"), &afterLen, 1.0);
 
   auto playOptions = ProjectAudioIO::GetDefaultOptions(project);
 
   if ( t1 - t0 > 0.0 && t1 - t0 < afterLen )
      TransportUtilities::PlayPlayRegionAndWait(
         context, SelectedRegion(t0 - beforeLen, t1),
         playOptions, PlayMode::oneSecondPlay);
   else
      TransportUtilities::PlayPlayRegionAndWait(
         context, SelectedRegion(t0 - beforeLen, t0 + afterLen),
         playOptions, PlayMode::oneSecondPlay);
}

References ViewInfo::Get(), ProjectAudioIO::GetDefaultOptions(), gPrefs, MakeReadyToPlay(), oneSecondPlay, TransportUtilities::PlayPlayRegionAndWait(), CommandContext::project, and wxT().

Referenced by ExtraTransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnPlayBeforeSelectionEnd()

void anonymous_namespace{TransportMenus.cpp}::OnPlayBeforeSelectionEnd

(

const CommandContext &

context

)

Definition at line 574 of file TransportMenus.cpp.

{
   auto &project = context.project;
 
   if( !MakeReadyToPlay(project) )
      return;
 
   auto &viewInfo = ViewInfo::Get( project );
   const auto &selectedRegion = viewInfo.selectedRegion;
 
   double t0 = selectedRegion.t0();
   double t1 = selectedRegion.t1();
   double beforeLen;
   gPrefs->Read(wxT("/AudioIO/CutPreviewBeforeLen"), &beforeLen, 2.0);
 
   auto playOptions = ProjectAudioIO::GetDefaultOptions(project);
 
   if ( t1 - t0 > 0.0 && t1 - t0 < beforeLen )
      TransportUtilities::PlayPlayRegionAndWait(
         context, SelectedRegion(t0, t1),
         playOptions, PlayMode::oneSecondPlay);
   else
      TransportUtilities::PlayPlayRegionAndWait(
         context, SelectedRegion(t1 - beforeLen, t1),
         playOptions, PlayMode::oneSecondPlay);
}

References ViewInfo::Get(), ProjectAudioIO::GetDefaultOptions(), gPrefs, MakeReadyToPlay(), oneSecondPlay, TransportUtilities::PlayPlayRegionAndWait(), CommandContext::project, and wxT().

Referenced by ExtraTransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnPlayBeforeSelectionStart()

void anonymous_namespace{TransportMenus.cpp}::OnPlayBeforeSelectionStart

(

const CommandContext &

context

)

Definition at line 526 of file TransportMenus.cpp.

{
   auto &project = context.project;
 
   if( !MakeReadyToPlay(project) )
      return;
 
   auto &viewInfo = ViewInfo::Get( project );
   const auto &selectedRegion = viewInfo.selectedRegion;
 
   double t0 = selectedRegion.t0();
   double beforeLen;
   gPrefs->Read(wxT("/AudioIO/CutPreviewBeforeLen"), &beforeLen, 2.0);
 
   auto playOptions = ProjectAudioIO::GetDefaultOptions(project);
 
   TransportUtilities::PlayPlayRegionAndWait(
      context, SelectedRegion(t0 - beforeLen, t0),
      playOptions, PlayMode::oneSecondPlay);
}

References ViewInfo::Get(), ProjectAudioIO::GetDefaultOptions(), gPrefs, MakeReadyToPlay(), oneSecondPlay, TransportUtilities::PlayPlayRegionAndWait(), CommandContext::project, and wxT().

Referenced by ExtraTransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnPlayCutPreview()

void anonymous_namespace{TransportMenus.cpp}::OnPlayCutPreview

(

const CommandContext &

context

)

Definition at line 682 of file TransportMenus.cpp.

{
   auto &project = context.project;
 
   if ( !MakeReadyToPlay(project) )
      return;
 
   // Play with cut preview
   TransportUtilities::PlayCurrentRegionAndWait(context, false, true);
}

References MakeReadyToPlay(), TransportUtilities::PlayCurrentRegionAndWait(), and CommandContext::project.

Referenced by ExtraTransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnPlayDefaultOrStop()

void anonymous_namespace{TransportMenus.cpp}::OnPlayDefaultOrStop

(

const CommandContext &

context

)

Definition at line 171 of file TransportMenus.cpp.

{
   auto &project = context.project;
   if (TransportUtilities::DoStopPlaying(project))
      return;
 
   if( !MakeReadyToPlay(project) )
      return;
 
   // Now play in a loop
   // Will automatically set mLastPlayMode
   TransportUtilities::PlayCurrentRegionAndWait(context, true);
}

References TransportUtilities::DoStopPlaying(), MakeReadyToPlay(), TransportUtilities::PlayCurrentRegionAndWait(), and CommandContext::project.

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnPlayOnceOrStop()

void anonymous_namespace{TransportMenus.cpp}::OnPlayOnceOrStop

(

const CommandContext &

context

)

Definition at line 157 of file TransportMenus.cpp.

{
   if (TransportUtilities::DoStopPlaying(context.project))
      return;
   TransportUtilities::DoStartPlaying(context.project);
}

References TransportUtilities::DoStartPlaying(), TransportUtilities::DoStopPlaying(), and CommandContext::project.

Referenced by ExtraTransportMenu(), and TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnPlayOneSecond()

void anonymous_namespace{TransportMenus.cpp}::OnPlayOneSecond

(

const CommandContext &

context

)

Definition at line 457 of file TransportMenus.cpp.

{
   auto &project = context.project;
   if( !MakeReadyToPlay(project) )
      return;
 
   auto &trackPanel = TrackPanel::Get( project );
   auto options = ProjectAudioIO::GetDefaultOptions(project);
 
   double pos = trackPanel.GetMostRecentXPos();
   TransportUtilities::PlayPlayRegionAndWait(
      context, SelectedRegion(pos - 0.5, pos + 0.5),
      options, PlayMode::oneSecondPlay);
}

References TrackPanel::Get(), ProjectAudioIO::GetDefaultOptions(), MakeReadyToPlay(), oneSecondPlay, TransportUtilities::PlayPlayRegionAndWait(), and CommandContext::project.

Referenced by ExtraTransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnPlayStopSelect()

void anonymous_namespace{TransportMenus.cpp}::OnPlayStopSelect

(

const CommandContext &

context

)

Definition at line 164 of file TransportMenus.cpp.

{
   ProjectAudioManager::Get( context.project ).DoPlayStopSelect();
}

References ProjectAudioManager::DoPlayStopSelect(), ProjectAudioManager::Get(), and CommandContext::project.

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnPlayToSelection()

void anonymous_namespace{TransportMenus.cpp}::OnPlayToSelection

(

const CommandContext &

context

)

The idea for this function (and first implementation) was from Juhana Sadeharju. The function plays the sound between the current mouse position and the nearest selection boundary. This gives four possible play regions depending on where the current mouse position is relative to the left and right boundaries of the selection region.

Definition at line 479 of file TransportMenus.cpp.

{
   auto &project = context.project;
 
   if( !MakeReadyToPlay(project) )
      return;
 
   auto &trackPanel = TrackPanel::Get( project );
   auto &viewInfo = ViewInfo::Get( project );
   const auto &selectedRegion = viewInfo.selectedRegion;
 
   double pos = trackPanel.GetMostRecentXPos();
 
   double t0,t1;
   // check region between pointer and the nearest selection edge
   if (fabs(pos - selectedRegion.t0()) <
       fabs(pos - selectedRegion.t1())) {
      t0 = t1 = selectedRegion.t0();
   } else {
      t0 = t1 = selectedRegion.t1();
   }
   if( pos < t1)
      t0=pos;
   else
      t1=pos;
 
   // JKC: oneSecondPlay mode disables auto scrolling
   // On balance I think we should always do this in this function
   // since you are typically interested in the sound EXACTLY
   // where the cursor is.
   // TODO: have 'playing attributes' such as 'with_autoscroll'
   // rather than modes, since that's how we're now using the modes.
 
   // An alternative, commented out below, is to disable autoscroll
   // only when playing a short region, less than or equal to a second.
//   mLastPlayMode = ((t1-t0) > 1.0) ? normalPlay : oneSecondPlay;
 
   auto playOptions = ProjectAudioIO::GetDefaultOptions(project);
 
   TransportUtilities::PlayPlayRegionAndWait(
      context, SelectedRegion(t0, t1),
      playOptions, PlayMode::oneSecondPlay);
}

References ViewInfo::Get(), TrackPanel::Get(), ProjectAudioIO::GetDefaultOptions(), MakeReadyToPlay(), oneSecondPlay, TransportUtilities::PlayPlayRegionAndWait(), and CommandContext::project.

Referenced by ExtraTransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnRecord()

void anonymous_namespace{TransportMenus.cpp}::OnRecord

(

const CommandContext &

context

)

Definition at line 190 of file TransportMenus.cpp.

{
   TransportUtilities::RecordAndWait(context, false);
}

References TransportUtilities::RecordAndWait().

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnRecord2ndChoice()

void anonymous_namespace{TransportMenus.cpp}::OnRecord2ndChoice

(

const CommandContext &

context

)

Definition at line 197 of file TransportMenus.cpp.

{
   TransportUtilities::RecordAndWait(context, true);
}

References TransportUtilities::RecordAndWait().

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnRescanDevices()

void anonymous_namespace{TransportMenus.cpp}::OnRescanDevices

(

const CommandContext &

WXUNUSEDcontext

)

Definition at line 397 of file TransportMenus.cpp.

{
   DeviceManager::Instance()->Rescan();
}

References DeviceManager::Instance(), and DeviceManager::Rescan().

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnSetPlayRegionIn()

void anonymous_namespace{TransportMenus.cpp}::OnSetPlayRegionIn

(

const CommandContext &

context

)

Definition at line 371 of file TransportMenus.cpp.

{
   auto &project = context.project;
   auto &playRegion = ViewInfo::Get(project).playRegion;
   if (!playRegion.Active())
      SelectUtilities::ActivatePlayRegion(project);
   SelectUtilities::OnSetRegion(project,
      true, false, SetLoopInTitle.Stripped());
}

References SelectUtilities::ActivatePlayRegion(), ViewInfo::Get(), SelectUtilities::OnSetRegion(), ViewInfo::playRegion, CommandContext::project, and SetLoopInTitle.

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnSetPlayRegionOut()

void anonymous_namespace{TransportMenus.cpp}::OnSetPlayRegionOut

(

const CommandContext &

context

)

Definition at line 382 of file TransportMenus.cpp.

{
   auto &project = context.project;
   auto &playRegion = ViewInfo::Get(project).playRegion;
   if (!playRegion.Active())
      SelectUtilities::ActivatePlayRegion(project);
   SelectUtilities::OnSetRegion(project,
      false, false, SetLoopOutTitle.Stripped());
}

References SelectUtilities::ActivatePlayRegion(), ViewInfo::Get(), SelectUtilities::OnSetRegion(), ViewInfo::playRegion, CommandContext::project, and SetLoopOutTitle.

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnSetPlayRegionToSelection()

void anonymous_namespace{TransportMenus.cpp}::OnSetPlayRegionToSelection

(

const CommandContext &

context

)

Definition at line 392 of file TransportMenus.cpp.

{
   SelectUtilities::SetPlayRegionToSelection(context.project);
}

References CommandContext::project, and SelectUtilities::SetPlayRegionToSelection().

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnSoundActivated()

void anonymous_namespace{TransportMenus.cpp}::OnSoundActivated

(

const CommandContext &

context

)

Definition at line 402 of file TransportMenus.cpp.

{
   AudacityProject &project = context.project;
 
   SoundActivatedRecordDialog dialog( &GetProjectFrame( project ) /* parent */ );
   dialog.ShowModal();
}

References GetProjectFrame(), and CommandContext::project.

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnStop()

void anonymous_namespace{TransportMenus.cpp}::OnStop

(

const CommandContext &

context

)

Definition at line 452 of file TransportMenus.cpp.

{
   ProjectAudioManager::Get( context.project ).Stop();
}

References ProjectAudioManager::Get(), CommandContext::project, and ProjectAudioManager::Stop().

Referenced by ExtraTransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnTogglePlayRecording()

void anonymous_namespace{TransportMenus.cpp}::OnTogglePlayRecording

(

const CommandContext &

WXUNUSEDcontext

)

Definition at line 417 of file TransportMenus.cpp.

{
   bool Duplex;
#ifdef EXPERIMENTAL_DA
   gPrefs->Read(wxT("/AudioIO/Duplex"), &Duplex, false);
#else
   gPrefs->Read(wxT("/AudioIO/Duplex"), &Duplex, true);
#endif
   gPrefs->Write(wxT("/AudioIO/Duplex"), !Duplex);
   gPrefs->Flush();
   ToolManager::ModifyAllProjectToolbarMenus();
}

References FileConfig::Flush(), gPrefs, ToolManager::ModifyAllProjectToolbarMenus(), and wxT().

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnTogglePlayRegion()

void anonymous_namespace{TransportMenus.cpp}::OnTogglePlayRegion

(

const CommandContext &

context

)

Definition at line 361 of file TransportMenus.cpp.

{
   SelectUtilities::TogglePlayRegion(context.project);
}

References CommandContext::project, and SelectUtilities::TogglePlayRegion().

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnToggleSoundActivated()

void anonymous_namespace{TransportMenus.cpp}::OnToggleSoundActivated

(

const CommandContext &

WXUNUSEDcontext

)

Definition at line 410 of file TransportMenus.cpp.

{
   SoundActivatedRecord.Toggle();
   gPrefs->Flush();
   ToolManager::ModifyAllProjectToolbarMenus();
}

References FileConfig::Flush(), gPrefs, ToolManager::ModifyAllProjectToolbarMenus(), SoundActivatedRecord, and BoolSetting::Toggle().

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

OnToggleSWPlaythrough()

void anonymous_namespace{TransportMenus.cpp}::OnToggleSWPlaythrough

(

const CommandContext &

WXUNUSEDcontext

)

Definition at line 430 of file TransportMenus.cpp.

{
   bool SWPlaythrough;
   gPrefs->Read(wxT("/AudioIO/SWPlaythrough"), &SWPlaythrough, false);
   gPrefs->Write(wxT("/AudioIO/SWPlaythrough"), !SWPlaythrough);
   gPrefs->Flush();
   ToolManager::ModifyAllProjectToolbarMenus();
}

References FileConfig::Flush(), gPrefs, ToolManager::ModifyAllProjectToolbarMenus(), and wxT().

Referenced by TransportMenu().

Here is the call graph for this function:

Here is the caller graph for this function:

TransportMenu()

BaseItemSharedPtr anonymous_namespace{TransportMenus.cpp}::TransportMenu

(

)

Definition at line 727 of file TransportMenus.cpp.

{
   using Options = CommandManager::Options;
 
   static const auto CanStopFlags = AudioIONotBusyFlag() | CanStopAudioStreamFlag();
 
   static BaseItemSharedPtr menu{
   /* i18n-hint: 'Transport' is the name given to the set of controls that
      play, record, pause etc. */
   Menu( wxT("Transport"), XXO("Tra&nsport"),
      Section( "Basic",
         Menu( wxT("Play"), XXO("Pl&aying"),
            /* i18n-hint: (verb) Start or Stop audio playback*/
            Command( wxT("DefaultPlayStop"), XXO("Pl&ay/Stop"), OnPlayDefaultOrStop,
               CanStopAudioStreamFlag(), wxT("Space") ),
            Command( wxT("PlayStopSelect"), XXO("Play/Stop and &Set Cursor"),
               OnPlayStopSelect, CanStopAudioStreamFlag(), wxT("X") ),
            Command( wxT("OncePlayStop"), XXO("Play &Once/Stop"), OnPlayOnceOrStop,
               CanStopAudioStreamFlag(), wxT("Shift+Space") ),
            Command( wxT("Pause"), XXO("&Pause"), OnPause,
               CanStopAudioStreamFlag(), wxT("P") )
         ),
 
         Menu( wxT("Record"), XXO("&Recording"),
            /* i18n-hint: (verb)*/
            Command( wxT("Record1stChoice"), XXO("&Record"), OnRecord,
               CanStopFlags, wxT("R") ),
 
            // The OnRecord2ndChoice function is: if normal record records beside,
            // it records below, if normal record records below, it records beside.
            // TODO: Do 'the right thing' with other options like TimerRecord.
            // Delayed evaluation in case gPrefs is not yet defined
            [](const AudacityProject&)
            { return Command( wxT("Record2ndChoice"),
               // Our first choice is bound to R (by default)
               // and gets the prime position.
               // We supply the name for the 'other one' here.
               // It should be bound to Shift+R
               (gPrefs->ReadBool("/GUI/PreferNewTrackRecord", false)
                ? XXO("&Append Record") : XXO("Record &New Track")),
               OnRecord2ndChoice, CanStopFlags,
               wxT("Shift+R")
            ); },
 
   #ifdef EXPERIMENTAL_PUNCH_AND_ROLL
            Command( wxT("PunchAndRoll"), XXO("Punch and Rol&l Record"),
               OnPunchAndRoll,
               WaveTracksExistFlag() | AudioIONotBusyFlag(), wxT("Shift+D") ),
   #endif
 
            // JKC: I decided to duplicate this between play and record,
            // rather than put it at the top level.
            // CommandManger::AddItem can now cope with simple duplicated items.
            // PRL:  caution, this is a duplicated command name!
            Command( wxT("Pause"), XXO("&Pause"), OnPause,
               CanStopAudioStreamFlag(), wxT("P") )
         )
      ),
 
      Section( "Other",
         Section( "",
            Menu( wxT("PlayRegion"), XXO("&Looping"),
               Command( wxT("TogglePlayRegion"), LoopToggleText,
                  OnTogglePlayRegion, AlwaysEnabledFlag,
                     Options(L"L").CheckTest([](const AudacityProject& project){
                         return IsLoopingEnabled(project);
                     } )),
               Command( wxT("ClearPlayRegion"), XXO("&Clear Loop"),
                  OnClearPlayRegion, AlwaysEnabledFlag, L"Shift+Alt+L" ),
               Command( wxT("SetPlayRegionToSelection"),
                  XXO("&Set Loop to Selection"),
                  OnSetPlayRegionToSelection, AlwaysEnabledFlag,
                     L"Shift+L" ),
               Command( wxT("SetPlayRegionIn"),
                  SetLoopInTitle,
                  OnSetPlayRegionIn, AlwaysEnabledFlag ),
               Command( wxT("SetPlayRegionOut"),
                  SetLoopOutTitle,
                  OnSetPlayRegionOut, AlwaysEnabledFlag )
            )
         ),
 
         Command( wxT("RescanDevices"), XXO("R&escan Audio Devices"),
            OnRescanDevices, AudioIONotBusyFlag() | CanStopAudioStreamFlag() ),
 
         Menu( wxT("Options"), XXO("Transport &Options"),
            Section( "Part1",
               // Sound Activated recording options
               Command( wxT("SoundActivationLevel"),
                  XXO("Sound Activation Le&vel..."), OnSoundActivated,
                  AudioIONotBusyFlag() | CanStopAudioStreamFlag() ),
               Command( wxT("SoundActivation"),
                  XXO("Sound A&ctivated Recording (on/off)"),
                  OnToggleSoundActivated,
                  AudioIONotBusyFlag() | CanStopAudioStreamFlag(),
                  Options{}.CheckTest(SoundActivatedRecord) )
            ),
 
            Section( "Part2",
               Command( wxT("Overdub"), XXO("&Overdub (on/off)"),
                  OnTogglePlayRecording,
                  AudioIONotBusyFlag() | CanStopAudioStreamFlag(),
                  Options{}.CheckTest( wxT("/AudioIO/Duplex"),
#ifdef EXPERIMENTAL_DA
                     false
#else
                     true
#endif
                  ) ),
               Command( wxT("SWPlaythrough"), XXO("So&ftware Playthrough (on/off)"),
                  OnToggleSWPlaythrough,
                  AudioIONotBusyFlag() | CanStopAudioStreamFlag(),
                  Options{}.CheckTest( wxT("/AudioIO/SWPlaythrough"), false ) )
 
 
      #ifdef EXPERIMENTAL_AUTOMATED_INPUT_LEVEL_ADJUSTMENT
               ,
               Command( wxT("AutomatedInputLevelAdjustmentOnOff"),
                  XXO("A&utomated Recording Level Adjustment (on/off)"),
                  OnToggleAutomatedInputLevelAdjustment,
                  AudioIONotBusyFlag() | CanStopAudioStreamFlag(),
                  Options{}.CheckTest(
                     wxT("/AudioIO/AutomatedInputLevelAdjustment"), false ) )
      #endif
            )
         )
      )
   ) };
   return menu;
}

References AlwaysEnabledFlag, AudioIONotBusyFlag(), CanStopAudioStreamFlag(), anonymous_namespace{TimerRecordDialog.cpp}::CanStopFlags, CommandManager::Options::CheckTest(), MenuTable::Command(), gPrefs, IsLoopingEnabled(), LoopToggleText, MenuTable::Menu(), OnClearPlayRegion(), OnPause(), OnPlayDefaultOrStop(), OnPlayOnceOrStop(), OnPlayStopSelect(), OnRecord(), OnRecord2ndChoice(), OnRescanDevices(), OnSetPlayRegionIn(), OnSetPlayRegionOut(), OnSetPlayRegionToSelection(), OnSoundActivated(), OnTogglePlayRecording(), OnTogglePlayRegion(), OnToggleSoundActivated(), OnToggleSWPlaythrough(), MenuTable::Section(), SetLoopInTitle, SetLoopOutTitle, SoundActivatedRecord, WaveTracksExistFlag(), wxT(), and XXO().

Here is the call graph for this function:

Variable Documentation

sAttachment1

AttachedItem anonymous_namespace{TransportMenus.cpp}::sAttachment1

Initial value:

{
   wxT(""),
   Shared( TransportMenu() )
}

Definition at line 858 of file TransportMenus.cpp.

sAttachment2

AttachedItem anonymous_namespace{TransportMenus.cpp}::sAttachment2

Initial value:

{
   wxT("Optional/Extra/Part1"),
   Shared( ExtraTransportMenu() )
}

Definition at line 906 of file TransportMenus.cpp.

sAttachment4

AttachedItem anonymous_namespace{TransportMenus.cpp}::sAttachment4

Initial value:

{
  { wxT("Optional/Extra/Part1/Select"), { OrderingHint::End, {} } },
  Shared(ExtraSelectionItems())
}

Definition at line 926 of file TransportMenus.cpp.