home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u513.dms / in.adf / AnimTools / Capture / Capture_doc < prev    next >
Encoding:
Text File  |  1990-06-25  |  7.1 KB  |  164 lines
  1.                             11/11/88
  2.             THE CAPTURE UTILITY
  3.  
  4.     The Capture program is a utility for converting animations from
  5.  virtually any animation file format to the Hash file format.  Due to the
  6. difficulty of obtaining and implementing code for the myriad of
  7. formats in existence, we wrote this utility to actually capture
  8. the frames as they are played by the appropriate player program. 
  9. Once the animation is in the Hash format, you can use
  10. Animation:Editor to convert it to ANIM, IFF pictures, or use the
  11. animation in any way you see fit.  Also, by converting these
  12. animations to the Hash format, you can use them in other Hash
  13. Animation: products like Animation:Multiplane, and
  14. Animation:Rotoscope.
  15.  
  16.     Capture requires at least enough RAM to play the animation
  17. and pack the frames (1 Meg minimum) and two disk drives (or a
  18. hard disk).
  19.  
  20.     If you just want to convert an ANIM file to a Hash packed
  21. file, use the Converter in Animation:Editor, it is MUCH easier to use
  22. Animation:Editor for this application.
  23.  
  24.     Capture takes full advantage of the Amiga's multitasking
  25. abilities and must be 'RUN' from the CLI.  Make sure you type
  26. 'RUN Capture'.  The Capture control screen will now appear. 
  27.  
  28.     To do its magic, Capture needs to know the resolution of the
  29. source animation.  The Capture task will wait until a screen in
  30. that resolution is displayed, and save it and all subsequent
  31. screens with that resolution.
  32.  
  33.  
  34.             FINDING THE RESOLUTION
  35.  
  36.     If you already know the resolution of the animation you want
  37. to capture, simply enter the width, height, and depth in the
  38. Resolution string gadgets at the upper left of the control
  39. screen.  If you don't know the resolution, Capture can find it
  40. for you.  But, this is a multi-step process, so it's worthwhile
  41. to know the resolution beforehand.
  42.  
  43.     To find the resolution of an animation, click the FindRes
  44. button.   You have two options at this point.  You can get the
  45. resolution directly from the file, or by playing the animation
  46. and getting the resolution from the screen.  The File option
  47. should be used with Byte-by-Byte's MOVIE format and any future
  48. format similar to ANIM.  Enter the animation filename when the
  49. File Requester appears.  If the File option is successful,
  50. Capture will also count the number of frames in the animation. 
  51. When the operation is finished, the appropriate values will be
  52. placed in the string gadgets on the Capture control panel.
  53.  
  54.     The FindRes Screen option should be used for mysterious non-
  55. ANIM formats (like Turbo Silver, RIFF, Forms-in-FlightII etc). 
  56. After selecting the Screen option, you will be asked if you are
  57. ready to play your animation.  This is your chance to abort the
  58. operation.  
  59.  
  60.     If you choose to procede, the Capture window will shrink,
  61. and you will see the CLI again.  Wait for the 'Exit Command OK'
  62. message to appear in the CLI. 
  63.  
  64.     Now insert your animation disk in another drive, and 'RUN' your
  65. player program.  Be sure you type 'RUN', remember Capture is a
  66. multitaking utility and must interact with the player.  Some
  67. players may require a larger stack to run properly.  So use the
  68. Stack command to set the stack.  The MOVIE player required Stack
  69. 16000, and the Fast_Flight_2 player requires Stack 25000.  Make
  70. sure you do this BEFORE you run the player.  Your animation
  71. should load and play.  After the animation has played a few
  72. times, exit the player.  Now resize the Capture window so that
  73. all of the gadgets are displayed.  You will see the values that
  74. the program found, in the Resolution panel.  
  75.  
  76.  
  77.         SETTING START FRAME AND CAPTURE LENGTH
  78.  
  79.     After setting the resolution, you now need to specify the
  80. start frame, and the number of frames you wish to capture.  The 
  81. default start frame is 3.  This may sound unusual at first, but
  82. the first few frames my be blank screens.  This value depends
  83. mainly on the player program.  MOVIE requires a starting frame of
  84. 4.  You may want to experiment with this value and determine
  85. which value works best with the respective players.  If you miss
  86. the first few frames by making the start value too large, you can
  87. capture them as the animation loops back to the beginning.  You
  88. can always re-arrange the frames later with Animation:Editor.
  89.  
  90.     You also need to set the frame length, i.e. the number of
  91. frames you want to capture.  The default value for frame length
  92. is 10.  If the animation is in the MOVIE format and you use the
  93. FindRes File option, this value will be set for you.  Otherwise,
  94. you will need to estimate the number of frames you will need.  If
  95. the player program allows single stepping, or slow playback, you
  96. may be able to count the frames. 
  97.  
  98.     If you choose a number for the frame length that is too
  99. small.  You can go back capture the remaining frames by changing
  100. the start frame to the next frame you want to capture, and
  101. linking the two output animations together with Animation:Editor. 
  102. Or you could set the start frame to the second to last frame
  103. captured, and use the -m (multiple file) option in Display
  104. (Version 3.24 or greater).
  105.  
  106.  
  107.             CAPTURING THE ANIMATION
  108.  
  109.     Now that you have selected the resolution, the start frame,
  110. and the number of frames to capture, you need to select the
  111. destination path and filename of your Hash packed file.  To do
  112. this, simply click on the Set Path button.  The File Requestor
  113. will appear, and you may select your destination path.  Insert
  114. your destination disk in the disk drive that is occupied by
  115. the Capture disk (or use RAD:, VD0:, DH0:, etc.).  Do NOT store the
  116. animation to RAM:, or Capture will fail.
  117.  
  118.     You are now ready to Capture the animation.  The process is
  119. very similar to using the FindRes Screen option.  You will use
  120. the appropriate player program to play the animation, and the
  121. Capture program will freeze each frame and store it in the
  122. destination file.
  123.  
  124.     Make sure your Capture disk is inserted in one drive, and
  125. your animation source (with player) disk is inserted in another drive.
  126.  
  127.     Now, click the Capture button.  You will now be given a
  128. chance to abort this operation.
  129.  
  130.     The Capture disk will now run for a moment, the Capture
  131. window will shrink and some help text will be printed in the CLI.
  132.  
  133.     Wait for the 'Exit Command OK' message to appear in the CLI. 
  134. Replace the Capture disk with your destination disk.  Now, 'RUN'
  135. your animation player (be sure to type RUN, and make sure you set
  136. the stack size).  Your animation will load, and you each frame
  137. will hold while it is being saved to your destination disk.  This
  138. process will continue until the frame length number has been
  139. reached.  Then the animation will play back at normal speed.
  140.  
  141.     You may now exit your player.     Re-insert the Capture disk
  142. and resize the Capture window.  
  143.  
  144.     If you wish to capture more animations, click the STOP
  145. Gadget to stop capturing  to the Destination file.  You may now repeat the
  146. above steps to capture more animations.
  147.  
  148.     If you want to exit the Capture program, click the QUIT
  149. Gadget to close the Destination file, and exit.
  150.  
  151.     That's all there is to it.  It takes a little practice, but
  152. it is worth it.  With this utility, you can break the animation
  153. format barrier.   
  154.  
  155. ---------
  156. The Capture utility is Copyrighted (c) by Martin D. Hash and Kenneth A. Baer.
  157.  
  158. Capture consists of three files:
  159.     Capture
  160.     Command
  161.     CaptureTask
  162. These files should remain in the same directory, and Capture should be run
  163. from that directory.
  164.