# IMGDSX

> [HTML Version](imgdsx_lit.htm)

_Updated June 2021; see History_

**IMGDSX imgspec \{switches\}**

or

**IMGDSX @albumspec \{switches\}**

IMGDSX 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](mx_findwindow.md) 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  <br>\{,scale,attr,font\} | 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.