home *** CD-ROM | disk | FTP | other *** search
/ Fractal Creations (Second Edition) / FRACTALS_2E.iso / frasrc.exe / HELP.SRC < prev    next >
Text File  |  1993-08-21  |  78KB  |  1,924 lines
  1. ;
  2. ; HELP.SRC
  3. ;
  4. ;
  5. ~HdrFile=HELPDEFS.H
  6. ~HlpFile=FRACTINT.HLP
  7. ~Version=100
  8. ~FormatExclude=8
  9. ;
  10. ;
  11. ;
  12. ~Topic=Main Help Index, Label=HELPMENU
  13. ~Label=HELP_INDEX
  14.  
  15. ~Format-
  16.    { Using Help }                { Fractals and the PC }
  17.    { Introduction }                { Distribution of Fractint }
  18.    { Conditions on Use }            { Contacting the Authors }
  19.    { Getting Started }                { The Stone Soup Story }
  20.    { What's New for the Second Edition }    { A Word About the Authors }
  21.    { New Features in Version 18.21 }        { Other Fractal Products }
  22.    { Display Mode Commands }
  23.    { Color Cycling Commands }            { Using Fractint With a Mouse }
  24.    { Palette Editing Commands }         { Video Adapter Notes }
  25.                       { GIF Save File Format }
  26.    { Summary of Fractal Types }
  27.                       { Common Problems }
  28.    { Doodads\, Bells\, and Whistles }
  29.    { "3D" Images }                          { Bibliography }
  30.    { Palette Maps }                { Other Programs }
  31.                       { Revision History }
  32.    { Startup Parameters\, Parameter Files }  { Version13 to 14 Conversion }
  33.    { Batch Mode }
  34.    { "Disk-Video" Modes }                   { Printing Fractint Documentation }
  35. ~Format+
  36. ;
  37. ;
  38. ;
  39. ~DocContents
  40. {     , 0, "New Features in Version 18.21", FF}
  41.  
  42. {     , 0, "Introduction", "Conditions on Use", FF}
  43.  
  44. {1.   , 0, Fractint Commands, FF}
  45. {1.1  , 1, "Getting Started"}
  46. {1.2  , 1, "Plotting Commands"}
  47. {1.3  , 1, "Zoom box Commands"}
  48. {1.4  , 1, "Color Cycling Commands"}
  49. {1.5  , 1, "Palette Editing Commands"}
  50. {1.6  , 1, "Image Save/Restore Commands"}
  51. {1.7  , 1, "Print Command"}
  52. {1.8  , 1, "Parameter Save/Restore Commands"}
  53. {1.9  , 1, "\"3D\" Commands"}
  54. {1.10 , 1, "Interrupting and Resuming"}
  55. {1.11 , 1, "Orbits Window"}
  56. {1.12 , 1, "View Window"}
  57. {1.13 , 1, "Video Mode Function Keys"}
  58. {1.14 , 1, "Hints"}
  59.  
  60. {2.   , 0, "Fractal Types", FF}
  61. {2.1  , 1, "The Mandelbrot Set"}
  62. {2.2  , 1, "Julia Sets"}
  63. {2.3  , 1, "Julia Toggle Spacebar Commands"}
  64. {2.4  , 1, "Inverse Julias"}
  65. {2.5  , 1, "Newton domains of attraction"}
  66. {2.6  , 1, "Newton"}
  67. {2.7  , 1, "Complex Newton"}
  68. {2.8  , 1, "Lambda Sets"}
  69. {2.9  , 1, "Mandellambda Sets"}
  70. {2.10 , 1, "Circle"}
  71. {2.11 , 1, "Plasma Clouds"}
  72. {2.12 , 1, "Lambdafn"}
  73. {2.13 , 1, "Mandelfn"}
  74. {2.14 , 1, "Barnsley Mandelbrot/Julia Sets"}
  75. {2.15 , 1, "Barnsley IFS Fractals"}
  76. {2.16 , 1, "Sierpinski Gasket"}
  77. {2.17 , 1, "Quartic Mandelbrot/Julia"}
  78. {2.18 , 1, "Distance Estimator"}
  79. {2.19 , 1, "Pickover Mandelbrot/Julia Types"}
  80. {2.20 , 1, "Pickover Popcorn"}
  81. {2.21 , 1, "Peterson Variations"}
  82. {2.22 , 1, "Unity"}
  83. {2.23 , 1, "Scott Taylor / Lee Skinner Variations"}
  84. {2.24 , 1, "Kam Torus"}
  85. {2.25 , 1, "Bifurcation"}
  86. {2.26 , 1, "Orbit Fractals"}
  87. {2.27 , 1, "Lorenz Attractors"}
  88. {2.28 , 1, "Rossler Attractors"}
  89. {2.29 , 1, "Henon Attractors"}
  90. {2.30 , 1, "Pickover Attractors"}
  91. {2.31 , 1, "Gingerbreadman"}
  92. {2.32 , 1, "Martin Attractors"}
  93. {2.33 , 1, "Icon"}
  94. {2.34 , 1, "Test"}
  95. {2.35 , 1, "Formula"}
  96. {2.36 , 1, "Julibrots"}
  97. {2.37 , 1, "Diffusion Limited Aggregation"}
  98. {2.38 , 1, "Magnetic Fractals"}
  99. {2.39 , 1, "L-Systems"}
  100. {2.40 , 1, "Lyapunov Fractals"}
  101. {2.41 , 1, "fn||fn Fractals"}
  102. {2.42 , 1, "Halley"}
  103. {2.43 , 1, "Dynamic System"}
  104. {2.44 , 1, "Mandelcloud"}
  105. {2.45 , 1, "Quaternion"}
  106. {2.46 , 1, "HyperComplex"}
  107. {2.47 , 1, "Cellular Automata"}
  108. {2.48 , 1, "Phoenix"}
  109. {2.49 , 1, "Frothy Basins"}
  110.  
  111. {3.   , 0, Doodads\, Bells\, and Whistles, FF}
  112. {3.1  , 1, "Drawing Method"}
  113. {3.2  , 1, "Palette Maps"}
  114. {3.3  , 1, "Autokey Mode"}
  115. {3.4  , 1, "Distance Estimator Method"}
  116. {3.5  , 1, "Inversion"}
  117. {3.6  , 1, "Decomposition"}
  118. {3.7  , 1, "Logarithmic Palettes and Color Ranges"}
  119. {3.8  , 1, "Biomorphs"}
  120. {3.9  , 1, "Continuous Potential"}
  121. {3.10 , 1, "Starfields"}
  122.  
  123. {4.   , 0, "\"3D\" Images", "3D Overview", FF}
  124. {4.1  , 1, "3D Mode Selection"}
  125. {4.2  , 1, "Select Fill Type Screen"}
  126. {4.3  , 1, "Stereo 3D Viewing"}
  127. {4.4  , 1, "Rectangular Coordinate Transformation"}
  128. {4.5  , 1, "3D Color Parameters"}
  129. {4.6  , 1, "Light Source Parameters"}
  130. {4.7  , 1, "Spherical Projection"}
  131. {4.8  , 1, "3D Overlay Mode"}
  132. {4.9  , 1, "Special Note for CGA or Hercules Users"}
  133. {4.10 , 1, "Making Terrains"}
  134. {4.11 , 1, "Making 3D Slides"}
  135. {4.12 , 1, "Interfacing with Ray Tracing Programs"}
  136.  
  137. {5.   , 0, Command Line Parameters\, Parameter Files\, Batch Mode, "Introduction to Parameters", FF}
  138. {5.1  , 1, "Using the DOS Command Line"}
  139. {5.2  , 1, "Setting Defaults (SSTOOLS.INI File)"}
  140. {5.3  , 1, "Parameter Files and the <@> Command"}
  141. {5.4  , 1, "General Parameter Syntax"}
  142. {5.5  , 1, "Startup Parameters"}
  143. {5.6  , 1, "Calculation Mode Parameters"}
  144. {5.7  , 1, "Fractal Type Parameters"}
  145. {5.8  , 1, "Image Calculation Parameters"}
  146. {5.9  , 1, "Color Parameters"}
  147. {5.10 , 1, "Doodad Parameters"}
  148. {5.11 , 1, "File Parameters"}
  149. {5.12 , 1, "Video Parameters"}
  150. {5.13 , 1, "Sound Parameters"}
  151. {5.14 , 1, "Printer Parameters"}
  152. {5.15 , 1, "PostScript Parameters"}
  153. {5.16 , 1, "PaintJet Parameters"}
  154. {5.17 , 1, "Plotter Parameters"}
  155. {5.18 , 1, "3D Parameters"}
  156. {5.19 , 1, "Batch Mode"}
  157.  
  158. {6.   , 0, Hardware Support, FF}
  159. {6.1  , 1, Notes on Video Modes\, \"Standard\" and Otherwise,
  160.             "Video Adapter Notes", "EGA", "Tweaked VGA", "Super-VGA",
  161.             "8514/A", "XGA", "Targa", "Targa+"}
  162. {6.2  , 1, "\"Disk-Video\" Modes"}
  163. {6.3  , 1, "Customized Video Modes\, FRACTINT.CFG"}
  164.  
  165. {7.   , 0, "Common Problems", FF}
  166.  
  167. {8.   , 0, "Fractals and the PC", FF}
  168. {8.1  , 1, A Little History}
  169. {8.1.1, 2, "Before Mandelbrot"}
  170. {8.1.2, 2, "Who Is This Guy\, Anyway?"}
  171. {8.2  , 1, A Little Code}
  172. {8.2.1, 2, "Periodicity Logic"}
  173. {8.2.2, 2, "Limitations of Integer Math (And How We Cope)"}
  174. {8.2.3, 2, "The Fractint \"Fractal Engine\" Architecture"}
  175.  
  176. {Appendix A, 0, Mathematics of the Fractal Types,
  177.            "Summary of Fractal Types",
  178.            "Inside=bof60|bof61|zmag|period",
  179.            "Inside=epscross|startrail",
  180.            "Finite Attractors",
  181.            "Trig Identities", FF}
  182.  
  183. {Appendix B, 0, Stone Soup With Pixels: The Authors,
  184.            "The Stone Soup Story",
  185.            "A Word About the Authors",
  186.            "Distribution of Fractint",
  187.            "Contacting the Authors", FF}
  188.  
  189. {Appendix C, 0, "GIF Save File Format", FF}
  190.  
  191. {Appendix D, 0, Other Fractal Products, FF}
  192.  
  193. {Appendix E, 0, "Bibliography", FF}
  194.  
  195. {Appendix F, 0, "Other Programs", FF}
  196.  
  197. {Appendix G, 0, Revision History,
  198.            "Version 17",
  199.            "Version 16",
  200.            "Version 15",
  201.            "Versions 12 through 14",
  202.            "Versions  1 through 11",
  203.            FF}
  204.  
  205. {Appendix H, 0, Version13 to Version 14 Type Mapping, "Version13 to 14 Conversion", FF}
  206. ;
  207. ; End of DoContents
  208. ;
  209. ;
  210. ;
  211. ~Topic=Using Help
  212. ; This topic is online only.
  213.  
  214. Use the following keys in help mode:
  215.  
  216.    F1           Go to the main help index.
  217.  
  218.    PgDn/PgUp       Go to the next/previous page.
  219.  
  220.    Backspace       Go to the previous topic.
  221.  
  222.    Escape       Exit help mode.
  223.  
  224.    Enter       Select (go to) highlighted hot-link.
  225.  
  226.    Tab/Shift-Tab   Move to the next/previous hot-link.
  227.  
  228.    \24 \25 \27 \26       Move to a hot-link.
  229.  
  230.    Home/End       Move to the first/last hot-link.
  231. ;
  232. ;
  233. ;
  234. ~Topic=Printing Fractint Documentation
  235.  
  236. You can generate a text file containing full Fractint documentation by
  237. selecting the "Generate FRACTINT.DOC now" hot-link below and pressing
  238. Enter, or by using the DOS command "fractint makedoc=filename" ("filename"
  239. is the name of the file to be written; it defaults to FRACTINT.DOC.)
  240.  
  241. All information in the documentation file is also available in the online
  242. help, so extracting it is a matter of preference - you can print the
  243. file (e.g.  DOS command "print fractint.doc" or "copy fractint.doc prn")
  244. or read it with a text editor.    It contains over 100 pages of information,
  245. has a table of contents, and is cross-referenced by page number.
  246.  
  247.   {=-101 Exit without generating FRACTINT.DOC}
  248.  
  249.   {=-100 Generate FRACTINT.DOC now}
  250.  
  251. Fractint's great (and unique as far as we know) online help and integrated
  252. documentation file software was written by Ethan Nagel.
  253. ;
  254. ;
  255. ;
  256. ~Topic=What's New for the Second Edition
  257. The first edition of Fractal Creations came with Fractint version 15.1x,
  258. which was released in late 1990. The Fractal Creations Second Edition
  259. comes with Fractint version 18.2X, released in mid 1993. In the
  260. intervening three years literally hundreds of new additions and improvements 
  261. have been made. A few of the main changes are highlighted here. For more 
  262. details see { New Features in Version 18.21 } and { Revision History }.
  263.  
  264.  * More than 27 new fractal types on the fractal type screen. Since
  265.    many previous fractal types have been consolidated, in reality
  266.    there are hundreds more new types.
  267.  
  268.  * Over 350 screens of on-line help accessible via a hypertext system
  269.    that lets you jump directly to related topics.
  270.  
  271.  * Many fractal types have been greatly speeded up through the use of
  272.    hand-coded assembler routines.
  273.  
  274.  * New real-time window mode lets you view orbit tracks and Julia outlines
  275.    as you move the cursor around your computer screen. 
  276.  
  277.  * New 3-D fractal types including ICON3D, new lorenz types, new IFS
  278.    types, and a greatly generalized Julibrot type that can use 4-D math.
  279.  
  280.  * Fractal parameter sets can be saved as named entries in .PAR files
  281.    so that you can exchange fractals in very compact form with fractal
  282.    enthusiasts around the world. Fractint's PAR format has become a
  283.    de facto standard supported by software on other platforms including
  284.    Mandella (Macintosh) and Xfract (UNIX).
  285.  
  286.  * New capability to make truly GIANT images, up to 65535x65535x256. The
  287.    previous limit was 2048x2048x256.
  288.  
  289.  * Greatly improved and expanded super VGA support.
  290.  
  291.  * IFS and Lyapunov fractals can now be stored as named entries
  292.    in .IFS and .L files.
  293.  
  294.  * Many new rendering options, including inside color options zmag, 
  295.    epscross, starcross, periodicity and outside options real, imag, mult,
  296.    and summ.
  297.  
  298.  * You can make fractal music (well, maybe "noise" is more accurate)
  299.    using Sound= with <O>rbits and <R>ead commands. This feature was
  300.    worked out with the help of Nick Dotson, a blind Fractint user,
  301.    who uses this feature to visualize fractals.
  302. ;
  303. ;
  304. ;
  305. ~Topic=New Features in Version 18.21
  306. Fractint version 18.21 is a special version of Fractint supplied with the
  307. Waite Group's "Fractal Creations, Second Edition", based on the 
  308. freeware version 18.2.
  309.  
  310. Versions 18.1 and 18.2 (and 18.21) are bug-fix releases for version 18.0.  
  311. Changes from 18.1 to 18.21 include:
  312.  
  313.  The <b> command now causes filenames only to be written in PAR files.
  314.  
  315.  Fractint will now search directories in the PATH for files not found in the 
  316.  requested the requested directory or the current directory. If you place 
  317.  .MAP, .FRM, etc. in directories in your PATH, then Fractint will find them.
  318.  
  319.  Fixed bug that caused fractals using PI symmetry to fail at high resolution.
  320.  
  321.  Fractals interrupted with <3> or <r> can now resume.
  322.  
  323.  The palette editor's <u> (undo) now works.
  324.  
  325.  The <s> command in orbit/Julia window mode is no longer case sensitive.
  326.  
  327.  Added warnings that the POV-Ray output is obsolete (but has been left in).
  328.  Use POV-Ray's height field facility instead or create and convert RAW files.
  329.  
  330.  Fixed several IFS bugs.
  331.  
  332. Changes from 18.0 to 18.1 include:
  333.  
  334.  Overlay tuning - the Mandelbrot/Julia Set fractals are now back up
  335.  to 17.x speeds
  336.  
  337.  Disk Video modes now work correctly with VESA video adapters (they
  338.  used to use the same array for different purposes, confusing each other)
  339.  
  340.  1024x768x256 and 2048x2048x256 disk video modes work again
  341.  
  342.  Parameter-file processing no longer crashes Fractint if it attempts to
  343.  run a formula requiring access to a non-existent FRM file
  344.  
  345.  IFS arrays no longer overrun their array space
  346.  
  347.  type=cellular fixes
  348.  
  349.  "autologmap=2" now correctly picks up the minimum color
  350.  
  351.  The use of disk-video mode with random-access fractal types is now
  352.  legal (it generates a warning message but lets you proceed if you
  353.  really want to)
  354.  
  355.  The Lsystems "spinning-wheel" now spins slower (removing needless overhead)
  356.  
  357.  Changes to contributors' addresses in the Help screens
  358.  
  359. (The remainder of this "new features" section is from version 18.0)
  360.  
  361. New fractal types:
  362.  
  363.  19 new fractal types, including:
  364.  
  365.  New fractal types - 'lambda(fn||fn)', 'julia(fn||fn)', 'manlam(fn||fn)',
  366.  'mandel(fn||fn)', 'halley', 'phoenix', 'mandphoenix', 'cellular',
  367.  generalized bifurcation, and 'bifmay' - from Jonathan Osuch.
  368.  
  369.  New Mandelcloud, Quaternion, Dynamic System, Cellular Automata fractal
  370.  types from Ken Shirriff.
  371.  
  372.  New HyperComplex fractal types from Timothy Wegner
  373.  
  374.  New ICON type from Dan Farmer, including a PAR file of examples.
  375.  
  376.  New Frothy Basin fractal types (and PAR entries) by Wesley Loewer
  377.  
  378.  MIIM (Modified Inverse Iteration Method) implementation of Inverse Julia
  379.  from Michael Snyder.
  380.  
  381.  New Inverse Julia fractal type from Juan Buhler.
  382.  
  383.  New floating-point versions of Markslambda, Marksmandel, Mandel4,
  384.  and Julia4 types (chosen automatically if the floating-point option
  385.  is enabled).
  386.  
  387. New options/features:
  388.  
  389.  New assembler-based parser logic from Chuck Ebbert - significantly
  390.  faster than the C-based code it replaces!
  391.  
  392.  New assembler-based Lyapunov logic from Nicholas Wilt and Wes Loewer.
  393.  Roughly six times faster than the old version!
  394.  
  395.  New Orbits-on-a-window / Julia-in-a-window options:\
  396.   1) The old Overlay option is now '#' (Shift-3).\
  397.   2) During generation, 'O' brings up orbits (as before) - after\
  398.      generation, 'O' brings up new orbits Windows mode.\
  399.   3) Control-O brings up new orbits Windows mode at any time.\
  400.   4) Spacebar toggles between Inverse Julia mode and the Julia set and\
  401.      back to the Mandelbrot set.\
  402.  These new "in-a-window" modes are really neat!  See {Orbits Window}
  403.  and {Julia Toggle Spacebar Commands} for details.
  404.  
  405.  New multi-image GIF support in the <B> command.  You can now generate
  406.  65535x65535x256 fractal images using Fractint (if you have the disk
  407.  space, of course).  This option builds special PAR entries and a
  408.  MAKEMIG.BAT file that you later use to invoke Fractint multiple times
  409.  to generate individual sections of the image and (in a final step)
  410.  stitch them all together.  If your other software can't handle
  411.  Multiple-image GIFs, a SIMPLGIF program is also supplied that converts
  412.  MIGS into simgle-image GIFs.  Press F1 at the <B> prompts screen for
  413.  details.
  414.  
  415.  Fractint's decoder now handles Multi-Image Gifs.
  416.  
  417.  New SuperVGA/VESA Autodetect logic from the latest version of
  418.  VGAKIT.  Sure hope we didn't break anything.
  419.  
  420.  New register-compatible 8514/A code from Jonathan Osuch.  By default,
  421.  Fractint now looks first for the presence of an 8514/A register-compatible
  422.  adapter and then (and only if it doesn't find one) the presence of the
  423.  8514/A API (IE, HDILOAD is no longer necessary for register-compatible
  424.  "8514/a" adapters).  Fractint can be forced to use the 8514/A API by using
  425.  a new command-line option, "afi=yes".  Jonathan also added ATI's
  426.  "8514/a-style" 800x600x256 and 1280x1024x16 modes.
  427.  
  428.  New XGA-detection logic for ISA-based XGA-2 systems.
  429.  
  430.  The palette editor now has a "freestyle" editing option.  See
  431.  {Palette Editing Commands} for details.
  432.  
  433.  
  434.  Fractint is now more "batch file" friendly.  When running Fractint from
  435.  a batch file, pressing any key will cause Fractint to exit with an
  436.  errorlevel = 2.  Any error that interrupts an image save to disk will
  437.  cause an exit with errorlevel = 2.  Any error that prevents an
  438.  image from being generated will cause an exit with errorlevel = 1.
  439.  
  440.  New Control-X, Control-Y, and Control-Z options flip a fractal image
  441.  along the X-axis, Y-axis, and Origin, respectively.
  442.  
  443.  New area calculation mode in TAB screen from Ken Shirriff 
  444.  (for accuracy use inside=0).
  445.  
  446.  The TAB screen now indicates when the Integer Math algorithms are in use.
  447.  
  448.  The palette must now be explicitly changed, it will not reset to the default
  449.  unexpectedly when doing things like switching video modes.
  450.  
  451.  The Julibrot type has been generalized.
  452.  Julibrot fractals can now be generated from PAR files.
  453.  
  454.  Added <b> command support for viewwindows. 
  455.  
  456.  Added room for two additional PAR comments in the <B> command
  457.  
  458.  New coloring method for IFS shows which parts of fractal came from
  459.  which transform.
  460.  
  461.  Added attractor basin phase plotting for Julia sets from Ken Shirriff.
  462.  
  463.  Improved finite attractor code to find more attractors from Ken Shirriff.
  464.  
  465.  New zero function, to be used in PAR files to replace old integer tan, tanh
  466.  
  467.  Debugflag=10000 now reports video chipset in use as well as CPU/FPU
  468.  type and available memory
  469.  
  470.  Added 6 additional parameters for params= for those fractal types that
  471.  need them.
  472.  
  473.  New 'matherr()' logic lets Fractint get more aggressive when these errors
  474.  happen.
  475.  
  476.  New autologmap option (log=+-2) from Robin Bussell that ensures that
  477.  all palette values are used by searching the screen border for the lowest
  478.  value and then setting log= to +- that color.
  479.  
  480.  Two new diffusion options - falling and square cavity.
  481.  
  482.  Three new Editpal commands: '!', '@' and '#' commands (that's
  483.  <shift-1>, <shift-2>, and <shift-3>) to swap R<->G, G<->B, R<->B.
  484.  
  485.  Parameter files now use a slightly shorter maximum line length, making
  486.  them a bit more readable when stuffed into messages on Compuserve.
  487.  
  488.  Plasma now has 16-bit .POT output for use with Ray tracers. The "old"
  489.  algorithm has been modified so that the plasma effect is independent
  490.  of resolution.
  491.  
  492.  Slight modification to the Raytrace code to make it compatible with
  493.  Rayshade 4.0 patch level 6.
  494.  
  495.  Improved boundary-tracing logic from Wesley Loewer.
  496.  
  497.  Command-line parameters can now be entered on-the-fly using the <g> key
  498.  thanks to Ken Shirriff.
  499.  
  500.  Dithered gif images can now be loaded onto a b/w display.
  501.  Thanks to Ken Shirriff.
  502.  
  503.  Pictures can now be output as compressed PostScript.
  504.  Thanks to Ken Shirriff.
  505.  
  506.  Periodicity is a new inside coloring option.
  507.  Thanks to Ken Shirriff.
  508.  
  509.  Fixes: symmetry values for the SQR functions, bailout for the floating-pt
  510.  versions of 'lambdafn' and 'mandelfn' fractals from Jonathan Osuch.
  511.  
  512.  "Flip", "conj" operators are now selectable in the parser
  513.  
  514.  New DXF Raytracing option from Dennis Bragg.
  515.  
  516.  Improved boundary-tracing logic from Wesley Loewer.
  517.  
  518.  New MSC7-style overlay structure is used if MAKEFRAC.BAT specifies MSC7.
  519.  (with new FRACTINT.DEF and FRACTINT.LNK files for MSC7 users).  Several
  520.  modules have been re-organized to take advantage of this new overlay
  521.  capability if compiled under MSC7.
  522.  
  523.  Fractint now looks first any embedded help inside FRACTINT.EXE, and then
  524.  for an external FRACTINT.HLP file before giving up. Previous releases
  525.  required that the help text be embedded inside FRACTINT.EXE.
  526.  
  527. Bug fixes:
  528.  
  529.  Corrected formulas displayed for Marksmandel, Cmplxmarksmandel, and
  530.   associated julia types.
  531.  
  532.  BTM and precision fixes.
  533.  
  534.  Symmetry logic changed for various "outside=" options
  535.  
  536.  Symmetry value for EXP function in lambdafn and lambda(fn||fn) fixed.
  537.  
  538.  Fixed bug where math errors prevented save in batch mode.
  539.  
  540.  The <3> and <r> commands no longer destroy image -- user can back out
  541.  with ESC and image is still there.
  542.  
  543.  Fixed display of correct number of Julibrot parameters, and Julibrot
  544.  relaxes and doesn't constantly force ALTERN.MAP.
  545.  
  546.  Fixed tesseral type for condition when border is all one color but center
  547.  contains image.
  548.  
  549.  Fixed integer mandel and julia when used with parameters > +1.99 and < -1.99
  550.  
  551.  Eliminated recalculation when generating a julia type from a mandelbrot
  552.  type when the 'z' screen is viewed for the first time.
  553.  
  554.  Minor logic change to prevent double-clutching into and out of graphics
  555.  mode when pressing, say, the 'x' key from a menu screen.
  556.  
  557.  Changed non-US phone number for the Houston Public (Software) Library
  558.  
  559.  The "Y" screen is now "Extended Options" instead of "Extended Doodads"
  560.  
  561.  ...and probably a lot more bux-fixes that we've since forgotten that
  562.  we've implemented.
  563.  
  564. ~Topic=Introduction
  565.  
  566. FRACTINT plots and manipulates images of "objects" -- actually, sets of
  567. mathematical points -- that have fractal dimension.
  568. See {"Fractals and the PC"} for some
  569. historical and mathematical background on fractal geometry, a discipline
  570. named and popularized by mathematician Benoit Mandelbrot. For now, these
  571. sets of points have three important properties:
  572.  
  573. 1) They are generated by relatively simple calculations repeated over and
  574. over, feeding the results of each step back into the next -- something
  575. computers can do very rapidly.
  576.  
  577. 2) They are, quite literally, infinitely complex: they reveal more and
  578. more detail without limit as you plot smaller and smaller areas. Fractint
  579. lets you "zoom in" by positioning a small box and hitting <Enter> to
  580. redraw the boxed area at full-screen size; its maximum linear
  581. "magnification" is over a trillionfold.
  582.  
  583. 3) They can be astonishingly beautiful, especially using PC color
  584. displays' ability to assign colors to selected points, and (with VGA
  585. displays or EGA in 640x350x16 mode) to "animate" the images by quickly
  586. shifting those color assignments.
  587. ~OnlineFF
  588.  
  589. For a demonstration of some of Fractint's features, run the demonstration
  590. file included with this release (DEMO.BAT) by typing "demo" at the DOS
  591. prompt. You can stop the demonstration at any time by pressing <Esc>.
  592.  
  593. The name FRACTINT was chosen because the program generates many of its
  594. images using INTeger math, rather than the floating point calculations
  595. used by most such programs. That means that you don't need a math co-
  596. processor chip (aka floating point unit or FPU), although for a few
  597. fractal types where floating point math is faster, the program recognizes
  598. and automatically uses an 80x87 chip if it's present. It's even faster on
  599. systems using Intel's 80386 and 80486 microprocessors, where the integer
  600. math can be executed in their native 32-bit mode.
  601.  
  602. Fractint works with many adapters and graphics modes from CGA to the
  603. 1024x768, 256-color XGA mode. Even "larger" images, up to 2048x2048x256,
  604. can be plotted to expanded memory, extended memory, or disk: this bypasses
  605. the screen and allows you to create images with higher resolution than
  606. your current display can handle, and to run in "background" under multi-
  607. tasking control programs such as DESQview and Windows 3.
  608. ~OnlineFF
  609.  
  610. Fractint is an experiment in collaboration. Many volunteers have joined
  611. Bert Tyler, the program's first author, in improving successive versions. 
  612. Through electronic mail messages, first on CompuServe's PICS forum and now 
  613. on GRAPHDEV, new versions are hacked out and debugged a little at a time.
  614. Fractint was born fast, and none of us has seen any other fractal plotter
  615. close to the present version for speed, versatility, and all-around
  616. wonderfulness. (If you have, tell us so we can steal somebody else's ideas
  617. instead of each other's.)
  618. See {The Stone Soup Story} and {A Word About the Authors} for information
  619. about the authors, and see {Contacting the Authors} for how to contribute
  620. your own ideas and code.
  621. ;
  622. ;
  623. ;
  624. ~Topic=Conditions on Use
  625.  
  626. Fractint is freeware. The copyright is retained by the Stone Soup Group.
  627.  
  628. Fractint may be freely copied and distributed in unmodified form but may
  629. not be sold. (A nominal distribution fee may be charged for media and
  630. handling by freeware and shareware distributors.) Fractint may be used
  631. personally or in a business - if you can do your job better by using
  632. Fractint, or using images from it, that's great! It may not be given away
  633. with commercial products without explicit permission from the Stone Soup
  634. Group.
  635.  
  636. There is no warranty of Fractint's suitability for any purpose, nor any
  637. acceptance of liability, express or implied.
  638.  
  639.  **********************************************************************\
  640.  * Contribution policy: Don't want money. Got money. Want admiration. *\
  641.  **********************************************************************
  642. ~OnlineFF
  643.  
  644. Source code for Fractint is also freely available - see
  645. {Distribution of Fractint}.
  646. See the FRACTSRC.DOC file included with the source for conditions on use.
  647. (In most cases we just want credit.)
  648. ;
  649. ;
  650. ;
  651. ~Topic=Getting Started
  652.  
  653. To start the program, enter FRACTINT at the DOS prompt. The program
  654. displays an initial "credits" screen. If Fractint doesn't start properly,
  655. please see {Common Problems}.
  656.  
  657. Hitting <Enter> gets you from the initial screen to the main menu. You can
  658. select options from the menu by moving the highlight with the cursor arrow
  659. keys
  660. ~Doc-
  661. (\24 \25 \27 \26)
  662. ~Doc+
  663. and pressing <Enter>, or you can enter commands directly.
  664.  
  665. As soon as you select a video mode, Fractint begins drawing an image - the
  666. "full" Mandelbrot set if you haven't selected another fractal type.
  667.  
  668. For a quick start, after starting Fractint try one of the following:\
  669.   If you have MCGA, VGA, or better:  <F3>\
  670.   If you have EGA:             <F9>\
  671.   If you have CGA:             <F5>\
  672.   Otherwise, monochrome:         <F6>
  673.  
  674. After the initial Mandelbrot image has been displayed, try zooming
  675. into it (see {Zoom Box Commands}) and color cycling (see
  676. {Color Cycling Commands}).
  677. Once you're comfortable with these basics, start exploring other
  678. functions from the main menu.
  679.  
  680. Help is available from the menu and at most other points in Fractint by
  681. pressing the <F1> key.
  682.  
  683. AT ANY TIME, you can hit
  684. ~Doc-
  685. one of the keys described in {Display Mode Commands}
  686. ~Doc+,Online-
  687. a command key
  688. ~Online+
  689. to select a function. You do not need to wait for a calculation
  690. to finish, nor do you have to return to the main menu.
  691.  
  692. When entering commands, note that for the "typewriter" keys, upper and
  693. lower case are equivalent, e.g. <B> and <b> have the same result.
  694.  
  695. Many commands and parameters can be passed to FRACTINT as command-line
  696. arguments or read from a configuration file;
  697. ~Doc-
  698. see {Startup Parameters\, Parameter Files} for details.
  699. ~Doc+,Online-
  700. see "Command Line Parameters, Parameter Files, Batch Mode" for details.
  701. ~Online+
  702. ;
  703. ;
  704. ;
  705. ~Topic=Display Mode Commands
  706. ;
  707. ; This topic is online only
  708.  
  709. ~Format-
  710.    { Summary of Commands }
  711.    { Plotting Commands}
  712.    { Zoom Box Commands }
  713.    { Image Save/Restore Commands }
  714.    { Print Command }
  715.    { Parameter Save/Restore Commands }
  716.    { Interrupting and Resuming }
  717.    { Orbits Window }
  718.    { View Window }
  719.    { \"3D\" Commands }
  720.    { Video Mode Function Keys }
  721.    { Hints }
  722. ;
  723. ;
  724. ;
  725. ~Topic=Summary of Commands, Label=HELPMAIN
  726. ; This topic is online only
  727. ~Doc-
  728.  
  729. Hit any of these keys at the menu or while drawing or viewing a fractal.
  730. Commands marked with an '*' are also available at the credits screen.
  731.  
  732. ~Format-
  733. {Plotting Commands}
  734.  * Delete,F2,F3,.. Select a Video Mode and draw (or redraw) current fractal
  735.  * F1           HELP! (Enter help mode)
  736.    Esc or m       Go to main menu
  737.    \\            Redraw previous screen (you can 'back out' recursively)
  738.    Tab           Display information about the current fractal image
  739.  * t           Select a new fractal type and parameters
  740.  * x           Set a number of options and doodads
  741.  * y           Set extended options and doodads
  742.  * z           Set fractal type-specific parameters
  743.    c or + or -       Enter Color-Cycling Mode (see {=HELPCYCLING Color Cycling Commands})
  744.    e           Enter Palette-Editing Mode (see {=HELPXHAIR Palette Editing Commands})
  745.    Spacebar       Mandelbrot/Julia Set toggle.
  746.    Enter       Continue an interrupted calculation (e.g. after a save)
  747.  * f           toggle the floating-point algorithm option ON or OFF
  748.  * i           Set parameters for 3D fractal types
  749.  * Insert       Restart the program (at the credits screen)
  750.    a           Convert the current image into a fractal 'starfield'
  751.    o           toggles 'orbits' option on and off during image generation
  752.  * d           Shell to DOS (type 'exit' at the DOS prompt to return)
  753.    Ctrl-X       Flip the current image along the screen's X-axis
  754.    Ctrl-Y       Flip the current image along the screen's Y-axis
  755.    Ctrl-Z       Flip the current image along the screen's Origin
  756.  
  757. {Image Save/Restore Commands}
  758.    s           Save the current screen image to disk
  759.  * r           Restore a saved (or .GIF) image ('3' or 'o' for 3-D)
  760.  
  761. {Orbits Window}
  762.    o           Turns on Orbits Window mode after image generation
  763.    ctrl-o       Turns on Orbits Window mode 
  764.  
  765. {View Window}
  766.  * v           Set view window parameters (reduction, aspect ratio)
  767.  
  768. {Print Command}
  769.    p           Print the screen (command-line options set printer type)
  770. ~OnlineFF
  771. {Parameter Save/Restore Commands}
  772.    b           Save commands describing the current image in a file
  773.            (writes an entry to be used with @ command)
  774.  * @           Run a set of commands (in command line format) from a file
  775.    g           Give a startup parameter: {Summary of all Parameters}
  776.  
  777. {\"3D\" Commands}
  778.  * 3           3D transform a saved (or .GIF) image
  779.    # (shift-3)       same as 3, but overlay the current image
  780.  
  781. {Zoom Box Commands}
  782.    PageUp       When no Zoom Box is active, bring one up
  783.            When active already, shrink it
  784.    PageDown       Expand the Zoom Box
  785.            Expanding past the screen size cancels the Zoom Box
  786.    \24 \25 \27 \26       Pan (Move) the Zoom Box
  787.    Ctrl- \24 \25 \27 \26   Fast-Pan the Zoom Box (may require an enhanced keyboard)
  788.    Enter       Redraw the Screen or area inside the Zoom Box
  789.    Ctrl-Enter       'Zoom-out' - expands the image so that your current
  790.            image is positioned inside the current zoom-box location.
  791.    Ctrl-Pad+/Pad-  Rotate the Zoom Box
  792.    Ctrl-PgUp/PgDn  Change Zoom Box vertical size (change its aspect ratio)
  793.    Ctrl-Home/End   Change Zoom Box shape
  794.    Ctrl-Ins/Del    Change Zoom Box color
  795.  
  796. {Interrupting and Resuming}
  797.  
  798. {Video Mode Function Keys}
  799. ~Doc+
  800. ;
  801. ;
  802. ;
  803. ~Topic=Plotting Commands
  804.  
  805. Function keys & various combinations are used to select a video mode and
  806. redraw the screen.  For a quick start try one of the following:\
  807.   If you have MCGA, VGA, or better:  <F3>\
  808.   If you have EGA:             <F9>\
  809.   If you have CGA:             <F5>\
  810.   Otherwise, monochrome:         <F6>\
  811.  
  812. <F1>\
  813. Display a help screen. The function keys available in help mode are
  814. displayed at the bottom of the help screen.
  815.  
  816. <M> or <Esc>\
  817. Return from a displayed image to the main menu.
  818.  
  819. <Esc>\
  820. From the main menu, <Esc> is used to exit from Fractint.
  821.  
  822. <Delete>\
  823. Same as choosing "select video mode" from the main menu.
  824. Goes to the "select video mode" screen.  See {Video Mode Function Keys}.
  825.  
  826. <\\> (previously <Home>)\
  827. Redraw the previous image. The program tracks 25 sets of previous
  828. coordinates and fractal types, but does not remember other options which
  829. were different for those past images.
  830.  
  831. <Tab>\
  832. Display the current fractal type, parameters, video mode, screen or (if
  833. displayed) zoom-box coordinates, maximum iteration count, and other
  834. information useful in keeping track of where you are.  The Tab function is
  835. non-destructive - if you press it while in the midst of generating an
  836. image, you will continue generating it when you return.  The Tab function
  837. tells you if your image is still being generated or has finished - a handy
  838. feature for those overnight, 1024x768 resolution fractal images.  If the
  839. image is incomplete, it also tells you whether it can be interrupted and
  840. resumed.  (Any function other than <Tab> and <F1> counts as an
  841. "interrupt".)
  842.  
  843. The Tab screen also includes a pixel-counting function, which will count
  844. the number of pixels colored in the inside color.  This gives an estimate
  845. of the area of the fractal.  Note that the inside color must be different
  846. from the outside color(s) for this to work; inside=0 is a good choice.
  847.  
  848. <T>\
  849. Select a fractal type. Move the cursor to your choice (or type the first
  850. few letters of its name) and hit <Enter>. Next you will be prompted for
  851. any parameters used by the selected type - hit <Enter> for the defaults.
  852. See {Fractal Types} for a list of supported types.
  853.  
  854. <X>\
  855. Select a number of eXtended options. Brings up a full-screen menu of
  856. options, any of which you can change at will.  These options are:\
  857.   "passes=" - see {Drawing Method}\
  858.   Floating point toggle - see <F> key description below\
  859.   "maxiter=" - see {Image Calculation Parameters}\
  860.   "inside=" and "outside=" - see {Color Parameters}\
  861.   "savename=" filename - see {File Parameters}\
  862.   "overwrite=" option - see {File Parameters}\
  863.   "sound=" option - see {Sound Parameters}\
  864.   "logmap=" - see {Logarithmic Palettes and Color Ranges}\
  865.   "biomorph=" - see {Biomorphs}\
  866.   "decomp=" - see {Decomposition}\
  867.   "fillcolor=" - see {Drawing Method}\
  868.  
  869. <F>\
  870. Toggles the use of floating-point algorithms
  871. (see {"Limitations of Integer Math (And How We Cope)"}).
  872. Whether floating point is in
  873. use is shown on the <Tab> status screen.  The floating point option can
  874. also be turned on and off using the "X" options screen.
  875. If you have a non-Intel floating point chip which supports the full 387
  876. instruction set, see the "FPU=" command in {Startup Parameters}
  877. to get the most out of your chip.
  878.  
  879. <Y>\
  880. More options which we couldn't fit under the <X> command:\
  881.   "finattract=" - see {Finite Attractors}\
  882.   "potential=" parameters - see {Continuous Potential}\
  883.   "invert=" parameters - see {Inversion}\
  884.   "distest=" parameters - see {Distance Estimator Method}\
  885.   "cyclerange=" - see {Color Cycling Commands}\
  886.  
  887. <Z>\
  888. Modify the parameters specific to the currently selected fractal type.
  889. This command lets you modify the parameters which are requested when you
  890. select a new fractal type with the <T> command, without having to repeat
  891. that selection. You can enter "e" or "p" in column one of the input fields
  892. to get the numbers e and pi (2.71828... and 3.14159...).\
  893. From the fractal parameters screen, you can press <F6> to bring up a
  894. sub parameter screen for the coordinates of the image's corners.
  895. ; With the IFS fractal type, <Z> brings up the IFS editor (see
  896. ; {=HT_IFS Barnsley IFS Fractals}).
  897.  
  898. <+> or <->\
  899. Switch to color-cycling mode and begin cycling the palette
  900. by shifting each color to the next "contour."  See {Color Cycling Commands}.\
  901. <C>\
  902. Switch to color-cycling mode but do not start cycling.
  903. The normally black "overscan" border of the screen changes to white.
  904. See {Color Cycling Commands}.
  905.  
  906. <E>\
  907. Enter Palette-Editing Mode.  See {Palette Editing Commands}.
  908.  
  909. <Spacebar>\
  910. Toggle between Mandelbrot set images and their corresponding Julia-set
  911. images. Read the notes in {=HT_JULIA Fractal Types, Julia Sets}
  912. before trying this option if you want to see anything interesting.
  913.  
  914. <J>\
  915. Toggle between Julia escape time fractal and the Inverse Julia orbit
  916. fractal. See {=HT_INVERSE Inverse Julias}
  917.  
  918. <Enter>\
  919. Enter is used to resume calculation after a pause. It is only
  920. necessary to do this when there is a message on the screen waiting to be
  921. acknowledged, such as the message shown after you save an image to disk.
  922.  
  923. <I>\
  924. Modify 3D transformation parameters used with 3D fractal types such as
  925. "Lorenz3D" and 3D "IFS" definitions, including the selection of
  926. {=HELP3DGLASSES "funny glasses"} red/blue 3D.
  927.  
  928. <A>\
  929. Convert the current image into a fractal 'starfield'.  See {Starfields}.
  930.  
  931. <O> (the letter, not the number)\
  932. If pressed while an image is being generated, toggles the display of
  933. intermediate results -- the "orbits" Fractint uses as it calculates values
  934. for each point. Slows the display a bit, but shows you how clever the
  935. program is behind the scenes. (See "A Little Code" in
  936. {"Fractals and the PC"}.)
  937.  
  938. <D>\
  939. Shell to DOS. Return to Fractint by entering "exit" at a DOS prompt.
  940. ~OnlineFF
  941. <Insert>\
  942. Restart at the "credits" screen and reset most variables to their initial
  943. state.    Variables which are not reset are: savename, lightname, video,
  944. startup filename.
  945. ;
  946. ;
  947. ;
  948. ~Topic=Zoom Box Commands, Label=HELPZOOM
  949.  
  950. Zoom Box functions can be invoked while an image is being generated or when
  951. it has been completely drawn.  Zooming is supported for most fractal types,
  952. but not all.
  953.  
  954. The general approach to using the zoom box is:    Frame an area using
  955. the keys described below,
  956. then <Enter> to expand what's in the frame to fill the
  957. whole screen (zoom in); or <Ctrl><Enter> to shrink the current image into
  958. the framed area (zoom out). With a mouse, double-click the left button to
  959. zoom in, double click the right button to zoom out.
  960.  
  961. <Page Up>, <Page Down>\
  962. Use <Page Up> to initially bring up the zoom box. It starts at full screen
  963. size. Subsequent use of these keys makes the zoom box smaller or larger.
  964. Using <Page Down> to enlarge the zoom box when it is already at maximum
  965. size removes the zoom box from the display. Moving the mouse away from you
  966. or toward you while holding the left button down performs the same
  967. functions as these keys.
  968.  
  969. Using the cursor "arrow" keys
  970. ~Doc-
  971. (\24 \25 \27 \26)
  972. ~Doc+
  973. or moving
  974. the mouse without holding any buttons down, moves the zoom box.
  975.  
  976. Holding <Ctrl> while pressing cursor "arrow" keys moves the box 5 times
  977. faster.  (This only works with enhanced keyboards.)
  978.  
  979. Panning: If you move a fullsize zoombox and don't change anything else
  980. before performing the zoom, Fractint just moves what's already on the
  981. screen and then fills in the new edges, to reduce drawing time. This
  982. feature applies to most fractal types but not all.  A side effect is that
  983. while an image is incomplete, a full size zoom box moves in steps larger
  984. than one pixel.  Fractint keeps the box on multiple pixel boundaries, to
  985. make panning possible.    As a multi-pass (e.g. solid guessing) image
  986. approaches completion, the zoom box can move in smaller increments.
  987.  
  988. In addition to resizing the zoom box and moving it around, you can do some
  989. rather warped things with it.  If you're a new Fractint user, we recommend
  990. skipping the rest of the zoom box functions for now and coming back to
  991. them when you're comfortable with the basic zoom box functions.
  992.  
  993. <Ctrl><Keypad->, <Ctrl><Keypad+>\
  994. Holding <Ctrl> and pressing the numeric keypad's + or - keys rotates the
  995. zoom box. Moving the mouse left or right while holding the right button
  996. down performs the same function.
  997.  
  998. <Ctrl><Page Up>, <Ctrl><Page Down>\
  999. These commands change the zoom box's "aspect ratio", stretching or
  1000. shrinking it vertically. Moving the mouse away from you or toward you
  1001. while holding both buttons (or the middle button on a 3-button mouse) down
  1002. performs the same function. There are no commands to directly stretch or
  1003. shrink the zoom box horizontally - the same effect can be achieved by
  1004. combining vertical stretching and resizing.
  1005.  
  1006. <Ctrl><Home>, <Ctrl><End>\
  1007. These commands "skew" the zoom box, moving the top and bottom edges in
  1008. opposite directions. Moving the mouse left or right while holding both
  1009. buttons (or the middle button on a 3-button mouse) down performs the same
  1010. function. There are no commands to directly skew the left and right edges
  1011. - the same effect can be achieved by using these functions combined with
  1012. rotation.
  1013.  
  1014. <Ctrl><Insert>, <Ctrl><Delete>\
  1015. These commands change the zoom box color. This is useful when you're
  1016. having trouble seeing the zoom box against the colors around it. Moving
  1017. the mouse away from you or toward you while holding the right button down
  1018. performs the same function.
  1019.  
  1020. You may find it difficult to figure out what combination of size, position
  1021. rotation, stretch, and skew to use to get a particular result.    (We do.)\
  1022. A good way to get a feel for all these functions is to play with the
  1023. Gingerbreadman fractal type. Gingerbreadman's shape makes it easy to
  1024. see what you're doing to him. A warning though: Gingerbreadman will run
  1025. forever, he's never quite done! So, pre-empt with your next zoom when he's
  1026. baked enough.
  1027.  
  1028. If you accidentally change your zoom box shape or rotate and
  1029. forget which way is up, just use <PageDown> to make it bigger until it
  1030. disappears, then <PageUp> to get a fresh one.  With a
  1031. mouse, after removing the old zoom box from the display release and
  1032. re-press the left button for a fresh one.
  1033.  
  1034. If your screen does not have a 4:3 "aspect ratio" (i.e. if the visible
  1035. display area on it is not 1.333 times as wide as it is high), rotating and
  1036. zooming will have some odd effects - angles will change, including the
  1037. zoom box's shape itself, circles (if you are so lucky as to see any with a
  1038. non-standard aspect ratio) become non-circular, and so on. The vast
  1039. majority of PC screens *do* have a 4:3 aspect ratio.
  1040.  
  1041. Zooming is not implemented for the plasma and diffusion fractal types, nor
  1042. for overlayed and 3D images. A few fractal types support zooming but
  1043. do not support rotation and skewing - nothing happens when you try it.
  1044. ;
  1045. ;
  1046. ;
  1047. ~Topic=Image Save/Restore Commands, Label=HELPSAVEREST
  1048.  
  1049. <S> saves the current image to disk. All parameters required to recreate
  1050. the image are saved with it. Progress is marked by colored lines moving
  1051. down the screen's edges.
  1052.  
  1053. The default filename for the first image saved after starting Fractint is
  1054. FRACT001.GIF;  subsequent saves in the same session are automatically
  1055. incremented 002, 003... Use the "savename=" parameter or <X> options
  1056. screen to change the name. By default, files left over from previous
  1057. sessions are not overwritten - the first unused FRACTnnn name is used.
  1058. Use the "overwrite=yes" parameter or <X> options screen) to overwrite
  1059. existing files.
  1060.  
  1061. A save operation can be interrupted by pressing any key. If you interrupt,
  1062. you'll be asked whether to keep or discard the partial file.
  1063.  
  1064. <R> restores an image previously saved with <S>, or an ordinary GIF file.
  1065. After pressing <R> you are shown the file names in the current directory
  1066. which match the current file mask. To select a file to restore, move the
  1067. cursor to it (or type the first few letters of its name) and press
  1068. <Enter>.
  1069.  
  1070. Directories are shown in the file list with a "\\" at the end of the name.
  1071. When you select a directory, the contents of that directory are shown. Or,
  1072. you can type the name of a different directory (and optionally a different
  1073. drive) and press <Enter> for a new display. You can also type a mask such
  1074. as "*.XYZ" and press <Enter> to display files whose name ends with the
  1075. matching suffix (XYZ).
  1076.  
  1077. You can use <F6> to switch directories to the default fractint directory
  1078. or to your own directory which is specified through the DOS environment
  1079. variable "FRACTDIR".
  1080.  
  1081. Once you have selected a file to restore, a summary description of the
  1082. file is shown, with a video mode selection list. Usually you can just
  1083. press <Enter> to go past this screen and load the image. Other choices
  1084. available at this point are:\
  1085.   Cursor keys: select a different video mode\
  1086.   <Tab>: display more information about the fractal\
  1087.   <F1>: for help about the "err" column in displayed video modes\
  1088. If you restore a file into a video mode which does not have the same pixel
  1089. dimensions as the file, Fractint will make some adjustments:  The view
  1090. window parameters (see <V> command) will automatically be set to an
  1091. appropriate size, and if the image is larger than the screen dimensions,
  1092. it will be reduced by using only every Nth pixel during the restore.
  1093. ;
  1094. ;
  1095. ;
  1096. ~Topic=Print Command
  1097.  
  1098. <P>\
  1099.  
  1100. Print the current fractal image on your (Laserjet, Paintjet, Epson-
  1101. compatible, PostScript, or HP-GL) printer.
  1102.  
  1103. See {"Setting Defaults (SSTOOLS.INI File)"} and {"Printer Parameters"}
  1104. for how to let Fractint know about your printer setup.
  1105.  
  1106. {"Disk-Video" Modes} can be used to
  1107. generate images for printing at higher resolutions than your screen
  1108. supports.
  1109. ;
  1110. ;
  1111. ;
  1112. ~Topic=Parameter Save/Restore Commands, Label=HELPPARMFILE
  1113.  
  1114. Parameter files can be used to save/restore all options and settings
  1115. required to recreate particular images.  The parameters required to
  1116. describe an image require very little disk space, especially compared with
  1117. saving the image itself.
  1118.  
  1119. <@>
  1120.  
  1121. The <@> command loads a set of parameters describing an image.
  1122. (Actually, it can also be used to set non-image parameters such as SOUND,
  1123. but at this point we're interested in images. Other uses of parameter
  1124. files are discussed in {"Parameter Files and the <@> Command"}.)
  1125.  
  1126. When you hit <@>, Fractint displays the names of the entries in the
  1127. currently selected parameter file.  The default parameter file,
  1128. FRACTINT.PAR, is included with the Fractint release and contains
  1129. parameters for some sample images.
  1130.  
  1131. After pressing <@>, highlight an entry and press <Enter> to load it, or
  1132. press <F6> to change to another parameter file.
  1133.  
  1134. Note that parameter file entries specify all calculation related
  1135. parameters, but do not specify things like the video mode - the image will
  1136. be plotted in your currently selected mode.
  1137.  
  1138. <B>
  1139.  
  1140. The <B> command saves the parameters required to describe the currently
  1141. displayed image, which can subsequently be used with the <@> command to
  1142. recreate it.
  1143.  
  1144. After you press <B>, Fractint prompts for:
  1145.  
  1146.   Parameter file:  The name of the file to store the parameters in.  You
  1147.   should use some name like "myimages" instead of fractint.par, so that
  1148.   your images are kept separate from the ones released with new versions
  1149.   of Fractint. You can use the PARMFILE= command in SSTOOLS.INI
  1150.   to set the default parameter file name to "myimages" or whatever.
  1151.   (See {"Setting Defaults (SSTOOLS.INI File)"} and "parmfile=" in
  1152.   {"File Parameters"}.)
  1153.  
  1154.   Name:  The name you want to assign to the entry, to be displayed when
  1155.   the <@> command is used.
  1156.  
  1157.   Main comment:  A comment to be shown beside the entry in the <@> command
  1158.   display.
  1159.  
  1160.   Second, Third, and Fourth comment:  Additional comments to store in the 
  1161.   file with the entry. These comments go in the file only, and are not 
  1162.   displayed by the <@> command.
  1163.  
  1164.   Record colors?:  Whether color information should be included in the
  1165.   entry. Usually the default value displayed by Fractint is what you want.
  1166.   Allowed values are:\
  1167.   "no" - Don't record colors. This is the default if the image is using
  1168.      your video adapter's default colors.
  1169.   "@mapfilename" - When these parameters are used, load colors from the
  1170.      named color map file. This is the default if you are currently using
  1171.      colors from a color map file.
  1172.   "yes" - Record the colors in detail. This is the default when you've
  1173.      changed the display colors by using the palette editor or by color
  1174.      cycling. The only reason that this isn't what Fractint always does
  1175.      for the <B> command is that color information can be bulky - up to
  1176.      nearly 1K of disk space. That may not
  1177.      sound like much, but can add up when you consider the thousands of
  1178.      wonderful images you may find you just *have* to record...
  1179.      Smooth-shaded ranges of colors are compressed, so if that's used a
  1180.      lot in an image the color information won't be as bulky.
  1181.  
  1182.   # of colors:    This only matters if "Record colors?" is set to "yes".  It
  1183.   specifies the number of colors to record. Recording less colors will
  1184.   take less space. Usually the default value displayed by Fractint is what
  1185.   you want. You might want to increase it in some cases, e.g. if you are
  1186.   using a 256 color mode with maxiter 150, and have used the palette
  1187.   editor to set all 256 possible colors for use with color cycling, then
  1188.   you'll want to set the "# of colors" to 256.
  1189.  
  1190.   At the bottom of the input screen are inputs for Fractint's "pieces"
  1191.   divide-and-conquer feature. You can create multiple PAR entries that
  1192.   break an image up into pieces so that you can generate the image pieces 
  1193.   one by one. There are two reasons for doing this. The first is in case the
  1194.   fractal is very slow, and you want to generate parts of the image at the 
  1195.   same time on several computers. The second is that you might want to make 
  1196.   an image greater than 2048 x 2048. The parameters for this feature are:
  1197.      X Multiples - How many divisions of final image in the x direction\
  1198.      Y Multiples - How many divisions of final image in the y direction\
  1199.      Video mode  - Fractint video mode for each piece (e.g. "F3")\
  1200.  
  1201.   The last item defaults to the current video mode. If either X Multiples or
  1202.   Y Multiples are greater than 1, then multiple numbered PAR entries for the
  1203.   pieces are added to the PAR file, and a MAKEMIG.BAT file is created that
  1204.   builds all of the component pieces and then stitches them together into
  1205.   a "multi-image" GIF.  The current limitations of the "divide and conquer"
  1206.   algorithm are 36 or fewer X and Y multiples (so you are limited to "only"
  1207.   36x36=1296 component images), and a final resolution limit in both the
  1208.   X and Y directions of 65,535 (a limitation of "only" four billion pixels
  1209.   or so).
  1210.  
  1211.   The final image generated by MAKEMIG is a "multi-image" GIF file called
  1212.   FRACTMIG.GIF.  In case you have other software that can't handle
  1213.   multi-image GIF files, MAKEMIG includes a final (but commented out) call
  1214.   to SIMPLGIF, a companion program that reads a GIF file that may contain
  1215.   little tricks like multiple images and creates a simple GIF from it.
  1216.   Fair warning: SIMPLGIF needs room to build a composite image while it
  1217.   works, and it does that using a temporary disk file equal to the size
  1218.   of the final image - and a 64Kx64K GIF image requires a 4GB temporary
  1219.   disk file!
  1220.  
  1221. <G>
  1222.  
  1223. The <G> command lets you give a startup parameter interactively.
  1224. ;
  1225. ;
  1226. ;
  1227. ~Topic=<X> Options Screen, Label=HELPXOPTS
  1228. ; This topic is online context-sensitive only.
  1229.  
  1230.    Passes - see {Drawing Method}\
  1231.    Fillcolor - see {Drawing Method}\
  1232.    Floating Point Algorithm - see notes below\
  1233.    Maximum Iterations - see {Image Calculation Parameters}\
  1234.    Inside and Outside colors - see {Color Parameters}\
  1235.    Savename and File Overwrite - see {File Parameters}\
  1236.    Sound option - see {Sound Parameters}\
  1237.    Log Palette - see {Logarithmic Palettes and Color Ranges}\
  1238.    Biomorph Color - see {Biomorphs}\
  1239.    Decomp Option - see {Decomposition}\
  1240.  
  1241. You can toggle the use of floating-point algorithms on this screen (see
  1242. {"Limitations of Integer Math (And How We Cope)"}).  Whether floating
  1243. point is in use is shown on the <Tab> status screen.  If you have a
  1244. non-Intel floating point chip which supports the full 387 instruction set,
  1245. see the "FPU=" command in {Startup Parameters} to get the most out of your
  1246. chip.
  1247. ;
  1248. ;
  1249. ~Topic=<Y> Options Screen, Label=HELPYOPTS
  1250. ; This topic is online context-sensitive only.
  1251.  
  1252.    Finite attractor - see{ Finite Attractors }\
  1253.  
  1254.    Potential parameters - see{ Continuous Potential }\
  1255.  
  1256.    Distance Estimator parameters - see{ Distance Estimator Method }\
  1257.  
  1258.    Inversion parameters - see{ Inversion }\
  1259.  
  1260.    Color cycling range - see{ Color Cycling Commands }\
  1261. ;
  1262. ;
  1263. ~Topic=Image Coordinates Screen, Label=HELPCOORDS
  1264. ; This topic is online context-sensitive only.
  1265.  
  1266. You can directly enter corner coordinates on this screen instead of
  1267. using the zoom box to move around.  You can also use <F4> to reset
  1268. the coordinates to the defaults for the current fractal type.
  1269.  
  1270. There are two formats for the display: corners or center-mag.  You can
  1271. toggle between the two by using <F7>.
  1272.  
  1273. In corners mode, corner coordinate values are entered directly.  Usually
  1274. only the top-left and bottom-right corners need be specified - the
  1275. bottom left corner can be entered as zeros to default to an ordinary
  1276. unrotated rectangular area.  For rotated or skewed images, the bottom
  1277. left corner must also be specified.
  1278.  
  1279. Center-mag mode can only be used with unrotated unstretched images.
  1280. In this mode the image area is described by entering the coordinates for
  1281. the center of the rectangle, and its magnification factor.
  1282. ;
  1283. ;
  1284. ;
  1285. ~Topic=Interrupting and Resuming
  1286.  
  1287. Fractint command keys can be loosely grouped as:
  1288.  
  1289.  o Keys which suspend calculation of the current image (if one is being
  1290.    calculated) and automatically resume after the function.  <Tab>
  1291.    (display status information) and <F1> (display help), are the only
  1292.    keys in this group.
  1293.  
  1294.  o Keys which automatically trigger calculation of a new image.
  1295.    Examples:  selecting a video mode (e.g. <F3>);  selecting a fractal
  1296.    type using <T>;  using the <X> screen to change an option such as
  1297.    maximum iterations.
  1298.  
  1299.  o Keys which do something, then wait for you to indicate what to do
  1300.    next.  Examples:  <M> to go to main menu;  <C> to enter color cycling
  1301.    mode;  <PageUp> to bring up a zoom box.  After using a command in this
  1302.    group, calculation automatically resumes when you return from the
  1303.    function (e.g. <Esc> from color cycling, <PageDn> to clear zoom box).
  1304.    There are a few fractal types which cannot resume calculation, they
  1305.    are noted below.  Note that after saving an image with <S>, you must
  1306.    press <Enter> to clear the "saved" message from the screen and resume.
  1307.  
  1308. An image which is <S>aved before it completes can later be <R>estored and
  1309. continued. The calculation is automatically resumed when you restore such
  1310. an image.
  1311.  
  1312. When a slow fractal type resumes after an interruption in the third
  1313. category above, there may be a lag while nothing visible happens.  This is
  1314. because most cases of resume restart at the beginning of a screen line.
  1315. If unsure, you can check whether calculation has resumed with the <Tab>
  1316. key.
  1317.  
  1318. The following fractal types cannot (currently) be resumed: plasma, 3d
  1319. transformations, julibrot, and 3d orbital types like lorenz3d.    To check
  1320. whether resuming an image is possible, use the <Tab> key while it is
  1321. calculating.  It is resumable unless there is a note under the fractal
  1322. type saying it is not.
  1323.  
  1324. The {Batch Mode} section discusses how to resume in batch mode.
  1325.  
  1326. To <R>estore and resume a "formula", "lsystem", or "ifs" type fractal your
  1327. "formulafile", "lfile", or "ifsfile" must contain the required name.
  1328. ;
  1329. ;
  1330. ;
  1331. ~Topic=Orbits Window, Label=HELP_ORBITS
  1332. The <O> key turns on the Orbit mode.  In this mode a cursor appears 
  1333. over the fractal. A window appears showing the orbit used in the 
  1334. calculation of the color at the point where the cursor is. Move the 
  1335. cursor around the fractal using the arrow keys or the mouse and watch
  1336. the orbits change. Try entering the Orbits mode with View Windows (<V>)
  1337. turned on. The following keys take effect in Orbits mode.\
  1338. <c>         Circle toggle - makes little circles with radii inversely\
  1339.             proportional to the iteration. Press <c> again to toggle\
  1340.             back to point-by-point display of orbits.\
  1341. <l>         Line toggle - connects orbits with lines (can use with <c>)\
  1342. <n>         Numbers toggle - shows coordinates of the cursor on the\ 
  1343.             screen. Press <n> again to turn off numbers.\
  1344. <p>         Enter pixel coordinates directly\ 
  1345. <h>         Hide fractal toggle. Works only if View Windows is turned on\ 
  1346.             and set for a small window (such as the default size.) Hides the\ 
  1347.             fractal, allowing the orbit to take up the whole screen. Press\
  1348.             <h> again to uncover the fractal.\
  1349. <s>         Saves the fractal, cursor, orbits, and numbers as they appear\
  1350.             on the screen.\
  1351. <<> or <,>  Zoom orbits image smaller\
  1352. <>> or <.>  Zoom orbits image larger\
  1353. <z>         Restore default zoom.\
  1354. ;
  1355. ;
  1356. ;
  1357. ~Topic=View Window, Label=HELPVIEW
  1358.  
  1359. The <V> command is used to set the view window parameters described below.
  1360. These parameters can be used to:\
  1361.  o Define a small window on the screen which is to contain the generated
  1362.    images. Using a small window speeds up calculation time (there are
  1363.    fewer pixels to generate). You can use a small window to explore
  1364.    quickly, then turn the view window off to recalculate the image at
  1365.    full screen size.
  1366.  o Generate an image with a different "aspect ratio"; e.g. in a square
  1367.    window or in a tall skinny rectangle.
  1368.  o View saved GIF images which have pixel dimensions different from any
  1369.    mode supported by your hardware. This use of view windows occurs
  1370.    automatically when you restore such an image.
  1371.  
  1372. "Preview display"\
  1373. Set this to "yes" to turn on view window, "no" for full screen display.
  1374. While this is "no", the only view parameter which has any affect is "final
  1375. media aspect ratio". When a view window is being used, all other Fractint
  1376. functions continue to operate normally - you can zoom, color-cycle, and
  1377. all the rest.
  1378.  
  1379. "Reduction factor"\
  1380. When an explicit size is not given, this determines the view window size,
  1381. as a factor of the screen size.  E.g. a reduction factor of 2 makes the
  1382. window 1/2 as big as the screen in both dimensions.
  1383.  
  1384. "Final media aspect ratio"\
  1385. This is the height of the final image you want, divided by the width. The
  1386. default is 0.75 because standard PC monitors have a height:width ratio of
  1387. 3:4. E.g. set this to 2.0 for an image twice as high as it is wide. The
  1388. effect of this parameter is visible only when "preview display" is
  1389. enabled.
  1390.  
  1391. "Crop starting coordinates"\
  1392. This parameter affects what happens when you change the aspect ratio. If
  1393. set to "no", then when you change aspect ratio, the prior image will be
  1394. squeezed or stretched to fit into the new shape. If set to "yes", the
  1395. prior image is "cropped" to avoid squeezing or stretching.
  1396.  
  1397. "Explicit size"\
  1398. Setting these to non-zero values over-rides the "reduction factor" with
  1399. explicit sizes in pixels. If only the "x pixels" size is specified, the "y
  1400. pixels" size is calculated automatically based on x and the aspect ratio.
  1401.  
  1402. More about final aspect ratio:    If you want to produce a high quality
  1403. hard-copy image which is say 8" high by 5" down, based on a vertical
  1404. "slice" of an existing image, you could use a procedure like the
  1405. following. You'll need some method of converting a GIF image to your final
  1406. media (slide or whatever) - Fractint can only do the whole job with a
  1407. PostScript printer, it does not preserve aspect ratio with other printers.
  1408.  o restore the existing image\
  1409.  o set view parameters: preview to yes, reduction to anything (say 2),
  1410.    aspect ratio to 1.6, and crop to yes
  1411.  o zoom, rotate, whatever, till you get the desired final image\
  1412.  o set preview display back to no\
  1413.  o trigger final calculation in some high res disk video mode, using the
  1414.    appropriate video mode function key
  1415.  o print directly to a PostScript printer, or save the result as a GIF
  1416.    file and use external utilities to convert to hard copy.
  1417. ;
  1418. ;
  1419. ;
  1420. ~Topic=\"3D\" Commands
  1421.  
  1422. See {\"3D\" Images} for details of these commands.
  1423.  
  1424. <3>\
  1425. Restore a saved image as a 3D "landscape", translating its color
  1426. information into "height". You will be prompted for all KINDS of options.
  1427.  
  1428. <#>\
  1429. Restore in 3D and overlay the result on the current screen.
  1430. ;
  1431. ;
  1432. ;
  1433. ~Topic=Video Mode Function Keys, Label=HELPVIDSEL
  1434.  
  1435. Fractint supports *so* many video modes that we've given up trying to
  1436. reserve a keyboard combination for each of them.
  1437.  
  1438. Any supported video mode can be selected by going to the "Select Video Mode"
  1439. screen (from main menu or by using <Delete>), then using the cursor up and down
  1440. arrow keys and/or <PageUp> and <PageDown> keys to highlight the desired mode,
  1441. then pressing <Enter>.
  1442.  
  1443. Up to 39 modes can be assigned to the keys F2-F10, SF1-SF10 <Shift>+<Fn>),
  1444. CF1-CF10 (<Ctrl>+<Fn>), and AF1-AF10 (<Alt>+<Fn>).  The modes assigned to
  1445. function keys can be invoked directly by pressing the assigned key, without
  1446. going to the video mode selection screen.
  1447.  
  1448. 30 key combinations can be reassigned:    <F1> to <F10> combined with any of
  1449. <Shift>, <Ctrl>, or <Alt>.
  1450. The video modes assigned to <F2> through <F10> can not be
  1451. changed - these are assigned to the most common video modes, which might
  1452. be used in demonstration files or batches.
  1453.  
  1454. To reassign a function key to a mode you often use, go to the "select
  1455. video mode" screen, highlight the video
  1456. mode, press the keypad (gray) <+> key, then press the desired
  1457. function key or key combination.  The new key assignment will be remembered
  1458. for future runs.
  1459.  
  1460. To unassign a key (so that it doesn't invoke any video
  1461. mode), highlight the mode currently selected by the key and press the
  1462. keypad (gray) <-> key.
  1463.  
  1464. A note about the "select video modes" screen:
  1465. the video modes which are displayed with a 'B' suffix in the number
  1466. of colors are modes which have no custom programming - they use the BIOS
  1467. and are S-L-O-W ones.
  1468.  
  1469. See {"Video Adapter Notes"} for comments about particular adapters.
  1470.  
  1471. See {"Disk-Video" Modes} for a description of these non-display modes.
  1472.  
  1473. See {"Customized Video Modes\, FRACTINT.CFG"} for information about
  1474. adding your own video modes.
  1475. ;
  1476. ;
  1477. ;
  1478. ~Topic=Hints
  1479.  
  1480. Remember, you do NOT have to wait for the program to finish a full screen
  1481. display before entering a command. If you see an interesting spot you want
  1482. to zoom in on while the screen is half-done, don't wait -- do it! If you
  1483. think after seeing the first few lines that another video mode would look
  1484. better, go ahead -- Fractint will shift modes and start the redraw at
  1485. once. When it finishes a display, it beeps and waits for your next
  1486. command.
  1487.  
  1488. In general, the most interesting areas are the "border" areas where the
  1489. colors are changing rapidly. Zoom in on them for the best results. The
  1490. first Mandelbrot-set (default) fractal image has a large, solid-colored
  1491. interior that is the slowest to display; there's nothing to be seen by
  1492. zooming there.
  1493.  
  1494. Plotting time is directly proportional to the number of pixels in a
  1495. screen, and hence increases with the resolution of the video mode.
  1496. You may want to start in a low-resolution mode for quick progress while
  1497. zooming in, and switch to a higher-resolution mode
  1498. when things get interesting. Or use the
  1499. solid guessing mode and pre-empt with
  1500. a zoom before it finishes. Plotting time also varies with the maximum
  1501. iteration setting, the fractal type, and your choice of drawing mode.
  1502. Solid-guessing (the default) is fastest, but it can be wrong:
  1503. perfectionists will want to use dual-pass mode (its first-pass preview is
  1504. handy if you might zoom pre-emptively) or single-pass mode.
  1505.  
  1506. When you start systematically exploring, you can save time (and hey, every
  1507. little bit helps -- these "objects" are INFINITE, remember!) by <S>aving
  1508. your last screen in a session to a file, and then going straight to it the
  1509. next time by using the command FRACTINT FRACTxxx (the .GIF extension is
  1510. assumed), or by starting Fractint normally and then using the <R> command
  1511. to reload the saved file. Or you could hit <B> to create a parameter file
  1512. entry with the "recipe" for a given image, and next time use the <@>
  1513. command to re-plot it.
  1514. ;
  1515. ;
  1516. ;
  1517. ~Topic=Color Cycling Commands, Label=@ColorCycling
  1518.  
  1519. ~Doc-
  1520. See {=HELPCYCLING Color Cycling Command Summary} for a summary of commands.
  1521.  
  1522. ~Doc+
  1523. Color-cycling mode is entered with the 'c', '+', or '-' keys from an image,
  1524. or with the 'c' key from Palette-Editing mode.
  1525.  
  1526. The color-cycling commands are available ONLY for VGA adapters and EGA
  1527. adapters in 640x350x16 mode.  You can also enter color-cycling while
  1528. using a disk-video mode, to load or save a palette - other functions are
  1529. not supported in disk-video.
  1530.  
  1531. Note that the colors available on an EGA adapter (16 colors at a
  1532. time out of a palette of 64) are limited compared to those of VGA, super-
  1533. VGA, and MCGA (16 or 256 colors at a time out of a palette of 262,144). So
  1534. color-cycling in general looks a LOT better in the latter modes. Also,
  1535. because of the EGA palette restrictions, some commands are not available
  1536. with EGA adapters.
  1537.  
  1538. Color cycling applies to the color numbers selected by the "cyclerange="
  1539. command line parameter (also changeable via the <Y> options screen and via
  1540. the palette editor).  By default, color numbers 1 to 255 inclusive are
  1541. cycled.  On some images you might want to set "inside=0" (<X> options or
  1542. command line parameter) to exclude the "lake" from color cycling.
  1543.  
  1544. When you are in color-cycling mode, you will either see the screen colors
  1545. cycling, or will see a white "overscan" border when paused, as a reminder
  1546. that you are still in this mode.  The keyboard commands available once
  1547. you've entered color-cycling. are described below.
  1548.  
  1549. <F1>\
  1550. Bring up a HELP screen with commands specific to color cycling mode.
  1551.  
  1552. <Esc>\
  1553. Leave color-cycling mode.
  1554.  
  1555. <+> or <->\
  1556. Begin cycling the palette by shifting each color to the next "contour."
  1557. <+> cycles the colors in one direction, <-> in the other.
  1558.  
  1559. '<' or '>'\
  1560. Force a color-cycling pause, disable random colorizing, and single-step
  1561. through a one color-cycle.  For "fine-tuning" your image colors.
  1562.  
  1563. Cursor up/down\
  1564. Increase/decrease the cycling speed. High speeds may cause a harmless
  1565. flicker at the top of the screen.
  1566.  
  1567. <F2> through <F10>\
  1568. Switches from simple rotation to color selection using randomly generated
  1569. color bands of short (F2) to long (F10) duration.
  1570.  
  1571. <1> through <9>\
  1572. Causes the screen to be updated every 'n' color cycles (the default is 1).
  1573. Handy for slower computers.
  1574.  
  1575. <Enter>\
  1576. Randomly selects a function key (F2 through F10) and then updates ALL the
  1577. screen colors prior to displaying them for instant, random colors.  Hit
  1578. this over and over again (we do).
  1579.  
  1580. <Spacebar>\
  1581. Pause cycling with white overscan area. Cycling restarts with any command
  1582. key (including another spacebar).
  1583.  
  1584. <Shift><F1>-<F10>\
  1585. Pause cycling and reset the palette to a preset two color "straight"
  1586. assignment, such as a spread from black to white. (Not for EGA)
  1587.  
  1588. <Ctrl><F1>-<F10>\
  1589. Pause & set a 2-color cyclical assignment, e.g. red->yellow->red (not EGA).
  1590.  
  1591. <Alt><F1>-<F10>\
  1592. Pause & set a 3-color cyclical assignment, e.g. green->white->blue (not EGA).
  1593.  
  1594. <R>, <G>, <B>\
  1595. Pause and increase the red, green, or blue component of all colors by a
  1596. small amount (not for EGA). Note the case distinction of this vs:
  1597.  
  1598. <r>, <g>, <b>\
  1599. Pause and decrease the red, green, or blue component of all colors by a
  1600. small amount (not for EGA).
  1601.  
  1602. <D> or <A>\
  1603. Pause and load an external color map from the files DEFAULT.MAP or
  1604. ALTERN.MAP, supplied with the program.
  1605.  
  1606. <L>\
  1607. Pause and load an external color map (.MAP file).  Several .MAP files are
  1608. supplied with Fractint.  See {Palette Maps}.
  1609.  
  1610. <S>\
  1611. Pause, prompt for a filename, and save the current palette to the named
  1612. file (.MAP assumed).  See {Palette Maps}.
  1613. ;
  1614. ;
  1615. ;
  1616. ~Topic=Color Cycling Command Summary, Label=HELPCYCLING
  1617. ; This topic is online only
  1618.  
  1619. ~Format-
  1620.   See {Color Cycling Commands} for full documentation.
  1621.  
  1622.   F1           HELP! (Enter help mode and display this screen)
  1623.   Esc           Exit from color-cycling mode
  1624.   + or -       (re)-set the direction of the color-cycling
  1625. ~Doc-
  1626.   \27 \26           (re)-set the direction of the color-cycling (just like +/-)
  1627.   \24 \25           SpeedUp/SlowDown the color cycling process
  1628. ~Doc+,Online-
  1629.   Right/Left Arrow (re)-set the direction of the color-cycling (just like +/-)
  1630.   Up/Down Arrow    SpeedUp/SlowDown the color cycling process
  1631. ~Online+
  1632.   F2 thru F10       Select Short--Medium--Long (randomly-generated) color bands
  1633.   1  thru 9       Cycle through 'nn' colors between screen updates (default=1)
  1634.   Enter        Randomly (re)-select all new colors    [TRY THIS ONE!]
  1635.   Spacebar       Pause until another key is hit
  1636.   < or >       Pause and single-step through one color-cycle
  1637. * SF1 thru AF10    Pause and reset the Palette to one of 30 fixed sequences
  1638.   d or a       pause and load the palette from DEFAULT.MAP or ALTERN.MAP
  1639.   l           load palette from a map file
  1640.   s           save palette to a map file
  1641. * r or g or b or   force a pause and Lower (lower case) or Raise (upper case)
  1642. * R or G or B       the Red, Green, or Blue component of the fractal image
  1643. ;
  1644. ;
  1645. ;
  1646. ~Topic=Palette Editing Commands
  1647.  
  1648. ~Doc-
  1649. See {=HELPXHAIR Palette Editing Command Summary} for a summary of commands.
  1650.  
  1651. ~Doc+
  1652. Palette-editing mode provides a number of tools for modifying the colors
  1653. in an image.  It can be used only with MCGA or higher adapters, and only
  1654. with 16 or 256 color video modes.
  1655. Many thanks to Ethan Nagel for creating the palette editor.
  1656.  
  1657. Use the <E> key to enter palette-editing mode from a displayed image or
  1658. from the main menu.
  1659.  
  1660. When this mode is entered, an empty palette frame is displayed. You can
  1661. use the cursor keys to position the frame outline, and <Pageup> and
  1662. <Pagedn> to change its size.  (The upper and lower limits on the size
  1663. depend on the current video mode.)  When the frame is positioned where you
  1664. want it, hit Enter to display the current palette in the frame.
  1665.  
  1666. Note that the palette frame shows R(ed) G(reen) and B(lue) values for two
  1667. color registers at the top.  The active color register has a solid frame,
  1668. the inactive register's frame is dotted.  Within the active register, the
  1669. active color component is framed.
  1670.  
  1671. Using the commands described below, you can assign particular colors to
  1672. the registers and manipulate them.  Note that at any given time there are
  1673. two colors "X"d - these are pre-empted by the editor to display the
  1674. palette frame. They can be edited but the results won't be visible. You
  1675. can change which two colors are borrowed ("X"d out) by using the <v>
  1676. command.
  1677.  
  1678. Once the palette frame is displayed and filled in, the following commands
  1679. are available:
  1680.  
  1681. <F1>\
  1682. Bring up a HELP screen with commands specific to palette-editing mode.
  1683.  
  1684. <Esc>\
  1685. Leave palette-editing mode
  1686.  
  1687. <H>\
  1688. Hide the palette frame to see full image; the cross-hair remains visible
  1689. and all functions remain enabled; hit <H> again to restore the palette
  1690. display.
  1691.  
  1692. Cursor keys\
  1693. Move the cross-hair cursor around. In 'auto' mode (the default) the color
  1694. under the center of the cross-hair is automatically assigned to the active
  1695. color register. Control-Cursor keys move the cross-hair faster. A mouse
  1696. can also be used to move around.
  1697.  
  1698. <R> <G> <B>\
  1699. Select the Red, Green, or Blue component of the active color register for
  1700. subsequent commands
  1701.  
  1702. <Insert> <Delete>\
  1703. Select previous or next color component in active register
  1704.  
  1705. <+> <->\
  1706. Increase or decrease the active color component value by 1  Numeric keypad
  1707. (gray) + and - keys do the same.
  1708.  
  1709. <Pageup> <Pagedn>\
  1710. Increase or decrease the active color component value by 5; Moving the
  1711. mouse up/down with left button held is the same
  1712.  
  1713. <0> <1> <2> <3> <4> <5>\
  1714. Set the active color component's value to 0 10 20 ... 60
  1715.  
  1716. <Space>\
  1717. Select the other color register as the active one.  In the default 'auto'
  1718. mode this results in the now-inactive register being set to remember the
  1719. color under the cursor, and the now-active register changing from whatever
  1720. it had previously remembered to now follow the color.
  1721.  
  1722. <,> <.>\
  1723. Rotate the palette one step.  By default colors 1 through 255 inclusive
  1724. are rotated.  This range can be over-ridden with the "cyclerange"
  1725. parameter, the <Y> options screen, or the <O> command described below.
  1726.  
  1727. "<" ">"\
  1728. Rotate the palette continuously (until next keystroke)
  1729.  
  1730. <O>\
  1731. Set the color cycling range to the range of colors currently defined by
  1732. the color registers.
  1733.  
  1734. <C>\
  1735. Enter Color-Cycling Mode.  When you invoke color-cycling from here, it
  1736. will subsequently return to palette-editing when you <Esc> from it.
  1737. See {Color Cycling Commands}.
  1738.  
  1739. <=>\
  1740. Create a smoothly shaded range of colors between the colors selected by
  1741. the two color registers.
  1742.  
  1743. <M>\
  1744. Specify a gamma value for the shading created by <=>.
  1745.  
  1746. <D>\
  1747. Duplicate the inactive color register's values to the active color
  1748. register.
  1749.  
  1750. <T>\
  1751. Stripe-shade - create a smoothly shaded range of colors between the two
  1752. color registers, setting only every Nth register.  After hitting <T>, hit
  1753. a numeric key from 2 to 9 to specify N.  For example, if you press <T>
  1754. <3>, smooth shading is done between the two color registers, affecting
  1755. only every 3rd color between them.  The other colors between them remain
  1756. unchanged.
  1757.  
  1758. <W>\
  1759. Convert current palette to gray-scale.    (If the <X> or <Y> exclude ranges
  1760. described later are in force, only the active range of colors is converted
  1761. to gray-scale.)
  1762.  
  1763. <Shift-F2> ... <Shift-F9>\
  1764. Store the current palette in a temporary save area associated with the
  1765. function key.  The temporary save palettes are useful for quickly
  1766. comparing different palettes or the effect of some changes - see next
  1767. command.  The temporary palettes are only remembered until you exit from
  1768. palette-editing mode.
  1769.  
  1770. <F2> ... <F9>\
  1771. Restore the palette from a temporary save area.  If you haven't previously
  1772. saved a palette for the function key, you'll get a simple grey scale.
  1773.  
  1774. <L>\
  1775. Pause and load an external color map (.MAP file).  See {Palette Maps}.
  1776.  
  1777. <S>\
  1778. Pause, prompt for a filename, and save the current palette to the named
  1779. file (.MAP assumed).  See {Palette Maps}.
  1780.  
  1781. <I>\
  1782. Invert frame colors.  With some colors the palette is easier to see when
  1783. the frame colors are interchanged.
  1784. ~OnlineFF
  1785. <\\>\
  1786. Move or resize the palette frame.  The frame outline is drawn - it can
  1787. then be repositioned and sized with the cursor keys, <Pageup> and
  1788. <Pagedn>, just as was done when first entering palette-editing mode.  Hit
  1789. Enter when done moving/sizing.
  1790.  
  1791. <V>\
  1792. Use the colors currently selected by the two color registers for the
  1793. palette editor's frame.  When palette editing mode is entered, the last
  1794. two colors are "X"d out for use by the palette editor; this command can be
  1795. used to replace the default with two other color numbers.
  1796.  
  1797. <A>\
  1798. Toggle 'auto' mode on or off.  When on (the default), the active color
  1799. register follows the cursor; when off, <Enter> must be pressed to set the
  1800. active register to the color under the cursor.
  1801.  
  1802. <Enter>\
  1803. Only useful when 'auto' is off, as described above; double clicking the
  1804. left mouse button is the same as Enter.
  1805.  
  1806. <X>\
  1807. Toggle 'exclude' mode on or off - when toggled on, only those image pixels
  1808. which match the active color are displayed.
  1809.  
  1810. <Y>\
  1811. Toggle 'exclude' range on or off - similar to <X>, but all pixels matching
  1812. colors in the range of the two color registers are displayed.
  1813.  
  1814. <N>\
  1815. Make a negative color palette - will convert only current color if in 'x' 
  1816. mode or range between editors in 'y' mode or entire palette if in "normal" 
  1817. mode.
  1818.  
  1819. <!>\
  1820. <@>\
  1821. <#>\
  1822. Swap R<->G, G<->B, and R<->B columns. These keys are shifted 1, 2, and 3,
  1823. which you may find easier to remember.
  1824.  
  1825. <U>\
  1826. Undoes the last palette editor command.  Will undo all the way to the 
  1827. beginning of the current session.
  1828. ~OnlineFF
  1829. <E>
  1830. Redoes the undone palette editor commands.
  1831.  
  1832. <F>\
  1833. Toggles "Freestyle mode" on and off (Freestyle mode changes a range of
  1834. palette values smoothly from a center value outward).
  1835. With your cursor inside the palette box, press the <F> key to enter
  1836. Freestyle mode.  A default range of colors will be selected for you
  1837. centered at the cursor (the ends of the color range are noted by putting
  1838. dashed lines around the corresponding palette values). While in Freestyle
  1839. mode:
  1840.  
  1841.  Moving the mouse changes the location of the range of colors that are
  1842.  affected.
  1843.  
  1844.  Control-Insert/Delete or the shifted-right-mouse-button changes the
  1845.  size of the affected palette range.
  1846.  
  1847.  The normal color editing keys (R,G,B,1-6, etc) set the central color
  1848.  of the affected palette range.
  1849. ~OnlineFF
  1850.  Pressing ENTER or double-clicking the left mouse button makes the
  1851.  palette changes permanent (if you don't perform this step, any
  1852.  palette changes disappear when you press the <F> key again to exit
  1853.  freestyle mode).
  1854. ;
  1855. ;
  1856. ;
  1857. ~Topic=Palette Editing Command Summary, Label=HELPXHAIR
  1858. ; This topic is online only.
  1859.  
  1860. ~Format-
  1861.   See {Palette Editing Commands} for full documentation.
  1862.  
  1863.   F1           HELP! (Enter help mode and display this screen)
  1864.   Esc           Exit from palette editing mode
  1865.   h           Hide/unhide the palette frame
  1866.   Cursor keys       Move the cross-hair cursor around. Control-Cursor keys
  1867.            move faster. A mouse can also be used to move around.
  1868.   r or g or b       Select the the Red, Green, or Blue component of the
  1869.            active color register for subsequent commands
  1870.   Insert or Delete Select previous or next color component in active register
  1871.   + or -       Increase or decrease the active color component by 1
  1872.   Pageup or Pagedn Increase or decrease the active color component by 5;
  1873.            Moving the mouse up/down with left button held is the same
  1874.   0 1 2 3 4 5 6    Set active color component to 0 10 20 ... 60
  1875.   Space        Select the other color register as the active one
  1876.   , or .       Rotate the palette one step
  1877.   < or >       Rotate the palette continuously (until next keystroke)
  1878.   c           Enter Color-Cycling Mode (see {=HELPCYCLING Color Cycling Commands})
  1879.   =           Create a smoothly shaded range of colors
  1880.   m           Set the gamma value for '='.
  1881. ~FF
  1882.   d           Duplicate the inactive color register in active color
  1883.   t           Stripe-shade; after hitting 't', hit a number from 2 to 9
  1884.            which is used as stripe width
  1885.   Shift-F2,F3,..F9 Store the current palette in a temporary save area
  1886.            associated with the function key
  1887.   F2,F3,...,F9       Restore the palette from a temporary save area
  1888.   w           Convert palette (or current exclude range) to gray-scale
  1889.   \\            Move or resize the palette frame
  1890.   i           Invert frame colors, useful with dark colors
  1891.   a           Toggle 'auto' mode on or off - when on, the active color
  1892.            register follows the cursor; when off, Enter must be hit
  1893.            to set the register to the color under the cursor
  1894.   Enter        Only useful when 'auto' is off, as described above; double
  1895.            clicking the left mouse button is the same as Enter
  1896.   x           Toggle 'exclude' mode on or off
  1897.   y           Toggle 'exclude' range on or off
  1898.   o           Set the 'cyclerange' (range affected by color cycling
  1899.            commands) to the range of the two registers
  1900.   n           Make a negative color palette
  1901.   u           Undoes the last command
  1902.   e           Redoes the last undone command
  1903. ~FF
  1904.   !           Swap red and green columns
  1905.   @           Swap green and blue columns
  1906.   #           Swap red and blue columns
  1907.   f                Enter Palette-Editing Mode.  See {Palette Editing Commands}
  1908.                    for details.
  1909. ;
  1910. ;
  1911. ; Fractal Types:
  1912. ~Include help2.src
  1913. ;
  1914. ; Doodads, 3D:
  1915. ~Include help3.src
  1916. ;
  1917. ; Parameters, Video Adapters & Modes:
  1918. ~Include help4.src
  1919. ;
  1920. ; The rest:
  1921. ~Include help5.src
  1922. ;
  1923. ;
  1924.