Directory Opus Updates & Release Notes

Directory Opus 13.25

Download manually, or use Help > Check for Program Updates.

The following is a summary of new features and other significant changes from 13.24.

See the New Releases forum for detailed release notes for the various beta versions from 13.24.1 onwards.

Note: This release of Opus is signed with a brand new certificate. Please don't be alarmed by any Microsoft SmartScreen warnings you may encounter.

Preferences

• Added an option to Preferences / File Display Modes / Details / Appearance (and a separate one for Power Mode) that lets the vertical padding of file display group header items be configured.
• Added Preferences / File Operations / Copying Files / Include duplicate count of 1 option (and a similar option for the shortcut template). If turned on a duplicate count of 1 (i.e. the first duplicate) will generate something like "xxx - Copy (1)" rather than "xxx - Copy".
• Added Preferences / File Display Columns / Options / Show abbreviation for "bytes" in file sizes option.
• Added Preferences / File Displays / Status Bar / Scale images to match the font size option.
• Added Preferences / File Displays / Options / Info Tips / Display checkerboard behind transparent images option.
• You can now configure separate actions for FAYT Folders Mode for Enter + shift/ctrl/alt.
• When running in a non-English language, the Preferences search now includes the original English-language names of the various Preferences pages in the search index (so you can, for example, search for "language" when running in another language and find the Language page).
• With custom window frames (toolbar moved into titlebar), default light and dark themes now apply a color accent to active windows rather than inactive ones. (Can be changed via the Window Title colors under Preferences / Colors and Fonts / Directory Opus Colors / Toolbars.)
• You can now configure what the right mouse button does in the standalone image viewer (Preferences / Viewer / Standalone Viewer / Mouse Buttons). If set to anything other than Context Menu, you can still display the context menu by holding the shift key when you right-click.
• When the GPU-accelerated viewer is enabled you can now configure the scaling mode exactly (rather than a single "high quality" option). Different modes can be selected for when the viewer is zoomed in (>100%) and zoomed out (<100%).
• The Toolbars / Icons page in Preferences now has a button to disable individual icon sets.
• Added a new default evaluator column, Image Size. Displays the size of an image in megapixels.
• Added options for the External Tools image formats to let a configured format override the internal image handling for both the viewer and thumbnails.

Status bar

• You can now use links in the status bar to add clickable links to run commands or show popup menus.
  • Use href to specify a command to run (e.g. About).
  • Use id to specify the name of a toolbar to show as a popup menu (e.g. Commands).
  • Use text to specify a tooltip (shown on mouseover).
• Added status bar {qkh} code. Displays an icon that provides a tooltip showing the FAYT Quick Keys modes.
• Added Preferences / File Displays / Status Bar / Custom Codes. This page lets you define custom codes for the status bar using the evaluator. It lets you make more complex evaluation clauses (over multiple lines) and use them in the status bar using a simple {code}-style insertion code. You can also pass data through to the evaluation clause, e.g. {code:data} which will be available in the evaluation clause in the args value.
• Redesigned how the various status bar modes are selected/described on the Preferences Status Bar page. Split the definition editor to a separate page with a dropdown to let you select which definition to edit, meaning the editor is now much larger.

Commands

• Added Show VIEWERCMD=acceleration and Show VIEWERCMD=scalemethod commands, which let GPU acceleration and the scaling methods be modified for the current viewer without having to change the global Preferences. These commands have also been added to the default Viewer toolbar (reset to Factory Defaults or find them in Customize / Default Toolbars).
• Added Show VIEWERCMD=selectregion command to the standalone viewer. By default this command selects a default region (respecting aspect ratio if one is set) which can then be modified. If a region is already selected it clears the existing selection. You can also specify the size of the region to select:
  • As a percentage, e.g. Show VIEWERCMD=selectregion,100%
  • As a width, e.g. Show VIEWERCMD=selectregion,1024. The height will be calculated automatically from the aspect ratio of the image.
  • As a size, e.g. Show VIEWERCMD=selectregion,1024,768. The selection will be centered in the image.
  • As a full rectangle specified as x,y,w,h; e.g. Show VIEWERCMD=selectregion,0,0,1024,768.
• The Show VIEWERCMD=backcol command can now be told to allow a checkerboard background behind the image while changing the remainder of the background color. For example, Show VIEWERCMD=backcol,#000000,allowcheckerboard.
• Command state tests like @ifset, IsChecked() etc can now use the Toolbar command to test if a toolbar is visible in a specific position rather than just on/off (e.g. @toggle:if Toolbar "MENU" STATE=top).
• Added CLI command CLOSETIMEOUT and AUTOSEARCHTIME arguments, which allow the configured FAYT timeouts to be overridden when initiating the FAYT via a command. You can specify the value 0 to disable auto-search / auto-close for that specific invocation.
• Added the CLI KEEPOPEN argument, which lets you invoke the FAYT and have the "keep open" pin selected by default.
• The CreateFolder MULTI argument can now be used in non-interactive mode, to indicate that the "create multiple folders" logic should still be used. This lets you have a command that creates multiple numbered folders, e.g. CreateFolder NAME="New Folder <5>" MULTI).
• You can now use {cp} with the CLI QUICKSEARCH command to specify where the cursor is positioned in the inserted string. For example, CLI QUICKSEARCHENGINE=everythingglobal QUICKSEARCH comment:"{cp}" would put the cursor between the two quotation marks.
• @if and similar command testing for Show VIEWERCMD=backcol now recognises the allowcheckerboard keyword.
• Added Set DELAY=x command which waits for x milliseconds.

