home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d9xx / d924 / s_anim5.lha / S_Anim5 / S_Anim5.doc < prev    next >
Text File  |  1993-10-07  |  5KB  |  140 lines
  1.    
  2.  
  3.                              S _ ANIM5  V1.3 
  4.  
  5.                          Self-Displaying Anim5
  6.  
  7.        
  8.        S_ANIM5 is a programme to turn Anim5 animations (DPaint, Videoscape,
  9.                     P-Anim etc) into self-displaying files.
  10.  
  11.  
  12.      So you have just created a really superb animation and you want to show it
  13.    to the world; in what form do you distribute it?  Here are some of the
  14.    options: (figures given are for the "Ripples" animation on Fish #127).
  15.  
  16.      Leave it uncompressed and include an animation display programme such as
  17.      Superview on the disk.
  18.  
  19.          Ripples 673020,   Superview3.0 9472           Total 682492 bytes
  20.  
  21.      Compress it (PowerPacker) and include PPAnim to display it, along with the
  22.      PowerPackerLibrary.
  23.  
  24.          Ripples.pp 470920  PPAnim 7404  PP.library 6076  Total 484400 bytes
  25.  
  26.      Archive it together with Superview, and include the archiver so that it
  27.      can be extracted.
  28.  
  29.          Archive (LHA) 405651,  LHA  53440             Total 459091 bytes
  30.  
  31.      or use P-Compress instead of PowerPacker, P-Reader decodes and displays.
  32.      Ripples(P-Compress) 425232  P-Reader 30472        Total 456704 bytes   
  33.  
  34.      Finally turn it into an S_Anim - no display tools, decompressors or
  35.      libraries needed
  36.  
  37.          Ripples.se 431236                             Total 431236 bytes 
  38.  
  39.     
  40.      If disk space is the criterion, The S_Anim solution wins outright.  Other
  41.    advantages are:
  42.  
  43.      Convenience:  no mucking about with de-Archiving, loading libraries,
  44.      moving display prograames around, setting icon default tools, or
  45.      creating  XIcon  texts.
  46.  
  47.      Portability:   The pic can be transferred anywhere without worrying over
  48.      whether a suitable decompressor/display tool is available, or changing
  49.      icons.
  50.  
  51.      Sound:  Along with the P-Compress solution, S_Anim will handle the music
  52.      track of animations produced by P-Anim.
  53.  
  54.      Speed: At a CLI it is a quicker to type "Ripples.se" than for example
  55.      "dh0:c/PPAnim Ripples". 
  56.  
  57.    Perhaps the real point is that it gives you a file that can be moved from
  58.   disk to disk without having to even consider whether suitable decompressing 
  59.   displayers are on them, and can distribute without having to consider whether
  60.   recipients have any means of decompressing and displaying.
  61.  
  62.    S_Anim5 is one of a family of tools for the production of self-executing 
  63.   files.  S-Text and S-Pic have already been released.  S-Exec will follow
  64.   in due course.
  65.  
  66.                            INSTRUCTIONS 
  67.  
  68.    To create the executable animation open a CLI and type:
  69.  
  70.                  S_Anim5 -[switches] <animfile> <outfile>
  71.  
  72.    Two swiches are available:
  73.  
  74.      -c   Run continuously until stopped.  The default is to run once only.
  75.  
  76.      -rx  Set framing rate in frames/second.  x should be between 1 and 30.
  77.           The default is to use whatever rate was set by the creator of the
  78.           animation.
  79.  
  80.      S_Anim5 -c -r8 Ripples Ripples.se would create the S_Anim file Ripples.se
  81.   which when executed would run continuously at a framing rate of 8 frames/
  82.   second.
  83.  
  84.      As always where switches indicated by '-' are used the animfile and
  85.   outfile names should not contain hyphens!  (Note that the name of this
  86.   program is `S_Anim5', not `S-Anim5' as might have been expected).
  87.  
  88.    The <outfile> must be different from <animfile>, you cannot directly
  89.   replace anims with their executable offspring.  It is a good idea to add
  90.   an extension (.se) to the outfile to distinguish it from a primitive
  91.   non-executable anim.
  92.  
  93.    For Workbench use provide the executable with a TOOL type icon.
  94.  
  95.    To view the anim treat the file just like any other executable:
  96.  
  97.      At a CLI type the name, use RUN if you wish.
  98.      From Workbench double-click the icon.
  99.  
  100.    A small window will open, asking you to click the Left mouse button to
  101.   start the animation and to click again to stop and clear it.   
  102.  
  103.      
  104.           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  105.  
  106.     S_Anim5 is Freeware.  It may be copied and distributed freely and used
  107.    without charge for non-commercial purposes.  Authority for commercial
  108.    use should be obtained from the author below.
  109.  
  110.     No responsibility can be accepted for any loss occasioned by use of the
  111.    programme.
  112.  
  113.      Comments, suggestions, bug-reports all welcome.
  114.  
  115.    Chas A. Wyndham,
  116.    1265 Canning Mills Road,
  117.    Roleystone,
  118.    WA 6111.
  119.    Australia 
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.