home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1995 November / PCWK1195.iso / inne / dos / fraktale / fracxtr6.exe / OTHER / FA100.ZIP / FA.TXT < prev    next >
Text File  |  1994-07-21  |  15KB  |  318 lines
  1. ┌─────┐ ┌──────┐ ┌──────┐ ┌─────┐ ┌─────┐ ┌──────┐ ┌─┐
  2. │ ┌───┘ │ ┌──┐ │ │ ┌──┐ │ │ ┌─┐ │ └─┐ ┌─┘ │ ┌──┐ │ │ │     ■ Version 1.0
  3. │ └─┐   │ └──┘ │ │ └──┘ │ │ │ └─┘   │ │   │ └──┘ │ │ │
  4. │ ┌─┘   │ ┌─┐ ┌┘ │ ┌──┐ │ │ │ ┌─┐   │ │   │ ┌──┐ │ │ │     ■ Copyright 1994
  5. │ │     │ │ │ └┐ │ │  │ │ │ └─┘ │   │ │   │ │  │ │ │ └──┐    Brian Towles
  6. └─┘     └─┘ └──┘ └─┘  └─┘ └─────┘   └─┘   └─┘  └─┘ └────┘
  7. ┌──────┐ ┌───┐  ┌─┐ ┌───┐ ┌───────┐ ┌──────┐ ┌─────┐ ┌──────┐ ┌──────┐
  8. │ ┌──┐ │ │   └┐ │ │ └┐ ┌┘ │ ┌┐ ┌┐ │ │ ┌──┐ │ └─┐ ┌─┘ │ ┌──┐ │ │ ┌──┐ │
  9. │ └──┘ │ │ ┌┐ └┐│ │  │ │  │ ││ ││ │ │ └──┘ │   │ │   │ │  │ │ │ └──┘ │
  10. │ ┌──┐ │ │ │└┐ └┘ │  │ │  │ │└─┘│ │ │ ┌──┐ │   │ │   │ │  │ │ │ ┌─┐ ┌┘
  11. │ │  │ │ │ │ └┐   │ ┌┘ └┐ │ │   │ │ │ │  │ │   │ │   │ └──┘ │ │ │ │ └┐
  12. └─┘  └─┘ └─┘  └───┘ └───┘ └─┘   └─┘ └─┘  └─┘   └─┘   └──────┘ └─┘ └──┘
  13.  
  14. Fractal Animator is a flexible command-line tool to be used in conjunction 
  15. with Fractint to create fractal animations with ease.
  16.  
  17. ««« TABLE OF CONTENTS »»»
  18.  
  19. - IDEAS BEHIND FRACTAL ANIMATOR
  20. - BASIC USES OF FRACTAL ANIMATOR
  21. - ADVANCED FEATURES OF FRACTAL ANIMATOR
  22. - OTHER FEATURES OF FRACTAL ANIMATOR
  23. - EXAMPLE COMMAND LINES
  24. - A FEW COMMON QUESTIONS
  25. - THANKS
  26. - LEGAL JAZZ AND MONEY
  27.  
  28.  
  29. ««« IDEAS BEHIND FRACTAL ANIMATOR »»»
  30.  
  31. The whole idea for Fractal Animator originated when I needed to created a 
  32. series of single images,  using Fractint, and capture them frame-by-frame 
  33. to video tape.  I had a few zooming utilities for Fractint, but their 
  34. output was basically useless.  So I wrote small C programs to make giant 
  35. batch files to control Fractint via the command line, which worked well, 
  36. but it was somewhat complex.  So I've simplified all the things that I've 
  37. learned about fractal animation into a rather easy to use command line 
  38. tool.  Fractal Animator solves these problems presented by other zooming 
  39. utilities I've seen:
  40.  
  41. - The command line length is limited from a batch file because of DOS, so 
  42. image information is stored in Fractint .PAR files, for greater precision
  43. and more options
  44.  
  45. - A substitute for the linear zooming formula, which creates a slow to fast 
  46. zoom speed; the Fractal Animator's "power" formula creates a smooth zoom, and 
  47. keeps the aspect ratio in tact
  48.  
  49. - Multiple input and output options, for real control of what is written to 
  50. the .PAR files
  51.  
  52. - Many helpful functions are provided: zooming, panning, rotation, .GIF 
  53. input, parameter functions, .MAP file input, palette transition, and 
  54. additional .PAR file input for custom animations
  55.  
  56.  
  57. ««« BASIC USES OF FRACTAL ANIMATOR »»»
  58.  
  59. To use any of the functions of this program well, it is important that one 
  60. basically understands the workings of Fractint, having to do with video 
  61. mode, parameters, saving files, .PAR files, and some other important 
  62. aspects of it.  Any animation created by Fractal Animator will create a 
  63. number of files: a .BAT file which controls the entire animation and is 
  64. executed by the user to start the animation and a .PAR file which contains 
  65. information about the individual images.  Sometimes Fractal Animator will 
  66. also create .MAP file(s) which are used to control the palette for every 
  67. image.  All of these files are vital in the creation of the animation and 
  68. should be copied into the Fractint directory before trying to render the
  69. frames.
  70.  
  71. Zoom-In & Pan: A zoom-in magnifies a small part of a fractal image, and the 
  72. a is simply a movement across (translation) the fractal image.  For the 
  73. simplest applications of the program, you only need to have the initial and 
  74. final corners of the fractal you wish to zoom into. The default fractal is 
  75. the mandelbrot set, but this can be changed with a command line argument. 
  76. The /i switch means initial corners in the form xmin, xmax, ymin, ymax; and 
  77. the /f switch accepts the same format for the final corners.  So the 
  78. command line would end up similar to this:
  79.  
  80. FA /i-2.5,1.5,-1.5,-1.5 /f-2,-1.6,-0.15,0.15
  81.  
  82. The two files created from Fractal Animator are ANIM.PAR and ANIM.BAT.  If 
  83. those files are copied to your Fractint directory, typing "ANIM (Enter)" 
  84. will create your first animation!  Link these images together with a .FLI 
  85. animation program to view a smooth zoom-in.
  86.  
  87. ** A zoom-in is seen when the length of the sides is decreasing (in the 
  88. previous example from 4 and 3 to .4 and .3) and a pan is seen when there is 
  89. a different center point for the viewing windows (from -.5,0 to -1.8,0).  
  90. Also notice that the aspect ratio between the side lengths is constant 
  91. (4:3).
  92.  
  93. Zoom-Out & Pan:  A zoom-out is the opposite of the zoom-in, so the 
  94. following command line will create a simple zoom-out, which also pans:
  95.  
  96. FA /i-2,-1.6,-0.15,0.15 /f-2.5,1.5,-1.5,-1.5
  97.  
  98. Also, the coordinates of the corners of a fractal image get bulky (over ten 
  99. significant figures) so fractal parameters can also be passed through .GIF 
  100. files created by Fractint.  An example would be:
  101.  
  102. FA /igFRACT001.GIF /fgFRACT002.GIF
  103.  
  104. The /ig and /fg switches mean initial and final input will come from a .GIF 
  105. file.  FRACT001.GIF is the initial image and Fractal Animator will create 
  106. the transition between it and FRACT002.GIF automatically.
  107.  
  108. Fractal Parameter Control:  Fractal Animator also allows control of up to 
  109. ten fractal parameters used by Fractint.  From this another basic form of 
  110. fractal animation emerges.  Changing the parameters of a fractal can also 
  111. create a pleasing animation.  The following is a simple parameter control 
  112. animation:
  113.  
  114. FA /i-2.5,1.5,-1.5,1.5 /0:cos(2*p*x) /1:sin(2*p*x)
  115.  
  116. The /0 through /9 switches tell Fractal Animator the parameter to vary, as 
  117. well as the function used to vary it.  The first function is a simple 
  118. cosine, in which the symbol p represents pi and x is the fraction of the 
  119. current frame number over the total number of frames.   As expected these 
  120. two functions created a circle motion in the fractal images when animated.  
  121.  
  122. Functions and constants supported by Fractal Animator are: +, -, *, /, 
  123. ^(power), cos, sin, tan, e, and p(pi).  Constant values are also acceptable 
  124. arguments.  The function evaluator in Fractal Animator isn't forgiving, 
  125. which will be improved in later versions.  Here are the basic rules: no 
  126. implied multiplication: ex. 3x+3, no spaces: ex. 5 + x won't work as a 
  127. function, and all trig functions are followed by a set of parathesis: ex. 
  128. sin(x).  All parameters are declared by putting the switch and parameter 
  129. number (ex. /4), followed by a colon(:), and then the parameter function.  
  130. The only variable is x, which is always the ratio of the current frame over 
  131. the total number of frames.
  132.  
  133. With these simple commands you can create interesting fractal animations, 
  134. but Fractal Animator also has an array of other options.
  135.  
  136.  
  137. ««« ADVANCED FEATURES OF FRACTAL ANIMATOR »»»
  138.  
  139. Rotation:  With the /r and /k switches the user can control the direction 
  140. of image rotation.  The /r switch can be followed by a + or - for clockwise 
  141. or counterclockwise rotation respectively (default is counterclockwise).  
  142. The /k switch followed by a number tells the number of whole rotations to 
  143. perform during the animation.  The /ri and /rf switches followed by a angle 
  144. in degrees can be used to set initial and final image rotation angles, and 
  145. Fractal Animator also accepts rotated images and coordinates from Fractint.  
  146. Using these effects together can create amazing output.
  147.  
  148. Palette Control:  With the /im and /fm input options the user can tell 
  149. Fractal Animator to load .MAP palette files for the initial and final 
  150. images, and Fractal Animator will automatically create a new .MAP file for 
  151. every frame, making a smooth transition between the two palettes.  Palettes 
  152. are also extracted from .GIF input files and the same transition is created 
  153. between those palettes.
  154.  
  155.  
  156. ««« OTHER FEATURES OF FRACTAL ANIMATOR »»»
  157.  
  158. Number of Frames:  The /s switch is followed by the number of frames to be 
  159. used in the current animation (default value is 30).
  160.  
  161. Zoom and Panning Formulas:  The /z and /m switches followed by a l, p, or i 
  162. sets the method used to calculated the steps for zooming and panning 
  163. respectively.  The l stands for linear, which seems to be the standard 
  164. zooming formula, but this creates problems in zoom speed (explained later).  
  165. The p is for power, which means the size of the steps between calculations 
  166. gets smaller as the current frame increases, creating a smooth zoom-in.  
  167. The i, is simply the inverse-power, which is useful for thinks such as 
  168. zooming-out (default is l for both panning and zooming).
  169.  
  170. Excluding Last Frame:  The /x or exclude last frame switch is useful when 
  171. linking together an animation in which the last .GIF image of one animation 
  172. is the first of the following - one would not want that frame to appear 
  173. twice.  So with this switch the final frame is left out of the animation, 
  174. and another frame is added between the initial and final frames, so that 
  175. the same number of frames are generated as without the switch (not 
  176. default).
  177.  
  178. Fractint Video Mode:  The Fractint video mode is given with the /v switch 
  179. (default is F3, which is 320x200x256).
  180.  
  181. Fractint Fractal Name:  The name of the type of fractal used is preceded by 
  182. the /t switch in the animation as defined by Fractint (default is mandel).
  183.  
  184. Additional .PAR Info:  The /a switch followed by text, will insert that 
  185. text into every .PAR file module created.
  186.  
  187. Command Line File:  The /c switch can be followed by a filename of a file 
  188. that contains extra command-line info (sometimes the DOS command line is 
  189. too small).  The file must be a text file, with each line containing a new 
  190. switch for Fractal Animator.
  191.  
  192. Output File Control:  The names of the output files can be controlled with 
  193. the /b, /p, and /m switches.  Following the /b and /p switches are the full 
  194. filenames of the .BAT and .PAR files respectively.  Following the /m switch 
  195. is up to five letters, which serve as the prefix of the map files (ex. 
  196. /mfract, will create this map fract000.map for the first frame).
  197.  
  198.  
  199. ««« EXAMPLE COMMAND LINES »»»
  200.  
  201. Here are some command lines with basic techniques:
  202.  
  203. To create a spiraling zoom-in (FRACT001.GIF is zoomed out):
  204.  
  205.     FA /igFRACT001.GIF /fgFRACTA002.GIF /zp /yp /k4
  206.  
  207. To create a swirling effect:
  208.     
  209.     FA /igFRACT001.GIF /0:2*sin(x*2*p) /1:2*cos(x*2*p)
  210.  
  211. To link three frames into one animation:
  212.  
  213.     FA /igFRACT001.GIF /fgFRACT002.GIF /x /panim1.par /banim1.bat /manim1
  214.  
  215.     and then:
  216.  
  217.     FA /igFRACT002.GIF /fgFRACT003.GIF /panim2.par /banim2.bat /manim2
  218.  
  219. To use a command-line file:
  220.  
  221.     FA /canimate.fa
  222.  
  223.     The animate.fa file:
  224.  
  225.     // animate.fa - a simple fractal animation
  226.     /igFRACT001.GIF
  227.     /fgFRACT002.GIF
  228.     /zp
  229.  
  230.  
  231. ««« A FEW COMMON QUESTIONS »»»
  232.  
  233. Q: Why do the frames seem to be random, and unrelated?
  234. A: Your trying to cover to much ground.  Try adding more steps, changing 
  235. the zoom or pan formula, moving the frames closer together, or lessening 
  236. the magnitude of parameter functions.
  237.  
  238. Q: How do a test an animation to see if it is what I wanted?
  239. A: Simply load the .PAR file created by Fractal Animator into Fractint, and 
  240. view a couple of single frames (type @ from the main menu and then press
  241. F6 to load a new .PAR file).
  242.  
  243. Q: Why do frames begin shutter or wiggle when animated?
  244. A: You are zoomed in past the precision of Fractint (try float=yes) or 
  245. parameter functions need to be smoothed or lessened in magnitude.
  246.  
  247. Q: Why does Fractal Animator tell me the .GIF I tried to use as input does 
  248. not have an application extension block?
  249. A: Make sure any .GIF is completely drawn before you save it, otherwise 
  250. Fractal Animator cannot use it.  For really slow fractals render them at a 
  251. very low resolution and change the video mode with the /v option.
  252.  
  253. Q: I made a long animation, and some frames are blacked out, or half 
  254. filled, why?
  255. A: I have found this to be a puzzling problem, but basically isolated it to 
  256. Fractint not saving the .GIF correctly.  What is really odd is that if you 
  257. load the half-image into Fractint, redraw it, and save it again it will 
  258. save properly, and this is the only way I know to fix this puzzlin' 
  259. problem.
  260.  
  261. Q: Why don't formula fractals (from .FRM files) work when loaded from a .GIF 
  262. file?
  263. A: Fractal Animator version 1.0 doesn't detect all the nessary formula 
  264. information needed to create the .PAR file, so this information must be
  265. included with the /a switch.
  266.  
  267. About recording animations:
  268.  
  269. Putting fractal animations on videotape can create INCREDIBLE results - you 
  270. can use high resolutions (640x480, is what I've used in the past), with a 
  271. constant speed of 30 fps.  This operation requires a number of different
  272. tools to successfully complete: a VCR with a serial interface (major cash),
  273. a program written to control the VCR (beyond expensive, if purchased), a
  274. VGA to NTSC/S-VHS converter (cheapest, but still expensive), and also an
  275. RS-232 to RS-422 converter for many high-end VCRs.  The scheme I used was 
  276. to create a batch file that first displayed a .GIF on the screen, then a 
  277. command-line program was called to record a single frame onto tape.  With
  278. a shortened pre-roll, and a good VCR, you can record five to six frames per
  279. minute . . . the resutls are well worth the wait!
  280.  
  281.  
  282. ««« THANKS »»»
  283.  
  284. Thanks to Fractint, for which my entire program is based on.  Thanks to 
  285. Borland and their C compilers.  Thank you for at least reading this far in 
  286. this documentation (this is my first documentation file, so bare with me.  
  287. I've also been known to misspell three letter words).
  288.  
  289.  
  290. ««« LEGAL JAZZ AND MONEY »»»
  291.  
  292. Disclaimer: This program was designed to help people get into fractal 
  293. animation, thus the name of the program.  I take no responsibility for what 
  294. the program does, so use Fractal Animator at your own risk.
  295.  
  296. Distribution:  This program claims to be Shareware, so feel free to 
  297. distribute it as you will, but for no charge.  Do not bundle it with other 
  298. products, and distribute it in original form (with all files: FA.EXE, 
  299. FA.TXT, and the example files).  If you are one of those Shareware Houses
  300. or want to distribute this program for a small charge, you must first 
  301. contact me in person and get my okay, before doing so.
  302.  
  303. And Finally Money and Support:  I would greatly appreciate any donations 
  304. for the use of this program (about $20 dollars is good, or whatever you 
  305. deem enough).  A lot of work went into planning this program and trying to 
  306. make it as comprehensive as possible.  I am possibly planning a Windows 
  307. version of this program, with features such as a preview mode, to get the 
  308. feel of what the animation will look like.  This all depends on your 
  309. response, so at least try to write.  If you write with any technical 
  310. questions or bugs, I'll try to respond.  I also have an Internet address  
  311. most of the year, I'm willing to give that out, too.  
  312.  
  313. Thanks:
  314.  
  315. Brian Towles 
  316. 8109 Running Cedar Trail
  317. Raleigh, NC 27615
  318.