Evaluator

• Added try/catch/throw to the evaluator. Lets you catch errors from functions and continue processing rather than have the evaluation aborted.
• The evaluator now supports suffixes to specify the types of numeric variables.
  • u - unsigned int
  • u64 - unsigned int 64
  • i64 - int 64
  • f - double
    For example, 1024u64 is the equivalent of 1024 as uint64.
• You can now add/subtract milliseconds from evaluator date variables with the 'i' prefix (e.g. date += 100i; to add 100ms)
• The evaluator DatePart() function can now use ii and iii for milliseconds (iii is zero-padded to three places).
• Evaluator columns can now return group information (when operator == "group") as a map, the same as for evaluator groups. This lets the group order, collapse state and optional markup for label headings be controlled.
• Added some numeric limits as predefined values in the evaluator: maxint, minint, maxuint, maxint64, minint64, maxuint64, maxdouble, mindouble.
• Added evaluator LanguageStr() canonical strings for "megapixels" and "mp".
• Added click_button value to evaluator functions (fits alongside click_pt and button_rect). Returns "l", "m" or "r" to identify which mouse button was clicked, or empty string if not applicable/known.
• Added evaluator Delay() function.
• Evaluator columns can now appear in more than one column category.

Scripting

• StringTools Encode/Decode methods now recognize the "WebCharset" keywords from the MIME types list in the registry (e.g. "shift_jis" is the web charset name for "iso-2022-jp").
• Script columns can now have their type set to "bool". The data provided to a bool column should be either false (0) or true (anything other than 0 - usually 1 or -1). The column value will be displayed as Yes/No in the current language, and will sort with Yes before No by default.
• The Viewer script object now has an id property which returns a unique ID number for that viewer instance.
• The Viewer script object now has a vars property which provides a Vars object local to the viewer. Each standalone viewer has its own set of variables. Viewer variables are not persisted to disk and only last until the viewer is closed.
• A script can now pass an Image object as the value of the Set BACKGROUNDIMAGE command to directly set an image as a background image. This implies "local" mode (e.g. BACKGROUNDIMAGEOPTS=local is implicit, even if not specified).
• Listviews in script dialogs have a new Sort Notify property. If turned on, clicking a column in the listview's sort header will generate a "sort" event rather than automatically sorting the list alphabetically by the chosen column. The 1-based column index will be provided in the Msg.index property. Clicking the current sort column generates a negative index (use this as a cue to sort in reverse order). You can use the Control.SortItems method to sort the list.
• The Control.SortItems method now takes an optional second argument.
  • When used with a custom sort callback, the second argument lets you specify the current sort column. The arrow indicator in the sort header will be updated to reflect the new column.
  • When given a column to sort by, the second argument is a flags value. Currently the only flag defined is "n", which performs a numeric string sort rather than a standard lexicographical sort.
• You can now change a script dialog palette control's options from code using the style property. Valid style flags are:
  • a - Palette type: alpha
  • t - Palette type: transparent
  • d - Palette type: default
  • n - No arrow
  • c - Can disable
  • m - Decimal
• The FolderEnum script object now supports wildcard and attribute filtering for the folder enumeration.
  • Use the wildcard property to set a wildcard pattern (prefix with "regex:" for regular expression). For example, folderEnum.wildcard="a*"; would only return filenames beginning with 'a'.
  • Set an attribute filter with attrinclude and attrexclude. For example, folderEnum.attrinclude="hs"; would only return items with both the hidden+system attributes set.
• The FSUtil.Run() method can now wait asynchronously for the launched program to complete and then send a message to a script dialog with the results. To use this, pass the dialog object as the sixth argument to the method (or as the dialog property if using map arguments). The return value from the Run() method in that case will be an ID number which identifies the task. Your message loop will receive a "run" message with this ID as the data property. The state property indicates whether the program was launched successfully or not, and the object property contains the RunResults object.
• In script dialog listview controls, you can now add multiple items/subitem values using a Map to specify the column names directly. The AddItem and InsertItemAt methods accept a Vector of Map objects. Each Map should contain key/value pairs for the column data to insert. By default the column titles are used as the keys but you can specify different (language-neutral, for example) keys with the new SetColumnPropertyNames method (this new method takes a Vector of strings; each string corresponds to a column in the listview.)
• In jscript scripts, jscript plain dictionary objects are now accepted as an argument documented as taking a Map. So for example you can pass {key:value, key:value, ...} to a method that accepts an Opus Map object.
• Script columns can now appear in more than one column category. The "category" property can specify multiple comma-separated category keywords.
• Scripts that generate toolbar buttons can now pass an Image object for the ButtonData.image and ButtonData.image2 properties.
• Added Filter.anyword and Filter.eval script properties.
• Added button_rect, click_pt, and click_button properties to Func script object, so scripts launched from buttons can also determine where the button was clicked.
• Added Point script object (similar to Rect) - returned by Func.click_pt property.
• Added diagnostic warning if a script's method names cannot be queried because it has names which only differ by case (ActiveScripting limitation).

