2010-01-23 19:44:49 +00:00
|
|
|
/**********************************************************************
|
|
|
|
|
|
|
|
Audacity: A Digital Audio Editor
|
|
|
|
|
2018-03-03 19:08:23 +00:00
|
|
|
MacroCommands.h
|
2010-01-23 19:44:49 +00:00
|
|
|
|
|
|
|
Dominic Mazzoni
|
|
|
|
James Crook
|
|
|
|
|
|
|
|
**********************************************************************/
|
|
|
|
|
|
|
|
#ifndef __AUDACITY_BATCH_COMMANDS_DIALOG__
|
|
|
|
#define __AUDACITY_BATCH_COMMANDS_DIALOG__
|
|
|
|
|
|
|
|
#include <wx/defs.h>
|
|
|
|
#include <wx/string.h>
|
|
|
|
|
|
|
|
#include "export/Export.h"
|
|
|
|
|
|
|
|
class Effect;
|
Automation: AudacityCommand
This is a squash of 50 commits.
This merges the capabilities of BatchCommands and Effects using a new
AudacityCommand class. AudacityCommand provides one function to specify the
parameters, and then we leverage that one function in automation, whether by chains,
mod-script-pipe or (future) Nyquist.
- Now have AudacityCommand which is using the same mechanism as Effect
- Has configurable parameters
- Has data-entry GUI (built using shuttle GUI)
- Registers with PluginManager.
- Menu commands now provided in chains, and to python batch.
- Tested with Zoom Toggle.
- ShuttleParams now can set, get, set defaults, validate and specify
the parameters.
- Bugfix: Don't overwrite values with defaults first time out.
- Add DefineParams function for all built-in effects.
- Extend CommandContext to carry output channels for results.
We abuse EffectsManager. It handles both Effects and
AudacityCommands now. In time an Effect should become a special case of
AudacityCommand and we'll split and rename the EffectManager class.
- Don't use 'default' as a parameter name.
- Massive renaming for CommandDefinitionInterface
- EffectIdentInterface becomes EffectDefinitionInterface
- EffectAutomationParameters becomes CommandAutomationParameters
- PluginType is now a bit field.
This way we can search for related types at the same time.
- Most old batch commands made into AudacityCommands.
The ones that weren't are for a reason. They are used by mod-script-pipe
to carry commands and responses across from a non-GUI thread to the GUI
thread.
- Major tidy up of ScreenshotCommand
- Reworking of SelectCommand
- GetPreferenceCommand and SetPreferenceCommand
- GetTrackInfo and SetTrackInfo
- GetInfoCommand
- Help, Open, Save, Import and Export commands.
- Removed obsolete commands ExecMenu, GetProjectInfo and SetProjectInfo
which are now better handled by other commands.
- JSONify "GetInfo: Commands" output, i.e. commas in the right places.
- General work on better Doxygen.
- Lyrics -> LyricsPanel
- Meter -> MeterPanel
- Updated Linux makefile.
- Scripting commands added into Extra menu.
- Distinct names for previously duplicated find-clipping parameters.
- Fixed longstanding error with erroneous status field number which
previously caused an ASSERT in debug.
- Sensible formatting of numbers in Chains, 0.1 not 0.1000000000137
2018-01-14 18:51:41 +00:00
|
|
|
class CommandContext;
|
2018-03-06 20:28:05 +00:00
|
|
|
class AudacityProject;
|
2019-02-12 21:30:22 +00:00
|
|
|
class wxArrayStringEx;
|
2010-01-23 19:44:49 +00:00
|
|
|
|
2018-03-06 20:28:05 +00:00
|
|
|
class MacroCommandsCatalog {
|
|
|
|
public:
|
|
|
|
// A triple of user-visible name, internal string identifier and type/help string.
|
|
|
|
struct Entry {
|
2018-03-15 23:06:30 +00:00
|
|
|
TranslatedInternalString name;
|
2018-03-06 20:28:05 +00:00
|
|
|
wxString category;
|
|
|
|
};
|
|
|
|
using Entries = std::vector<Entry>;
|
|
|
|
|
|
|
|
MacroCommandsCatalog( const AudacityProject *project );
|
|
|
|
|
|
|
|
// binary search
|
|
|
|
Entries::const_iterator ByFriendlyName( const wxString &friendlyName ) const;
|
|
|
|
// linear search
|
|
|
|
Entries::const_iterator ByCommandId( const wxString &commandId ) const;
|
|
|
|
|
|
|
|
// Lookup by position as sorted by friendly name
|
|
|
|
const Entry &operator[] ( size_t index ) const { return mCommands[index]; }
|
|
|
|
|
|
|
|
Entries::const_iterator begin() const { return mCommands.begin(); }
|
|
|
|
Entries::const_iterator end() const { return mCommands.end(); }
|
|
|
|
|
|
|
|
private:
|
|
|
|
// Sorted by friendly name
|
|
|
|
Entries mCommands;
|
|
|
|
};
|
|
|
|
|
2018-03-16 18:47:39 +00:00
|
|
|
// Stores information for one macro
|
2018-03-03 19:08:23 +00:00
|
|
|
class MacroCommands final {
|
2010-01-23 19:44:49 +00:00
|
|
|
public:
|
|
|
|
// constructors and destructors
|
2018-03-03 19:08:23 +00:00
|
|
|
MacroCommands();
|
2010-01-23 19:44:49 +00:00
|
|
|
public:
|
2018-03-08 04:42:57 +00:00
|
|
|
bool ApplyMacro( const MacroCommandsCatalog &catalog,
|
|
|
|
const wxString & filename = wxT(""));
|
|
|
|
bool ApplyCommand( const wxString &friendlyCommand,
|
|
|
|
const wxString & command, const wxString & params,
|
|
|
|
CommandContext const * pContext=NULL );
|
|
|
|
bool ApplyCommandInBatchMode( const wxString &friendlyCommand,
|
2018-08-04 18:16:32 +00:00
|
|
|
const wxString & command, const wxString ¶ms,
|
|
|
|
CommandContext const * pContext = NULL);
|
2018-03-08 04:42:57 +00:00
|
|
|
bool ApplySpecialCommand(
|
|
|
|
int iCommand, const wxString &friendlyCommand,
|
|
|
|
const wxString & command, const wxString & params);
|
|
|
|
bool ApplyEffectCommand(
|
|
|
|
const PluginID & ID, const wxString &friendlyCommand,
|
|
|
|
const wxString & command,
|
|
|
|
const wxString & params, const CommandContext & Context);
|
|
|
|
bool ReportAndSkip( const wxString & friendlyCommand, const wxString & params );
|
2010-01-23 19:44:49 +00:00
|
|
|
void AbortBatch();
|
|
|
|
|
|
|
|
// Utility functions for the special commands.
|
2018-08-04 18:16:32 +00:00
|
|
|
static wxString BuildCleanFileName(const wxString &fileName, const wxString &extension);
|
2015-04-23 14:07:25 +00:00
|
|
|
bool WriteMp3File( const wxString & Name, int bitrate );
|
2010-01-23 19:44:49 +00:00
|
|
|
double GetEndTime();
|
2018-08-04 18:16:32 +00:00
|
|
|
static bool IsMono();
|
2010-01-23 19:44:49 +00:00
|
|
|
|
|
|
|
// These commands do not depend on the command list.
|
2018-03-15 00:07:36 +00:00
|
|
|
static void MigrateLegacyChains();
|
2015-04-27 14:22:47 +00:00
|
|
|
static wxArrayString GetNames();
|
2019-02-12 21:30:22 +00:00
|
|
|
static wxArrayStringEx GetNamesOfDefaultMacros();
|
2018-01-10 02:49:49 +00:00
|
|
|
|
2015-04-27 14:22:47 +00:00
|
|
|
static wxString GetCurrentParamsFor(const wxString & command);
|
|
|
|
static wxString PromptForParamsFor(const wxString & command, const wxString & params, wxWindow *parent);
|
|
|
|
static wxString PromptForPresetFor(const wxString & command, const wxString & params, wxWindow *parent);
|
|
|
|
|
2014-06-03 20:30:19 +00:00
|
|
|
// These commands do depend on the command list.
|
2018-03-03 19:08:23 +00:00
|
|
|
void ResetMacro();
|
2010-01-23 19:44:49 +00:00
|
|
|
|
2018-03-03 20:26:31 +00:00
|
|
|
void RestoreMacro(const wxString & name);
|
2018-03-03 19:08:23 +00:00
|
|
|
bool ReadMacro(const wxString & macro);
|
|
|
|
bool WriteMacro(const wxString & macro);
|
|
|
|
bool AddMacro(const wxString & macro);
|
|
|
|
bool DeleteMacro(const wxString & name);
|
|
|
|
bool RenameMacro(const wxString & oldmacro, const wxString & newmacro);
|
2010-01-23 19:44:49 +00:00
|
|
|
|
2018-03-03 19:08:23 +00:00
|
|
|
void AddToMacro(const wxString & command, int before = -1);
|
|
|
|
void AddToMacro(const wxString & command, const wxString & params, int before = -1);
|
|
|
|
void DeleteFromMacro(int index);
|
2010-01-23 19:44:49 +00:00
|
|
|
wxString GetCommand(int index);
|
|
|
|
wxString GetParams(int index);
|
|
|
|
int GetCount();
|
2017-12-20 21:19:23 +00:00
|
|
|
wxString GetMessage(){ return mMessage;};
|
|
|
|
void AddToMessage(const wxString & msgIn ){ mMessage += msgIn;};
|
2010-01-23 19:44:49 +00:00
|
|
|
|
|
|
|
bool IsFixed(const wxString & name);
|
|
|
|
|
|
|
|
void Split(const wxString & str, wxString & command, wxString & param);
|
|
|
|
wxString Join(const wxString & command, const wxString & param);
|
|
|
|
|
2018-03-03 19:08:23 +00:00
|
|
|
wxArrayString mCommandMacro;
|
|
|
|
wxArrayString mParamsMacro;
|
2010-01-23 19:44:49 +00:00
|
|
|
bool mAbort;
|
2017-12-20 21:19:23 +00:00
|
|
|
wxString mMessage;
|
2010-01-23 19:44:49 +00:00
|
|
|
|
|
|
|
Exporter mExporter;
|
|
|
|
wxString mFileName;
|
|
|
|
};
|
|
|
|
|
|
|
|
#endif
|