ShowPics Version 3-Non ARP
7-Oct-89 John Matthews
Written in M2Sprint Modula 2 from M2S, Texas, USA

ShowPics is a IFF display program for use from CLI or Workbench.

It will display 
  1) a single file,
  2) a command line list of files, including multiple wildcards
  3) a menu selected list of files
  4) a script file of files

Command Format:

 CLI:

   - Version 3-ARP has a greatly enhanced CLI interface thanks to ARP.
     This version tries to mimic that, but is not as good. If you have ARP,
     use the other version.

  ShowPics  {[-B[+|-]] [-Tnnn] [-S] FileName}  ( 0 or more times )
             Show listed files.
             -B + or - turns on/off buffering until next specified.
             -Tnnn sets delay at nnn seconds
             -S specifies next file is a script file
  

    If no filenames are specified, a file requester allowing the selection
    of multiple files will appear. Click on all the files to display
    (they toggle), then click on OK.

 Workbench:

 Click on the first icon, then while holding down the SHIFT key, click on
 the rest, then double shift-click on ShowPics.
 Script file are designated type a FILETYPE=PICSCRIPT entry in its ToolType
 entries.
 
 Other ToolType entries affect behavior:

   BUFFERED=FALSE|TRUE turns double buffering on and off
   TIME=nnn specifies delay between pictures

   Until these are specified, they default to OFF, and wait til space
   pressed. They retain their values until something specifies them again.

   They can be set by ILBM icons, or PICSCRIPT icons. After a script, settings
   remain as they were at the end of the script, so script commands may alter
   them.


Press SPACE to move to next picture (or wait for nnn seconds if option T
selected). Pressing ESC stops, after the picture being loaded if in double
buffered mode. Pressing the arrow keys moves the screen.

ShowPics does not multitask in that it uses lots of CHIP memory (especially in
double buffered mode) and steals keyboard input (SPACE, ESC, Arrow keys).
If you avoid these keys, however, no problem.

Script commands:
Begin a line with a - (minus sign) and it will be interpreted as a command.

-B+    Turns buffering on
-B-    Turns buffering off
-Tnum  Treats num as the future delay between screens
-T-    Switches to ESC key delay
-Cnum  Repeat the script num times

Note: no spaces in commands


Changes for Version 2.2:
  Blank screen between unbuffered screens.
  Reuse of screens, if all characteristics identical -
    ie. if you have a script of screens all produced to the same resolution
    the program does not need to keep opening and closing screens
  Abort function added, press left mouse button
    (then press it again to activate something and return the pointer)

Changes for Version 3.0 - ARP
  ARP command line parsing, including wildcards.
  Better Workbench support, mixed ILBMs and Scripts

Changes for Version 3.0 - NonARP
  Removed ARP support from 3.0, created a semi-ok CLI interface.