Other changes

• Added a command to the Rename preset management dropdown menu to save the current dialog settings as the defaults for the Rename dialog. The defaults will be used when the Rename dialog first opens (unless overridden by command line arguments).
• Added "Clear History" command to the context menu for the edit field in the Set Description dialog. You can also delete individual strings from the dropdown history by pressing Shift+Del.
• Shortcuts created by Opus now set the Initial Directory field to the parent for files, and leave it blank for folders, similar to what File Explorer does.
• If a search launched from the FAYT is bumped to a new tab because the current tab is locked, the FAYT is now opened in the new tab with the same search string so that the search can be easily modified.
• File display toolbars now use the spacing configured under Preferences / Toolbars / Appearance if it is smaller than their standard 1x1 spacing.
• Automatic Formats list in Preferences now preserves selection and scroll position when reacting to changes (both new folders being added, and old folders being removed).
• Added a context menu for the evaluator groups Preferences page.
• Time format strings can now use ii and iii for milliseconds (iii is zero-padded to three places).
• Junctions made with Opus now set the 'PrintName' field in the filesystem (previously this was left empty). Should not have any effect on how they work.
• Numeric string comparisons now ignore thousands separators (so, e.g. "10,000.txt" will sort after "12.txt")
• Matching brace highlighting in the script editor now takes comments into account.
• Fixed occasional distortion in GPU viewer when panning a magnified image.
• Changed how the codepage name lookup table is built for the StringTools Encode/Decode script functions.
• Cursor position is now preserved when the FAYT is bumped to a new tab due to searching in a locked tab.
• Date columns from the shell (e.g. System.ItemDate) are now handled as dates rather than as text, which means they're formatted better and sort properly.
• The function editor now notifies you in real time if you specify a hotkey that's already in use, rather than waiting until you click OK to close the dialog.
• Added {thumbnailf} code for a new "flexible" layout of infotip thumbnails.
• The FAYT "keep open" pin button is now shown for all FAYT modes rather than just search.
• The FileType command's PATH argument now supports aliases.
• You can now use \n in in markup to insert a line break in the tooltip.
• Added support for compressed SVG files (.SVGZ)
• The status bar definition editor now remembers its settings (visible spaces, etc).
• The InfoTips and Tiles fields in the filetype editor now have syntax highlighting and features like "show visible spaces".
• Removed the length limit on the Set Description dialog. You can also resize this dialog now to make it easier to edit long descriptions.
• In thumbnails and tiles modes the "Spread excess space between the columns" option now adjusts the horizontal position of each icon to center it within its column.
• If lossless JPG rotation is enabled/possible, the image converter's flip operation is now lossless (previously, selecting flip would disable the lossless option).
• For viewer plugins, increased the buffer size for the lpszHandleExts field.
• Added Vietnamese language support.
• The installer now supports dark mode (matches the Windows setting).

This is a beta release. It may be unstable. Some text may not be translated yet. Use at your own risk!

Download manually, or use Help > Check for Program Updates (if beta versions are enabled in Preferences / Internet / Updates).

Note: This release of Opus is signed with a brand new certificate. Please don't be alarmed by any Microsoft SmartScreen warnings you may encounter.

• Fix for list not updating when toolbar icon set deleted in Preferences.
• Fix for Automatic Formats Preferences page hanging when trying to get the icon for a disconnected network drive.
• The installer now supports dark mode (matches the Windows setting).

⚠️ This is a beta release. It may be unstable. Some text may not be translated yet. Use at your own risk!

Download manually, or use Help > Check for Program Updates (if beta versions are enabled in Preferences / Internet / Updates).

Note: This release of Opus is signed with a brand new certificate. Please don't be alarmed by any Microsoft SmartScreen warnings you may encounter.

• Added diagnostic warning if a script's method names cannot be queried because it has names which only differ by case (ActiveScripting limitation).
• Possible fix for reported crash on ARM64 system.

⚠️ This is a beta release. It may be unstable. Some text may not be translated yet. Use at your own risk!

Download manually, or use Help > Check for Program Updates (if beta versions are enabled in Preferences / Internet / Updates).

Note: This release of Opus is signed with a brand new certificate. Please don't be alarmed by any Microsoft SmartScreen warnings you may encounter.

• If lossless JPG rotation is enabled/possible, the image converter's flip operation is now lossless (previously, selecting flip would disable the lossless option).
• Fixed Lossless option in image convert dialog being unavailable if "never lossless" had previously been selected.
• Fixed Rename dialog lockup with empty old/new name when switching to RegEx + FindRep mode (introduced in previous beta).
• External tools can now override thumbnail generation for archive files.
• Possible fix for crash ID 784

