home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 13 / AACD13.ISO / AACD / Graphics / TimeMachine / TM_206.readme next >
Text File  |  2000-08-28  |  8KB  |  229 lines

  1. Short:    Layers Animator for ImageFX v3+    
  2. Author:   steve.chapple@mcr1.poptel.org.uk   
  3. Uploader: steve.chapple@mcr1.poptel.org.uk
  4. Type:     gfx/ifx
  5.  
  6. *************************
  7.  
  8. Time Machine v2.06
  9. Steve Chapple 23/8//2000
  10. steve.chapple@mcr1.poptel.org.uk
  11.  
  12. *************************
  13.  
  14. Overview
  15. --------
  16.  
  17. Time Machine can be thought of as "AutoFX on layers" - a
  18. series of stills, sequences, videoclips etc are loaded into
  19. ImageFX as layers, positioned, processed, flattened and
  20. saved.
  21.  
  22. It has the advantage of being able to load images of
  23. different sizes, being able to position layers visually and
  24. does not require video clip style file formats to be broken
  25. down into single frames, or single images to be multiplied
  26. before being combined together.
  27.  
  28.  
  29. Requirements:
  30. -------------
  31.  
  32. ImageFXv3+; lots of RAM and other goodies can't hurt.
  33. The Gui4cli system (included) by Demetris Keletsekis.
  34. (http://users.hol.gr/~dck/gcmain.htm)
  35.  
  36. Installation:
  37. -------------
  38.  
  39. Copy the files Gui and Gui4cli to your c: directory
  40.  
  41. Copy the TimeMachine directory to the root of your ImageFX
  42. directory. (e.g. it should be on the same level as storage,
  43. rexx etc.)
  44.  
  45. Copy the TM_Effects directory to your ImageFX/Rexx directory
  46.  
  47.  
  48. Starting Time Machine:
  49. ----------------------
  50.  
  51. Time Machine is designed to be used from the "windowed" version of ImageFX. 
  52. Please do not attempt to run it from the Classic version.
  53.  
  54. From the "Arexx" button on the main ImageFX panel run the
  55. "Start_TM.ifx" script in the TimeMachine directory.
  56.  
  57. On the title screen you will be asked if you want to start a new
  58. project, or load a TM project from disk. If starting a new project you
  59. will be prompted for the number of frames in the finished project, the
  60. image format for the background layer, and a filename, if appropriate.
  61.  
  62. Image sequences should be defined as a "basename", that is
  63. the filename common to all files, without any frame number
  64. extension. For example, if your sequence is named
  65. effect0001, effect0002 ..... effect1234 enter "effect" as
  66. the basename in the sequence file requester.(Note that
  67. sequences named "effect.0001" should be entered as
  68. "effect.", and currently Time Machine does not recognise
  69. sequences not ending in up to six digits, or not starting at
  70. frame 1. "pic0001.jpg", for example, will not be
  71. recognised).
  72.  
  73. For image sequences, ANIMs, JStreams and Flyerclips you will be
  74. asked which frame you wish to load on frame 1 of your
  75. project.
  76.  
  77. For Anim files and video clip formats there is the option of setting
  78. a "freeze frame" - the frame number specified in the "start frame"
  79. dialogue will be loaded on all frames of the Time Machine project.
  80. Saves having to break apart a file to get at one picture (and I'm
  81. told loads faster with some PPC loader modules than using a single
  82. image).  
  83.  
  84. Due to the way IFX works if you load an ANIM as the background layer
  85. it won't allow any more layers to be loaded, because the background
  86. is a CMAP image. Time Machine catches this (and CMAP still images), 
  87. and won't load the ANIM in the first place. You can load CMAP layers 
  88. on top of an RGB background, however, so quickest work-around is to 
  89. make your background layer a blank frame, and load the ANIM as Layer 1.
  90. (Remember to add a GreytoColor command at the start of any Arexx
  91. scripts on ANIM or CMAP layers to allow use of the full set of IFX commands.)
  92.  
  93. *** I believe that IFX users who have upgraded to version 4.1 will no
  94. longer be able to load ANIM files due to a change in the way that the
  95. ANIM loader works. I hope that this may be rectified in the future. ***
  96.  
  97. ImageFX Controls
  98. ----------------
  99.  
  100. Selecting layers in the Time Machine project is done in the ImageFX layers
  101. palette as usual. When saving ANIM files the render toolbar will be opened,
  102. the colour depth, dithering etc. can be set here. If the settings are not
  103. correct at the prompt cancel rendering, alter the render settings and then
  104. press "Render" on the Time Machine toolbar again.
  105.  
  106.  
  107. Toolbar
  108. -------
  109. Currently Time Machine has three items on the toolbar:
  110.  
  111. Load Layer
  112. Loads a new layer to the project.
  113.  
  114. Render
  115. Start the Time Machine!
  116. Your project will step forward frame by frame, loading the
  117. necessary files into the layer system, setting the saved
  118. layer parameters, processing, and flattening the image for
  119. saving.
  120.  
  121. Quit
  122. Quit Time Machine, and close the current buffer.
  123.  
  124.  
  125. Menus
  126. -----
  127. (Note, the menus will only be visible with the Time Machine
  128. toolbar highlighted)
  129.  
  130. Project/Load
  131. Loads a project from file
  132.  
  133. Project/Save
  134. Save all TM settings for the current project to file
  135.  
  136. Project/Restart
  137. Delete the current project, and reset all saved parameters.
  138. You will be prompted for a new project length, then proceed
  139. adding layers as usual.
  140.  
  141. Layer/Snapshot Position
  142. Save the layer offset for the currently selected layer. Only
  143. one "global" value is currently saved.
  144.  
  145. Layer/Snapshot Blend
  146. As above, but for layer blend
  147.  
  148. Layer/Snapshot Mode
  149. As above, but for layer mode. (This includes whether a layer
  150. is a "mask" layer. If you want to use an image stream as a
  151. mask for the layers above it's currently best to set it as a
  152. mask than try and load it as an alpha channel in a layer)
  153.  
  154. Process/Layer Script
  155. Apply a previously saved Arexx script to the selected layer.
  156. Again, one script per layer is supported. AutoFX scripts should be avoided,
  157. as they use variables set by the AutoFX hook.
  158.  
  159. Process/Post Script
  160. Apply a previously saved Arexx script to the final,
  161. flattened image.
  162.  
  163. Save formats
  164. ------------
  165.  
  166. Sequence: saves a series of 24 bit files with a 4 digit frame
  167. extension (file0001, file0002,.....file9999). You can choose between
  168. standard Amiga ILBM files, or JPEG files with quality of 85 or 50.
  169.  
  170. JStream:  writes a new JStream (you will be prompted for an
  171. existing file to clone compression settings from), or appends to an
  172. existing file.
  173.  
  174. Flyerclip: Well, God knows? Hopefully someone will tell me if it
  175. works!
  176.  
  177. Anim: Anim5/7 anims with or without locked palette.
  178.  
  179.  
  180.  
  181. Warnings and other strangeness:
  182. -------------------------------
  183.  
  184. Do not try and delete layers or try and swap them around: at
  185. the moment TM is not smart enough to realise you've done it!
  186.  
  187. This has the hidden benefit, however, that you can create a new
  188. layer, play about with it so it fits with the currently loaded
  189. layers, save the layer to disk, delete it, then load it back in
  190. through TM's Load Layer button. TM doesn't know you've done any
  191. work on a layer, so there is a little room for experimentation
  192. with scripts and such like. All TM will remember when you press
  193. "Render" is what has been set from the TM menus and toolbar.
  194.  
  195. Thanks and greets
  196. -----------------
  197. Thanks to everyone who has tested TM, especially Don Paul, Ed Vishoot
  198. and Ron Jensen. Big shout to everyone on the IFX mailing list 
  199. (www.egroups.com/group/imagefx). Thanks to Tom and Kermit for
  200. making IFX in the first place. Hello Mum.
  201.  
  202. History
  203. -------
  204. v2.06    Added render frame number tracking to make incremental
  205.     hooks such as clouds work from TM.
  206.     Added some TM_Effects scripts for fire, clouds etc.
  207.  
  208. v2.05    Lots of housekeeping and error trapping. 
  209.     Fixed the Gui4cli console appearing when cancelling a requester.
  210.     Added saving sequences as .jpgs.
  211.  
  212. v2.04    Fixed some foolishness in the load projects script - still
  213.     something odd in saving?
  214.     Added saving projects as ANIM files
  215.  
  216. v2.03    Added Freeze frame option to loading Anim/Jstream/FClip
  217.     files (Don)
  218.     Made default load path the same as IFX prefs. Will now return
  219.     to the last used directory for loading new layers.
  220.     Added trap to prevent loading grey/Cmap buffers on the background.
  221.     Added load/save project function.
  222.  
  223. v2.02    Added saving JStream files, and possibly Flyerclips.
  224.  
  225. v2.01    Added Anim5/7 loading. Actually turned on Flyerclip loading
  226.     at render time.
  227.  
  228. v2.0    First release to interested parties
  229.