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 do not 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. What gets opened depends on the current Open Mode. Note that the Close all visible files discarding changes first option may be specified if desired.

Full Capability

This mode provides the ability to close selected files, open selected files and to run a post processing action. 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. In order for the action to be run, at least one file must have been specified to be opened (#open).

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 there is only one file selected when the action is run):

#open
/volumes/music/test.mp3
#close
\!Loaded File UID!
#run
Post Process

The file associated with the specified Loaded File UID property will be closed and test.mp3 will be opened. The action named Post Process will be run.

Stop Action and Close Selected Files