⚠️ This is a beta release. It may be unstable. Some text may not be translated yet. Use at your own risk!

Download manually, or use Help > Check for Program Updates (if beta versions are enabled in Preferences / Internet / Updates).

Note: This release of Opus is signed with a brand new certificate. Please don't be alarmed by any Microsoft SmartScreen warnings you may encounter.

• Added options for the External Tools image formats to let a configured format override the internal image handling for both the viewer and thumbnails.
• In thumbnails and tiles modes the "Spread excess space between the columns" option now adjusts the horizontal position of each icon to center it within its column.
• Fields like {created} when used by the Rename command now support milliseconds properly and don't rely on milliseconds being displayed in the Lister.
• Fixed This PC status bar showing incorrect codes (from previous beta).
• Fixed multiline description field not getting the focus when the Set Description dialog opens.
• Fixed regular expression + find & replace rename mode ending early if a find/replace step resulted in no change to the filename.
• Added Vietnamese language support.

⚠️ This is a beta release. It may be unstable. Some text may not be translated yet. Use at your own risk!

Download manually, or use Help > Check for Program Updates (if beta versions are enabled in Preferences / Internet / Updates).

Note: This release of Opus is signed with a brand new certificate. Please don't be alarmed by any Microsoft SmartScreen warnings you may encounter.

• Added evaluator Delay() function.
• Added Set DELAY=x command which waits for x milliseconds.
• The Set Description dialog now remembers its size from one invocation to the next.
• Ctrl+Backspace/Delete now works in multiline edit controls.
• Status bar custom code editor now remembers its settings.
• Fixed standalone viewer not using the configured background color before the initial image has loaded.
• Fixed splitter spacing in status bar Preferences page.
• Theme Tester now includes a listview with grid lines.

⚠️ This is a beta release. It may be unstable. Some text may not be translated yet. Use at your own risk!

Download manually, or use Help > Check for Program Updates (if beta versions are enabled in Preferences / Internet / Updates).

Note: This release of Opus is signed with a brand new certificate. Please don't be alarmed by any Microsoft SmartScreen warnings you may encounter.

Status Bar

• Added Preferences / File Displays / Status Bar / Custom Codes. This page lets you define custom codes for the status bar using the evaluator. It lets you make more complex evaluation clauses (over multiple lines) and use them in the status bar using a simple {code}-style insertion code. You can also pass data through to the evaluation clause, e.g. {code:data} which will be available in the evaluation clause in the args value.

Other changes

• Removed the length limit on the Set Description dialog. You can also resize this dialog now to make it easier to edit long descriptions.
• Fixed 7zip (and possibly others) drag & drop context menu not working reliably from outside of Opus.
• Fixed viewer selection magnifier going off-screen in some cases.

⚠️ This is a beta release. It may be unstable. Some text may not be translated yet. Use at your own risk!

Download manually, or use Help > Check for Program Updates (if beta versions are enabled in Preferences / Internet / Updates).

Note: This release of Opus is signed with a brand new certificate. Please don't be alarmed by any Microsoft SmartScreen warnings you may encounter.

Preferences

• Added Preferences / File Displays / Options / Info Tips / Display checkerboard behind transparent images option.

Scripting

• Added Filter.anyword and Filter.eval script properties.

Other changes

• Added support for compressed SVG files (.SVGZ)
• The status bar definition editor now remembers its settings (visible spaces, etc).
• The InfoTips and Tiles fields in the filetype editor now have syntax highlighting and features like "show visible spaces".

Fixes

• Fixed 'Open Path'-style commands in other apps (e.g. Everything) misidentifying Opus tabs which had previously displayed the relevant folder but were now showing an Opus-only path (e.g. a file collection).
• Fixed Image CONVERT button being disabled with no files selected even if it specified the source file on the command line.
• Fixed issues with FileType NEWNAME argument if a count of %1c or %2c was given.
• Fixed clicks on filter bar edit field not positioning the cursor properly.
• Fixed evaluator IsChecked() etc not working in the status bar.
• Fixed the status bar scaling icons like the format lock below the standard shell icon size.
• Fixed "Zone.Identifier" file appearing in the target folder when dragging a file from Firefox to Opus.
• Fixed Show VIEWERCMD=selaspect,reset not being remembered.
• Fixed image viewer resize quirk with very small image zoomed to maximum when image frame toggled on and off.
• Fixed Preferences / File Operations / Progress Indicators / Counting Files / Use Everything to count files where possible not being disabled if Everything not available.
• Possible fix for crash ID 779

⚠️ This is a beta release. It may be unstable. Some text may not be translated yet. Use at your own risk!
Download manually, or use Help > Check for Program Updates (if beta versions are enabled in Preferences / Internet / Updates).

Note: This release of Opus is signed with a brand new certificate. Please don't be alarmed by any Microsoft SmartScreen warnings you may encounter.

Preferences

