home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / amiga / animutil / rtap / rtap.lha / RTap.doc next >
Encoding:
Text File  |  1991-10-10  |  4.1 KB  |  88 lines
  1.  
  2.  
  3.  
  4.                                   RTAP 1.0
  5.  
  6.                           A Real Time Anim Player
  7.  
  8.                           ⌐ 1991 Sebastiano Vigna
  9.  
  10.  
  11. RTAP is a very simple ANIM 5 player. It should work with any animation file,
  12. as long as it is a correct ANIM 5 FORM (what can "correct" mean for a mess
  13. like the ANIM specs, I leave you to imagine). It has some very simple
  14. parameters, like the relative timing of the frames and the number of times a
  15. "loopable" animation should be played. RTAP works under both AmigaDOS 1.3
  16. and 2.0.
  17.  
  18. Why "Real Time"? Well, the main property of RTAP (and its reason of
  19. existence) is that it doesn't need the animation to be in RAM in order to
  20. play it. It simply needs two buffer as large as the largest BODY/DLTA chunk
  21. in the ANIM, and that's all. The animation will be loaded while playing it.
  22. Don't expect to see perfectly smooth 16-colors hi-res overscan filled-with-
  23. moving-stuff anims to go smoothly at 30 fps, but on a A3000 25/100 you could
  24. be pleasantly surprised.
  25.  
  26. RTAP does its best in order to use all the concurrency of the Amiga system,
  27. i.e., the Copper, the blitter, the 68000 and possibly the DMA of the device
  28. which contains the ANIM file work together to put the ANIM on the screen.
  29.  
  30. Some compromises had to be done. For instance, RTAP will (gently and
  31. intelligently) poke into copperlists. The overhead for a LoadRGB4() each
  32. frame is absolutely unacceptable. I hope my implementation will survive to
  33. future versions of the OS.
  34.  
  35. The syntax of the command is:
  36.  
  37. RTAP <anim file> [BUFFER <buffer size in K>] [TIMES <number of loops>]
  38.                  [RELTIME <relative timing in video frames>]
  39.                  [PRIORITY <decomp task priority>]
  40.  
  41. The anim file is of course the file you want to see.
  42.  
  43. BUFFER lets you choose a size for the buffer used while loading the ANIM. If
  44. you choose a buffer big enough to load the entire animation, you get
  45. something like a normal ANIM player (the "like" is due to the fact that the
  46. animation will be anyway probably loaded in two steps, and during the second
  47. one the first part of the animation will be displayed).
  48.  
  49. TIMES lets you see an ANIM many times. Note that not all ANIMs are
  50. loopable---the two last frames have to be equal to the first two ones.
  51.  
  52. RELTIME sets the number of video frames which has to pass between each ANIM
  53. frame (if RTAP can keep up, of course). Consider that PAL is 50Hz, NTSC is
  54. 60Hz. So RELTIME 5 is 10fps (frames per second) in PAL but it's 12fps in
  55. NTSC. If no RELTIME is specified (or if you specify RELTIME 0) the timing
  56. data contained in the ANIM will be used. Note that the reltime field of the
  57. AnimHeader struct is specified in 1/60s, so on a PAL machine an animation
  58. will be slower (5/6 of the original speed).
  59.  
  60. PRIORITY sets the priority of the tasks spawned by RTAP (one for the
  61. decompression and one for I/O). Usually they are at priority 10 and 9,
  62. respectively. This value should be carefully chosen depending on the device
  63. you are using. The decompression task will get the priority you specify, the
  64. I/O task will get the same priority minus one. Usually the best thing is a
  65. number equal (▒1) to the priority of the task which manages the device. For
  66. instance, I find 4 is good for floppies (5 causes *horrible* noises). Also,
  67. if you're reading from floppies you should always use FFS and something like
  68. 30 RAM buffers.
  69.  
  70.  
  71. The code for the ANIM 5 decompression is the public domain code by Jim Kent,
  72. slightly modified in order to make it work with the SAS Assembler.
  73.  
  74. This work has been partially supported by DigiMail s.r.l., Milano, Italy.
  75.  
  76. This software is provided "AS IS" without warranty of any kind, either
  77. expressed or implied. By using RTAP, you agree to accept the entire risk as
  78. to the quality and performance of the program. RTAP is ⌐ 1991 Sebastiano
  79. Vigna and it's freely distributable as long as all of its files are included
  80. in their original form without additions, deletions, or modifications of any
  81. kind, and only a nominal fee is charged for its distribution.
  82.  
  83.     Sebastiano Vigna
  84.     BIX: svigna
  85.     UUCP:...{uunet|piramid|rutgers}!cbmvax!cbmehq!cbmita!sebamiga!seba
  86.     Via Valparaiso 18
  87.     I-20144 Milano MI
  88.