home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / anim / players / biganim2.lha / BigAnim.doc < prev   
Text File  |  1993-01-12  |  4KB  |  124 lines
  1.  
  2.             *-------------*
  3.             | BigAnim 2.0 |
  4.             *=============*
  5.  
  6.  
  7.     What is BigAnim?
  8.     ~~~~~~~~~~~~~~~~
  9. BigAnim is an animation player (you guessed it!), and it's called
  10. "BigAnim" because it is able to display animations that are too large
  11. to be loaded into memory directly.
  12.  
  13. The two most important features of BigAnim are:
  14.  
  15. o BigAnim loads the animation asynchronously, 100 KByte at a time,
  16.   which means that while it displays one 100 KByte part of the
  17.   animation, it is loading the next 100 KByte.
  18.  
  19. o For speed, BigAnim takes over the display from intuition, but
  20.   only when BigAnim's screen is the frontmost one, and if it
  21.   hasn't been dragged down. This means that you can flip screens
  22.   or pull down BigAnim's screen, but if you do this, BigAnim will
  23.   be forced to use an intuition-friendly method of displaying the
  24.   animation. This method is, of course, slower.
  25.  
  26.  
  27.     Usage
  28.     ~~~~~
  29. BigAnim can only be run from a CLI or shell, and the usage is:
  30.  
  31.     Usage: BigAnim filename [LOADALL]
  32.  
  33. where "filename" should refer to an ANIM type 5 animation.
  34. If you use the switch "LOADALL", BigAnim tries to load the
  35. entire animation into memory.
  36.  
  37.  
  38.     Keys
  39.     ~~~~
  40. While the animation is being played, you can press the following keys:
  41.  
  42. ESC   - Quits BigAnim (also the right mouse button)
  43. Space - Pauses the animation, or restarts if already paused
  44. N     - If paused, displays the next frame
  45. TAB   - Toggles color cycling
  46.  
  47.  
  48.     Additional info
  49.     ~~~~~~~~~~~~~~~
  50. o BigAnim supports CMAP chunks inside the animation, and changes the
  51.   screen colors accordingly. 
  52.  
  53. o BigAnim uses the RelTime field of the ANHD chunk to decide how much
  54.   delay to put between frames.
  55.  
  56. o BigAnim uses an optimized version of the official ANIM type 5
  57.   decompression routines; Run on a 68000, the optimization led to
  58.   a 1.9 second improvement in the "Juggler" test mentioned below.
  59.  
  60.  
  61.     Test results
  62.     ~~~~~~~~~~~~
  63. I have compared BigAnim against the following programs:
  64. RTAP 1.0, PPAnim 1.0b, DPaint 4.0 and ShowANIM v4.30.
  65.  
  66. The tests were performed on an Amiga 500 (1 MB Chip + 2 MB Fast memory),
  67. with an A590 (Quantum LP105S), running Kickstart 2.04.
  68.  
  69. The two test animations are Eric Graham's The Juggler, converted
  70. to ANIM5, and Silencio8.anim, by Alejandro Garza. These two animations
  71. are radically different, Juggler is a ray-traced HAM animation with only
  72. 24 frames while Silencio is a hand-drawn 32 color animation with 365
  73. frames. The DLTA chunks in Juggler are quite large, about 8 KB each,
  74. and the DLTAs in Silencio are small; the mean size is about 1400 bytes.
  75.  
  76. Juggler, 10 loops: (time in seconds)
  77.  
  78. Method           | BigAnim  RTAP   DPaint  PPAnim ShowANIM
  79. -----------------+----------------------------------------
  80. Load-while-play  |  11.1    14.0     N/A     N/A     N/A
  81. Load all         |   9.9    13.2    14.4    14.8    16.1
  82.  
  83. Silencio:
  84.  
  85. Method           | BigAnim  RTAP   DPaint  PPAnim ShowANIM
  86. -----------------+----------------------------------------
  87. Load-while-play  |   8.2     8.6     N/A     N/A     N/A
  88. Load all         |   7.7     8.4    14.7    14.8    15.0
  89.  
  90.  
  91.     Future versions
  92.     ~~~~~~~~~~~~~~~
  93. I am currently working on BigAnim 3.0. It will be rewritten in C, except
  94. for the decompression routines and other time-critical code. This will
  95. mean that I can very easily add more features and options, and it will be
  96. easier for me to find bugs and memory leaks. BigAnim 3.0 will require
  97. Kickstart 2.04, and have support for Kickstart 3.0 and ANIM type 7.
  98. Hopefully I can include support for the AGA chipset as well.
  99.  
  100.  
  101.     Disclaimer
  102.     ~~~~~~~~~~
  103. #include <std/disclaimer.h>
  104.  
  105.  
  106.     Distribution
  107.     ~~~~~~~~~~~~
  108. BigAnim is freely distributable, as long as it is distributed unaltered
  109. and together with this doc file.
  110.  
  111.  
  112.     Feedback
  113.     ~~~~~~~~
  114. If you want to send me suggestions, bug reports, etc, I can
  115. be reached at:
  116.  
  117. Internet:    d8sunch@dtek.chalmers.se
  118.  
  119. Snail-mail:    Christer Sundin
  120.         7321 Bollestad
  121.         S-442 93 Kungälv
  122.         Sweden
  123.  
  124.