home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / anim / players / showan54.lzh / SHOWANIM.DOC < prev   
Text File  |  1989-06-17  |  9KB  |  174 lines
  1.  
  2.                           ShowANIM  Version 5.30
  3.                              13 September 1988
  4.  
  5.                           written by Gary Bonham
  6.  
  7.                      Copyright (c) 1988 by SPARTA Inc.
  8.                            Laguna Hills, Calif.
  9.                            All Rights Reserved
  10.  
  11. ShowANIM is a freely distributable player for ANIM animation files and for
  12. IFF ILBM picture files.
  13.  
  14. ShowANIM 5.3 represents a significant advance from the previously released
  15. versions, the latest of which was v4.3.  I wish to thank all those who have
  16. contributed suggestions and hope that at least most of you will be pleased
  17. with this release.  The most significant change in this release is a rework
  18. of the internal way of handling overscan and the display in general.  The
  19. result is that this version will support both NTSC and PAL in all resolutions
  20. and all normal levels of overscan.  Overscan levels that have been verified
  21. include no overscan (320/640 x 200/400), medium overscan (352/704 x 220/440),
  22. and severe overscan (384/768 x 240/480).  Also the corresponding levels
  23. for PAL which are identical in width but 56/112 taller.  Note that PAL
  24. overscan will, in general, require more than 512k of chip ram.  Therefore,
  25. you may not be able to utilize these modes until Commodore releases new
  26. chips which permit 1Mb of chip ram.  In addition keyboard
  27. control of animation speed as well as pause/restart/resume has been added,
  28. and full control of ShowANIM can now be specified from a workbench icon via
  29. the tooltypes table (which duplicates all command line parameters when run
  30. from the CLI).
  31.  
  32. In addition, this version will properly handle ANIMs which have new color
  33. maps on each frame.  Also, color cycling is supported.
  34.  
  35. Separate timing is provided for the first and last frame of an animation.
  36. These are defaulted to 3 seconds apiece so running ShowANIM without any
  37. parameters on an ANIM will hold the first frame 3 seconds, play the ANIM,
  38. and then hold on the last frame for 3 seconds before termination.  During
  39. this time you can use the keyboard to pause, or alter other settings such
  40. as looping playback and speed.  If showing a single picture, such as an
  41. IFF ILBM picture from a paint program, the two 3 second delays combine into
  42. one 6 second period during which the picture is displayed.
  43.  
  44. Specific features are as follows:
  45.  
  46. 1) Continuous play mode.  In continuous play it is assumed that the last two
  47.    frames of an ANIM exactly match the first two frames.  The ANIM can then
  48.    be run in a continuous loop mode where frame 3 follows the last frame.
  49.  
  50.       CLI command line:   -C#   where # indicates the number of times the
  51.                                 ANIM is to be continuously looped.  If left
  52.                                 off, then it will loop forever (well, at
  53.                                 least a LOT of times - something like 32000).
  54.  
  55.       Icon Tooltype:      CONTINUOUS=#  same as above except that # is
  56.                                 required.  If you want infinite play, set it
  57.                                 to a large value such as 32000.
  58.  
  59. 2) Looping play mode.  In looping play, each loop the ANIM will start with
  60.    frame 1 like starting from scratch.  There will be a definite pause at
  61.    this point since the compression used for the initial frame is not very
  62.    fast, and it contains the entire picture and not just the differences
  63.    from the previous frame.  The delay for first and last frames apply to
  64.    the first and last frames of each loop.  If both continuous and looping
  65.    play are selected then the continuous loop is inside of the looping play
  66.    loop.
  67.  
  68.       CLI command line:   -L#   where # indicates the number of times the
  69.                                 ANIM is to be repeated.  If left
  70.                                 off, then it will loop forever (well, at
  71.                                 least a LOT of times - something like 32000).
  72.  
  73.       Icon Tooltype:      LOOP=#  same as above except that # is required.
  74.                                 If you want infinite play, set it to a large
  75.                                 value such as 32000.
  76.  
  77. 3) PingPong mode.  In this mode an ANIM will play first to last and then
  78.    backwards back to the first, and so on.  N.B. that this mode will ONLY
  79.    WORK if the ANIM was generated in the XOR mode.  As of the date of this
  80.    writing, there is no commercial product offering the XOR mode, and when
  81.    one becomes available, it will probably be a slightly different
  82.    compression technique which will necessitate a revision to ShowANIM.
  83.    There will be a product from Aegis in the next few months which will
  84.    offer this as an option, unless it is pulled prior to release.
  85.  
  86.       CLI command line:   -B#   where # indicates the number of times the
  87.                                 ANIM is to be pingpong looped.  If left
  88.                                 off, then it will loop forever (well, at
  89.                                 least a LOT of times - something like 32000).
  90.  
  91.       Icon Tooltype:      PINGPONG=#  same as above except that # is
  92.                                 required.  If you want infinite play, set it
  93.                                 to a large value such as 32000.
  94.  
  95. 4) ANIM timing.  Normally, an ANIM will play back as fast as possible unless
  96.    there are timing values on the file itself (the relative timing parameter
  97.    in the ANHD chunk on each frame).  One can override this value by 
  98.    specifying the timing for all frames (in jiffies - 1/60 sec video frames).
  99.    Note that this is different than the special timing delays for the first
  100.    and last frames - this will affect ALL frames, overriding any timing on
  101.    the ANIM file itself.
  102.  
  103.       CLI command line:   +#    where # indicates the timing in jiffies
  104.                                 (1/60 second video frames).  
  105.  
  106.       Icon Tooltype:      TIMING=#
  107.  
  108. 5) Special timing delay for first/last frames.  These permit you to delay the
  109.    first and last frames of an ANIM.  If in looping play mode, these apply to
  110.    the first and last frames of each loop.  These are defaulted to 180
  111.    jiffies (3 seconds) each.
  112.  
  113.       CLI command line:   +F#   For timing delay on first frame.
  114.                           +L#   For timing delay on last frame.
  115.  
  116.       Icon Tooltype:      FIRST=#
  117.                           LAST=#
  118.  
  119.  
  120. 6) Color Cycling.  Not many products can generate an ANIM with cycling info,
  121.    but if they do, ShowANIM can play them.  Also, showing still pictures will
  122.    frequently require color cycling since most paint programs support
  123.    cycling.  Cycling is normally off, but may be activated with the
  124.    following:
  125.  
  126.       CLI command line:   +C    Acivate Color Cycling.
  127.  
  128.       Icon Tooltype:      CYCLING=ON
  129.  
  130.    N.B. that there is NO CYCLING=OFF command.  The contents of the right side
  131.         of this expression is ignored - the very presence of this command
  132.         will activate cycling.
  133.  
  134. 7) Keyboard control.  While an ANIM or picture is being displayed, one can
  135.    type the following keys for the following actions:
  136.  
  137.       ESC or CTRL-C - aborts the play.
  138.  
  139.       F1  - Set timing to 1 jiffy (60 fps).  Note that these timings will
  140.             not force a given speed if the Amiga cannot decompress the images
  141.             fast enough.  The timing is used to delay so the ANIM will not
  142.             play faster than this speed.
  143.       F2  - Set timing to 2 jiffies (30 fps).
  144.       F3  - Set timing to 3 jiffies (20 fps).
  145.       F4  - Set timing to 4 jiffies (15 fps).
  146.       F5  - Set timing to 5 jiffies (12 fps).
  147.       F6  - Set timing to 6 jiffies (10 fps).
  148.       F7  - Set timing to 10 jiffies (6 fps).
  149.       F8  - Set timing to 20 jiffies (3 fps).
  150.       F9  - Set timing to 30 jiffies (2 fps).
  151.       F10 - Set timing to 60 jiffies (1 fps).
  152.  
  153.       TAB - Toggle color cycling.
  154.  
  155.       Down Arrow  - Pause.
  156.       Up Arrow    - Continue.
  157.       Right Arrow - Go to next frame immediately.
  158.       Left Arrow  - Restart ANIM from first frame - Note, this puts play
  159.                     into the Looping play mode with 32000 loops.
  160.  
  161.       C   - Set continuous loop mode with 32000 loops.
  162.       L   - Set looping mode with 32000 loops.
  163.  
  164. **********************************************************************
  165.  
  166. One last disclaimer ... This program does its own copperlist creation.
  167. Therefore, if anyone encounters difficulties with particular size
  168. pictures, resolutions, etc., please contact me so it can be corrected.
  169. Many thanks go to Bart, Dale, Jimm, and others who have been very
  170. helpful in getting this code to run.
  171.  
  172. ... Gary Bonham, SPARTA Inc., Laguna Hills, Calif - 714) 768-8161
  173.  
  174.