Updated June 2021; see History
IMGDSX imgspec {switches}
or
IMGDSX @albumspec {/switches}
This command provides simple but flexible standalone image display capabilities, either for single images or for albums (lists) of images.
Parameters
imgspec
The filespec of the image to display. File extension of the image file must match its type and be one of the types supported by AUI_IMAGE (JPG, BMP, PCX, TIF). Remember to quote the imgspec if it is a native filespec not compatible with the AMOS 10.3 format.
@albumspec
The filespec of a text file containing a list of images to display. The format of the list is:
;(blank lines and those starting with a semicolon are ignored)
imgspec {,title}
imgspec {,title}
etc.
switches
Switch |
Function |
/1 |
Force previous instance of IMGDSX to close before the new one appears. This applies only when launching a new session to execute IMGDSX, or launching it via ATE. |
/albumfile |
File containing imagespec{,title} lines. |
/A:hhh |
Send a WM_SETFOCUS to window hhh when image has been displayed. Useful for putting focus back on the window that launched IMGDSX. See MX_FINDWINDOW for info on determining your window handle. |
/B:bmsg |
Set bottom status message (else bottom status line is removed from window) |
/C |
Continuous (spec if file of specs) |
/D:secs |
Auto-advance delay when displaying an album. Default is five seconds. Note: use a high number (max 65535) to effectively stop the auto-advance. |
/E |
Close instance when Escape hit or X clicked. |
/M:msg |
Message to display in window just below image (for albums, will be overridden by image title in the album file). Attribute values are the same as those used by AUI_CONTROL . |
/P |
(Albums only) Append "(n of m)" page count info to /M title |
/S |
Stretch image to fit window |
/T:title |
Set title bar (else image spec is display on window title bar) |
/W:l,t,r,b |
Left, top, right, bottom window coordinates in units ranging from zero for the top or left edge to 10000 for the right or bottom edge. Else window size remains as is. |
/? |
Writes switch listing and usage info to the screen. |
History
2021 June, A-Shell 6.5.1704: Two IMGDSX.LIT 1.0(115) refinements:
• Quoted image specs with UNIX-style directory separators are now supported.
• Image specs are no longer folded to upper case. This was a problem for web servers running Linux since Linux is case sensitive.