~~Title: Show ~~ The **Show** internal command can be used to: * Display selected image files in the [[:additional_functionality:viewing_images|standalone image viewer]] * Display a slideshow of the contents of the current folder * View and manipulate installed viewer plugins (third-party libraries that can extend the image handling abilities of Opus) * Dynamically adjust the size of thumbnails displayed in the current file display * Execute the internal commands of the standalone image viewer (allowing you to configure the viewer toolbar and hotkeys) **Command Arguments:** $$ Argument $$ Type $$ Possible values $$ Description $$ (#)//(no argument)// $$ - $$ - $$ Opens the [[:additional_functionality:viewing_images|standalone image viewer]] to display selected files. ``Show`` $$ 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 **[[:preferences:preferences_categories:viewer:standalone_viewer|Standalone Viewer]]** 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. ``Show AUTOFILELIST LISTSIBLINGS`` $$ 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: ``Show "C:\Pictures\Mum & Dad.jpg"``\\ ``Show FILE="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. ``Show "C:\Cats\Best Cat.jpg" VIEWPANECMD=open`` $$ FULLSCREEN $$ /S $$ //(no value)// $$ Opens the image viewer in full-screen mode. ``Show FULLSCREEN`` $$ HEADING $$ /O $$ //(no value)// $$ When used with commands which generate a list of items (see [[:customize:creating_your_own_buttons:editing_the_toolbar:dynamic_buttons|dynamic buttons]]), the **HEADING** argument adds a small heading at the start of the list. The heading will be hidden when the list is empty. Headings only happen for commands which potentially generate multiple items at the same level as the button itself. When **HEADING** is used by itself, without specifying a text value, the main button's label text is used for the heading. ``Show THUMBNAILSIZE=list HEADING`` $$ $$ $$ //// $$ You can specify the heading text if you want it to be different to the button's label. ``Show THUMBNAILSIZE=list HEADING="Thumb Size"`` $$ LISTERLINK $$ /O $$ //(no value)// $$ The viewer which opens will be linked to the lister which ran the command. The viewer tracks the lister's file selection, similar to a detached preview pane. When a file is clicked in the lister, it will be loaded into the viewer. ``Show LISTERLINK`` If Preferences or other arguments specify re-use of an existing viewer, one will only be re-used if it was also opened with the **LISTERLINK** argument and came from the same Lister. Similarly, requests to open viewers without **LISTERLINK** will not re-use viewers opened with it. This argument is for use on lister toolbars (etc.) when opening a new viewer. See **VIEWERCMD=listerlink**, below, if you wish to link or unlink a viewer which is already open. $$ $$ $$ **close** $$ Closes all standalone viewers currently linked to the Lister which runs the command. ``Show LISTERLINK=close`` $$ $$ $$ **toggle** $$ Opens a new linked viewer, if the Lister does not have one already, and closes all the Lister's linked viewers otherwise. ``Show LISTERLINK=toggle`` $$ 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. ``Show FULLSCREEN LISTSIBLINGS`` $$ 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. ``Show LOADALLTHUMBS`` $$ PLUGIN $$ /K $$ //// $$ 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). The //// can be the either the name of the plugin DLL (including the **.dll** extension) or the "pretty name" of the plugin. Note that this command can't force a plugin to view a file it can't handle. This argument is also used in conjunction with **PLUGINDISABLE** to enable or disable the specified plugin. ``Show PLUGIN "Animated GIF"`` $$ PLUGINABOUT $$ /K $$ //// $$ Displays the **About** dialog for the specified plugin. The //// can be the either the name of the plugin DLL (including the **.dll** extension) or the "pretty name" of the plugin. ``Show PLUGINABOUT text.dll`` $$ PLUGINCONFIG $$ /K $$ //// $$ Displays the configuration dialog for the specified plugin (if it has one). ``Show PLUGINCONFIG dcrawrap.dll`` $$ 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. ``Show PLUGINDISABLE PLUGIN gifanim.dll`` $$ $$ $$ **enable** $$ Enables the plugin specified with the **PLUGIN** argument. ``Show PLUGINDISABLE=enable PLUGIN text.dll`` $$ $$ $$ **disable** $$ Disables the plugin specified with the **PLUGIN** argument. ``Show PLUGIN audiotags.dll PLUGINDISABLE disable`` $$ $$ $$ **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. ``Show PLUGIN="audiotags.dll" PLUGINDISABLE=toggle`` 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:// @toggle:invert Show PLUGIN="wma.dll" PLUGINDISABLE=toggle $$ PLUGINLIST $$ /S $$ //(no value)// $$ Displays a dynamic list of your installed viewer plugins (acts as a [[:customize:creating_your_own_buttons:editing_the_toolbar:dynamic_buttons|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. ``Show PLUGINLIST`` $$ PLUGINMANAGER $$ /S $$ //(no value)// $$ Displays the **[[:preferences:preferences_categories:viewer:viewer_plugins|Viewer / Viewer Plugins]]** page in Preferences, which lets you see and manage your installed viewer plugins. ``Show PLUGINMANAGER`` $$ POS $$ /K $$ //,// $$ 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. ``Show POS 1920,0`` $$ SIZE $$ /K $$ //,// $$ Overrides the default size of the standalone viewer. ``Show POS 1920,0 SIZE 960,1080`` $$ SLIDESHOW $$ /O $$ //(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. You can adjust the speed of the slideshow, and choose whether the order should be linear or random, from the **[[:preferences:preferences_categories:viewer:standalone_viewer:slideshow|Slideshow]]** page in Preferences. ``Show SLIDESHOW LISTSIBLINGS FULLSCREEN`` $$ $$ $$ **fade** $$ Initiates a slideshow using a cross-fade transition between the images. ``Show SLIDESHOW=fade FULLSCREEN`` $$ THUMBNAILSIZE $$ /K $$ //// $$ Sets the size of thumbnails in the active Lister to the specified size in pixels. This overrides the global thumbnail size set in the **[[:preferences:preferences_categories:file_display_modes:thumbnails_mode|File Display Modes / Thumbnails]]** page in Preferences. ``Show THUMBNAILSIZE 192`` $$ $$ $$ //,// $$ Sets the width and height of thumbnails separately. This lets you have non-square thumbnail sizes if desired. ``Show THUMBNAILSIZE 92,64`` $$ $$ $$ //// $$ 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. ``Show THUMBNAILSIZE +32`` $$ $$ $$ //,// $$ Adjusts both the width and height of thumbnails by the specified deltas. ``Show THUMBNAILSIZE +16,+24`` $$ $$ $$ **left** $$ Applies the size change to only the left (or top) file display in a [[:basic_concepts:the_lister:dual_display|dual-display]] Lister. ``Show THUMBNAILSIZE left,128`` $$ $$ $$ **right** $$ Applies the size change to only the right (or bottom) file display. ``Show THUMBNAILSIZE +64,right`` $$ $$ $$ **source** $$ Applies the size change to only the source file display. ``Show THUMBNAILSIZE source,64,80`` $$ $$ $$ **dest** $$ Applies the size change to only the destination file display. ``Show THUMBNAILSIZE dest,256`` $$ $$ $$ **both** $$ Applies the size change to both visible file displays in a dual-display Lister, but only the active folder tabs. ``Show THUMBNAILSIZE both,+32`` $$ $$ $$ **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. ``Show THUMBNAILSIZE all,+32`` $$ $$ $$ **reset** $$ Resets the thumbnail size to the value set in Preferences. ``Show THUMBNAILSIZE all,reset`` $$ $$ $$ **list** $$ Generates [[:customize:creating_your_own_buttons:editing_the_toolbar:dynamic_buttons|dynamic buttons]] that provide a number of thumbnail size options, intelligently chosen to suit your system DPI settings. ``Show THUMBNAILSIZE=list`` $$ USEEXISTING $$ /O $$ //(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 **[[:preferences:preferences_categories:viewer:standalone_viewer|Standalone Viewer]]** page in Preferences. ``Show USEEXISTING`` $$ $$ $$ **no** $$ Prevents the re-use of an existing viewer window - a new window will always be opened. ``Show USEEXISTING=no`` $$ $$ $$ **avoid** $$ Avoids switching to another virtual desktop - will only re-use a window on the same desktop. This overrides the **Avoid switching desktops** option. ``Show USEEXISTING=yes,avoid`` $$ $$ $$ **noavoid** $$ Does not avoid switching to another virtual desktop. ``Show USEEXISTING=yes,noavoid`` $$ VIEWERCMD $$ /K $$ //// $$ Only for use in the [[:additional_functionality:viewing_images|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. ``Show VIEWERCMD=alpha`` $$ $$ $$ **alwaysontop** $$ Toggle the //Keep On Top// option on and off. This makes the viewer always on-top relative to other normal windows. ``Show VIEWERCMD=alwaysontop`` If Preferences or Customize are opened, the viewer will reset to normal to avoid the dialogs opening behind it. Full-screen viewers are inherently on-top when active, regardless of this setting. You can also specify `on` or `off` to ensure the viewer is in a particular mode instead of toggling. ``Show VIEWERCMD=alwaysontop,on`` $$ $$ $$ **backcol** $$ Override or reset the viewer's //background color//. This only affects viewers and plugins which support it, and is useful for checking images that use transparency against various background colors. The change is temporary (not saved to your configuration) and only affects the viewer the command is run in. If no color is specified, the background is reset to the color from Preferences. ``Show VIEWERCMD=backcol`` Otherwise, a color should be specified in either #RRGGBB hex or RRR,GGG,BBB decimal format: ``Show VIEWERCMD=backcol,#FFFFFF``\\ ``Show VIEWERCMD=backcol,127,127,127`` If you need a button or hotkey which toggles a color override on each push, edit the items in the default Viewer toolbar's **View / Background Color** menu to see how it's done. $$ $$ $$ **channelall** $$ Displays all channels (R/G/B/A) as normal. Use to undo the effects of `channelred` etc. ``Show VIEWERCMD=channelall`` $$ $$ $$ **channelalpha** $$ Displays only the alpha channel of the image. ``Show VIEWERCMD=channelalpha`` $$ $$ $$ **channelblue** $$ Displays only the blue channel of the image. ``Show VIEWERCMD=channelblue`` $$ $$ $$ **channelgreen** $$ Displays only the green channel of the image. ``Show VIEWERCMD=channelgreen`` $$ $$ $$ **channelred** $$ Displays only the red channel of the image. ``Show VIEWERCMD=channelred`` $$ $$ $$ **close** $$ Closes the standalone viewer window. ``Show VIEWERCMD=close`` $$ $$ $$ **cmdbar** $$ Displays a [[:basic_concepts:the_lister:find-as-you-type_field|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. ``Show VIEWERCMD=cmdbar`` $$ $$ $$ **copy** $$ Copies the currently selected region of the image to the clipboard. ``Show VIEWERCMD=copy`` $$ $$ $$ **copyto** $$ Prompts for a new filename to copy the currently viewed file to. ``Show VIEWERCMD=copyto`` $$ $$ $$ **crop** $$ Crops the image to the currently selected region. The file on disk is not modified unless the image is saved. ``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. ``Show VIEWERCMD=cut`` $$ $$ $$ **delete** $$ Deletes the currently viewed file (after prompting for confirmation, by default). ``Show VIEWERCMD=delete`` The main difference between using this command and the actual [[delete|Delete command]] is that the viewer will move to the next file after the current one has been deleted. The additional options can be specified: * **close** automatically closes the viewer after deleting the image * **noadvance** stops the viewer moving onto the next image after deleting the image You may also specify one or more of the following [[delete|Delete command arguments]]: **shift**, **force**, **quiet**, **norecycle**, **recycle**, or **secure** (or **secure=//n//** for //n// passes). Any additional options or Delete command arguments must be included in a comma separated list without any extra spaces: ``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**: ``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. ``Show VIEWERCMD=dragsel,expand,mclick,pos:100,100`` $$ $$ $$ **first** $$ Goes back to view the first file in the list. ``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. ``Show VIEWERCMD=flip,horiz`` $$ $$ $$ **frame** $$ Turns the standalone viewer's //picture frame// option on or off. This only affects viewers and plugins which support it (most image types, but not things like Office or PDF documents). The change affects all open viewer windows and is saved to your configuration. The frame is toggled by default. ``Show VIEWERCMD=frame`` You can also specify "on" or "off" to explicitly turn the frame on or off. ``Show VIEWERCMD=frame,on`` $$ $$ $$ **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. ``Show VIEWERCMD=fullscreen``\\ ``Show VIEWERCMD=fullscreen,on``\\ ``Show VIEWERCMD=fullscreen,off`` $$ $$ $$ **gamma** $$ Adjust the gamma value of the image display. The adjustment value can be one of the following: |**+**////|increase gamma by ////| |**-**////|decrease gamma by ////| |////|set absolute gamma to value| |**0-**////|set absolute negative gamma value| |**reset**|reset gamma to default value| ``Show VIEWERCMD=gamma,+1``\\ ``Show VIEWERCMD=gamma,reset`` $$ $$ $$ **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 **-**. You can also jump to an image by name, by providing either the full pathname, just the filename, or a wildcard pattern. When providing a wildcard, the next match from the current file will be found - if no matches remain, the search will loop around and start again from the beginning. ``Show VIEWERCMD=goto,0``\\ ``Show VIEWERCMD=goto,+10``\\ ``Show VIEWERCMD="goto,car photo*.jpg"`` $$ $$ $$ **help** $$ Displays help about the image viewer. ``Show VIEWERCMD=help`` $$ $$ $$ **hex** $$ Toggles the display in and out of hexadecimal mode. ``Show VIEWERCMD=hex`` $$ $$ $$ **info** $$ Toggles the image information overlay on and off. ``Show VIEWERCMD=info`` $$ $$ $$ **last** $$ Go to the last file in the list. ``Show VIEWERCMD=last`` $$ $$ $$ **listerlink** $$ Link or unlink the viewer from the lister that opened it. When a lister and viewer are linked, selecting a file in the lister will display it in the viewer, making a standalone viewer like a detached preview pane. If **listerlink** is specified on its own, it will toggle the link (assuming the lister still exists). You can also specify **toggle** to be more explicit, or **on** or **off** to turn linking on or off without toggling. ``Show VIEWERCMD=listerlink``\\ ``Show VIEWERCMD=listerlink,off`` This is for running via viewer toolbars (etc.) to change the link state of an existing viewer. There is also a standalone **LISTERLINK** argument (above) which can be used to open new viewers from a lister and link them as soon as they open. $$ $$ $$ **mark** $$ This keyword is used to control image marking. It has many different functions, which are accessed by combining it with the following keywords: |//(no sub-keyword)//|Toggle mark state of current image (same as the **toggle** keyword).| |**browse**|Browse marked pictures (opens the marked pictures collection in a new tab).| |**clear**|Clear all marks.| |**exchange**|Exchange the current image for the previously marked image (unmarks the previous one and marks this one in its place).| |**first**|Jump to the first marked image.| |**last**|Jump to the last marked image.| |**next**|Jump to the next marked image.| |**nohighlight**|Prevents a button being highlighted when the condition it describes is true (e.g. when an image is marked, stops a **mark,toggle** button from being highlighted). Use with **on**, **off**, **toggle** and **view**.| |**off**|Unmarks the current image.| |**on**|Marks the current image.| |**prev**|Jump to the previously marked image.| |**return**|Return from a jump to the image you were previously viewing (e.g. after **mark,first** to jump to the first marked image, **mark,return** would put you back where you were).| |**toggle**|Toggle mark state of current image.| |**view**|Toggle the marked pane on and off.| ``Show VIEWERCMD=mark,toggle,nohighlight``\\ ``Show VIEWERCMD=mark,view`` $$ $$ $$ **markfirst** $$ Use this in conjunction with **next** and **prev** to mark the previous image before moving onto the next (or previous) one. ``Show VIEWERCMD=next,markfirst``\\ $$ $$ $$ **meta** $$ Toggles the embedded metadata panel on or off, and controls its width. Combine with the following keywords: |////|Specify the width of the metadata panel in pixels.| |**grow**|When opening the metadata panel, the viewer window will grow as much as possible to accommodate it. When closing the panel, provided the window has not been manually resized, its original width will be restored.| |**nofocus**|Prevents the metadata editor from gaining input focus when it opens.| |**off**|Turns the metadata panel off.| |**on**|Turns the metadata panel on.| |**toggle**|Toggles the metadata panel on and off.| ``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. ``Show VIEWERCMD=minwidth`` $$ $$ $$ **monitornext** $$ Assuming a multi-monitor system, moves the viewer to the next monitor. Most useful with full-screen viewers. ``Show VIEWERCMD=monitornext`` $$ $$ $$ **monitorprev** $$ Move the viewer to the previous monitor. ``Show VIEWERCMD=monitorprev`` $$ $$ $$ **moveto** $$ Prompts for a new filename to move the currently viewed file to. ``Show VIEWERCMD=moveto`` $$ $$ $$ **next** $$ Go to and view the next file in the list. You can combine this with **markfirst** to mark the current image first. ``Show VIEWERCMD=next`` $$ $$ $$ **nextlist** $$ Generates a list of the subsequent files in the image list (acts as a [[:customize:creating_your_own_buttons:editing_the_toolbar:dynamic_buttons|dynamic button]] - designed for use on the drop-down attached to the //Next// button). ``Show VIEWERCMD=nextlist`` $$ $$ $$ **notfullscreen** $$ Hides this button when the viewer is not in full-screen mode. You can combine this with any other keyword. ``Show VIEWERCMD=delete,notfullscreen`` $$ $$ $$ **onlyfullscreen** $$ Hides this button unless the viewer is in full-screen mode. You can combine this with any other keyword. ``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). ``Show VIEWERCMD=open``\\ ``Show VIEWERCMD="open,c:\my pictures\image.jpg"`` $$ $$ $$ **pluginabout** $$ Displays the //About// dialog for the current viewer plugin. ``Show VIEWERCMD=pluginabout`` $$ $$ $$ **plugincfg** $$ Displays the configuration dialog for the current viewer plugin (if it provides one). ``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. ``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 [[:customize:creating_your_own_buttons:editing_the_toolbar:dynamic_buttons|dynamic button]]. ``Show VIEWERCMD=plugincmds`` $$ $$ $$ **prev** $$ Go to and view the previous file in the list. You can combine this with **markfirst** to mark the current image first. ``Show VIEWERCMD=prev,markfirst`` $$ $$ $$ **prevlist** $$ Generates a list of the previous files in the image list (acts as a [[:customize:creating_your_own_buttons:editing_the_toolbar:dynamic_buttons|dynamic button]] - designed for use on the drop-down attached to the //Previous// button). ``Show VIEWERCMD=prevlist`` $$ $$ $$ **print** $$ Print the currently viewed file. ``Show VIEWERCMD=print`` $$ $$ $$ **refresh** $$ Refresh the currently viewed file. The file will be reloaded from disk. ``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, ...). ``Show VIEWERCMD=reselect`` $$ $$ $$ **restore** $$ Undoes the previous crop operation. ``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: |**+**////|rotate clockwise by //// degrees| |**-**////|rotate anti-clockwise by //// degrees| |////|set rotation to an absolute value| |**reset**|reset the rotation| ``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. ``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). ``Show VIEWERCMD=saveas``\\ ``Show VIEWERCMD="saveas,c:\my pictures\image.png"`` $$ $$ $$ **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: |**bottom**|Scroll to the bottom (vertical) or far right (horizontal).| |**down**|Scroll down (vertical) or right (horizontal).| |**horiz**|Scroll horizontally.| |**pagedown**|Scroll down a page (vertical) or right a page (horizontal).| |**pageup**|Scroll up a page (vertical) or left a page (horizontal).| |**top**|Scroll to the top (vertical) or far left (horizontal).| |**up**|Scroll up (vertical) or left (horizontal).| |**vert**|Scroll vertically.| |**center**|Scroll to the center. Can optionally be combined with **horiz** or **vert**.| ``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. ``Show VIEWERCMD=selaspect,16:9``\\ ``Show VIEWERCMD=selaspect,reset`` $$ $$ $$ **selectall** $$ Select the entire image. ``Show VIEWERCMD=selectall`` $$ $$ $$ **selectfile** $$ Select the currently displayed file in the folder tab the viewer was launched from. ``Show VIEWERCMD=selectfile`` $$ $$ $$ **shortcutbar** $$ Toggle the display of the shortcut bar on and off. ``Show VIEWERCMD=shortcutbar`` $$ $$ $$ **slideshow ** $$ Toggle slideshow mode on and off. ``Show VIEWERCMD=slideshow`` You can also turn it on or off explicitly, regardless of its current state: ``Show VIEWERCMD=slideshow,on``\\ ``Show VIEWERCMD=slideshow,off`` Add the `fade` keyword to enable a cross-fade transition between images: ``Show VIEWERCMD=slideshow,fade,on`` $$ $$ $$ **statusbar** $$ Toggle the status bar on and off. ``Show VIEWERCMD=statusbar`` $$ $$ $$ **toolbar** $$ Toggle display of the toolbar on and off. ``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: |**center**|The image will be centered on the desktop with a solid color fill surrounding it (this is the default). | |**fill**|The image will be expanded or shrunk to fill the desktop (may leave black bars at the top and bottom or sides, to preserve the aspect ratio). | |**fit**|The image will be expanded or shrunk to fill the desktop (the top and bottom or sides of the image may be cropped to preserve the aspect ratio). | |**span**|The image will be spanned across multiple monitors. | |**stretch**|The image will be stretched to fit the monitor, ignoring its aspect ratio. | |**tile**|A small image will be tiled multiple times horizontally and vertically to fit the monitor.| ``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: |**+**|zoom in.| |**-**|zoom out.| |**+**////|Zoom in a specified amount (percentage).| |**-**////|Zoom out a specified amount (percentage).| |////|Zoom to an absolute percentage of the original size.| |**fit**|Set zoom mode to "fit to page" - the image will be shrunk to fit the page if it's too large to fit all at once.| |**grow**|Set zoom mode to "grow to page" - the image will be shrunk to fit if it's larger, and expanded to fill the page if it's smaller.| |**tile**|Set zoom mode to "tile" - a small image will be tiled multiple times horizontally and vertically to fill the page.| |**reset**|Reset the zoom level.| ``Show VIEWERCMD=zoom,+`` $$ VIEWPANECMD $$ /K $$ $$ Sends commands to the Lister's viewer pane. Most of the available commands correspond to buttons in the viewer pane's toolbar and context menu, and exist so you can create hotkeys to perform the same actions. $$ $$ $$ **backcol** $$ Change the viewer pane's background color, overriding the color specified in Preferences. This only affects image viewers and plugins which support it, and is useful for checking images that use transparency against various background colors. If no color is specified, the background is reset to the color from Preferences: ``Show VIEWPANECMD=backcol`` Otherwise, a color should be specified in either #RRGGBB hex or RRR,GGG,BBB decimal format: ``Show VIEWPANECMD=backcol,#FFFFFF`` $$ $$ $$ **clear** $$ Unload any existing file and clear the viewer pane. ``Show VIEWPANECMD=clear`` $$ $$ $$ **frame** $$ Toggle the picture frame on and off (if supported by the current viewer). ``Show VIEWPANECMD=frame`` $$ $$ $$ **prev** $$ Go to the previews file. ``Show VIEWPANECMD=prev`` $$ $$ $$ **next** $$ Go to the next file. ``Show VIEWPANECMD=next`` $$ $$ $$ **open** $$ Open a particular file in the viewer pane. ``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: ``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. $$ $$ $$ **rotateleft** $$ Rotate the image 90 degrees counter-clockwise. ``Show VIEWPANECMD=rotateleft`` $$ $$ $$ **rotateright** $$ Rotate the image 90 degrees clockwise. ``Show VIEWPANECMD=rotateright`` $$ $$ $$ **zoomfit** $$ Reduce the image, if needed, to fit the available space. ``Show VIEWPANECMD=zoomfit`` $$ $$ $$ **zoomgrow** $$ Enlarge or reduce the image to match the available space. ``Show VIEWPANECMD=zoomgrow`` $$ $$ $$ **zoomin** $$ Increase the zoom amount by one step. ``Show VIEWPANECMD=zoomin`` $$ $$ $$ **zoomout** $$ Decrease the zoom amount by one step. ``Show VIEWPANECMD=zoomout`` $$ $$ $$ **zoomreset** $$ Show the image at 100% zoom. ``Show VIEWPANECMD=zoomreset``