/********************************************************************** Audacity: A Digital Audio Editor BatchCommands.cpp Dominic Mazzoni James Crook ********************************************************************//*! \class BatchCommands \brief Maintains the chain of commands used in batch processing. See also BatchCommandDialog and BatchProcessDialog. *//*******************************************************************/ #include "Audacity.h" #include #include #include #include #include #include "Project.h" #include "BatchCommands.h" #include "commands/CommandManager.h" #include "effects/EffectManager.h" #include "FileNames.h" #include "Internat.h" #include "Prefs.h" #include "Shuttle.h" #include "export/ExportFLAC.h" #include "export/ExportMP3.h" #include "export/ExportOGG.h" #include "export/ExportPCM.h" #include "Theme.h" #include "AllThemeResources.h" // KLUDGE: All commands should be on the same footing // however, for historical reasons we distinguish between // - Effects (which are looked up in effects lists) // - Menu commands (which are held in command manager) // - Specials (which we deal with specially here) enum eCommandType { CtEffect, CtMenu, CtSpecial }; // TIDY-ME: Not currently translated, // but there are issues to address if we do. wxString SpecialCommands[] = { wxT("NoAction"), wxT("Import"), wxT("SaveHqMaster1"), wxT("SaveHqMaster2"), wxT("StereoToMono"), wxT("ExportFlac"), wxT("ExportMp3"), wxT("ExportOgg"), wxT("ExportWav") }; static const wxString CleanSpeech = wxT("CleanSpeech"); static const wxString MP3Conversion = wxT("MP3 Conversion"); BatchCommands::BatchCommands() { ResetChain(); wxArrayString names = GetNames(); if (names.Index(CleanSpeech) == wxNOT_FOUND) { AddChain(CleanSpeech); RestoreChain(CleanSpeech); WriteChain(CleanSpeech); } if (names.Index(MP3Conversion) == wxNOT_FOUND) { AddChain(MP3Conversion); RestoreChain(MP3Conversion); WriteChain(MP3Conversion); } } wxString BatchCommands::GetCommand(int index) { if (index < 0 || index >= (int)mCommandChain.GetCount()) { return wxT(""); } return mCommandChain[index]; } wxString BatchCommands::GetParams(int index) { if (index < 0 || index >= (int)mParamsChain.GetCount()) { return wxT(""); } return mParamsChain[index]; } int BatchCommands::GetCount() { return (int)mCommandChain.GetCount(); } bool BatchCommands::ReadChain(const wxString & chain) { // Clear any previous chain ResetChain(); // Build the filename wxFileName name(FileNames::ChainDir(), chain, wxT("txt")); // Set the file name wxTextFile tf(name.GetFullPath()); // Open and check tf.Open(); if (!tf.IsOpened()) { // wxTextFile will display any errors return false; } // Load commands from the file int lines = tf.GetLineCount(); if (lines > 0) { for (int i = 0; i < lines; i++) { // Find the command name terminator...ingore line if not found int splitAt = tf[i].Find(wxT(':')); if (splitAt < 0) { continue; } // Parse and clean wxString cmd = tf[i].Left(splitAt).Strip(wxString::both); wxString parm = tf[i].Mid(splitAt + 1).Strip(wxString::trailing); // Add to lists mCommandChain.Add(cmd); mParamsChain.Add(parm); } } // Done with the file tf.Close(); return true; } bool BatchCommands::WriteChain(const wxString & chain) { // Build the filename wxFileName name(FileNames::ChainDir(), chain, wxT("txt")); // Set the file name wxTextFile tf(name.GetFullPath()); // Create the file (Create() doesn't leave the file open) if (!tf.Exists()) { tf.Create(); } // Open it tf.Open(); if (!tf.IsOpened()) { // wxTextFile will display any errors return false; } // Start with a clean slate tf.Clear(); // Copy over the commands int lines = mCommandChain.GetCount(); for (int i = 0; i < lines; i++) { tf.AddLine(mCommandChain[i] + wxT(":") + mParamsChain[ i ]); } // Write the chain tf.Write(); // Done with the file tf.Close(); return true; } bool BatchCommands::AddChain(const wxString & chain) { // Build the filename wxFileName name(FileNames::ChainDir(), chain, wxT("txt")); // Set the file name wxTextFile tf(name.GetFullPath()); // Create it..Create will display errors return tf.Create(); } bool BatchCommands::DeleteChain(const wxString & chain) { // Build the filename wxFileName name(FileNames::ChainDir(), chain, wxT("txt")); // Delete it...wxRemoveFile will display errors return wxRemoveFile(name.GetFullPath()); } bool BatchCommands::RenameChain(const wxString & oldchain, const wxString & newchain) { // Build the filenames wxFileName oname(FileNames::ChainDir(), oldchain, wxT("txt")); wxFileName nname(FileNames::ChainDir(), newchain, wxT("txt")); // Rename it...wxRenameFile will display errors return wxRenameFile(oname.GetFullPath(), nname.GetFullPath()); } void BatchCommands::SetCleanSpeechChain() { ResetChain(); // TIDY-ME: Effects change their name with localisation. // Commands (at least currently) don't. Messy. /* i18n-hint: Effect name translations must agree with those used elsewhere, or batch won't find them */ AddToChain( wxT("StereoToMono") ); AddToChain( wxT("Normalize") ); AddToChain( wxT("SaveHqMaster1") ); AddToChain( wxT("NoiseRemoval") ); AddToChain( wxT("TruncateSilence") ); AddToChain( wxT("Leveller") ); AddToChain( wxT("Normalize") ); AddToChain( wxT("ExportMp3") ); } void BatchCommands::SetWavToMp3Chain() { ResetChain(); AddToChain( wxT("Normalize") ); AddToChain( wxT("ExportMp3") ); } // Gets all commands that are valid for this mode. wxArrayString BatchCommands::GetAllCommands() { wxArrayString commands; wxString command; commands.Clear(); AudacityProject *project = GetActiveProject(); if (!project) return commands; EffectArray * effects; unsigned int i; for(i=0;iGetCleanSpeechMode() ) additionalEffects = 0; effects = EffectManager::Get().GetEffects(PROCESS_EFFECT | BUILTIN_EFFECT | additionalEffects); for(i=0; iGetCount(); i++) { command=(*effects)[i]->GetEffectIdentifier(); if (!command.IsEmpty()) { commands.Add( command); } } delete effects; /* This is for later in development: include the menu commands. CommandManager * mManager = project->GetCommandManager(); wxArrayString mNames; mNames.Clear(); mManager->GetAllCommandNames(mNames, false); for(i=0; iTransferParameters( shuttle ); if( shuttle.mParams.IsEmpty() ) return wxT("");// effect had no parameters. return shuttle.mParams; } bool BatchCommands::PromptForParamsFor(wxString command, wxWindow *parent) { Effect * f = EffectManager::Get().GetEffectByIdentifier(command); if( f==NULL ) return false; //mFactory = factory; //mProjectRate = projectRate; f->mParent = parent; //mTracks = list; return f->PromptUser(); } double BatchCommands::GetEndTime() { AudacityProject *project = GetActiveProject(); if( project == NULL ) { //wxMessageBox( wxT("No project to process!") ); return -1.0; } TrackList * tracks = project->GetTracks(); if( tracks == NULL ) { //wxMessageBox( wxT("No tracks to process!") ); return -1.0; } double endTime = tracks->GetEndTime(); return endTime; } bool BatchCommands::IsMono() { AudacityProject *project = GetActiveProject(); if( project == NULL ) { //wxMessageBox( wxT("No project and no Audio to process!") ); return false; } TrackList * tracks = project->GetTracks(); if( tracks == NULL ) { //wxMessageBox( wxT("No tracks to process!") ); return false; } TrackListIterator iter(tracks); Track *t = iter.First(); bool mono = true; while (t) { if (t->GetLinked()) { mono = false; break; } t = iter.Next(); } return mono; } bool BatchCommands::WriteMp3File( const wxString Name, int bitrate ) { //check if current project is mono or stereo int numChannels = 2; if (IsMono()) { numChannels = 1; } double endTime = GetEndTime(); if( endTime <= 0.0f ) return false; AudacityProject *project = GetActiveProject(); if( bitrate <=0 ) { // 'No' bitrate given, use the current default. // Use Mp3Stereo to control if export is to a stereo or mono file return mExporter.Process(project, numChannels, wxT("MP3"), Name, false, 0.0, endTime); } bool rc; long prevBitRate = gPrefs->Read(wxT("/FileFormats/MP3Bitrate"), 128); gPrefs->Write(wxT("/FileFormats/MP3Bitrate"), bitrate); // Use Mp3Stereo to control if export is to a stereo or mono file rc = mExporter.Process(project, numChannels, wxT("MP3"), Name, false, 0.0, endTime); gPrefs->Write(wxT("/FileFormats/MP3Bitrate"), prevBitRate); return rc; } // TIDY-ME: Get rid of special commands and make them part of the // 'menu' system (but not showing on the menu) // // ======= IMPORTANT ======== // Special Commands are a KLUDGE whilst we wait for a better system to handle the menu // commands from batch mode. // // Really we should be using a similar (or same) system to that used for effects // so that parameters can be passed to the commands. Many of the menu // commands take a selection as their parameter. // // If you find yourself adding lots of existing commands from the menus here, STOP // and think again. // ======= IMPORTANT ======== bool BatchCommands::ApplySpecialCommand(int iCommand, const wxString command,const wxString params) { if (ReportAndSkip(command, params)) return true; AudacityProject *project = GetActiveProject(); int numChannels = 1; //used to switch between mono and stereo export if (IsMono()) { numChannels = 1; //export in mono } else { numChannels = 2; //export in stereo } wxString filename; if (mFileName.IsEmpty()) { filename = project->BuildCleanFileName(project->GetFileName()); } else { filename = project->BuildCleanFileName(mFileName); } // We have a command index, but we don't use it! // TODO: Make this special-batch-command code use the menu item code.... // FIX-ME: No error reporting on write file failure in batch mode. if (command == wxT("NoAction")) { return true; } else if (!mFileName.IsEmpty() && command == wxT("Import")) { // historically this was in use, now ignored if there return true; } else if (command == wxT("SaveHqMaster1")) { filename.Replace(wxT("cleaned/"), wxT("cleaned/MasterBefore_"), false); return WriteMp3File(filename, 56); } else if (command == wxT("SaveHqMaster2")) { filename.Replace(wxT("cleaned/"), wxT("cleaned/MasterAfter_"), false); return WriteMp3File(filename, 56); } else if (command == wxT("StereoToMono")) { // StereoToMono is an effect masquerading as a menu item. Effect * f = EffectManager::Get().GetEffectByIdentifier(wxT("StereoToMono")); if (f != NULL) { return ApplyEffectCommand(f, command, params); } wxMessageBox(_("Stereo to Mono Effect not found")); return false; } else if (command == wxT("ExportMp3")) { return WriteMp3File(filename, 0); // 0 bitrate means use default/current } else if (command == wxT("ExportWav")) { filename.Replace(wxT(".mp3"), wxT(".wav"), false); double endTime = GetEndTime(); if (endTime <= 0.0f) { return false; } return mExporter.Process(project, numChannels, wxT("WAV"), filename, false, 0.0, endTime); } else if (command == wxT("ExportOgg")) { #ifdef USE_LIBVORBIS filename.Replace(wxT(".mp3"), wxT(".ogg"), false); double endTime = GetEndTime(); if (endTime <= 0.0f) { return false; } return mExporter.Process(project, numChannels, wxT("OGG"), filename, false, 0.0, endTime); #else wxMessageBox(_("Ogg Vorbis support is not included in this build of Audacity")); return false; #endif } else if (command == wxT("ExportFlac")) { #ifdef USE_LIBFLAC filename.Replace(wxT(".mp3"), wxT(".flac"), false); double endTime = GetEndTime(); if (endTime <= 0.0f) { return false; } return mExporter.Process(project, numChannels, wxT("FLAC"), filename, false, 0.0, endTime); #else wxMessageBox(_("FLAC support is not included in this build of Audacity")); return false; #endif } wxMessageBox(wxString::Format(_("Command %s not implemented yet"),command.c_str())); return false; } bool BatchCommands::SetCurrentParametersFor( Effect * f, const wxString command, const wxString params) { // transfer the parameters to the effect... if( !params.IsEmpty() ) { ShuttleCli shuttle; shuttle.mParams = params; shuttle.mbStoreInClient=true; if( !f->TransferParameters( shuttle )) { wxMessageBox( wxString::Format( _("Could not set parameters of effect %s\n to %s."), command.c_str(),params.c_str() )); return false; } } return true; } bool BatchCommands::ApplyEffectCommand( Effect * f, const wxString command, const wxString params) { //Possibly end processing here, if in batch-debug if( ReportAndSkip(command, params)) return true; AudacityProject *project = GetActiveProject(); //FIX-ME: for later versions may want to not select-all in batch mode. //IF nothing selected, THEN select everything // (most effects require that you have something selected). project->SelectAllIfNone(); // NOW actually apply the effect. return project->OnEffect(ALL_EFFECTS | CONFIGURED_EFFECT , f, params, false); } bool BatchCommands::ApplyMenuCommand(const wxString command, const wxString params) { if( ReportAndSkip(command, params)) return true; return true; } bool BatchCommands::ApplyCommand(const wxString command, const wxString params) { unsigned int i; // Test for a special command. for(i=0;iGetShowId3Dialog(); rc = ApplyCommand( command, params ); // exit batch mode... project->SetShowId3Dialog(prevShowMode); return rc; } // ApplyChain returns true on success, false otherwise. // Any error reporting to the user has already been done. bool BatchCommands::ApplyChain(const wxString & filename) { mFileName = filename; unsigned int i; bool res = true; mAbort = false; for (i = 0; i < mCommandChain.GetCount(); i++) { if (!ApplyCommandInBatchMode(mCommandChain[i], mParamsChain[i]) || mAbort) { res = false; break; } } mFileName.Empty(); AudacityProject *proj = GetActiveProject(); if (!res) { if(proj) { // Chain failed or was cancelled; revert to the previous state UndoManager *um = proj->GetUndoManager(); proj->SetStateTo(um->GetCurrentState()); } return false; } // Chain was successfully applied; save the new project state wxString longDesc, shortDesc; wxString name = gPrefs->Read(wxT("/Batch/ActiveChain"), wxEmptyString); if (name.IsEmpty()) { longDesc = wxT("Applied batch chain"); shortDesc = wxT("Apply chain"); } else { longDesc = wxString::Format(wxT("Applied batch chain '%s'"), name.c_str()); shortDesc = wxString::Format(wxT("Apply '%s'"), name.c_str()); } if (!proj) return false; proj->PushState(longDesc, shortDesc); return true; } // AbortBatch() allows a premature terminatation of a batch. void BatchCommands::AbortBatch() { mAbort = true; } void BatchCommands::AddToChain(const wxString &command, int before) { AddToChain(command, GetCurrentParamsFor(command), before); } void BatchCommands::AddToChain(const wxString &command, const wxString ¶ms, int before) { if (before == -1) { before = (int)mCommandChain.GetCount(); } mCommandChain.Insert(command, before); mParamsChain.Insert(params, before); } void BatchCommands::DeleteFromChain(int index) { if (index < 0 || index >= (int)mCommandChain.GetCount()) { return; } mCommandChain.RemoveAt(index); mParamsChain.RemoveAt(index); } void BatchCommands::ResetChain() { mCommandChain.Clear(); mParamsChain.Clear(); } // ReportAndSkip() is a diagnostic function that avoids actually // applying the requested effect if in batch-debug mode. bool BatchCommands::ReportAndSkip(const wxString command, const wxString params) { int bDebug; gPrefs->Read(wxT("/Batch/Debug"), &bDebug, false); if( bDebug == 0 ) return false; //TODO: Add a cancel button to these, and add the logic so that we can abort. if( params != wxT("") ) { wxMessageBox( wxString::Format(_("Apply %s with parameter(s)\n\n%s"),command.c_str(), params.c_str()), _("Test Mode")); } else { wxMessageBox( wxString::Format(_("Apply %s"),command.c_str()), _("Test Mode")); } return true; } wxArrayString BatchCommands::GetNames() { wxArrayString names; wxArrayString files; wxDir::GetAllFiles(FileNames::ChainDir(), &files, wxT("*.txt"), wxDIR_FILES); size_t i; for (i = 0; i < files.GetCount(); i++) { wxFileName f(files[i]); names.Add(f.GetName()); } return names; } bool BatchCommands::IsFixed(const wxString & name) { if (name == CleanSpeech || name == MP3Conversion) { return true; } return false; } void BatchCommands::RestoreChain(const wxString & name) { // TIDY-ME: Effects change their name with localisation. // Commands (at least currently) don't. Messy. /* i18n-hint: Effect name translations must agree with those used elsewhere, or batch won't find them */ if (name == CleanSpeech) { SetCleanSpeechChain(); } else if (name == MP3Conversion) { SetWavToMp3Chain(); } } void BatchCommands::Split(const wxString & str, wxString & command, wxString & param) { int splitAt; command.Empty(); param.Empty(); if (str.IsEmpty()) { return; } splitAt = str.Find(wxT(':')); if (splitAt < 0) { return; } command = str.Mid(0, splitAt); param = str.Mid(splitAt + 1); return; } wxString BatchCommands::Join(const wxString & command, const wxString & param) { return command + wxT(": ") + param; } // Indentation settings for Vim and Emacs and unique identifier for Arch, a // version control system. Please do not modify past this point. // // Local Variables: // c-basic-offset: 3 // indent-tabs-mode: nil // End: // // vim: et sts=3 sw=3 // arch-tag: TBD