home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / ST_USER / 1990 / USERAP90.MSA / DSLIDE_DSLIDE.DOC < prev    next >
Encoding:
Text File  |  1990-02-05  |  8.3 KB  |  204 lines
  1.    ========================================================================
  2.            Deluxe SlideShow 1.1           (c)1987 Advanced Software
  3.               by John Brochu                  rev: June 16, 1987
  4.    ========================================================================
  5.  
  6.             This program is public domain, and is not to be sold.
  7.                Please do not distribute without this doc file.
  8.  
  9.    ------------------------------------------------------------------------
  10.  
  11.  
  12.    Changes from the Original Version
  13.    ---------------------------------
  14.         o Full color animation support
  15.         o Titling has been fixed to display with highest contrast possible
  16.  
  17.  
  18.    Features
  19.    --------
  20.         Deluxe SlideShow is an attempt to combine all the currently popular
  21.    ST  graphics  formats into one compact, but flexible slide show program.
  22.    The program includes support for NeoChrome, DEGAS, DEGAS compressed, and
  23.    Tiny  format  pictures.   Any  pic can be loaded and displayed on EITHER
  24.    monitor.   The low and med to hi-res conversions take a few seconds, but
  25.    the  results  are  very  pleasing  since a 16 (or 4 in the med-res case)
  26.    level dither table is used to represent the different color intensities.
  27.    Hi-res to med-res is the same conversion as used in PicSwitch 0.6 and is
  28.    almost instantaneous.
  29.  
  30.         The  user  has  full  control  over slide speed, titling, and slide
  31.    order  through  the  use  of  an  optional script file.  You can specify
  32.    multiple search paths and/or filenames with full wildcard support.
  33.  
  34.         o Neo, DEGAS, DEGAS compressed, & Tiny support
  35.         o Fully automatic res-switching
  36.         o Fully programmable
  37.         o Optional script files with separate mono & color scripts
  38.         o Optional titles
  39.         o Supports command line input, with wildcards
  40.         o Full color-animation support (4 channels for DEGAS Elite pics)
  41.  
  42.  
  43.    File Formats
  44.    ------------
  45.         DSLIDE.PRG  will  load  and  display  pics  with the following file
  46.    extenders...
  47.              NEO............ NeoChrome
  48.              PI1-3.......... DEGAS
  49.              PC1-3.......... DEGAS compressed
  50.              TNY or TN1-3... Tiny
  51.  
  52.  
  53.    Script Files
  54.    ------------
  55.         DSLIDE  uses  a  fairly  complex search routine to quickly find the
  56.    desired  files  in the directory.  If a valid file is found that matches
  57.    the  search  path,  the  extender  is  first verified to be sure it is a
  58.    picture file.
  59.  
  60.         When  the  program  is run, the command line is first checked for a
  61.    valid  pathname  or  filename.   If one is found it is processed and the
  62.    slide show proceeds.  If not, then the current directory is searched for
  63.    one  of  three script files, depending on whether a color or mono system
  64.    is  used.  If color, "SLIDEC.LST" is loaded and processed; if mono, then
  65.    "SLIDEM.LST"   is  loaded.   If  neither  is  found,  the  default  file
  66.    "SLIDE.LST"  is  used.   This  allows  you  to  have different slideshow
  67.    configurations  for  color  &  monochrome on the same disk.  If all else
  68.    fails, the default path "#:*.*" is used as the search path, where '#' is
  69.    the current directory.
  70.  
  71.         Script  files  may  contain the following fields (all are optional,
  72.    and can be in any order), default settings are given in brackets:
  73.              NAME:     a flag to indicate whether to title the pics [no]
  74.              TIME:     delay between pics (in seconds) [0 secs]
  75.              PATH:     Pathname list [current directory]
  76.              FILE:     Filename list [all files]
  77.  
  78.         The  'NAME:'  field  is  a  character  string,  a 'Y', or 'y' first
  79.    character  indicates  the  pictures will be titled at the bottom center,
  80.    anything else will be taken as a 'no' (and this is the default).
  81.  
  82.         The  'TIME:'  field  is  a  numeric string specifying the number of
  83.    seconds  to  display each picture.  Note this is the actual time the pic
  84.    will  be  on-screen.   Unlike  most  other  slide  shows,  DSLIDE  takes
  85.    disk-access  time  into  account.   If the pic takes longer than this to
  86.    load, it will flip immediately after it is loaded.
  87.  
  88.         The  'PATH:'  field  consists of a list of pathnames to be searched
  89.    one after another.  If a full pathname is present (ie. "A:\PICS\*.PI1"),
  90.    then  that  is  the  search  path  used.  If a path is present without a
  91.    filename  ("A:\PICS\"),  then  the FILE list is scanned one at a time to
  92.    complete  the  full  pathname.   Wildcards  may  be used in the filename
  93.    only.
  94.  
  95.         The  'FILE:'  field  consists of a list of filenames (and filenames
  96.    ONLY,  paths  will  be  stripped,  ie.  "A:\PICS\*.PC?"  will be read as
  97.    "*.PC?")  to  be  processed  one  at  a  time.   Again,  you may include
  98.    wildcards or use full filenames.
  99.  
  100.         The field names MUST BE UPPER CASE and MUST CONTAIN THE COLON.
  101.  
  102.         Blank  lines  are  ignored,  and all text before the first field is
  103.    ignored, so that comments can be used at the start of a script file.
  104.  
  105.         The following is a sample script file:
  106.  
  107.    ---------cut here----------
  108.    This is a sample DSLIDE script file...
  109.    Any text before the first field is ignored!
  110.    TIME:
  111.    5
  112.    NAME:
  113.    yes
  114.    PATH:
  115.    c:\pics\*.tny
  116.    c:\images\
  117.    #:
  118.    FILE:
  119.    *.p??
  120.    *.neo
  121.    *.tny
  122.    ----------cut here----------
  123.  
  124.         This  script  will  display  the  pics with a 5 sec delay, and with
  125.    titles.   The  first  PATH  entry  will cause all Tiny pics found in the
  126.    "pics"  folder  on  drive  C  to  be  displayed.   Since  this is a full
  127.    pathname,  the  file  list is ignored for this path, and the pathname is
  128.    searched  as-is.   After  this  is  complete  the  second  PATH entry is
  129.    processed.   Since it is a pathname only (no filename), each of the FILE
  130.    entries  in  turn  is  appended  to the path to form the complete search
  131.    pathname  (ie.  the  first path searched will be "c:\images\*.p??", then
  132.    "c:\images\*.neo",  and  finally "c:\images\*.tny").  Finally, the third
  133.    PATH  entry is processed, again since it is not a complete pathname, the
  134.    FILE list is scanned one at a time to complete the search pathname.  The
  135.    '#' character is used to denote the current drive (drive the program was
  136.    run from).
  137.  
  138.         Note  you  can  also specify the pics to display by name, in either
  139.    the  PATH  or  FILE fields, if you wish to display the pics in a certain
  140.    order, such as:
  141.  
  142.    -----------cut here-----------
  143.    PATH:
  144.    a:\pics\
  145.    FILE:
  146.    cat.pi1
  147.    house.pi1
  148.    dog.pi1
  149.    sketch.pi2
  150.    -----------cut here-----------
  151.  
  152.    or:
  153.  
  154.    -----------cut here-----------
  155.    PATH:
  156.    a:\pics\cat.pi1
  157.    a:\pics\house.pi1
  158.    a:\pics\dog.pi1
  159.    a:\pics\sketch.pi2
  160.    -----------cut here-----------
  161.  
  162.  
  163.    The Command Line
  164.    ----------------
  165.         A  'PATH:' or 'FILE:' entry can also be entered on the command line
  166.    when  running  DSLIDE.   To do this, rename DSLIDE.PRG to DSLIDE.TTP, or
  167.    install  it as a Tos Takes Parameters application from the desktop.  You
  168.    can  also  install it with a certain file type and then display a single
  169.    pic at a time by double-clicking on the picture file's icon.
  170.  
  171.  
  172.    Keyboard commands
  173.    -----------------
  174.         The  following  key  commands  are  accepted while the slideshow is
  175.    running:
  176.              SPACE......... pause at the current pic, any key resumes
  177.              RETURN, UNDO.. abort the show
  178.              ESC........... skip delay/animation and flip to the next pic
  179.              HELP.......... toggle titles on/off
  180.              F1-F10........ change minimum pic display time as follows:
  181.                   F1..... 0 sec
  182.                   F2..... 1 sec
  183.                   F3..... 2 sec
  184.                   F4..... 4 sec
  185.                   F5..... 8 sec
  186.                   F6.... 15 sec
  187.                   F7.... 30 sec
  188.                   F8..... 1 min
  189.                   F9..... 2 min
  190.                   F10.... 4 min
  191.  
  192.         Holding down the right mouse button also aborts the slide show.
  193.  
  194.  
  195.    Comments, anyone?
  196.    -----------------
  197.         If  you  have  any  comments on Deluxe SlideShow or suggestions for
  198.    future  enhancement,  I'd  like  to  here from you.  I can be reached on
  199.    GEnie [JAKOB] and CIS [70376,1235], or by mail at:
  200.  
  201.              Advanced Software
  202.              21 Northend Street
  203.              Peabody, MA  01923
  204.