home *** CD-ROM | disk | FTP | other *** search
/ Photo CD Demo 1 / Demo.bin / fractint / fras1611.zip / HELP3.SRC < prev    next >
Text File  |  1991-07-21  |  64KB  |  1,354 lines

  1. ~Topic=Doodads\, Bells\, and Whistles
  2.  
  3. ~Format-
  4.    { Drawing Method }
  5.    { Autokey Mode }
  6.    { Distance Estimator Method }
  7.    { Inversion }
  8.    { Decomposition }
  9.    { Logarithmic Palettes and Color Ranges }
  10.    { Biomorphs }
  11.    { Continuous Potential }
  12.    { Starfields }
  13. ~Format+
  14. ;
  15. ;
  16. ;
  17. ~Topic=Drawing Method
  18.  
  19. The "passes option" (<X> options screen or "passes=" parameter)
  20. selects single-pass, dual-pass, or solid-guessing
  21. (default) mode.  This option applies to most fractal types.
  22.  
  23. Single-pass mode ("1") draws the screen pixel by pixel.
  24.  
  25. Dual-pass ("2") generates a "coarse" screen first as a preview
  26. using 2x2-pixel boxes, and then generates the rest of the dots with a
  27. second pass.
  28.  
  29. Solid-guessing ("g") is the default.  It performs from two to four
  30. visible passes -
  31. more in higher resolution video modes. Its first visible pass is
  32. actually two passes - one pixel per 4x4, 8x8, or 16x16 pixel box
  33. is generated, and the guessing logic is
  34. applied to fill in the blocks at the next level (2x2, 4x4, or 8x8).
  35. Subsequent passes fill in the display at the next finer resolution,
  36. skipping blocks which are surrounded by the same color. Solid-guessing can
  37. guess wrong, but it sure guesses quickly!
  38.  
  39. Boundary Tracing ("b"), which only
  40. works with fractal types (such as the Mandelbrot set, but not the Newton
  41. type) that do not contain "islands" of colors, finds a color "boundary",
  42. traces it around the screen, and then "blits" in the color over the
  43. enclosed area.\
  44. ;
  45. ;
  46. ;
  47. ~Topic=Autokey Mode
  48.  
  49. The autokey feature allows you to set up beautiful self-running demo
  50. "loops". You can set up hypnotic sequences to attract people to a booth,
  51. to generate sequences for special effects, to teach how Fractal exploring
  52. is done, etc.
  53.  
  54. A sample autokey file (DEMO.KEY) and a batch to run it (DEMO.BAT) are
  55. included with Fractint. Type "demo" at the DOS prompt to run it.
  56.  
  57. Autokey record mode is enabled with the command line parameter
  58. "AUTOKEY=RECORD". Keystrokes are saved in an intelligible text format in a
  59. file called AUTO.KEY. You can change the file name with the "AUTOKEYNAME="
  60. parameter.
  61.  
  62. Playback is enabled with the parameter "AUTOKEY=PLAY". Playback can be
  63. terminated by pressing the <Esc> key.
  64.  
  65. After using record mode to capture an autokey file, you'll probably want
  66. to touch it up using your editor before playing it back.
  67.  
  68. Separate lines are not necessary but you'll probably find it
  69. easier to understand an autokey file if you put each command on a separate
  70. line. Autokey files can contain the following:
  71.  
  72.   Quoted strings. Fractint reads whatever is between the quotes just as if
  73.   you had typed it. For example,
  74.       "t" "ifs"
  75.   issues the "t" (type) command and then enters the letters i", "f", and
  76.   "s" to select the ifs type.
  77.  
  78.   Symbols for function keys used to select a video mode. Examples:\
  79.       F3  -- Function key 3\
  80.       SF3 --<Shift> and <F3> together\
  81.  
  82.   Special keys: ENTER ESC F1 PAGEUP PAGEDOWN HOME END LEFT RIGHT UP DOWN
  83.   INSERT DELETE TAB
  84.  
  85.   WAIT <nnn.n> -- wait nnn.n seconds before continuing
  86.  
  87.   CALCWAIT -- pause until the current fractal calculation or file save or
  88.   restore is finished. This command makes demo files more robust since
  89.   calculation times depend on the  speed of the machine running the demo -
  90.   a "WAIT 10" command may allow enough time to complete a fractal on one
  91.   machine, but not on another. The record mode does not generate this
  92.   command - it should be added by hand to the autokey file whenever there
  93.   is a process that should be allowed to run to completion.
  94.  
  95.   GOTO target -- The autokey file continues to be read from the label
  96.   "target". The label can be any word that does not duplicate a key word.
  97.   It must be present somewhere in the autokey file with a colon after it.
  98.   Example:\
  99.       MESSAGE 2 This is executed once\
  100.       start:\
  101.       MESSAGE 2 This is executed repeatedly\
  102.       GOTO start\
  103.   GOTO is mainly useful for writing continuous loop demonstrations. It can
  104.   also be useful when debugging an autokey file, to skip sections of it.
  105.  
  106.   ; -- A semi-colon indicates that the rest of the line containing it is a
  107.   comment.
  108.  
  109.   MESSAGE nn <Your message here> -- Places a message on the top of the
  110.   screen for nn seconds
  111.  
  112. Making Fractint demos can be tricky. Here are some suggestions which may
  113. help:
  114.  
  115.   Start Fractint with "fractint autokeyname=mydemo.key autokey=record".
  116.   Use a unique name each time you run so that you don't overwrite prior
  117.   files.
  118.  
  119.   When in record mode, avoid using the cursor keys to select filenames,
  120.   fractal types, formula names, etc. Instead, try to type in names. This
  121.   will ensure that the exact item you want gets chosen during playback
  122.   even if the list is different then.
  123.  
  124.   Beware of video mode assumptions. It is safest to build a separate demo
  125.   for different resolution monitors.
  126.  
  127.   When in the record mode, try to type names quickly, then pause. If you
  128.   pause partway through a name Fractint will break up the string in the
  129.   .KEY file. E.g. if you paused in the middle of typing fract001, you
  130.   might get:\
  131.       "fract"\
  132.       WAIT 2.2\
  133.       "001"\
  134.   No harm done, but messy to clean up. Fractint ignores pauses
  135.   less than about 1/2 second.
  136.  
  137.   DO pause when you want the viewer to see what is happening during
  138.   playback.
  139.  
  140.   When done recording, clean up your mydemo.key file. Insert a CALCWAIT
  141.   after each keystroke which triggers something that takes a variable
  142.   amount of time (calculating a fractal, restoring a file, saving a file).
  143.  
  144.   Add comments with ";" to the file so you know what is going on in
  145.   future.
  146.  
  147.   It is a good idea to use INSERT before a GOTO which restarts the demo.
  148.   The <insert> key resets Fractint as if you exited the program and
  149.   restarted it.
  150.  
  151. Warning: an autokey file built for this version of Fractint will probably
  152. require some retouching before it works with future releases of Fractint.
  153. We have no intention of making sure that the same sequence of keystrokes
  154. will have exactly the same effect from one version of Fractint to the
  155. next. That would require pretty much freezing Fractint development, and we
  156. just love to keep enhancing it!
  157. ;
  158. ;
  159. ;
  160. ~Topic=Distance Estimator Method
  161.  
  162. This is Phil Wilson's implementation of an alternate method for the M and
  163. J sets, based on work by mathematician John Milnor and described in "The
  164. Science of Fractal Images", p. 198.  While it can take full advantage of
  165. your color palette, one of the best uses is in preparing monochrome images
  166. for a printer.    Using the 1600x1200x2 disk-video mode and an HP LaserJet,
  167. we have produced pictures of quality equivalent to the black and white
  168. illustrations of the M-set in "The Beauty of Fractals."
  169.  
  170. The distance estimator method widens very thin "strands" which are part of
  171. the "inside" of the set.  Instead of hiding invisibly between pixels,
  172. these strands are made one pixel wide.
  173.  
  174. Though this option is available with any escape time fractal type, the
  175. formula used is specific to the mandel and julia types - for most other
  176. types it doesn't do a great job.
  177.  
  178. To turn on the distance estimator method with any escape time  fractal
  179. type, set the "Distance Estimator" value on the <Y> options screen (or use
  180. the "distest=" command line parameter).
  181.  
  182. Setting the distance estimator option to a negative value -nnn enables
  183. edge-tracing mode.  The edge of the set is display as color number nnn.
  184. This option works best when the "inside" and "outside" color values are
  185. also set to some other value(s).
  186.  
  187. In a 2 color (monochrome) mode, setting to any positive value results in
  188. the inside of the set being expanded to include edge points, and the
  189. outside points being displayed in the other color.
  190.  
  191. In color modes, setting to value 1 causes the edge points to be displayed
  192. using the inside color and the outside points to be displayed in their
  193. usual colors.  Setting to a value greater than one causes the outside
  194. points to be displayed as contours, colored according to their distance
  195. from the inside of the set.  Use a higher value for narrower color bands,
  196. a lower value for wider ones.  1000 is a good value to start with.
  197.  
  198. The second distance estimator parameter ("width factor") sets the distance
  199. from the inside of the set which is to be considered as part of the
  200. inside.  This value is expressed as a percentage of a pixel width, the
  201. default is 71.
  202.  
  203. You should use 1 or 2 pass mode with the distance estimator method, to
  204. avoid missing some of the thin strands made visible by it.  For the
  205. highest quality, "maxiter" should also be set to a high value, say 1000 or
  206. so.  You'll probably also want "inside" set to zero, to get a black
  207. interior.
  208.  
  209. Enabling the distance estimator method automatically toggles to floating
  210. point mode. When you reset distest back to zero, remember to also turn off
  211. floating point mode if you want it off.
  212.  
  213. Unfortunately, images using the distance estimator method can take many
  214. hours to calculate even on a fast machine with a coprocessor, especially
  215. if a high "maxiter" value is used.  One way of dealing with this is to
  216. leave it turned off while you find and frame an image.    Then hit <B> to
  217. save the current image information in a parameter file
  218. (see {Parameter Save/Restore Commands}).  Use an editor to change the parameter
  219. file entry, adding "distest=1", "video=something" to select a high-
  220. resolution monochrome disk-video mode, "maxiter=1000", and "inside=0". Run
  221. the parameter file entry with the <@> command when you won't be needing
  222. your machine for a while (over the weekend?)
  223. ;
  224. ;
  225. ;
  226. ~Topic=Inversion
  227.  
  228. Many years ago there was a brief craze for "anamorphic art": images
  229. painted and viewed with the use of a cylindrical mirror, so that  they
  230. looked weirdly distorted on the canvas but correct in the distorted
  231. reflection. (This byway of art history may be a useful defense when your
  232. friends and family give you odd looks for staring at fractal images color-
  233. cycling on a CRT.)
  234.  
  235. The Inversion option performs a related transformation on most of the
  236. fractal types. You define the center point and radius of a circle;
  237. Fractint maps each point inside the circle to a corresponding point
  238. outside, and vice-versa. This is known to mathematicians as inverting (or
  239. if you want to get precise, "everting") the plane, and is something they
  240. can contemplate without getting a headache. John Milnor (also mentioned
  241. in connection with the {Distance Estimator Method}), made his name in the
  242. 1950s with a method for everting a seven-dimensional sphere, so we have a
  243. lot of catching up to do.
  244.  
  245. For example, if a point inside the circle is 1/3 of the way from the
  246. center to the radius, it is mapped to a point along the same radial line,
  247. but at a distance of (3 * radius) from the origin. An outside point at 4
  248. times the radius is mapped inside at 1/4 the radius.
  249.  
  250. The inversion parameters on the <Y> options screen allow entry of the
  251. radius and center coordinates of the inversion circle. A default choice of
  252. -1 sets the radius at 1/6 the smaller dimension of the image currently on
  253. the screen.  The default values for Xcenter and Ycenter use the
  254. coordinates currently mapped to the center of the screen.
  255.  
  256. Try this one out with a {=HT_NEWT Newton} plot, so its radial "spokes"
  257. will give you
  258. something to hang on to. Plot a Newton-method image, then set the
  259. inversion radius to 1, with default center coordinates. The center
  260. "explodes" to the periphery.
  261.  
  262. Inverting through a circle not centered on the origin produces bizarre
  263. effects that we're not even going to try to describe. Aren't computers
  264. wonderful?
  265. ;
  266. ;
  267. ;
  268. ~Topic=Decomposition
  269.  
  270. You'll remember that most fractal types are calculated by iterating a
  271. simple function of a complex number, producing another complex number,
  272. until either the number exceeds some pre-defined "bailout" value, or the
  273. iteration limit is reached. The pixel corresponding to the starting point
  274. is then colored based on the result of that calculation.
  275.  
  276. The decomposition option ("decomp=", on the <X> screen) toggles to another
  277. coloring protocol.  Here the points are colored according to which
  278. quadrant of the complex plane (negative real/positive imaginary, positive
  279. real/positive imaginary, etc.) the final value is in. If you use 4 as the
  280. parameter, points ending up in each quadrant are given their own color; if
  281. 2 (binary decomposition), points in alternating quadrants are given 2
  282. alternating colors.
  283.  
  284. The result is a kind of warped checkerboard coloring, even in areas that
  285. would ordinarily be part of a single contour. Remember, for the M-set all
  286. points whose final values exceed 2 (by any amount) after, say, 80
  287. iterations are normally the same color; under decomposition, Fractint runs
  288. [bailout-value] iterations and then colors according to where the actual
  289. final value falls on the complex plane.
  290.  
  291. When using decomposition, a higher bailout value will give a more accurate
  292. plot, at some expense in speed.  You might want to set the bailout value
  293. (in the parameters prompt following selection of a new fractal type;
  294. present for most but not all types) to a higher value than the default.  A
  295. value of about 50 is a good compromise for M/J sets.
  296. ;
  297. ;
  298. ;
  299. ~Topic=Logarithmic Palettes and Color Ranges
  300.  
  301. By default, Fractint maps iterations to colors 1:1. I.e. if the
  302. calculation for a fractal "escapes" (exceeds the bailout value) after N
  303. iterations, the pixel is colored as color number N. If N is greater than
  304. the number of colors available, it wraps around. So, if you are using a
  305. 16-color video mode, and you are using the default maximum iteration count
  306. of 150, your image will run through the 16-color palette 150/16 = 9.375
  307. times.
  308.  
  309. When you use Logarithmic palettes, the entire range of iteration values is
  310. compressed to map to one span of the color range.  This results in
  311. spectacularly different images if you are using a high iteration limit
  312. near the current iteration maximum of 32000 and are zooming in on an area
  313. near a "lakelet".
  314.  
  315. When using a compressed palette in a 256 color mode, we suggest changing
  316. your colors from the usual defaults.  The last few colors in the default
  317. IBM VGA color map are black.  This results in points nearest the "lake"
  318. smearing into a single dark band, with little contrast from the blue (by
  319. default) lake.
  320.  
  321. Fractint has a number of types of compressed palette, selected by the "Log
  322. Palette" line on the <X> screen, or by the "logmap=" command line
  323. parameter:
  324.  
  325.   logmap=1: for standard logarithmic palette.
  326.  
  327.   logmap=-1: "old" logarithmic palette. This variant was the only one used
  328.   before Fractint 14.0. It differs from logmap=1 in that some colors are
  329.   not used - logmap=1 "spreads" low color numbers which are unused by
  330.   logmap=-1's pure logarithmic mapping so that all colors are assigned.
  331.  
  332.   logmap=N (>1): Same as logmap=1, but starting from iteration count N.
  333.   Pixels with iteration counts less than N are mapped to color 1. This is
  334.   useful when zooming in an area near the lake where no points in the
  335.   image have low iteration counts - it makes use of the low colors which
  336.   would otherwise be unused.
  337.  
  338.   logmap=-N (<-1): Similar to logmap=N, but uses a square root
  339.   distribution of the colors instead of a logarithmic one.
  340.  
  341. Another way to change the 1:1 mapping of iteration counts to colors is to
  342. use the "RANGES=" parameter.  It has the format:\
  343.    RANGES=aa/bb/cc/dd/...
  344.  
  345. Iteration counts up to and including the first value are mapped to color
  346. number 0, up to and including the second value to color number 1, and so
  347. on. The values must be in ascending order.
  348.  
  349. A negative value can be specified for "striping". The negative value
  350. specifies a stripe width, the value following it specifies the limit of
  351. the striped range.  Two alternating colors are used within the striped
  352. range.
  353.  
  354. Example:\
  355.    RANGES=0/10/30/-5/65/79/32000\
  356. This example maps iteration counts to colors as follows:
  357.  
  358. ~Format-
  359.     color    iterations
  360.     -------------------
  361.       0      unused (formula always iterates at least once)
  362.       1       1 to 10
  363.       2      11 to 30
  364.       3      31 to 35, 41 to 45, 51 to 55, and 61 to 65
  365.       4      36 to 40, 46 to 50, and 56 to 60
  366.       5      66 to 79
  367.       6      80 and greater
  368. ~Format+
  369.  
  370. Note that the maximum value in a RANGES parameter is 32767.
  371. ;
  372. ;
  373. ;
  374. ~Topic=Biomorphs, Label=@Biomorphs
  375.  
  376. Related to {Decomposition} are the "biomorphs" invented by Clifford
  377. Pickover, and discussed by A. K. Dewdney in the July 1989 "Scientific
  378. American", page 110.  These are so-named because this coloring scheme
  379. makes many fractals look like one-celled animals.  The idea is simple.
  380. The escape-time algorithm terminates an iterating formula when the size of
  381. the orbit value exceeds a predetermined bailout value. Normally the pixel
  382. corresponding to that orbit is colored according to the iteration when
  383. bailout happened. To create biomorphs, this is modified so that if EITHER
  384. the real OR the imaginary component is LESS than the bailout, then the
  385. pixel is set to the "biomorph" color. The effect is a bit better with
  386. higher bailout values: the bailout is automatically set to 100 when this
  387. option is in effect. You can try other values with the "bailout=" option.
  388.  
  389. The biomorph option is turned on via the "biomorph=nnn" command-line
  390. option (where "nnn" is the color to use on the affected pixels).  When
  391. toggling to Julia sets, the default corners are three times bigger than
  392. normal to allow seeing the biomorph appendages. Does not work with all
  393. types - in particular it fails with any of the mandelsine family. However,
  394. if you are stuck with monochrome graphics, try it - works great in two-
  395. color modes. Try it with the marksmandel and marksjulia types.
  396. ;
  397. ;
  398. ;
  399. ~Topic=Continuous Potential
  400.  
  401. Note: This option can only be used with 256 color modes.
  402.  
  403. Fractint's images are usually calculated by the "level set" method,
  404. producing bands of color corresponding to regions where the calculation
  405. gives the same value. When "3D" transformed (see {\"3D\" Images}),
  406. most images other than plasma
  407. clouds are like terraced landscapes: most of the surface is either
  408. horizontal or vertical.
  409.  
  410. To get the best results with the "illuminated" 3D fill options 5 and 6,
  411. there is an alternative approach that yields continuous changes in colors.
  412.  
  413. Continuous potential is approximated by calculating
  414.  
  415.      potential =  log(modulus)/2^iterations
  416.  
  417. where "modulus" is the orbit value (magnitude of the complex number) when
  418. the modulus bailout was exceeded, at the "iterations" iteration.  Clear as
  419. mud, right?
  420.  
  421. Fortunately, you don't have to understand all the details. However, there
  422. ARE a few points to understand. First, Fractint's criterion for halting a
  423. fractal calculation, the "modulus bailout value", is generally set to 4.
  424. Continuous potential is inaccurate at such a low value.
  425.  
  426. The bad news is that the integer math which makes the "mandel" and "julia"
  427. types so fast imposes a hard-wired maximum value of 127. You can still
  428. make interesting images from those types, though, so don't avoid them. You
  429. will see "ridges" in the "hillsides." Some folks like the effect.
  430.  
  431. The good news is that the other fractal types, particularly the (generally
  432. slower) floating point algorithms, have no such limitation.  The even
  433. better news is that there is a floating-point algorithm for the "mandel"
  434. and "julia" types.  To force the use of a floating-point algorithm, use
  435. Fractint with the "FLOAT=YES" command-line toggle.  Only a few fractal
  436. types like plasma clouds, the Barnsley IFS type, and "test" are unaffected
  437. by this toggle.
  438.  
  439. The parameters for continuous potential are:\
  440.     potential=maxcolor[/slope[/modulus[/16bit]]]\
  441. These parameters are present on the <Y> options screen.
  442.  
  443. "Maxcolor" is the color corresponding to zero potential, which plots as
  444. the TOP of the mountain. Generally this should be set to one less than the
  445. number of colors, i.e. usually 255. Remember that the last few colors of
  446. the default IBM VGA palette are BLACK, so you won't see what you are
  447. really getting unless you change to a different palette.
  448.  
  449. "Slope" affects how rapidly the colors change -- the slope of the
  450. "mountains" created in 3D. If this is too low, the palette will not cover
  451. all the potential values and large areas will be black. If it is too high,
  452. the range of colors in the picture will be much less than those available.
  453. There is no easy way to predict in advance what this value should be.
  454.  
  455. "Modulus" is the bailout value used to determine when an orbit has
  456. "escaped". Larger values give more accurate and smoother potential. A
  457. value of 500 gives excellent results. As noted, this value must be <128
  458. for the integer fractal types (if you select a higher number, they will
  459. use 127).
  460.  
  461. "16bit":  If you transform a continuous potential image to 3D, the
  462. illumination modes 5 and 6 will work fine, but the colors will look a bit
  463. granular. This is because even with 256 colors, the continuous potential
  464. is being truncated to integers. The "16bit" option can be used to add an
  465. extra 8 bits of goodness to each stored pixel, for a much smoother result
  466. when transforming to 3D.
  467.  
  468. Fractint's visible behavior is unchanged when 16bit is enabled, except
  469. that solid guessing and boundary tracing are not used. But when you save
  470. an image generated with 16bit continuous potential:\
  471.  o The saved file is a fair bit larger.\
  472.  o Fractint names the file with a .POT extension instead of .GIF, if you
  473.    didn't specify an extension in "savename".
  474.  o The image can be used as input to a subsequent <3> command to get the
  475.    promised smoother effect.
  476.  o If you happen to view the saved image with a GIF viewer other than
  477.    Fractint, you'll find that it is twice as wide as it is supposed to
  478.    be. (Guess where the extra goodness was stored!) Though these files
  479.    are structurally legal GIF files the double-width business made us
  480.    think they should perhaps not be called GIF - hence the .POT filename
  481.    extension.
  482.  
  483. A 16bit (.POT) file can be converted to an ordinary 8 bit GIF by
  484. <R>estoring it, changing "16bit" to "no" on the <Y> options screen, and
  485. <S>aving.
  486.  
  487. You might find with 16bit continuous potential that there's a long delay
  488. at the start of an image, and disk activity during calculation. Fractint
  489. uses its disk-video cache area to store the extra 8 bits per pixel - if
  490. there isn't sufficient memory available, the cache will page to disk.
  491.  
  492. The following commands can be used to recreate the image that Mark
  493. Peterson first prototyped for us, and named "MtMand":
  494.  
  495.     TYPE=mandel\
  496.     CORNERS=-0.19920/-0.11/1.0/1.06707\
  497.     INSIDE=255\
  498.     MAXITER=255\
  499.     POTENTIAL=255/2000/1000/16bit\
  500.     PASSES=1\
  501.     FLOAT=yes\
  502.  
  503. Note that prior to version 15.0, Fractint:\
  504.  o Produced "16 bit TGA potfiles" This format is no longer generated, but
  505.    you can still (for a release or two) use <R> and <3> with those files.
  506.  o Assumed "inside=maxit" for continuous potential. It now uses the
  507.    current "inside=" value - to recreate prior results you must be
  508.    explicit about this parameter.
  509. ;
  510. ;
  511. ;
  512. ~Topic=Starfields, Label=HELPSTARFLD
  513.  
  514. Once you have generated your favorite fractal image, you can convert it
  515. into a fractal starfield with the 'a' transformation (for 'astronomy'? -
  516. once again, all of the good letters were gone already).  Stars are
  517. generated on a pixel-by-pixel basis - the odds that a particular pixel
  518. will coalesce into a star are based (partially) on the color index of that
  519. pixel.
  520.  
  521. (The following was supplied by Mark Peterson, the starfield author).
  522.  
  523. If the screen were entirely black and the 'Star Density per Pixel' were
  524. set to 30 then a starfield transformation would create an evenly
  525. distributed starfield with an average of one star for every 30 pixels.
  526.  
  527. If you're on a 320x200 screen then you have 64000 pixels and would end up
  528. with about 2100 stars.    By introducing the variable of 'Clumpiness' we can
  529. create more stars in areas that have higher color values.  At 100%
  530. Clumpiness a color value of 255 will change the average of finding a star
  531. at that location to 50:50.  A lower clumpiness values will lower the
  532. amount of probability weighting.  To create a spiral galaxy draw your
  533. favorite spiral fractal (IFS, Julia, or Mandelbrot) and perform a
  534. starfield transformation.  For general starfields I'd recommend
  535. transforming a plasma fractal.
  536.  
  537. Real starfields have many more dim stars than bright ones because very few
  538. stars are close enough to appear bright.  To achieve this effect the
  539. program will create a bell curve based on the value of ratio of Dim stars
  540. to bright stars.  After calculating the bell curve the curve is folded in
  541. half and the peak used to represent the number of dim stars.
  542.  
  543. Starfields can only be shown in 256 colors.  Fractint will automatically
  544. try to load ALTERN.MAP and abort if the map file cannot be found.
  545. ;
  546. ;
  547. ;
  548. ~Topic=Palette Maps, Label=HELPCOLORMAP
  549.  
  550. If you have a VGA, MCGA, Super-VGA, 8514/A, XGA, TARGA, or TARGA+ video
  551. adapter, you can save and restore color palettes for use
  552. with any image.  To load a palette onto an existing image, use
  553. the <L> command in color-cycling or palette-editing mode.  To save a
  554. palette, use the <S> command in those modes.  To change the default
  555. palette for an entire run, use the command line "map=" parameter.
  556.  
  557. The default filetype for color-map files is ".MAP".
  558.  
  559. These color-maps are ASCII text
  560. files set up as a series of RGB triplet values (one triplet per
  561. line, encoded as the red, green, and blue [RGB] components of the color).
  562.  
  563. Note that .MAP file color values are in GIF format - values go from 0 (low) to
  564. 255 (high), so for a VGA adapter they get divided by 4 before being
  565. stuffed into the VGA's Video-DAC registers (so '6' and '7' end up
  566. referring to the same color value).
  567. ~OnlineFF
  568.  
  569. ~Format-
  570. Fractint is distributed with some sample .MAP files:
  571.    ALTERN.MAP     the famous "Peterson-Vigneau Pseudo-Grey Scale"
  572.    BLUES.MAP     for rainy days, by Daniel Egnor
  573.    CHROMA.MAP     general purpose, chromatic
  574.    DEFAULT.MAP     the VGA start-up values
  575.    FIRESTRM.MAP  general purpose, muted fire colors
  576.    GAMMA1.MAP and GAMMA2.MAP  Lee Crocker's response to ALTERN.MAP
  577.    GLASSES1.MAP  used with 3d glasses modes
  578.    GLASSES2.MAP  used with 3d glasses modes
  579.    GOODEGA.MAP     for EGA users
  580.    GREEN.MAP     shaded green
  581.    GREY.MAP     another grey variant
  582.    GRID.MAP     for stereo surface grid images
  583.    HEADACHE.MAP  major stripes, by D. Egnor (try cycling and hitting <2>)
  584.    LANDSCAP.MAP  Guruka Singh Khalsa's favorite map for plasma "landscapes"
  585.    NEON.MAP     a flashy map, by Daniel Egnor
  586.    PAINTJET.MAP  high resolution mode PaintJet colors
  587.    ROYAL.MAP     the royal purple, by Daniel Egnor
  588.    TOPO.MAP     Monte Davis's contribution to full color terrain
  589.    VOLCANO.MAP     an explosion of lava, by Daniel Egnor
  590. ~Format+
  591. ;
  592. ;
  593. ;
  594. ~Topic=\"3D\" Images, Label=HELP3D
  595. ; Empty in docs, just to have the hotlink defined at chapter level.
  596. ~Format-,Doc-
  597.  
  598.    { 3D Overview }
  599.    { 3D Mode Selection }
  600.    { Select Fill Type Screen }
  601.    { Stereo 3D Viewing }
  602.    { Rectangular Coordinate Transformation }
  603.    { 3D Color Parameters }
  604.    { Light Source Parameters }
  605.    { Spherical Projection }
  606.    { 3D Overlay Mode }
  607.    { Special Note for CGA or Hercules Users }
  608.    { Making Terrains }
  609.    { Making 3D Slides }
  610.    { Interfacing with Ray Tracing Programs }
  611. ~Format+,Doc+
  612. ;
  613. ;
  614. ;
  615. ~Topic=3D Overview
  616.  
  617. Fractint can restore images in "3D". Important: we use quotation marks
  618. because it does not CREATE images of 3D fractal objects (there are such,
  619. but we're not there yet.) Instead, it restores .GIF images as a 3D
  620. PROJECTION or STEREO IMAGE PAIR.  The iteration values you've come to know
  621. and love, the ones that determine pixel colors, are translated into
  622. "height" so that your saved screen becomes a landscape viewed in
  623. perspective. You can even wrap the landscape onto a sphere for realistic-
  624. looking planets and moons that never existed outside your PC!
  625.  
  626. We suggest starting with a saved plasma-cloud screen. Hit <3> in main
  627. command mode to begin the process. Next, select the file to be
  628. transformed, and the video mode. (Usually you want the same video mode the
  629. file was generated in; other choices may or may not work.)
  630.  
  631. After hitting <3>, you'll be bombarded with a long series of options.
  632. Not to worry: all
  633. of them have defaults chosen to yield an acceptable starting image, so the
  634. first time out just pump your way through with the <Enter> key. When you
  635. enter a different value for any option, that becomes the default value the
  636. next time you hit <3>, so you can change one option at a time until you
  637. get what you want. Generally <ESC> will take you back to the previous
  638. screen.
  639.  
  640. Once you're familiar with the effects of the 3D option values you have a
  641. variety of options on how to specify them. You can specify them all on the
  642. command line (there ARE a lot of them so they may not all fit within the
  643. DOS command line limits), with an SSTOOLS.INI file, or with a parameter
  644. file.
  645.  
  646. Here's an example for you power FRACTINTers, the command
  647.  
  648.       FRACTINT MYFILE SAVENAME=MY3D 3D=YES BATCH=YES
  649.  
  650. would make Fractint load MYFILE.GIF, re-plot it as a 3D landscape (taking
  651. all of the defaults), save the result as MY3D.GIF, and exit to DOS. By the
  652. time you've come back with that cup of coffee, you'll have a new world to
  653. view, if not conquer.
  654.  
  655. Note that the image created by 3D transformation is treated as if it were
  656. a plasma cloud - We have NO idea how to retain the ability to zoom and pan
  657. around a 3D image that has been twisted, stretched, perspective-ized, and
  658. water-leveled. Actually, we do, but it involves the kind of hardware that
  659. Industrial Light & Magic, Pixar et al. use for feature films. So if you'd
  660. like to send us a check equivalent to George Lucas' net from the "Star
  661. Wars" series...
  662. ;
  663. ;
  664. ;
  665. ~Topic=3D Mode Selection, Label=HELP3DMODE
  666.  
  667. After hitting <3> and getting past the filename prompt and video mode
  668. selection, you're presented with a "3d Mode Selection" screen.  If you
  669. wish to change the default for any of the following parameters,
  670. use the cursor keys to move through the menu. When you're
  671. satisfied press <Enter>.
  672.  
  673. Preview Mode:
  674.    Preview mode provides a rapid look at your transformed image using by
  675.    skipping a lot of rows and filling the image in. Good for quickly
  676.    discovering the best parameters. Let's face it, the Fractint authors
  677.    most famous for "blazingly fast" code *DIDN'T* write the 3D routines!
  678.    [Pieter: "But they *are* picking away it and making some progress in
  679.    each release."]
  680.  
  681. Show Box:
  682.    If you have selected Preview Mode you have another option to worry
  683.    about. This is the option to show the image box in scaled and rotated
  684.    coordinates x, y, and z. The box only appears in rectangular
  685.    transformations and shows how the final image will be oriented. If you
  686.    select light source in the next screen, it will also show you the
  687.    light source vector so you can tell where the light is coming from in
  688.    relation to your image. Sorry no head or tail on the vector yet.
  689.  
  690. ~OnlineFF
  691. Coarseness:
  692.    This sets how many divisions the image will be divided into in the y
  693.    direction, if you select preview mode, ray tracing output, or grid fill
  694.    in the "Select Fill Type" screen.
  695.  
  696. Spherical Projection:
  697.    The next question asks if you want a sphere projection. This will take
  698.    your image and map it onto a plane if you answer "no" or a sphere if
  699.    you answer "yes" as described above. Try it and you'll see what we
  700.    mean.  See {Spherical Projection}.
  701.  
  702. Stereo:
  703.  
  704.    Stereo sound in Fractint? Well, not yet. Fractint now allows you to
  705.    create 3D images for use with red/blue glasses like 3D comics you may
  706.    have seen, or images like Captain EO.
  707.  
  708.    Option 0 is normal old 3D you can look at with just your eyes.
  709.  
  710.    Options 1 and 2 require the special red/blue-green glasses.    They are
  711.    meant to be viewed right on the screen or on a color print off of the
  712.    screen. The image can be made to hover entirely or partially in front
  713.    of the screen. Great fun!  These two options give a gray scale image
  714.    when viewed.
  715.  
  716.    Option 1 gives 64 shades of gray but with half the spatial resolution
  717.    you have selected. It works by writing the red and blue images on
  718.    adjacent pixels, which is why it eats half your resolution. In
  719.    general, we recommend you use this only with resolutions above
  720.    640x350. Use this mode for continuous potential landscapes where you
  721.    *NEED* all those shades.
  722.  
  723.    Option "2" gives you full spatial resolution but with only 16 shades
  724.    of gray. If the red and blue images overlap, the colors are mixed.
  725.    Good for wire-frame images (we call them surface grids), lorenz3d and
  726.    3D IFS. Works fine in 16 color modes.
  727.  
  728.    Option 3 is for creating stereo pair images for view later with more
  729.    specialized equipment. It allows full color images to be presented in
  730.    glorious stereo. The left image presented on the screen first. You may
  731.    photograph it or save it. Then the second image is presented, you may
  732.    do the same as the first image. You can then take the two images and
  733.    convert them to a stereo image pair as outlined by Bruce Goren (see
  734.    below).
  735.  
  736.    Also see {Stereo 3D Viewing}.
  737.  
  738. ~OnlineFF
  739. Ray Tracing Output:
  740.  
  741.    Fractint can create files of its 3d transformations which are
  742.    compatible with many ray tracing programs. Currently four are supported
  743.    directly: DKB, VIVID, MTV, and RAYSHADE.
  744.    In addition a "RAW" output is supported which
  745.    can be relatively easily transformed to be usable by many other
  746.    products.
  747.  
  748.    One other option is supported: ACROSPIN.  This is not a ray tracer,
  749.    but the same Fractint options apply - see {=@ACROSPIN Acrospin}.
  750.  
  751.    Option values:\
  752.       0  disables the creation of ray tracing output\
  753.       1  DKB format\
  754.       2  VIVID format\
  755.       3  generic format (must be massaged externally)\
  756.       4  MTV format\
  757.       5  RAYSHADE format\
  758.       6  ACROSPIN format\
  759.  
  760.    All ray tracing files consist of triangles which follow the surface
  761.    created by Fractint during the 3d transform. Triangles which lie below
  762.    the "water line" are not created in order to avoid causing unnecessary
  763.    work for the poor ray tracers which are already overworked.
  764.    A simple plane can be substituted by the user at the
  765.    waterline if needed.
  766.  
  767.    The size (and therefore the number) of triangles created is determined
  768.    by the "coarse" parameter setting. While generating the ray tracing
  769.    file, you will view the image from above and watch it partitioned into
  770.    triangles.
  771.  
  772.    The color of each triangle is the average of the color of its verticies
  773.    in the original image, unless BRIEF is selected.
  774.  
  775.    If BRIEF is selected, a default color is assigned at the begining of the
  776.    file and is used for all triangles.
  777.  
  778.    Also see {Interfacing with Ray Tracing Programs}.
  779.  
  780. Brief output:
  781.  
  782.    This is a ray tracing sub-option.
  783.    When it is set to yes, Fractint creates a considerably
  784.    smaller and somewhat faster file. In this mode, all triangles
  785.    use the default color specified at the begining of the file.
  786.    This color should be edited to supply the color of your choice.
  787.  
  788. Output File Name:
  789.  
  790.    This is a ray tracing sub-option, used to specify the name of the
  791.    file to be written.    The default name is FRACT001.RAY.  The name is
  792.    incremented by one each time a file is written.
  793.    If you have not set "overwrite=yes" then
  794.    the file name will also be automatically incremented to avoid
  795.    over-writing previous files.
  796.  
  797. ~Online-
  798. When you are satisfied with your selections press enter to go
  799. to the next parameter screen.
  800. ~Online+
  801. ;
  802. ;
  803. ;
  804. ~Topic=Select Fill Type Screen, Label=HELP3DFILL
  805.  
  806. This option exists because in the course of the 3D projection, portions
  807. of the original image may be stretched to fit the new surface. Points of
  808. an image that formerly were right next to each other, now may have a space
  809. between them. This option generally determines what to do with the space
  810. between the mapped dots. It is not used if you have selected a value for
  811. RAY other than 0.
  812.  
  813. For an illustration, pick the second option "just draw the points", which
  814. just maps points to corresponding points. Generally this will leave empty
  815. space between many of the points. Therefore you can choose various
  816. algorithms that "fill in" the space between the points in various ways.
  817.  
  818. Later, try the first option "make a surface grid." This option will make a
  819. grid of the surface which is as many divisions in the original "y"
  820. direction as was set in "coarse" in the first screen. It is very fast, and
  821. can give you a good idea what the final relationship of parts of your
  822. picture will look like.
  823.  
  824. Later, try the second option "connect the dots (wire frame)", then "surface
  825. fills" - "colors interpolated" and "colors not interpolated", the general
  826. favorites of the authors. Solid fill, while it reveals the pseudo-geology
  827. under your pseudo-landscape, inevitably takes longer.
  828.  
  829. Later, try the light source fill types. These two algorithms allow you to
  830. position the "sun" over your "landscape." Each pixel is colored according
  831. to the angle the surface makes with an imaginary light source. You will be
  832. asked to enter the three coordinates of the vector pointing toward the
  833. light in a following parameter screen - see {Light Source Parameters}.
  834.  
  835. "Light source before transformation" uses the illumination direction without
  836. transforming it. The light source is fixed relative to your computer screen.
  837. If you generate a sequence of images with progressive rotation, the effect is
  838. as if you and the light source are fixed and the object is rotating. Therefore
  839. as the object rotates features of the object move in and out of the light.
  840. This fill option was incorrect prior to version 16.1, and has been changed.
  841.  
  842. "Light source after transformation" applies the same transformation to both
  843. the light direction and the object. Since both the light direction and the
  844. object are transformed, if you generate a sequence of images with the rotation
  845. progressively changed, the effect is as if the image and the light source
  846. are fixed in relation to each other and you orbit around the image. The
  847. illumination of features on the object is constant, but you see the object
  848. from different angles. This fill option was correct in earlier Fractint
  849. versions and has not been changed.
  850.  
  851. For ease of discussion we will refer to the following fill types by these
  852. numbers:
  853.     1 - surface grid\
  854.     2 - (default) - no fill at all - just draw the dots\
  855.     3 - wire frame - joins points with lines\
  856.     4 - surface fill - (colors interpolated)\
  857.     5 - surface fill - (interpolation turned off)\
  858.     6 - solid fill - draws lines from the "ground" up to the point\
  859.     7 - surface fill with light model - calculated before 3D transforms\
  860.     8 - surface fill with light model - calculated after 3D transforms\
  861.  
  862. Types 4, 7, and 8 interpolate colors when filling, making a very smooth
  863. fill if the palette is continuous. This may not be desirable if the
  864. palette is not continuous. Type 5 is the same as type 4 with interpolation
  865. turned off. You might want to use fill type 5, for example, to project
  866. a .GIF photograph onto a sphere. With type 4, you might see the filled-in
  867. points, since chances are the palette is not continuous; type 5 fills
  868. those same points in with the colors of adjacent pixels. However, for most
  869. fractal images, fill type 4 works better.
  870.  
  871. This screen is not available if you have selected a ray tracing option.
  872. ;
  873. ;
  874. ;
  875. ~Topic=Stereo 3D Viewing, Label=HELP3DGLASSES
  876.  
  877. The "Funny Glasses" (stereo 3D) parameter screen is presented only if
  878. you select a non-zero stereo option in the prior 3D parameters.
  879. (See {3D Mode Selection}.)
  880. We suggest you definitely use defaults at first on this screen.
  881.  
  882. When you look at an image with both eyes, each eye sees the image in
  883. slightly different perspective because they see it from different places.
  884.  
  885. The first selection you must make is ocular separation, the distance the
  886. between the viewers eyes. This is measured as a % of screen and is an
  887. important factor in setting the position of the final stereo image in
  888. front of or behind the CRT Screen.
  889.  
  890. The second selection is convergence, also as a % of screen. This tends to
  891. move the image forward and back to set where it floats. More positive
  892. values move the image towards the viewer. The value of this parameter
  893. needs to be set in conjunction with the setting of ocular separation and
  894. the perspective distance. It directly adjusts the overall separation of
  895. the two stereo images. Beginning anaglyphers love to create images
  896. floating mystically in front of the screen, but grizzled old 3D veterans
  897. look upon such antics with disdain, and believe the image should be safely
  898. inside the monitor where it belongs!
  899.  
  900. Left and Right Red and Blue image crop (% of screen also) help keep the
  901. visible part of the right image the same as the visible part of the left
  902. by cropping them. If there is too much in the field of either eye that the
  903. other doesn't see, the stereo effect can be ruined.
  904.  
  905. Red and Blue brightness factor. The generally available red/blue-green
  906. glasses, made for viewing on ink on paper and not the light from a CRT,
  907. let in more red light in the blue-green lens than we would like. This
  908. leaves a ghost of the red image on the blue-green image (definitely not
  909. desired in stereo images). We have countered this by adjusting the
  910. intensity of the red and blue values on the CRT. In general you should not
  911. have to adjust this.
  912.  
  913. The final entry is Map file name (present only if stereo=1 or stereo=2
  914. was selected).
  915. If you have a special map file you want
  916. to use for Stereo 3D this is the place to enter its name. Generally
  917. glasses1.map is for type 1 (alternating pixels), and glasses2.map is for
  918. type 2 (superimposed pixels). Grid.map is great for wire-frame images
  919. using 16 color modes.
  920.  
  921. This screen is not available if you have selected a ray tracing option.
  922. ;
  923. ;
  924. ;
  925. ~Topic=3D Fractal Parameters, Label=HELP3DFRACT
  926. ; This topic is online only.
  927.  
  928. The parameters on this screen are a subset of the zillions of options
  929. available for Fractint's 3D image transformations.
  930. This screen's parameters are those which also affect 3D fractal types like
  931. lorenz3d and kamtorus3d.
  932. Since they are documented elsewhere, we won't repeat ourselves:
  933.  
  934. For a description of rotation, perspective, and shift parameters, please
  935. see {Rectangular Coordinate Transformation}.  Ignore the paragraphs about
  936. "scaling" and "water level" - those parts apply only to 3D Transforms.
  937.  
  938. For a description of the stereo option, please see the "stereo" subheading
  939. in {3D Mode Selection}.
  940. ;
  941. ;
  942. ;
  943. ~Topic=Rectangular Coordinate Transformation, Label=HELP3DPARMS
  944.  
  945. The first entries are rotation values around the X, Y, and Z axes. Think
  946. of your starting image as a flat map: the X value tilts the bottom of your
  947. monitor towards you by X degrees, the Y value pulls the left side of the
  948. monitor towards you, and the Z value spins it counter-clockwise. Note that
  949. these are NOT independent rotations: the image is rotated first along the
  950. X-axis, then along the Y-axis, and finally along the Z-axis. Those are
  951. YOUR axes, not those of your (by now hopelessly skewed) monitor. All
  952. rotations actually occur through the center of the original image. Rotation
  953. parameters are not used when a ray tracing option has been selected.
  954.  
  955. Then there are three scaling factors in percent. Initially, leave the X
  956. and Y axes alone and play with Z, now the vertical axis, which translates
  957. into surface "roughness."  High values of Z make spiky, on-beyond-Alpine
  958. mountains and improbably deep valleys; low values make gentle, rolling
  959. terrain. Negative roughness is legal: if you're doing an M-set image and
  960. want Mandelbrot Lake to be below the ground, instead of eerily floating
  961. above, try a roughness of about -30%.
  962.  
  963. Next we need a water level -- really a minimum-color value that performs
  964. the function "if (color < waterlevel) color = waterlevel". So it plots all
  965. colors "below" the one you choose at the level of that color, with the
  966. effect of filling in "valleys" and converting them to "lakes."
  967.  
  968. Now we enter a perspective distance, which you can think of as the
  969. "distance" from your eye to the image. A zero value (the default) means no
  970. perspective calculations, which allows use of a faster algorithm.
  971. perspective calculations, which allows use of a faster algorithm.
  972. Perspective distance is not available if you have selected a ray tracing
  973. option.
  974.  
  975. For non-zero values, picture a box with the original X-Y plane of your
  976. flat fractal on the bottom, and your 3D fractal inside. A perspective
  977. value of 100% places your eye right at the edge of the box and yields
  978. fairly severe distortion, like a close view through a wide-angle lens.
  979. 200% puts your eye as far from the front of the box as the back is behind.
  980. 300% puts your eye twice as far from the front of the box as the back is,
  981. etc. Try about 150% for reasonable results. Much larger values put you far
  982. away for even less distortion, while values smaller than 100% put you
  983. "inside" the box. Try larger values first, and work your way in.
  984.  
  985. Next, you are prompted for two types of X and Y shifts (now back in the
  986. plane of your screen) that let you move the final image around if you'd
  987. like to re-center it. The first set, x and y shift with perspective, move
  988. the image and the effect changes the perspective you see. The second set,
  989. "x and y adjust without perspective", move the image but do not change
  990. perspective.  They are used just for positioning the final image on the
  991. screen. Shifting of any type is not available if you have selected a ray
  992. tracing option.
  993. ~Doc-
  994.  
  995. {3D Color Parameters} are also requested on the same input screen.\
  996.  
  997. If you are doing a {Spherical Projection}, special parameters for
  998. it are requested at the start of this screen.
  999. ~Doc+
  1000. ;
  1001. ;
  1002. ;
  1003. ~Topic=3D Color Parameters
  1004.  
  1005. You are asked for a range of "transparent" colors, if any. This
  1006. option is most useful when using the {3D Overlay Mode}.  Enter the
  1007. color range (minimum and maximum value) for which you do not want to
  1008. overwrite whatever may already be on the screen. The default is no
  1009. transparency (overwrite everything).
  1010.  
  1011. Now, for the final option. This one will smooth the transition between
  1012. colors by randomizing them and reduce the banding that occurs with some
  1013. maps. Select the value of randomize to between 0 (for no effect) and 7 (to
  1014. randomize your colors almost beyond use). 3 is a good starting point.
  1015.  
  1016. Well, OK, we lied. If you selected one of the light source fill options,
  1017. there are still MORE options.
  1018.  
  1019. If you have selected a fill type which uses light source, you can select
  1020. the final image to be either in monochrome or full color. 0 selects
  1021. monochrome and 1 selects glorious full color.
  1022.  
  1023. That's all for this screen. Press enter for these parameters and the
  1024. next and final screen will appear (honestly!).
  1025. ;
  1026. ;
  1027. ;
  1028. ~Topic=Light Source Parameters, Label=HELP3DLIGHT
  1029.  
  1030. This one deals with all the aspects of light source.
  1031.  
  1032. You must chose the direction of the light from the light source. This will
  1033. be scaled in the x, y, and z directions the same as the image. For
  1034. example, 1,1,3 positions the light to come from the lower right front of
  1035. the screen in relation to the untransformed image. It is important to
  1036. remember that these coordinates are scaled the same as your image. Thus,
  1037. "1,1,1" positions the light to come from a direction of equal distances to
  1038. the right, below and in front of each pixel on the original image.
  1039. However, if the x,y,z scale is set to 90,90,30 the result will be from
  1040. equal distances to the right and below each pixel but from only 1/3 the
  1041. distance in front of the screen i.e.. it will be low in the sky, say,
  1042. afternoon or morning.
  1043.  
  1044. Then you are asked for a smoothing factor. Unless you used
  1045. {Continuous Potential} when generating the starting image, the
  1046. illumination when using light source fills may appear "sparkly", like a
  1047. sandy beach in bright sun. A smoothing factor of 2 or 3 will allow you to
  1048. see the large-scale shapes better.
  1049.  
  1050. Smoothing is primarily useful when doing light source fill types with plasma
  1051. clouds. If your fractal is not a plasma cloud and has features with
  1052. sharply defined boundaries (e.g. Mandelbrot Lake), smoothing may cause
  1053. the colors to run. This is a feature, not a bug. (A copyrighted response
  1054. of [your favorite commercial software company here], used by permission.)
  1055.  
  1056. The ambient option sets the minimum light value a surface has if it has no
  1057. direct lighting at all. All light values are scaled from this value to
  1058. white. This effectively adjusts the depth of the shadows and sets the
  1059. overall contrast of the image.
  1060.  
  1061. If you selected the full color option, you have a few more choices. The
  1062. next is the haze factor. Set this to make distant objects more hazy. Close
  1063. up objects will have little effect, distant objects will have most. 0
  1064. disables the function. 100 is the maximum effect, the farthest objects
  1065. will be lost in the mist. Currently, this does not really use distance
  1066. from the viewer, we cheat and use the y value of the original image. So
  1067. the effect really only works if the y-rotation (set earlier) is between
  1068. +/- 30.
  1069.  
  1070. Finally, absolutely the last option (this time we mean it): you can chose
  1071. the name under which to save your light file. If you have a RAM disk
  1072. handy, you might want to create the file on it for speed, so include its
  1073. full path name in this option. If you have not set "overwrite=yes" then
  1074. the file name will be incremented to avoid over-writing previous files. By
  1075. the way, the background on the full color file is sky blue instead of
  1076. black.
  1077.  
  1078. You'll probably want to adjust the final colors for monochrome fill types
  1079. using light source via {=@ColorCycling color cycling}.
  1080. Try one of the more continuous
  1081. palettes (<F8> through <F10>), or load the GRAY palette with the
  1082. <A>lternate-map command.
  1083.  
  1084. ~Online-
  1085. Now, lie down for a while in a quiet room with a damp washcloth on your
  1086. forehead. Feeling better? Good -- because it's time to go back almost to
  1087. the top of the 3D options and just say yes to:
  1088. ~Online+
  1089. ;
  1090. ;
  1091. ;
  1092. ~Topic=Spherical Projection
  1093.  
  1094. Picture a globe lying on its side, "north" pole to the right. (It's our
  1095. planet, and we'll position it the way we like.) You will be mapping the X
  1096. and Y axes of the starting image to latitude and longitude on the globe,
  1097. so that what was a horizontal row of pixels follows a line of longitude.
  1098. The defaults exactly cover the hemisphere facing you, from longitude 180
  1099. degrees (top) to 0 degrees (bottom) and latitude -90 (left) to latitude 90
  1100. (right). By changing them you can map the image to a piece of the
  1101. hemisphere or wrap it clear around the globe.
  1102.  
  1103. The next entry is for a radius factor that controls the over-all size of
  1104. the globe. All the rest of the entries are the same as in the landscape
  1105. projection. You may want less surface roughness for a plausible look,
  1106. unless you prefer small worlds with big topography, a la "The Little
  1107. Prince."
  1108.  
  1109. WARNING: When the "construction" process begins at the edge of the globe
  1110. (default) or behind it, it's plotting points that will be hidden by
  1111. subsequent points as the process sweeps around the sphere toward you. Our
  1112. nifty hidden-point algorithms "know" this, and the first few dozen lines
  1113. may be invisible unless a high mountain happens to poke over the horizon.
  1114. If you start a spherical projection and the screen stays black, wait for a
  1115. while (a longer while for higher resolution or fill type 6) to see if
  1116. points start to appear. Would we lie to you? If you're still waiting hours
  1117. later, first check that the power's still on, then consider a faster
  1118. system.
  1119. ;
  1120. ;
  1121. ;
  1122. ~Topic=3D Overlay Mode, Label=HELP3DOVLY
  1123.  
  1124. While the <3> command (see {\"3D\" Images})
  1125. creates its image on a blank screen, the <O> command
  1126. draws a second image over an existing displayed image. This image can be
  1127. any restored image from a <R> command or the result of a just executed <3>
  1128. command. So you can do a landscape, then hit <O> and choose spherical
  1129. projection to re-plot that image or another as a moon in the sky above the
  1130. landscape. <O> can be repeated as many times as you like.
  1131.  
  1132. It's worth noting that not all that many years ago, one of us watched
  1133. Benoit Mandelbrot and fractal-graphics wizard Dick Voss creating just such
  1134. a moon-over-landscape image at IBM's research center in Yorktown Heights,
  1135. NY. The system was a large and impressive mainframe with floating-point
  1136. facilities bigger than the average minicomputer, running LBLGRAPH -- what
  1137. Mandelbrot calls "an independent-minded and often very ill-mannered heap
  1138. of graphics programs that originated in work by Alex Hurwitz and Jack
  1139. Wright of IBM Los Angeles."
  1140.  
  1141. We'd like to salute LBLGRAPH, its successors, and their creators, because
  1142. it was their graphic output (like "Planetrise over Labelgraph Hill," plate
  1143. C9 in Mandelbrot's "Fractal Geometry of Nature") that helped turn fractal
  1144. geometry from a mathematical curiosity into a phenomenon. We'd also like
  1145. to point out that it wasn't as fast, flexible or pretty as Fractint on a
  1146. 386/16 PC with S-VGA graphics. Now, a lot of the difference has to do with
  1147. the incredible progress of micro-processor power since then, so a lot of
  1148. the credit should go to Intel rather than to our highly tuned code. OK,
  1149. twist our arms -- it IS awfully good code.
  1150. ;
  1151. ;
  1152. ;
  1153. ~Topic=Special Note for CGA or Hercules Users
  1154.  
  1155. If you are one of those unfortunates with a CGA or Hercules 2-color
  1156. monochrome graphics, it is now possible for you to make 3D projection
  1157. images.
  1158.  
  1159. Try the following unfortunately circuitous approach. Invoke Fractint,
  1160. making sure you have set askvideo=yes. Use a disk-video mode to create a
  1161. 256 color fractal. You might want to edit the fractint.cfg file to make a
  1162. disk-video mode with the same pixel dimensions as your normal video. Using
  1163. the "3" command, enter the file name of the saved 256 color file, then
  1164. select your 2 or 4
  1165. color mode, and answer the other 3D prompts. You will then see a 3D
  1166. projection of the fractal. Another example of Stone Soup responsiveness to
  1167. our fan mail!
  1168. ;
  1169. ;
  1170. ;
  1171. ~Topic=Making Terrains
  1172.  
  1173. If you enjoy using Fractint for making landscapes, we have several new
  1174. features for you to work with. When doing 3d transformations banding tends
  1175. to occur because all pixels of a given height end up the same color. Now,
  1176. colors can be randomized to make the transitions between different colors
  1177. at different altitudes smoother. Use the new "RANDOMIZE= " variable to
  1178. accomplish this. If your light source images all look like lunar
  1179. landscapes since they are all monochrome and have very dark shadows, we
  1180. now allow you to set the ambient light for adjusting the contrast of the
  1181. final image. Use the "Ambient= " variable. In addition to being able to
  1182. create scenes with light sources in monochrome, you can now do it in full
  1183. color as well. Setting fullcolor=1 will generate a Targa-24 file with a
  1184. full color image which will be a combination of the original colors of the
  1185. source image (or map file if you select map=something) and the amount of
  1186. light which reflects off a given point on the surface. Since there can be
  1187. 256 different colors in the original image and 256 levels of light, you
  1188. can now generate an image with *lots* of colors. To convert it to a GIF if
  1189. you can't view Targa files directly, you can use PICLAB (see
  1190. {Other Programs}), and the following commands:
  1191.  
  1192.     SET PALETTE 256\
  1193.     SET CREZ 8\
  1194.     TLOAD yourfile.tga\
  1195.     MAKEPAL\
  1196.     MAP\
  1197.     GSAVE yourfile.gif\
  1198.     EXIT\
  1199. Using the full color option allows you to also set a haze factor with the
  1200. "haze= " variable to make more distant objects more hazy.
  1201.  
  1202. As a default, full color files also have the background set to sky blue.
  1203. Warning, the files which are created with the full color option are very
  1204. large, 3 bytes per pixel. So make sure to use a disk with enough space.
  1205. The file is created using Fractint's disk-video caching, but is always
  1206. created on real disk (expanded or extended memory is not used.) Try the
  1207. following settings of the new variables in sequence to get a feel for the
  1208. effect of each one:\
  1209.     ;use this with any filltype\
  1210.     map=topo\
  1211.     randomize=3; adjusting this smooths color transitions\
  1212.  
  1213.     ;now add this using filltype 5 or 6\
  1214.     ambient=20; adjusting this changes the contrast\
  1215.     filltype=6\
  1216.     smoothing=2; makes the light not quite as granular as the terrain\
  1217.  
  1218.     ;now add the following, and this is where it gets slow\
  1219.     fullcolor=1; use PICLAB to reduce resulting lightfile to a GIF\
  1220.  
  1221.     ;and finally this\
  1222.     haze=20; sets the amount of haze for distant objects\
  1223.  
  1224. When full color is being used, the image you see on the screen will
  1225. represent the amount of light being reflected, not the colors in the final
  1226. image. Don't be disturbed if the colors look weird, they are an artifact
  1227. of the process being used. The image being created in the lightfile won't
  1228. look like the screen.
  1229.  
  1230. However, if you are worried, hit ESC several times and when Fractint gets
  1231. to the end of the current line it will abort. Your partial image will be
  1232. there as LIGHT001.TGA or with whatever file name you selected with the
  1233. lightname option. Convert it as described above and adjust any parameters
  1234. you are not happy with. Its a little awkward, but all we haven't figured
  1235. out a better way yet.
  1236. ;
  1237. ;
  1238. ;
  1239. ~Topic=Making 3D Slides
  1240.  
  1241. Bruce Goren, CIS's resident stereoscopic maven, contributed these tips on
  1242. what to do with your 3D images (Bruce inspired and prodded us so much we
  1243. automated much of what follows, allowing both this and actual on screen
  1244. stereo viewing, but we included it here for reference and a brief
  1245. tutorial.)
  1246.  
  1247. "I use a Targa 32 video card and TOPAS graphic software, moving the
  1248. viewport or imaginary camera left and right to create two separate views
  1249. of the stationary object in x,y,z, space. The distance between the two
  1250. views, known as the inter-ocular distance, toe-in or convergence angle, is
  1251. critical. It makes the difference between good 3-D and headache-generating
  1252. bad 3-D.
  1253.  
  1254. "For a 3D fractal landscape, I created and photographed the left and right
  1255. eye views as if flying by in an imaginary airplane and mounted the film
  1256. chips for stereo viewing. To make my image, first I generated a plasma
  1257. cloud based on a color map I calculated to resemble a geological survey
  1258. map (available on CIS as TARGA.MAP). In the 3D reconstruction, I used a
  1259. perspective value of 150 and shifted the camera -15 and +15 on the X-axis
  1260. for the left and right views. All other values were left to the defaults.
  1261.  
  1262. "The images are captured on a Matrix 3000 film recorder -- basically a box
  1263. with a high-resolution (1400 lines) black and white TV and a 35mm camera
  1264. (Konica FS-1) looking at the TV screen through a filter wheel. The Matrix
  1265. 3000 can be calibrated for 8 different film types, but so far I have only
  1266. used Kodak Ektachrome 64 daylight for slides and a few print films. I
  1267. glass mount the film chips myself.
  1268.  
  1269. "Each frame is exposed three times, once through each of the red, blue,
  1270. and green filters to create a color image from computer video without the
  1271. scan-lines which normally result from photographing television screens.
  1272. The aspect ratio of the resulting images led me to mount the chips using
  1273. the 7-sprocket Busch-European Emde masks. The best source of Stereo
  1274. mounting and viewing supplies I know of is an outfit called Reel 3-D
  1275. Enterprises, Inc. at P.O. Box 2368, Culver City, CA 90231, tel. 213-837-
  1276. 2368. "My platform is an IBM PC/AT crystal-swapped up to 9 MHz. The math
  1277. co-processor runs on a separate 8-MHz accessory sub-board.  The system
  1278. currently has 6.5 MB of RAM."
  1279. ;
  1280. ;
  1281. ;
  1282. ~Topic=Interfacing with Ray Tracing Programs
  1283.  
  1284. (Also see "Ray Tracing Output", "Brief", and "Output File Name"
  1285. in {"3D Mode Selection"}.)
  1286.  
  1287. Fractint allows you to save your 3d transforms in files which may be
  1288. fed to a ray tracer (or to "Acrospin").
  1289. However, they are not ready to be traced by
  1290. themselves. For one thing, no light source is included. They are
  1291. actually meant to be included within other ray tracing files.
  1292.  
  1293. Since the intent is to produce an object which may be included in a larger
  1294. ray tracing scene, it is expected that all rotations, shifts, and final
  1295. scaling will be done by the ray tracer. Thus, in creating the images, no
  1296. facilities for rotations or shifting is provided. Scaling is provided to
  1297. achieve the correct aspect ratio.
  1298.  
  1299. WARNING! The files created using the RAY option can be huge. Setting
  1300. COARSE to 40 will result in over 2000 triangles. Each triangle can utilize
  1301. from 50 to 200 bytes each to describe, so your ray tracing files can
  1302. rapidly approach or exceed 1Meg. Make sure you have enough disk space before
  1303. you start.
  1304.  
  1305. Each file starts with a comment identifying the version of Fractint
  1306. by which it was created. The file ends with a comment giving the number
  1307. of triangles in the file.
  1308.  
  1309. The files consist of long strips of adjacent triangles. Triangles are
  1310. clockwise or counter clockwise depending on the target ray tracer.
  1311. Currently, MTV and Rayshade are the only ones which use counter clockwise
  1312. triangles. The size of the triangles is set by the COARSE setting in the
  1313. main 3d menu. Color information about each individual triangle is included
  1314. for all files unless in the brief mode.
  1315.  
  1316. To keep the poor ray tracer from working too hard, if WATERLINE is set
  1317. to a non zero value, no triangle which lies entirely at or below the
  1318. current setting of WATERLINE is written to the ray tracing file.  These
  1319. may be replaced by a simple plane in the syntax of the ray tracer you are
  1320. using.
  1321.  
  1322. Fractint's coordinate system has the origin of the x-y plane at the upper
  1323. left hand corner of the screen, with positive x to the right and positive
  1324. y down. The ray tracing files have the origin of the x-y plane moved to
  1325. the center of the screen with positive x to the right and positive y up.
  1326. Increasing values of the color index are out of the screen and in the +z
  1327. direction. The color index 0 will be found in the xy plane at z=-1.
  1328.  
  1329. When x- y- and zscale are set to 100, the surface created by the
  1330. triangles will fall within a box of +/- 1.0 in all 3 directions. Changing
  1331. scale will change the size and/or aspect ratio of the enclosed object.
  1332.  
  1333. We will only describe the structure of the RAW format here. If you want
  1334. to understand any of the ray tracing file formats besides RAW, please
  1335. see your favorite ray tracer docs.
  1336.  
  1337. The RAW format simply consists of a series of clockwise triangles. If
  1338. BRIEF=yes, Each line is a vertex with coordinates x, y, and z. Each
  1339. triangle is separated by a couple of CR's from the next. If BRIEF=no, the
  1340. first line in each triangle description if the r,g,b value of the triangle.
  1341.  
  1342. Setting BRIEF=yes produces shorter files with the color of each triangle
  1343. removed - all triangles will be the same color. These files are
  1344. otherwise identical to normal files but will run faster than the non BRIEF
  1345. files.    Also, with BRIEF=yes, you may be able to get files with more
  1346. triangles to run than with BRIEF=no.
  1347.  
  1348. For DKB, when BRIEF=yes and WATERLINE is non-zero, you may get empty
  1349. COMPOSITE/END_COMPOSITE pairs, ie. containing no triangle info.
  1350. These are harmless, but may be edited out of the file if desired.
  1351. ;
  1352. ;
  1353. ;
  1354.