• Added Preferences / File Displays / Status Bar / Scale images to match the font size option.
• Redesigned how the various status bar modes are selected/described on the Preferences Status Bar page. Split the definition editor to a separate page with a dropdown to let you select which definition to edit, meaning the editor is now much larger.

Other changes

• Changed the default infotip thumbnail positioning back to the old algorithm. Added {thumbnailf} for the new "flexible" layout.
• The FileType command's PATH argument now supports aliases.
• <a> links in the status bar are no longer underlined or change colour on mouseover.
• You can now use \n in <a text="..."> in markup to insert a line break in the tooltip.

Fixes

• Fixed a couple of places where Opus acted like Everything was installed when it wasn't.
• The FAYT pin did not work properly with FAYT script add-ins.
• Fixed evaluator multiplication of double with unsigned int returning 0.
• Fixed evaluator crash with mismatched brackets (introduced in beta 13.24.1).

⚠️ This is a beta release. It may be unstable. Some text may not be translated yet. Use at your own risk!

Download manually, or use Help > Check for Program Updates (if beta versions are enabled in Preferences / Internet / Updates).

Note: This release of Opus is signed with a brand new certificate. Please don't be alarmed by any Microsoft SmartScreen warnings you may encounter.

Status bar

• You can now use <a> links in the status bar to add clickable links to run commands or show popup menus.
  • Use href to specify a command to run (e.g. <a href="help about">About</a>).
  • Use id to specify the name of a toolbar to show as a popup menu (e.g. <a id="MyCommands">Commands</a>).
  • Use text to specify a tooltip (shown on mouseover).
• Added status bar {qkh} code. Displays an icon that provides a tooltip showing the FAYT Quick Keys modes.

Commands

• Added the CLI KEEPOPEN argument, which lets you invoke the FAYT and have the "keep open" pin selected by default.
• The CLI AUTOSEARCHTIME argument now accepts the value 0 to disable auto-search altogether for that invocation.
• The CLI CLOSETIMEOUT argument now works with all the different FAYT modes, and accepts the value 0 to disable the auto-close altogether for that invocation.

Scripting / Evaluator

• Added click_button value to evaluator functions (fits alongside click_pt and button_rect). Returns "l", "m" or "r" to identify which mouse button was clicked, or empty string if not applicable/known.
• Added button_rect, click_pt, and click_button properties to Func script object, so scripts launched from buttons can also determine where the button was clicked.
• Added Point script object (similar to Rect) - returned by Func.click_pt property.

Other changes

• The FAYT "keep open" pin button is now shown for all FAYT modes rather than just search.
• Improved Ctrl/Shift/Alt key tracking in the file replace dialog.

Fixes

• Fix for 4-bit PNG images not rendering properly in the accelerated viewer.
• Fixed folder tree sort order of newly-added folders within libraries.
• Improved numeric sorting algorithm to prevent unexpected sorting with version numbers.
• Fixed script dialog listviews returning incorrect data when queried for items added as a batch.

⚠️ This is a beta release. It may be unstable. Some text may not be translated yet. Use at your own risk!

Download manually, or use Help > Check for Program Updates (if beta versions are enabled in Preferences / Internet / Updates).

Note: This release of Opus is signed with a brand new certificate. Please don't be alarmed by any Microsoft SmartScreen warnings you may encounter.

Preferences

• Added Preferences / File Display Columns / Options / Show abbreviation for "bytes" in file sizes option.
• Added a new default evaluator column, Image Size. Displays the size of an image in megapixels.

Commands

• The CreateFolder MULTI argument can now be used in non-interactive mode, to indicate that the "create multiple folders" logic should still be used. This lets you have a command that creates multiple numbered folders, e.g. CreateFolder NAME="New Folder <5>" MULTI).
• @if and similar command testing for Show VIEWERCMD=backcol now recognises the allowcheckerboard keyword.

Scripting

• The FSUtil.Run() method can now wait asynchronously for the launched program to complete and then send a message to a script dialog with the results. To use this, pass the dialog object as the sixth argument to the method (or as the dialog property if using map arguments). The return value from the Run() method in that case will be an ID number which identifies the task. Your message loop will receive a "run" message with this ID as the data property. The state property indicates whether the program was launched successfully or not, and the object property contains the RunResults object.
• In script dialog listview controls, you can now add multiple items/subitem values using a Map to specify the column names directly. The AddItem and InsertItemAt methods accept a Vector of Map objects. Each Map should contain key/value pairs for the column data to insert. By default the column titles are used as the keys but you can specify different (language-neutral, for example) keys with the new SetColumnPropertyNames method (this new method takes a Vector of strings; each string corresponds to a column in the listview.)
• In jscript scripts, jscript plain dictionary objects are now accepted as an argument documented as taking a Map. So for example you can pass {key:value, key:value, ...} to a method that accepts an Opus Map object.
• Scripts that generate toolbar buttons can now pass an Image object for the ButtonData.image and ButtonData.image2 properties.
• The Command.IsSet() method now handles it again when it's incorrectly given the "Set" command at the start of the command line (accidentally changed in 13.24.1).

