This statement is used to make changes to various preference settings or items. Unless otherwise mentioned, changes are automatically reverted as follows: When batch processing, the changes are reverted when the batch process stops. When not batch processing, the changes are reverted when the action started from the UI stops.
Set Changes
Various functionality uses default preference sets. You can override the default values via specifying alternate sets. When the alternate set name is empty, the pre-action value will be reset. The set name can be chosen from a drop down menu or can be manually entered. The set name can contain any of the escape sequences described in Escape Sequences. At runtime, the set name must exist, be the empty string or be none (case insensitive). None is equivalent to removing the associated set. eg. setting the Natural Sort Exception Set to none, means there is no Natural Sort Exception Set.
The following sets can be overridden:
Individual Setting Changes
You can override various individual settings by specifying a temporary value. When the temporary value is empty, the application preferences value will be restored. The temporary value can contain any of the escape sequences described in Escape Sequences. The current settings which can be overridden are as follows:
- Action Pending Window Font
- Set to 0 for a proportional font or non zero for a monospaced font.
- Artwork Scale Only if Square
- This setting overrides the Preferences-Artwork scale only if approximately square option. A non zero integer value, enables the option. A value of zero disables the option.
- Artwork Scale Size
- This setting overrides the Preferences-Artwork scale down to option. A value of zero implies do not scale. Other integer values represent the scale down to size.
- Ask False Button Label
- Alternate text for the Ask statement's False button.
- Ask True Button Label
- Alternate text for the Ask statement's True button.
- Audio Free Space Padding
- Override the Preferences-Audio-Common free space padding value.
- Audio Remove Free Space
- Override the Preferences-Audio-Common remove free space setting. A non zero numeric value enables the setting. Any other value disables it.
- Auto Close Batch Processor Window
- This can be used to override the Preferences - Actions Automatically close the Batch Processor when done setting. An integer value of zero implies do not close while any other integer value implies close. Note that this preference change will be ignored unless Preferences - Actions Allow actions to override the auto close Batch Processor panel setting is enabled.
- Auto Truncate Path Components
- This can be used to override the Preferences - Rename - Settings - Automatically truncate path components setting.
- Batch Auto Save Files
- This can be used to override the batch processor's 'Auto Save Files' setting. A non zero numeric value enables the setting. Any other value disables it.
- Batch Verbose Logging
- Set the value to 1 for verbose, or 0 for not. Note that this setting is ignored unless you are batch processing. Changing this setting will change the value of the Batch Verbose named variable.
- Copy Initial to Editing State On Save
- Set to 0 for Never, 1 for On the First Save, 2 for On All Saves.
- Do not Treat 'mix' as a Roman Numeral
- Set the value to 1 for make sure mix is not treated as a Roman Numeral. Set it to 0 to allow it.
- Log Raw Data Limit
- This override is used to set the data limit for the Log statement's raw data modes. A value of 0 will disable the display of binary data. A positive integer represents a raw data log with the specified amount as the limit. A negative integer represents a raw data log with no limit.
- Maximum Grouping-Work Name Compatibility
- This can be used to override the Preferences-Apple Apps-General setting of the same name. This is useful if you want to force the saving of an MP3 or AIFF files with a specific encoding for the Grouping and Work Name fields. A non zero numeric value enables the setting. Any other value disables it.
- No Auto Tag Writes on Save
- This setting is intended to be used when you are attempting to remove all tag information from a file. This typically involves the use of a Clear statement followed by a Save statement. This setting only makes sense if you are clearing all tag information as it only disables those items which can write tag information not affected by a Clear. The temporary value is ignored except to test if it is empty. This item disables all preference settings which can cause the generation of tag information automatically or not associated with fields. The presense of this item with a non empty value currently disables the following settings:
- Preferences-Apple Apps-General-Maximum Grouping-Work Name compatibility
- Preferences-Audio-Common-Set Tagging Time whenever file is written
- Preferences-Audio-MPEG-4-Apple App settings
- Write empty Content Advisory
- Process iTunMOVI for files with video
- Notifications
- Enables or disables notifications. A non zero numeric value enables the setting. Any other value disables it.
- Preserve Mod Date/Time when Saving Files
- Set to 0 for do not preserve or 1 for preserve.
- Prefer PIDs When Linking
- A non zero numeric value enables the setting. Any other value disables it.
- Rename Space Handling
- Set to 0 for No Changes, 1 for Remove Leading/Trailing or 2 for Remove Leading/Trailing and Compress.
- Rename Substitution
- You can override the Preferences - Audio - Common - Rename Substitution setting. As the setting has a special interpretation when empty and this statement treats empty as restore the default value, enter a ? to imply the setting should be empty. Rename templates can directly override this setting but Move statements cannot.
- Round Icon Corners
- A non zero numeric value enables the setting. Any other value disables it.
- Unique Value Mode
- Set the value to 2 for GUS. Any other value is interpreted as UUID.
- Video Aggressively Free Space
- Override the Preferences-Video aggressively free space value. A non zero numeric value enables the setting. Any other value disables it.
- Video Fast Rewrites
- Override the Preferences-Video free space padding value.
- Video Free Space Padding
- Override the Preferences-Video free space padding value. A non zero numeric value enables the setting. Any other value disables it. Note this will have no effect if Preferences-Video Override audio free space settings is not enabled. That setting can be overridden here via Video Override Audio Free Space Settings.
- Video Override Audio Free Space Settings
- Modify the Preferences-Video Override audio free space settings. A non zero numeric value enables the setting. Any other value disables it.
- Video Remove Free Space
- Override the Preferences-Video remove free space value. A non zero numeric value enables the setting. Any other value disables it. Note this will have no effect if Preferences-Video Override audio free space settings is not enabled. That setting can be overridden here via Video Override Audio Free Space Settings.
- Write ID3 v2.3
- This setting is used to set writes of specific file types to use ID3 v2.3. The specified integer represents the sum of various Audio File Type property values. The appropriate values are:
1 = mp3
8 = aiff
16 = dsf
32 = wav
64 = dff
-1 = all ID3 based file types
- Write ID3 v2.4
- This setting is used to set writes of specific file types to use ID3 v2.4. The value is constructed as in the Write ID3 v2.3 setting.
- Extension
- This setting is reserved for extensibility which might be necessary prior to other items being added to this list.
Clear Lists
You can choose to empty all preference lists (Artist, Composer, etc.) or any one single list. Warning: the clearing of a preference list is not undone when batch or action processing terminates. Note that you are clearing the lists as displayed in the Preferences-Lists section. Remember that any list can be associated with more than one field. Typically you would clear a list if you are going to use the Fill Lists statement to accumulate list contents.