====================================================================== ".IMG Slide Show" IMGSHOW.PRG (c) Copyright 1989 Migraph, Inc. All Rights Reserved Version 1.1 1/31/89 ====================================================================== This program is NOT public domain, but may be distributed free of charge provided this doc file accompanies the program. Distribution with commercial applications is FORBIDDEN, unless prior written consent is acquired from Migraph, Inc. ---------------------------------------------------------------------- This .IMG Slide Show program (IMGSHOW.PRG) allows the viewing of monochrome .IMG files on any resolution ST. (Low, Med, Hi & Viking 1) The user has control over speed, titles, slide order and other attributes through the use of an optional script file. You may specify multiple search paths and/or filenames with full wildcard support. * Optional file information about each slide * Black or white background * Cycling or non-cycling slide show * Key pause after each image or controllable time delay ---------------------------------------------------------------------- Script files: ---------------------------------------------------------------------- When the slide show is run, the command line is first checked for pathnames and/or filenames. If found, the slide show proceeds. If not, the current directory is searched for the script file "IMGSHOW.LST". If found, the script file is parsed and the slide show continues. Otherwise, "#*.img" is used as the search path, where '#' is the current directory. When this is the case, the slides in the directory will be shown in alphabetical order and you will be presented with a dialog box to choose display options from. Script files may contain the following fields (all are optional, and can be in any order), default settings are given in brackets. The user should specify 'Y','y','N', or 'n' following the field to indicate whether they would like the option enabled or suppressed. INFO: Indicate whether to show file information [no] TINYINF: Shall info be displayed in a line at the top of the screen or in a box at the right hand side [use box except in low-res] BLACK: Indicate whether the background behind the slide shall be black or white [no] CYCLE: Shall the slideshow start over at end [no] KEY: Wait for keystroke before displaying next slide [yes] SPEED: Value of 1,2, or 3 representing short, medium and long screen delays before displaying next slide [2] The next two fields don't take a letter after the field name: PATH: FILE: The 'PATH:' field consists of a list of pathnames to be searched one after another. If a full pathname is present (ie. "A:\IMGS\*.img"), then that is the search path used. If a path is present without a filename ("A:\IMGS\"), the FILE list is scanned one at a time to complete the full pathname. Wildcards may be used in the filename only. Up to 10 paths may be specified. The 'FILE:' field consists of a list of filenames (and filenames ONLY, paths will be stripped, ie. "A:\IMGS\*.img" will be read as "*.img") to be processed one at a time. Again, you may include wildcards or use full filenames. Field names MUST BE UPPER CASE and MUST CONTAIN THE COLON. Blank lines are ignored and anything after a semi-colon on a line is considered to be a comment. The following is a sample script file: -------------------------------------- ; Sample IMGSHOW script file ; anything after a semi-colon is a comment ; INFO:Y ; show file info. default is no BLACK:Y ; use a black background. default is no KEY:Y ; wait for keypress after each slide. default is pause ; PATH: c:\pics\*.img c:\images\ f:\imgs\touchup.img ; FILE: tiger?.img ss*.img The above script file will display the pictures with file information on top of a black background. Slides will not advance without a keypress. The first PATH entry will cause all .img files found in the "pics" folder on drive C to be displayed. Since this is a full pathname, the file list is ignored for this path. After this, the second PATH entry is processed. Since it is a pathname only (no filename), each of the FILE entries in turn is appended to the path to form complete search pathnames (ie. the first path searched will be "c:\images\tiger?.img", then "c:\images\ss*.img"). Finally, the third PATH entry is processed. It's a complete filename and the FILE list is ignored. ---------------------------------------------------------------------- The Command Line: ---------------------------------------------------------------------- 'PATH:' entries can be entered on the command line of various shells (ie. GULAM, MSH). You may need to enclose your paths in single quotes depending upon your shell. ---------------------------------------------------------------------- Install Application: ---------------------------------------------------------------------- You may also use Install Application from the desktop to install IMGSHOW.PRG as file type IMG. This will let you double-click an .IMG file to display it. ---------------------------------------------------------------------- Keyboard commands: ---------------------------------------------------------------------- The following key commands are accepted while the slideshow is running: SPACE.......... Pause at the current pic, any key resumes (does not pause if key pause is in effect) HELP........... Toggle file info on/off UNDO........... Toggle background color between black and white Up Arrow....... Display previous slide F1............. Show a screen of other information ESCAPE......... Abort slideshow Holding down the left mouse button also aborts the slideshow. Note: Some .IMG files take a while to load and sometimes keypresses won't seem to take effect until after the next slide. Also, keys should not be pressed too quickly after one another or commands may be lost. ---------------------------------------------------------------------- We hope this program makes your use of .IMG files more enjoyable and productive. Comments or problems may be addressed to: Migraph, Inc. 200 S 333rd St (220) Federal Way, Wa. 98003 phone lines 9-5 PST weekdays: 1-800-223-3729 Order line 1-206-838-4677 Product support Online support - GEnie address: MIGRAPH-TECH Category 28 in ST Roundtable