Evaluator

• Evaluator columns can now return group information (when operator == "group") as a map, the same as for evaluator groups. This lets the group order, collapse state and optional markup for label headings be controlled.
• Added some numeric limits as predefined values in the evaluator: maxint, minint, maxuint, maxint64, minint64, maxuint64, maxdouble, mindouble.
• Added evaluator LanguageStr() canonical strings for "megapixels" and "mp".

Other changes

• Date columns from the shell (e.g. System.ItemDate) are now handled as dates rather than as text, which means they're formatted better and sort properly.
• Improvement for the fix in 13.24.1 "Fixed interaction between @keydown:ctrl and the Set DUAL command."
• The function editor now notifies you in real time if you specify a hotkey that's already in use, rather than waiting until you click OK to close the dialog.
• Improved the positioning of the tooltip thumbnail when displayed to the right of the text.

Fixes

• Fixed pinned file labels not working reliably on folder read if autosize all columns was turned off.
• Fixed Docs plugin's error message not always rendering when it opens in a standalone viewer.
• Fixed viewer scrollbar arrows being drawn over when resizing the viewer window.
• Fixed distortion when resizing window with zoomed image in GPU-accelerated viewer.
• When the viewer pane is horizontal, its context menu can now be accessed from the header (previously the whole of the header could be used to resize the panel, now just the top portion of it can be).

⚠️ This is a beta release. It may be unstable. Some text may not be translated yet. Use at your own risk!

Download manually, or use Help > Check for Program Updates (if beta versions are enabled in Preferences / Internet / Updates).

Note: This release of Opus is signed with a brand new certificate. Please don't be alarmed by any Microsoft SmartScreen warnings you may encounter.

Commands

• Added Show VIEWERCMD=acceleration and Show VIEWERCMD=scalemethod commands, which let GPU acceleration and the scaling methods be modified for the current viewer without having to change the global Preferences. These commands have also been added to the default Viewer toolbar (reset to Factory Defaults or find them in Customize / Default Toolbars).
• The Show VIEWERCMD=selectregion command now lets you specify the size of the region to select:
  • As a percentage, e.g. Show VIEWERCMD=selectregion,100%
  • As a width, e.g. Show VIEWERCMD=selectregion,1024. The height will be calculated automatically from the aspect ratio of the image.
  • As a size, e.g. Show VIEWERCMD=selectregion,1024,768. The selection will be centered in the image.
  • As a full rectangle specified as x,y,w,h; e.g. Show VIEWERCMD=selectregion,0,0,1024,768.
• The Show VIEWERCMD=backcol command can now be told to allow a checkerboard background behind the image while changing the remainder of the background color. For example, Show VIEWERCMD=backcol,#000000,allowcheckerboard.

Other changes

• Numeric string comparisons now ignore thousands separators (so, e.g. "10,000.txt" will sort after "12.txt")
• Matching brace highlighting in the script editor now takes comments into account.
• Fixed occasional distortion in GPU viewer when panning a magnified image.
• Changed how the codepage name lookup table is built for the StringTools Encode/Decode script functions.
• Cursor position is now preserved when the FAYT is bumped to a new tab due to searching in a locked tab.

Fixes

• Fixed viewer not allowing selection grab handles to be clicked without Shift key down if left button action was set to 'next image'.
• Fixed evaluator error from FileDate() command when used in an inline insert code.
• Errors in inline evaluator codes in functions now (e.g. Select {=banana()=}) are now shown in the button editor log as well as the global log.
• Possible fix for crash ID 765
• Updated to unrar64.dll 7.23.
• Updated to 7z.dll 26.02.

⚠️ This is a beta release. It may be unstable. Some text may not be translated yet. Use at your own risk!

Download manually, or use Help > Check for Program Updates (if beta versions are enabled in Preferences / Internet / Updates).

Preferences

• You can now configure separate actions for FAYT Folders Mode for Enter + shift/ctrl/alt.
• When running in a non-English language, the Preferences search now includes the original English-language names of the various Preferences pages in the search index (so you can, for example, search for "language" when running in another language and find the Language page).
• With custom window frames (toolbar moved into titlebar), default light and dark themes now apply a color accent to active windows rather than inactive ones. (Can be changed via the Window Title colors under Preferences / Colors and Fonts / Directory Opus Colors / Toolbars.)
• You can now configure what the right mouse button does in the standalone image viewer (Preferences / Viewer / Standalone Viewer / Mouse Buttons). If set to anything other than Context Menu, you can still display the context menu by holding the shift key when you right-click.
• When the GPU-accelerated viewer is enabled you can now configure the scaling mode exactly (rather than a single "high quality" option). Different modes can be selected for when the viewer is zoomed in (>100%) and zoomed out (<100%).
• The Toolbars / Icons page in Preferences now has a button to disable individual icon sets.
• Added an option to Preferences / File Display Modes / Details / Appearance (and a separate one for Power Mode) that lets the vertical padding of file display group header items be configured.
• Added Preferences / File Operations / Copying Files / Include duplicate count of 1 option (and a similar option for the shortcut template). If turned on a duplicate count of 1 (i.e. the first duplicate) will generate something like "xxx - Copy (1)" rather than "xxx - Copy".

