The Show internal command can be used to:
Command Arguments:
Argument |
Type |
Possible values |
Description |
---|---|---|---|
(no argument) |
- |
- |
Opens the standalone
image viewer to display selected
files. |
AUTOFILELIST |
/S |
(no value) |
Used to automatically populate the "next / previous" list in the viewer with other files visible in the folder tab which launched the command. Use AUTOFILELIST on its own, without LISTSIBLINGS, to make a command with similar behavior to launching the viewer by double-clicking a file. Specifically, it makes the command respect the Generate next/previous list (when opened via double-click) option on the Viewer Behavior page in Preferences, even when not triggered by a double-click. If the option is off then AUTOFILELIST on its own may have no effect. If you combine AUTOFILELIST and LISTSIBLINGS together, the command will always populate the "next / previous" list, even if the Preferences option is off, unless more than one file is selected. (If two or more files are selected, and you run the command on them, then just those files will be in the "next / previous" list.) The "next / previous" list generated by AUTOFILELIST
(when the Preferences option is on, or when combined with
LISTSIBLINGS) will usually be the same as that generated
by LISTSIBLINGS on its own. The two differ in situations
where what's visible in the folder tab does not correspond to a real
folder on disk. If the folder tab has a filter applied, or is showing
something like Find Results or a mode like Flat View, then
AUTOFILELIST gets you a list which corresponds to that
filtered or multi-directory view; on the other hand,
LISTSIBLINGS (on its own) gets you a list of files from
the same directory as the file you start with, which may be files that are
not displayed in the folder tab at
all. |
FILE |
|
<file> |
Specifies the file or folder to show. If a folder is specified, all files directly below it will be queued to the viewer's "next / previous" list. If you don't provide a file or folder on the command line, all selected files from the folder tab the command was launched from will be used, if applicable. Remember to enclose paths in quotes if they contain spaces. Since FILE is the default argument, you don't need to explicitly use its name. Both examples below do the same thing: Example: Show "C:\Pictures\Mum &
Dad.jpg" The FILE argument can also be used with VIEWPANECMD=open to open a particular file in the lister's viewer pane. Example: Show "C:\Cats\Best Cat.jpg" VIEWPANECMD=open |
FULLSCREEN |
/S |
(no value) |
Opens the image viewer in full screen
mode. |
LISTSIBLINGS |
/S |
(no value) |
When LISTSIBLINGS is used on its own, without AUTOFILELIST, it automatically populates the "next / previous" list in the viewer with other files from the same directory as the specified file (or single selected file). If neither LISTSIBLINGS nor AUTOFILELIST are specified, or if the command is run against multiple selected files, only the specified or selected files will be included in the viewer's "next / previous" list. See the description of AUTOFILELIST for what happens
when both are specified, and the differences between the
two. |
LOADALLTHUMBS |
/S |
(no value) |
Triggers the generation of thumbnail images for all files in the source
folder, including those that are currently out-of-view. Example: Show LOADALLTHUMBS |
NOUSEEXISTING |
/S |
(no value) |
Prevents the re-use of an existing viewer window - a new window will
always be opened. This overrides the Reuse existing viewer
window option on the Viewer
Behavior page in
Preferences. |
PLUGIN |
/K |
<plugin name> |
Forces the use of the specified plugin to display the files. Without
this, Opus will automatically determine the best plugin to use (or, for a
format that can be handled internally, no plugin will be used). |
PLUGINABOUT |
/K |
<plugin name> |
Displays the About dialog for the specified plugin.
The <plugin name> can be the either the name of the plugin
DLL (including the .dll extension) or the "pretty name"
of the plugin. |
PLUGINCONFIG |
/K |
<plugin name> |
Displays the configuration dialog for the specified plugin (if it has
one). |
PLUGINDISABLE |
/O |
(no value) |
Toggles the enable state of the specified plugin. If the plugin is
currently enabled it will be disabled, and vice versa. The plugin must be
specified using the PLUGIN
argument. |
|
|
enable |
Enables the plugin specified with the PLUGIN
argument. |
|
|
disable |
Disables the plugin specified with the PLUGIN
argument. |
|
|
toggle |
It is not necessary to specify "toggle", since it is the default if
neither "enable" nor "disable" are specified, but you can if you want to
be more explicit. Note that when a PLUGINDISABLE button is a toggle, the button will appear active (e.g. checked or highlighted) when the plugin is disabled. As with most commands, you can add @toggle:invert on a new line at the top of the command sequence to reverse this. Example: |
PLUGINLIST |
/S |
(no value) |
Displays a dynamic list of your installed viewer plugins (acts as a dynamic button). The
generated list contains a sub-menu for each viewer plugin, with commands
to enable/disable, configure and show information about the
plugin. |
PLUGINMANAGER |
/S |
(no value) |
Displays the Viewer / Viewer
Plugins page in Preferences, which lets you see and manage
your installed viewer plugins. |
POS |
/K |
<x>,<y> |
Overrides the default positioning of the standalone viewer, and opens
its window at the specified coordinates. This could be used, for example,
to always display the viewer on a particular monitor. Example: Show POS 1920,0 |
SIZE |
/K |
<width>,<height> |
Overrides the default size of the standalone viewer. Example: Show POS 1920,0 SIZE 960,1080 |
SLIDESHOW |
/S |
(no value) |
Initiates a slideshow of images. If any files are currently selected in
the source file display, only those images will be shown in the slideshow
- otherwise, all image files in the current folder will be displayed. Use
with the LISTSIBLINGS argument to always include all
files in the folder, irrespective of how many are currently
selected. |
THUMBNAILSIZE |
/K |
<size> |
Sets the size of thumbnails in the active Lister to the specified size
in pixels. This overrides the global thumbnail size set in the File Display
Modes / Thumbnails page in
Preferences. |
|
|
<width>,<height> |
Sets the width and height of thumbnails separately. This lets you have
non-square thumbnail sizes if
desired. |
|
|
<change> |
Adjusts the size of thumbnails in the active Lister by the specified
delta value. You must specify either a leading + or
- to make this a relative size
change. |
|
|
<change w>,<change h> |
Adjusts both the width and height of thumbnails by the specified
deltas. |
|
|
left |
Applies the size change to only the left (or top) file display in
a dual-display
Lister. |
|
|
right |
Applies the size change to only the right (or bottom) file
display. |
|
|
source |
Applies the size change to only the source file
display. |
|
|
dest |
Applies the size change to only the destination file
display. |
|
|
both |
Applies the size change to both visible file displays in a dual-display
Lister, but only the active folder
tabs. |
|
|
all |
Applies the size change to all file displays in the Lister, including
both sides of a dual-display Lister and all folder tabs. This is the
default behaviour. |
|
|
reset |
Resets the thumbnail size to the value set in
Preferences. |
|
|
list |
Generates dynamic
buttons that provide a number of thumbnail size options, intelligently
chosen to suit your system DPI settings. Example: Show THUMBNAILSIZE=list |
USEEXISTING |
/S |
(no value) |
Forces the re-use of an existing viewer window - a new window will
never be opened if there is an existing viewer currently open. This
overrides the Reuse existing viewer window option on the
Viewer
Behavior page in
Preferences. |
VIEWERCMD |
/K |
<command> |
Only for use in the standalone viewer, this command forms the basis of the default viewer toolbar, context menu and hotkeys. These commands can also be used from scripts that run within the context of the viewer. |
|
|
alpha |
Toggle the Hide Alpha Channel option on and off. Example: Show VIEWERCMD=alpha |
|
|
close |
Closes the standalone viewer window. Example: Show VIEWERCMD=close |
|
|
cmdbar |
Displays a FAYT-style command bar at the bottom of
the viewer window, which lets you type in an ad-hoc command to run in the
context of the viewer. Example: Show VIEWERCMD=cmdbar |
|
|
copy |
Copies the currently selected region of the image to the
clipboard. Example: Show VIEWERCMD=copy |
|
|
copyto |
Prompts for a new filename to copy the currently viewed file
to. Example: Show VIEWERCMD=copyto |
|
|
crop |
Crops the image to the currently selected region. The file on disk is
not modified unless the image is saved. Example: Show VIEWERCMD=crop |
|
|
cut |
Cuts the currently viewed file to the clipboard. If you then perform a
paste in a Lister the viewed file will be moved. Example: Show VIEWERCMD=cut |
|
|
delete |
Deletes the currently viewed file (after prompting for confirmation, by default).
Example: Show VIEWERCMD=delete
The main difference between using this command and the actual Delete command is that the viewer will move to the next file after the current one has been deleted.
You may also specify one or more of the following Delete command arguments: shift, force, quiet, norecycle, recycle, or secure (or secure=n for n passes). Any additional Delete command arguments must be included in a comma separated list without any extra spaces:
Example: Show VIEWERCMD=delete,quiet,secure=2
If no additional arguments are given, the shift argument is implicit, to maintain the old default behavior. If you only wish to disable the shift argument, use noshift:
Example: Show VIEWERCMD=delete,noshift |
|
|
dragsel |
Lets you trigger certain mouse actions from an OnViewerEvent script event. For example, when the script event is triggered to tell you the user clicked the left mouse button, you could trigger scrolling or expand mode depending on where on the window the mouse was clicked.
The default behavior is to scroll; use the "select" keyword to trigger selection mode, and "expand" to trigger expand/scroll mode.
By default the command assumes the left mouse button was used to trigger the event - use the "rclick" keyword for the right mouse button, and "mclick" keyword for the middle mouse button.
You can also provide the coordinates of the click by passing "pos:x,y"
on the command line - if not provided, the current mouse position is
assumed. Example: Show VIEWERCMD=dragsel,expand,mclick,pos:100,100 |
|
|
first |
Goes back to view the first file in the list. Example: Show VIEWERCMD=first |
|
|
flip |
Flips the currently viewed image. The file on disk is not modified
unless the image is saved. Use with horiz to flip
horizontally or vert to flip vertically. Example: Show
VIEWERCMD=flip,horiz |
|
|
fullscreen |
Turns full-screen mode on and off. By default, it will toggle the
setting, but you can also explicitly turn it on or off. Example: Show
VIEWERCMD=fullscreen |
|
|
gamma |
Adjust the gamma value of the image display. The adjustment value can be one of the following:
Example: Show
VIEWERCMD=gamma,+1 |
|
|
goto |
Go to a specified file in the list. Must be used with a value
indicating the image, where 0 is the first image,
1 is the second and so on. This command can also be
used to jump forwards or backwards a specific number of files, by
specifying a number preceded by + or
-. Example: Show
VIEWERCMD=goto,0 |
|
|
help |
Displays help about the image viewer. Example: Show VIEWERCMD=help |
|
|
hex |
Toggles the display in and out of hexadecimal mode. Example: Show VIEWERCMD=hex |
|
|
info |
Toggles the image information overlay on and off. Example: Show VIEWERCMD=info |
|
|
last |
Go to the last file in the list. Example: Show VIEWERCMD=last |
|
|
mark |
This keyword is used to control image marking. It has many different functions, which are accessed by combining it with the following keywords:
Example: Show
VIEWERCMD=mark,toggle,nohighlight |
|
|
meta |
Toggles the embedded metadata panel on or off, and controls its width. Combine with the following keywords:
Example: Show VIEWERCMD=meta,toggle,grow,400 |
|
|
minwidth |
Save the width of the current viewer window as the new minimum width.
When new viewers open they won't automatically size themselves narrower
than this width. Example: Show VIEWERCMD=minwidth |
|
|
moveto |
Prompts for a new filename to move the currently viewed file
to. Example: Show VIEWERCMD=moveto |
|
|
next |
Go to and view the next file in the list. Example: Show VIEWERCMD=next |
|
|
nextlist |
Generates a list of the subsequent files in the image list (acts as a
dynamic button -
designed for use on the drop-down attached to the Next
button). Example: Show VIEWERCMD=nextlist |
|
|
notfullscreen |
Hides this button when the viewer is not in full-screen mode. You can
combine this with any other keyword. Example: Show VIEWERCMD=delete,notfullscreen |
|
|
onlyfullscreen |
Hides this button unless the viewer is in full-screen mode. You can
combine this with any other keyword. Example: Show VIEWERCMD=close,onlyfullscreen |
|
|
open |
Open and view a new file. By default this will prompt for the file to
open, but you can provide a filename on the command line (e.g. from a
script). Example: Show VIEWERCMD=open Example: Show VIEWERCMD="open,c:\my pictures\image.jpg" |
|
|
pluginabout |
Displays the About dialog for the current viewer
plugin. Example: Show VIEWERCMD=pluginabout |
|
|
plugincfg |
Displays the configuration dialog for the current viewer plugin (if it
provides one). Example: Show VIEWERCMD=plugincfg |
|
|
plugincmd |
Trigger a command provided by the current viewer plugin (if it provides
any). The command is specified as a number where 0 means
the first command, 1 means the second and so
on. Example: Show VIEWERCMD=plugincmd,0 |
|
|
plugincmds |
Generates a list of the commands provided by the current viewer plugin
(if it provides any). This acts as a dynamic button. Example: Show VIEWERCMD=plugincmds |
|
|
prev |
Go to and view the previous file in the list. Example: Show VIEWERCMD=prev |
|
|
prevlist |
Generates a list of the previous files in the image list (acts as
a dynamic button - designed
for use on the drop-down attached to the Previous
button). Example: Show VIEWERCMD=prevlist |
|
|
|
Print the currently viewed file. Example: Show VIEWERCMD=print |
|
|
refresh |
Refresh the currently viewed file. The file will be reloaded from
disk. Example: Show VIEWERCMD=refresh |
|
|
reselect |
Reselect the previous selection. This lets you easily crop more than
one image to the same area (i.e. select a region, crop and save this
image, move to the next image, reselect the previous region, crop and
save, ...). Example: Show VIEWERCMD=reselect |
|
|
restore |
Undoes the previous crop operation. Example: Show VIEWERCMD=restore |
|
|
rotate |
Rotate the display of the current image. The file on disk is not modified unless you save the image. The amount to rotate by can be specified as follows:
Example: Show VIEWERCMD=rotate,+90 |
|
|
save |
Save any changes you have made to the current image. Use with the
quiet option to replace the existing file silently. This
command is unavailable if the image is not in one of the formats that Opus
is able to save (currently PNG, JPG, BMP and GIF) - in that case, you can
use saveas to save the image in one of those
formats. Example: Show VIEWERCMD=save,quiet |
|
|
saveas |
Prompts for a new filename to save the image to. The Save
Picture dialog also lets you choose the image format to save in. You
can optionally provide a filename to save to on the command line (e.g.
from a script). Example: Show
VIEWERCMD=saveas |
|
|
scroll |
Scrolls the current image. You must specify either horiz or vert to indicate the dimension you want to scroll, combined with another keyword to indicate how far to scroll. The keywords are:
Example: Show VIEWERCMD=scroll,vert,pagedown |
|
|
selaspect |
Fixes the aspect ratio of the selection marquee. You can specify an
aspect ratio (16:9, 3/2, etc), or reset to remove the
restriction. Example: Show
VIEWERCMD=selaspect,16:9 |
|
|
selectall |
Select the entire image. Example: Show VIEWERCMD=selectall |
|
|
selectfile |
Select the currently displayed file in the folder tab the viewer was
launched from. Example: Show VIEWERCMD=selectfile |
|
|
shortcutbar |
Toggle the display of the shortcut bar on and off. Example: Show VIEWERCMD=shortcutbar |
|
|
slideshow |
Toggle slideshow mode on and off. Example: Show VIEWERCMD=slideshow |
|
|
statusbar |
Toggle the status bar on and off. Example: Show VIEWERCMD=statusbar |
|
|
toolbar |
Toggle display of the toolbar on and off. Example: Show VIEWERCMD=toolbar |
|
|
wallpaper |
Sets the currently displayed image as your Windows desktop wallpaper. By default the wallpaper will be set to center mode, but you can specify a mode by providing an additional keyword:
Example: Show VIEWERCMD=wallpaper,span |
|
|
zoom |
Adjusts the zoom level of the current image display. You must provide an additional keyword to indicate the desired zoom level:
Example: Show VIEWERCMD=zoom,+ |
VIEWPANECMD |
/K |
<command> |
Sends commands to the viewer pane. Most of the available commands correspond to buttons in the viewer pane's toolbar, so you can create hotkeys to perform the same actions:
Example: Show VIEWPANECMD=zoomin There are also these commands, unrelated to the viewer pane's toolbar:
Example: Show VIEWPANECMD="open,C:\My Image.png" When using open, you may want to first run Set VIEWPANELOCK=On to prevent the viewer pane from loading other files when they are selected in the file display. You can also specify the file to open using the FILE argument instead: Example: Show FILE="C:\Cats\Best Cat.jpg" VIEWPANECMD=open Finally, Show VIEWPANECMD=open on its own can be used to simply open the viewer pane, although Set VIEWPANE=On or Set VIEWPANE=Toggle are the more standard ways of doing that. |