Stop Action and Post Process

This function immediately terminates action processing and provides post processing capabilities. This statement is not valid while batch processing.

Any files closed by this statement are closed discarding changes. If you want to preserve modifications, Save the files first.

A number of operational modes are available:

Closing All Open Files

Specifying that the source list is in a named variable, leaving it empty; and selecting Close all visible files discarding changes first will not do any post processing other than closing all visible file first.

Loading Files

Specify a list of paths to files and/or folders in the source named or track variable. The paths must be separated by newline characters (\n) or the default list delimiter (\~). The paths may be to any folder or file that can be opened by Yate. Note that the Close all visible files discarding changes first option may be specified if desired. What gets opened depends on the current Open Mode. You can set an Open Mode using the Set Open Mode statement.

Full Capability

This mode provides the ability to close selected files, open selected files, to run a post processing action and to select a specific edit panel. The source referenced by the specified named or track variable must start with a # character. Note that the Close all visible files discarding changes first option may be specified if desired.

The source is read as a sequence of lines separated by newline characters (\n) or the default list delimiter (\~). Three special # commands are processed in the source text. The commands are case insensitive. All other lines which begin with a # and empty lines are ignored. All lines have leading and trailing spaces removed. The valid commands are:

#open

All subsequent lines up to the next valid # command are treated as paths to audio files or folders. These items are loaded as if the Open Mode was Playlist Mode, Add to the Filelist, Do Not Process Subfolders. Invalid paths and paths to items which are not audio files or folders are ignored.

#close

All subsequent lines up to the next valid # command must be the Loaded File UID property of a file to be closed. The file is closed, discarding any modifications. Hidden files cannot be closed. Only visible files.

#run

All subsequent lines up to the next valid # command are treated as the name of an action to be run. Note that only the first action name is retained. Any subsequent action name is ignored. Remember that depending on the action being run, you might need at least one open file in order for it to be executed. If the action does not have Always specified in the Action Manager and no files are open, it will not be started. Note: If there are files specified to be opened, and none are because they are already loaded, the action will not be run.

#Edit Panel

All subsequent lines up to the next valid # command are treated as the case insensitive name of an edit panel. Note that only the first edit panel name is retained. If the specified edit panel name is valid it will become the current edit panel.

Note that any of the above commands can be specified more than once but there is no advantage to it. Any non # lines before one of the above commands is encountered are assumed to be following an #open command. ie. #open is the default mode.

The post processing proceeds as follows:

• If Close all visible files discarding changes first is enabled, it is done before any other processing.
• All files specified following a #close command are closed discarding any changes.
• All files specified following an #open command are opened.
• If a action to be run has been specified and there was at least one file specified to be opened (#open), the action will be run.

example: Assume all selected files (not all loaded) are to be closed and only one file is to be loaded:

Get Property Loaded File UID -> Variable 0
Build List with delimiter "⏎" in named variable 'Files to be Closed' from field Variable 0 (As found) string delimiter "\~"
Set named variable 'list' to "#↵…"
Stop Action and Post Process with the contents of named variable 'list'

Named variable list would be set to:

#
#close
\<files to be closed>
#open
/volumes/music/test.mp3
#run
Post Process
#edit panel
Artwork

The files in Files to be Closed will be closed; test.mp3 will be opened; the action named Post Process will be run; the Artwork panel will be displayed.

Stop Action and Close Selected Files

Set Open Mode