Commands

• You can now use {cp} with the CLI QUICKSEARCH command to specify where the cursor is positioned in the inserted string. For example, CLI QUICKSEARCHENGINE=everythingglobal QUICKSEARCH comment:"{cp}" would put the cursor between the two quotation marks.
• Added Show VIEWERCMD=selectregion command to the standalone viewer. Automatically selects a default region (respecting aspect ratio if one is set) which can then be modified. If a region is already selected it clears the existing selection.
• Command state tests like @ifset, IsChecked() etc can now use the Toolbar command to test if a toolbar is visible in a specific position rather than just on/off (e.g. @toggle:if Toolbar "MENU" STATE=top).
• Added CLI command CLOSETIMEOUT and AUTOSEARCHTIME arguments, which allow the configured FAYT timeouts to be overridden when initiating the FAYT via the CLI QUICKSEARCH command.

Evaluator

• Added try/catch/throw to the evaluator. Lets you catch errors from functions and continue processing rather than have the evaluation aborted.
• The evaluator now supports suffixes to specify the types of numeric variables.
  • u - unsigned int
  • u64 - unsigned int 64
  • i64 - int 64
  • f - double
    For example, 1024u64 is the equivalent of 1024 as uint64.
• You can now add/subtract milliseconds from evaluator date variables with the 'i' prefix (e.g. date += 100i; to add 100ms).
• The evaluator DatePart() function can now use ii and iii for milliseconds (iii is zero-padded to three places).

Scripting

• StringTools Encode/Decode methods now recognize the "WebCharset" keywords from the MIME types list in the registry (e.g. "shift_jis" is the web charset name for "iso-2022-jp").
• Script columns can now have their type set to "bool". The data provided to a bool column should be either false (0) or true (anything other than 0 - usually 1 or -1). The column value will be displayed as Yes/No in the current language, and will sort with Yes before No by default.
• The Viewer script object now has an id property which returns a unique ID number for that viewer instance.
• The Viewer script object now has a vars property which provides a Vars object local to the viewer. Each standalone viewer has its own set of variables. Viewer variables are not persisted to disk and only last until the viewer is closed.
• A script can now pass an Image object as the value of the Set BACKGROUNDIMAGE command to directly set an image as a background image. This implies "local" mode (e.g. BACKGROUNDIMAGEOPTS=local is implicit, even if not specified).
• Listviews in script dialogs have a new Sort Notify property. If turned on, clicking a column in the listview's sort header will generate a "sort" event rather than automatically sorting the list alphabetically by the chosen column. The 1-based column index will be provided in the Msg.index property. Clicking the current sort column generates a negative index (use this as a cue to sort in reverse order). You can use the Control.SortItems method to sort the list.
• The Control.SortItems method now takes an optional second argument.
  • When used with a custom sort callback, the second argument lets you specify the current sort column. The arrow indicator in the sort header will be updated to reflect the new column.
  • When given a column to sort by, the second argument is a flags value. Currently the only flag defined is "n", which performs a numeric string sort rather than a standard lexicographical sort.
• You can now change a script dialog palette control's options from code using the style property. Valid style flags are:
  • a - Palette type: alpha
  • t - Palette type: transparent
  • d - Palette type: default
  • n - No arrow
  • c - Can disable
  • m - Decimal
• The FolderEnum script object now supports wildcard and attribute filtering for the folder enumeration.
  • Use the wildcard property to set a wildcard pattern (prefix with "regex:" for regular expression). For example, folderEnum.wildcard="a*"; would only return filenames beginning with 'a'.
  • Set an attribute filter with attrinclude and attrexclude. For example, folderEnum.attrinclude="hs"; would only return items with both the hidden+system attributes set.

Other changes

• Added a command to the Rename preset management dropdown menu to save the current dialog settings as the defaults for the Rename dialog. The defaults will be used when the Rename dialog first opens (unless overridden by command line arguments).
• Added "Clear History" command to the context menu for the edit field in the Set Description dialog.
• You can now delete individual strings from the dropdown history list in the Set Description dialog by pressing Shift+Del.
• Shortcuts created by Opus now set the Initial Directory field to the parent for files, and leave it blank for folders, similar to what File Explorer does.
• If a search launched from the FAYT is bumped to a new tab because the current tab is locked, the FAYT is now opened in the new tab with the same search string so that the search can be easily modified.
• For viewer plugins, increased the buffer size for the lpszHandleExts field.
• File display toolbars now use the spacing configured under Preferences / Toolbars / Appearance if it is smaller than their standard 1x1 spacing.
• Automatic Formats list in Preferences now preserves selection and scroll position when reacting to changes (both new folders being added, and old folders being removed).
• Added a context menu for the evaluator groups Preferences page.
• Script and evaluator columns can now appear in more than one column category. For scripts columns, the "category" property can specify multiple comma-separated category keywords. For evaluator columns, the UI allows multiple columns to be chosen.
• Time format strings can now use ii and iii for milliseconds (iii is zero-padded to three places).
• Junctions made with Opus now set the 'PrintName' field in the filesystem (previously this was left empty). Should not have any effect on how they work.

