Image Overlay Utility

Command line support

For convenience, Image Overlay Utility can be started with command line arguments. These can be used when starting Image Overlay Utility from the Command Prompt or from a Windows shortcut (.ink) file.

Command Line Argument Description
-open (followed by relative or absolute path to file)

Opens the specified image or preset file. Note that quotes are necessary if the path contains spaces. Examples:

ImageOverlayUtility.exe -open C:\Images\image.jpg
ImageOverlayUtility.exe -open "My Preset File.iou"
-closeOverlay Closes the image overlay. This is meant to be used with single-instance parameter passing, since there should be no reason to open an image overlay and immediately close it.
-exit Closes Image Overlay Utility. This is meant to be used with single-instance parameter passing, since there should be no reason to open the program and immediately close it.
-minimize Minimizes the control box.
-minimizeToTray Minimizes the control box to the system tray.
-reactivate Site license users can make use of this to license mulitple copies of the program via the command line after copying over a copy of a valid license.dat file to each machine (for example through SCCM).
-reloadFile Reloads the currently loaded file. This is meant to be used with single-instance parameter passing, since there should be no reason to open a file and immediately reload it. This will re-open the image overlay if it was closed.

Single-instance parameter passing

If Image Overlay Utility is set to "allow only one instance" in Preferences and you attempt to load a second instance of the program, the command line arguments for the would-be second instance will instead be passed to the first instance for it to handle. This allows you to, for instance, swap out the image that is overlayed by reinvoking the program from the command line with the -open switch.

Caveat: Single-instance parameter passing currently requires that the user have read and write permissions on the directory in which the program executable resides, as Image Overlay Utility needs to be able to write a file containing the would-be second instance's command line arguments to be read by the first instance of the program. This shouldn't be much of a problem, since read and write permissions are required to license the program in the first place.


Default hotkeys

Here are the default keyboard shortcuts. To use these shortcuts, the control box or image overlay window must have focus. I will try to hook them globally in a future release. They also aren't user-configurable yet, but will be in a future update.

Keyboard Shortcut(s) Description
~ Numpad * Cycle through the opacity chain
(The opacity chain lets you cycle through several definable opacity percentages with the press of a key. Set the size of the opacity chain in Preferences.)
+ - Numpad + Numpad - Adjust opacity up/down
1 .. 9 Numpad 0 .. Numpad 9 1 Set opacity to specified percentage
0 Numpad Decimal 1 Set opacity to 100%
 
W
A S D
Move image overlay (change increment with Ctrl/Shift)
Numpad / Flip image horizontally
Shift + Numpad / Flip image vertically
Ctrl + P 2 Open Preferences
Ctrl + C 2 Open System Color Picker
Ctrl + Shift + C 2 Open WPF Toolkit Color Picker
F1 2 Open About Dialog
Ctrl Shift Hold these keys down to change the increment with which you change the opacity, rotation, and scale fields/sliders (you can use them in combination with the mouse wheel when hovering the mouse cursor over them)
1 Num Lock must be on.
2 Control box must be focused.

Presets

With the full version of Image Overlay Utility, presets can be saved using the 'Save' button in the main control box window. Parameter data is saved as regular JSON data, so preset files can be opened and modified using a text editor.