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