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