Fixes

• Fixed unintentional folder tab repositioning with locked (allow changes) tab when quickly clicking/moving mouse/releasing to reset tab to its locked folder.
• Fixed Opus Find not matching document/author field in PNG images.
• Fixed matching brace highlighting in the script editor not working if the opening brace was at the end of the line.
• Fixed Viewer.title not returning the correct string after Viewers.Update() had been called.
• Fixed erroneous error from FileDate() evaluator called when used in inline button code.
• Fixed standalone viewer not reacting to toolbar background image changes until re-opened.
• Fixed unpainted gap between Preferences/Customize buttons on maximized titlebar if both were open and toolbars moved into titlbars.
• Creating shortcuts to the Libraries root (lib://) now works.
• Fixed the OnTabClick script event not getting proper qualifiers when Alt key was pressed.
• FAYT search did not work in a "locked (reuse unlocked tab)" tab.
• Fixed evaluator parsing error with multiple chained negative multiplications
• Fixed evaluator signed/unsigned mathematics operations converting the result to unsigned (now converts to signed).
• Fixed issue when grouping by evaluator columns that rely on metadata columns.
• Commands like Select FILTER worked in Opus 12 but did not work in Opus 13 (because FILTER had changed from /S to /O). Now they should work again.
• When an image's rotation is changed via metadata its thumbnail is now flushed from the cache; otherwise Opus could display a stale (non-rotated) thumbnail if the file's size and timestamp hadn't changed.
• The edit field in the SetAttr DESCRIPTION dialog no longer loses its cursor position when the dialog loses and then regains activation.
• Fixed script dialog palette control not reporting alpha value properly.
• Fix for tab drag & drop triggering Windows' "do not disturb" mode when "Turn on do not disturb automatically > When using an app in full-screen mode" is enabled.
• Fixed "Enter" property of script dialog edit controls affecting multiline edit fields (you would have to have set the property on first before changing the type to multiline, but it should not affect those controls at all).
• Fixed interaction between @keydown:ctrl and the Set DUAL command.
• Errors in inline evaluator codes in functions now (e.g. Select {=banana()=}) are now reported normally rather than being suppressed.
• File copies now set the Modified timestamp at the end of the copy again, not at the start, to avoid confusing software that expects it to only change when the copy finishes.
• Fixed @ifsel:type=*.png and similar patterns behaving as if the condition was true when nothing at all was selected.

Directory Opus 13.24

Download manually, or use Help > Check for Program Updates.

The following is a summary of new features and other significant changes from 13.23.

See the New Releases forum for detailed release notes for the various beta versions from 13.23.1 onwards.

Native SVG support

Opus now supports native rendering of SVG files.

• When shown in the viewer, images are dynamically resized when zoomed.
• Toolbar buttons can now use SVG code for their icon imagery, embedded within the button itself (i.e. not reliant on external files).
• You can also include inline SVG code in marked up text. The image will be automatically scaled to shell icon size (16x16 at 100% dpi). Use <%svg> to introduce the SVG code. E.g. blue <%svg viewBox="0 0 32 32"> dot.
• Things that accept marked-up text (e.g. markup text control in script dialogs) now also accept SVG code directly (rather than as an inline code) - in this case the image will be resized to fill the available space.
• The DOpus.LoadImage() script method can now create an image object from SVG code. In this mode, the "alpha" parameter is no longer valid, instead the last parameter is "remove_padding".
• You can use stylesheets with SVG images to support colour remapping in dark/light modes. Add and elements to the SVG definition. Opus will automatically recolor the image for the currently selected mode.

SVG Icons

Opus now supports SVG icon sets. Unlike traditional icon sets that use one or more bitmaps with a grid of icons, SVG icon sets store the SVG code directly in their XML definition file, making them completely self-contained. SVG icons will scale automatically, and if rendered using "currentColor" in the SVG will use the toolbar's default text color automatically.

• To make an SVG icon set, the element's size attribute should be set to "svg".
• Optionally, set remove_padding="yes" to have any padding automatically removed from the SVG image.
• You can include common styles that will be shared by all icons in the set. The

⚠️ This is a beta release. It may be unstable. Some text may not be translated yet. Use at your own risk!

Download manually, or use Help > Check for Program Updates (if beta versions are enabled in Preferences / Internet / Updates).

• Added Help CLOUDDIAGNOSTIC command, prints diagnostic info for cloud storage to the Diagnostic log.
• The script editor now allows .svg files to be added to script packages.
• File copies now set the Modified timestamp at the end of the copy again, not at the start, to avoid confusing software that expects it to only change when the copy finishes.
• Fixed some items/groups not being shown in the Preferences Filters page.
• Fix for script log not working properly on Windows 10.
• Possible fix for crash IDs 758 and 760.
• Fix for crash ID 759.