home *** CD-ROM | disk | FTP | other *** search
/ YPA: Your Privacy Assured / YPA.ISO / other_goodies / utilities / amiflick.lha / expansion / AmiFlick.doc < prev    next >
Text File  |  1993-10-26  |  5KB  |  98 lines
  1.                               AmiFlick v1.05
  2.                         An FLI player for the Amiga
  3.                             ⌐1993 Garrick Meeker
  4.  
  5.    This program is hereby placed in the public domain.  You may freely
  6. distribute it as long no more than a nominal fee for time and copying costs
  7. is charged.  This document must be included with the program.  I assume
  8. no reponsibilities for the behavior of this program.
  9.  
  10.    Have you ever wanted to use your Amiga to handle all those zillions
  11. of FLI files for PeeCee's?  Well, now there's AmiFlick.  It can play FLI's
  12. or write them to disk as a bunch of IFF's.  It can also handle the newer
  13. format of FLI's (sometimes called FLC's).  AmiFlick requires at least
  14. AmigaDOS 1.2 (I might make it requires 2.0 in the future).  A version for
  15. accelerated computers is not included because at the moment most of the
  16. work is done in OS calls, so it wouldn't be any faster.
  17.  
  18. Usage: AmiFlick [-v] [-d<delay>] [-c] [-h] [-H]
  19.                 [-g] [-s] [-l] [-b] file [outfile]
  20.  -v         Verbose file information
  21.  -d<delay>  Delay between frames in 1/70s of a second
  22.  -c         Color mode (requires AGA)
  23.  -h         HAM mode
  24.  -H         AGA HAM mode (allows Hires HAM)
  25.  -g         256 shade grey mode
  26.  -s         Scan file only
  27.  -l         Load file into memory before playing
  28.  -b         Double buffer playback
  29. 16 shade grey mode is the default
  30.    If outfile is specified, a series of 256 color ILBM's are written
  31. in the form outfile.nnn or outfile.nnnnn, depending on how many
  32. frames are in the file.
  33.  
  34.    To write the frames as a bunch of pictures just type:
  35.  
  36. AmiFlick file outfile
  37.  
  38.    Where 'file' is the FLI and outfile is the basename for the 256 color
  39. IFF pictures.
  40.  
  41.    'AmiFlick -s file' will just display info about the file, like how
  42. many frames there are.
  43.  
  44.    For playback, just type 'AmiFlick file'.  This will give you a 16 shade
  45. grey scale display.  During playback, you can use these keys:
  46.         ESC          Exits the animation.
  47.         Left Arrow   Slows down playback.
  48.         Right Arrow  Speeds up playback.
  49.         Space Bar    Pauses playback or steps forward a frame.
  50.         Return       Resumes playback.
  51.    If the screen is bigger than the display you can autoscroll with the
  52. mouse under 2.0 and greater.  The other display modes available are:
  53.         '-g'   256 shade grey scale.  Requires AGA.
  54.         '-c'   Color.  This will display the file without any conversion.
  55.                Also requires AGA.
  56.         '-h'   HAM mode.  In order to speed things up this looks very blocky
  57.                and has a "rainbow" effect on text.  I might improve the
  58.                algorithm in the future.
  59.         '-H'   Hires HAM mode.  Almost exactly like '-h' but for a 640x480
  60.                you'll get a hires HAM screen instead of a lores one.  This
  61.                option is pretty much useless because it requires AGA, so
  62.                anyone who could use it could just use '-c' instead.  I just
  63.                included it because it was easy.
  64.  
  65.    Some other options:
  66.         '-v'         Verbose information on the file, mainly for debugging.
  67.         '-b'         Double buffer the display.  This requires that one
  68.                      buffer is constantly copied to other.  Since this is
  69.                      done with the blitter, people with a 68020 or better
  70.                      may want to run CpuBlit.
  71.         '-l'         Load the file into RAM before playing it.
  72.         '-d<delay>'  Changes the delay between each frame in 1/70's of
  73.                      a second.
  74.  
  75.    Files with palette changes may look messed up unless you use either the
  76. '-g' or '-c' option.  This is because of the conversion that takes place.
  77. There isn't really anything I can do about it.  Fortunately, these files
  78. are extremely rare.
  79.  
  80. Plans for the future:
  81.    Playback is still pretty slow.  This is because of the hundreds of
  82. calls to WritePixel().  However, there are still plenty of things I can
  83. do to optimize AmiFlick.  The next release should be a good amount faster.
  84.    Some of the others things planned:
  85.         Direct writing of ANIM5 and ANIM7 files.
  86.         Writing files in one of the displayed modes instead of 256 color.
  87.         Possibly a better HAM algorithm.
  88.         Some sort of GUI.  At least a file requester and a screen mode
  89.            requester.
  90.         Possibly a separate program to write FLI animations from IFF
  91.            pictures or ANIM's.
  92.    If you want to see one of these features implemented then let me know!
  93.  
  94. I can be reached by e-mail at:
  95.  
  96. gmeeker@soda.berkeley.edu
  97.  
  98.