home *** CD-ROM | disk | FTP | other *** search
/ Computerworld 1996 March / Computerworld_1996-03_cd.bin / idg_cd3 / grafika / fraktaly / fw1-08 / manual.asc < prev    next >
Text File  |  1992-03-19  |  20KB  |  531 lines
  1.  
  2.  
  3.                      How to Perform Fractal WitchCraft
  4.  
  5.  
  6.       We've put lots of context sensitive help into Fractal WitchCraft (FW),
  7. so you can get by without this manual.  But, we think you will learn to cast
  8. fractal spells a little faster if you read "Basics" and do the "Tutorial."
  9.  
  10.                                 Contents
  11.  
  12.                  Getting Started . . . . . . . . . . . 2
  13.                  Basics  . . . . . . . . . . . . . . . 3
  14.                  Tutorial  . . . . . . . . . . . . . . 4
  15.                  Commonly Used Features  . . . . . . . 5
  16.                  Menu Structure  . . . . . . . . . . . 6
  17.                  Technical Stuff . . . . . . . . . . . 7
  18.                  Ordering  . . . . . . . . . . . . . . 8
  19.  
  20.  
  21.  
  22.       ShareWare
  23.  
  24. FW is not copy protected; you can give it away, and we hope you will.  FW is
  25. copyrighted; you may not sell it.
  26.  
  27. If you enjoy FW enough to use it, as we hope you will, then we ask that you
  28. buy it.  The price is $24.95, but if you can see the two letters after the
  29. serial number, take a $5.00 discount.
  30.  
  31. FW is based on a new, and revolutionary algorithm, which took more hours to
  32. perfect than we care to remember.  While requiring nearly 100 times more
  33. coding than the standard algorithm, it produces speed increases that
  34. generally range between 2 and 100 fold.
  35.  
  36. Having discovered this wonderful agorithm, we wanted to share it as widely
  37. as possible, so we put even more time into building a freindly and versitile
  38. program.  We hope you enjoy it, and hope you will pay your small share if you
  39. do.  For our part, we will continue to improve the aglorithm and the program.
  40.  
  41.  
  42.       Money from the Demo
  43.  
  44. FW can clone itself as a DEMO and errase the 2-letter discount password. 
  45. Give this away, on a network, to a store, or wherever it might catch peoples
  46. attention.  We Will Pay You the $5.00 refund for each copy it sells.  We will
  47. know your sales by the serial number the buyer must report.
  48.  
  49.  
  50.  
  51.  
  52.  
  53. -----  SuperNatural Graphics / P.O.Box 9185 / Berkeley, CA   94709  -----
  54.                                                                           2
  55.                              Getting Started
  56.  
  57.       Please install FW on your hard disk; it will work much better there.
  58.  
  59.  
  60. A 3 Minute Installation:
  61.  
  62.       1.   Put the INSTALL disk in your floppy drive.
  63.       2.   At the DOS prompt, type  a:install  or  b:install  as appropriate.
  64.       3.   Additional floppies, can be installed in any order.
  65.  
  66.       Typically your C: drive will now have a sub-directory c:\fw for the
  67.       program, manual and QWK images.  Another sub-directory, c:\fw\pictures,
  68.       holds the slides.  There should be an FW.BAT file in your path
  69.       (eg. c:\  'root' directory).
  70.  
  71.  
  72. Now, See the Show:  Type  fw show  at any DOS prompt.
  73.  
  74.  
  75. How to QUIT:  / q n
  76.  
  77.       Simply escape to the "MAIN menu", then hit  q  for quit and  n  for
  78.       no-don't save.  (If the MAIN menu vanishes, hit <Esc> once more.)
  79.  
  80.  
  81.  
  82.  
  83.  
  84. About the Show:
  85.  
  86.       You are seeing pre-calculated images, which have a fixed design and
  87. only appear to change because the colors change.  Most "slides" in the show
  88. are magnifications of the Mandlebrot set or its related Julia sets.
  89.  
  90.       Some images have been magnified more than a million million times, and
  91. some need many thousands of calculations to find the color of a single pixel. 
  92. In spite of FW's speed, these images can take hours to calculate even with
  93. a math coprocessor chip.
  94.  
  95.       The slide show is controled by a PICTURE.SHW file that you can modify
  96. with WordPerfect or any DOS TEXT editor.  You can also control the show when
  97. it's in progress.  Hit the space bar to stop on a particular slide.  Hit it
  98. again to go on.  While stopped, hit the number keys 0-5 to change how the
  99. colors swirl.  Hit up arrows to make them swirl faster and down arrows for
  100. slower.  It is also possible to permanently recolor slides.
  101.  
  102.  
  103.  
  104.  
  105.  
  106. -----  SuperNatural Graphics / P.O.Box 9185 / Berkeley, CA   94709  -----
  107.                                                                           3
  108.                                  Basics
  109.  
  110. Notation:  <something>  Indicates a singe keystroke.
  111.            For example <UpAw> means hit the Up-Arrow key.
  112.  
  113. The Four Most Important Things to Learn
  114.        1.<F1>  gets HELP on your current activity.
  115.        2.    <Esc> BACK-tracks to your previous activity.
  116.        3.    /     jumps to MAIN menu.
  117.        4.    Always read the bottom two lines of a menu screen.
  118.  
  119. Escaping: <Esc> will do one of the following as appropriate:
  120.       1.   Return you to the previous menu.
  121.       2.   Stop the computation.
  122.       3.   Abort a partially complete data entry.
  123.       4.   Leave a Data-Entry Window and preserve changes. 
  124.  
  125. If You Get Lost: Return to the MAIN menu.
  126.       You can always get back to the MAIN menu by hitting <Esc> a few times,
  127.       or  /  once.  If the menu vanishes, hit <Esc> once more to make it
  128.       reappear.  It says "MAIN menu" on the top line.  Each menu is named on
  129.       its top line.
  130.  
  131. To Start the Picture Show:
  132.       1.   Go to MAIN menu.
  133.       2.   Type  P G  for Picture, Go.
  134.       If you don't see full screen pictures with swirling color, you need to
  135.       change to the \FW\PICTURES directory.  Hit <Esc>, then  C  for Change,
  136.       then down arrow to that directory, then <Enter><Enter><Esc>, then  G 
  137.       for Go again.
  138.  
  139. Draw/Compute a Fractal from Scratch:
  140.       1.   Go to MAIN menu.
  141.       2.   Type  D G  for Draw, Go.  Or:  Type  R F  for Restart Fresh.
  142.       3.   You are now in the Draw/Compute Window.  The menu is off.
  143.       4.   Hit <F1> and read the help.  Then zoom into the Mandelbrot set.
  144.       5.   <Esc> to the DRAW menu.  From there use Controls and Rainbow.
  145.  
  146. Save an Image:
  147.       1.   Go to MAIN menu.
  148.       2.   Type  F S A name Enter  for File, Save, Automatic, your-file-name.
  149.  
  150. Set Image Coordinates:
  151.       1.   Go to MAIN menu
  152.       2.   Type  D C S <F1>  for Draw, Controls, Size/Magnification, help.
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159. -----  SuperNatural Graphics / P.O.Box 9185 / Berkeley, CA   94709  -----
  160.                                                                           4
  161.                            A 5 Minute Tutorial
  162.  
  163. This is the quickest way to get aquainted with FW's main features.  Each step
  164. below is followed by the list of key-strokes needed to achieve that step. 
  165. Esc means hit the escape key.  <ent> means enter, and other arrows refer to
  166. the arrow keys.  Letters are just the easy way to select menu items, so before
  167. hitting a letter, look to see which menu item (starting with that letter) will
  168. be selected.
  169.  
  170. 1.  Start Fractal WitchCraft:            fw  <ent>
  171. 2.  Retreive Example picture.            f r a ex <ent>
  172. 3.  Go to the Draw/Compute window:       / d g
  173. 4.  Zoom in 11 times:                    - - - - - - - - - - -
  174. 5.  Move 3 up:                           UpAw UpAw UpAw
  175. 6.  Move 5 right:                        RtAw RtAw RtAw RtAw RtAw
  176. 7.  Compute a small picture.             s
  177. 8.  Stop once the center is visible.     Esc
  178. 9.  Zoom in 6 times.                     - - - - - -
  179. 10. Compute a medium picture.            m
  180. 11. Stop early (optional).               Esc
  181. 12. Change Rainbows (colors).            Esc r UpAw UpAw RtAw RtAw
  182. 13. Save your picture.                   Esc f s <ent> mypic <ent>
  183. 14. Fresh Start.                         / r f
  184. 15. Retrieve your picture.               Esc f r a my <ent>
  185. 16. Go to Control menu.                  / d c
  186. 17. Change Bandwidth & Recolor.          b 4 <ent> r
  187. 18. Band width=1, Vary bandwidth=9       1 <ent> v 9 <ent> r
  188. 19. Compute a large picture.             Esc <ent> l
  189. 20. Stop early (optional).               Esc
  190. 21. Quit and save your place.            / q y
  191. 22. Start Fractal WitchCraft:            fw <ent>
  192. 23. Continue computing                   r r g c
  193. 24. Stop early (optional).               Esc
  194. 25. Save it again                        Esc f s a mypic <ent>
  195. 26. Go to Picture Show select menu       / p s
  196. 27. Add it to the show                   m y Space Esc
  197. 28. Watch the show. (yours is last)      <ent>
  198. 29. Change slides early                  Space Space
  199. 30. Stop on a slide                      Space
  200. 31. Make it swirl faster                 UpAw UpAw UpAw UpAw ....
  201. 32. Change swirl type                    4
  202. 33. Capture this Rainbow                 c
  203. 34. Change swirl type, then stop.        1 0
  204. 35. Read help about slide show           <F1>
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212. -----  SuperNatural Graphics / P.O.Box 9185 / Berkeley, CA   94709  -----
  213.                                                                           5
  214.                          Commonly Used Features
  215.  
  216.      Keystrokes work from anywhere in FW.  But from the MAIN menu, you may
  217.      omit the /.  Do not enter keystokes too quickly.  FW limits type-ahead
  218.      for safety.
  219.  
  220.      Feature                                Keystroke
  221.      ------------------------------------------------
  222.      Advanced-feature Help infor ation      / H A
  223.      Basic Help                             / H B
  224.      Buying information                     / B H
  225.      Change DOS directory (for image files) / F C
  226.      Color palette editor                   / D R <Enter>
  227.      Color swirling control                 / D V
  228.      Coordinate settings*                   / D C S
  229.      Draw/Compute window                    / D G
  230.      Dwell/Bandwidth                        / D C
  231.      Fractal type selection                 / A T
  232.      Hardware requirements                  / H R
  233.      Julia set draw/compute                 / D J J
  234.      Make a DEMO copy from your REAL copy   / A M
  235.      Menu off (or back on)                  / <Esc>
  236.      Names displayed with the images        / F N
  237.      Password check                         / B H S
  238.      Picture show start                     / P G <Space>
  239.      Picture show modify                    / P S
  240.      Rainbow change/shift                   / D R
  241.      Re-Start calculation (assumes Quit with "y")   / R R
  242.      Re-Start fresh                         / R F
  243.      Retrieve an image file                 / F R A {DnAws} <Enter>
  244.      Save the displayed fractal (as picture file)   / F S P {name}
  245.      Serial number check                    / B H S
  246.      Slide show                             / P G <Space>
  247.      Swirl control                          / D V
  248.  
  249. Automatic Parameter Control:  MAIN menu: D C  then point to parameter and
  250.      hit  A.  This will turn automatic control off (if on) and on (if off).
  251.      Watch for the letter A by the = sign.  Also, changing a parameter turns
  252.      automatic off.
  253.  
  254. Color Swirl Control:  Any time a fractal is displayed, with no menu or
  255.      instruction on the screen, you can control the swirl rate and type.
  256.      Hit <F1> to find out how.
  257.  
  258. Timing of Calculations:  To automatically time a fractal calculation:
  259.      calculate the whole fractal from start to finish without interuption.
  260.      Then hit <Esc> C.  The number of seconds is shown in upper right.
  261.  
  262. * The control menu is not available until you have started a fractal.
  263.  
  264.  
  265. -----  SuperNatural Graphics / P.O.Box 9185 / Berkeley, CA   94709  -----
  266.                                                                           6
  267.                       Getting Started:  A 5 Minute Tutorial
  268.  
  269.  
  270.          We will now give you a very quick tour of just some of FW's main
  271.       features.  Each step below is followed by the list of key-strokes
  272.       you need to perform in order to achieve that step.  For example "P"
  273.       means hit the letter P with or without the shift-key.  Esc means hit
  274.       the escape key.  The arrow keys are denoted by LfAw, RtAw, UpAw, DnAw.
  275.       Letters are the easy way to select menu items, so before hitting a
  276.       letter look to see which menu item will be selected.  On steps 6, 11
  277.       and 22 you should feel free to exercise creativity.
  278.  
  279.  
  280.       1.    Start Fractal Witchcraft:             fw  Enter
  281.       2.    Turn ON the image names:              F N Esc
  282.       3.    Watch the Picture Show:               P G Space
  283.       4.    Stop on the "EXAMPLE" picture:        Esc
  284.       5.    Go to the Draw/Compute window:        Esc D G
  285.       6.    Zoom in 10 times:                     - - - - - - - - - -
  286.       7.    Move 3 down:                          DnAw DnAw DnAw
  287.       8.    Move 5 right:                         RtAw RtAw RtAw RtAw RtAw
  288.       9.    Compute a small picture.              S
  289.       10.   Wait till it stops.
  290.       11.   Zoom in 6 times:                      - - - - - -
  291.       12.   Move 2 down and 2 right:              DnAw DnAw RtAw RtAw
  292.       13.   Compute a medium picture.             M
  293.       14.   Change Rainbows (colors).             Esc R UpAw UpAw RtAw RtAw
  294.       15.   Save your picture.                    Esc F S P MYPIC Enter
  295.       16.   Go to Picture Show select menu        Esc P S
  296.       17.   Delete your picture, then             MYPIC Space
  297.       18.   Add it back to the show               UpAw Space Esc
  298.       19.   Watch the slide show again.           G Space
  299.       20.   Stop on your slide.                   Esc
  300.       21.   Go to the Draw/Compute window:        Esc D G
  301.       22.   Zoom in on a part you like:           (up to you)
  302.       23.   Compute a medium picture.             M
  303.       24.   Stop when the picture is half done.   Esc
  304.       25.   Quit and save your place.             Esc Esc Q Y
  305.       26.   Start Fractal WitchCraft:             fw Enter
  306.       27.   Re-Start your picture computing.      R R G C 
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318. -----  SuperNatural Graphics / P.O.Box 9185 / Berkeley, CA   94709  -----
  319.                                                                           7
  320.                         WitchCraft Menu Structure Part 1
  321.  
  322.  
  323.       (The upper-case BOLD letters will activate your selection.)
  324.       (The [ ] indicate  a set of commands not specified here.)
  325.  
  326.  
  327.       D raw/compute
  328.          G o! compute and draw
  329.             [Fractal Image Generation] (S mall, M edium, L arge)
  330.          R ainbows
  331.             [Cycle Rainbows Menus] (LfAw, RtAw, UpAw, DnAw)
  332.                E dit rainbow
  333.                eX change rainbows
  334.          C ontrols
  335.              (A utomatic, M ax itteration, O uter itteration, B andwidth,
  336.                 V ary bandwidth, W arp speed)
  337.              S ize/location
  338.                 (X center, Y center, M agnified, L eft side, R ight side,
  339.                 T op, B ottom)
  340.              alG orithm (W arp speed, E dge trace)
  341.          V iews
  342.              (H ide menu, T ype of swirl, S peed of swirl, M ove colors,
  343.                 C apture rainbow)
  344.          F ile: save/retrieve
  345.              (S ave, R etrieve/delete, V iews, C hange directory,
  346.                 A djust rainbows, N ame on/off)
  347.          J ulia sets
  348.              (J ulia set, U n-julia, M agnified julia)
  349.       P icture show
  350.          G o! start the show
  351.             [options display] <space> [Automatic Slide Show]
  352.          C hange directory
  353.             [Edit DOS path pointing to pictures]
  354.          S elect picture
  355.             [Select from directory list]
  356.       F ile: save/retrieve
  357.          (S ave, R etrieve/delete, V iews, C hange directory,
  358.             A djust rainbows, N ame on/off)
  359.       R e-start
  360.          R e-start from save
  361.          F resh restart
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371. -----  SuperNatural Graphics / P.O.Box 9185 / Berkeley, CA   94709  -----
  372.                                                                           8
  373.                         WitchCraft Menu Structure Part 2
  374.  
  375.  
  376.       (The upper-case BOLD letters will activate your selection.)
  377.       (The [ ] indicate  a set of commands not specified here.)
  378.       
  379.  
  380.       H elp using FW
  381.          B asics
  382.             V ery basic help
  383.             S ee picture show
  384.             R e-color pictures
  385.             M ake new pictures
  386.             G eneral FW notice
  387.          C ommon commands list
  388.          R equired hardware
  389.          A dvanced
  390.             D well and limits
  391.             3  file types
  392.             C ustomizing picture show
  393.             T ricks
  394.       B uy FW/make money
  395.          H ow to buy FW
  396.             (S erial #, A ddress, O rdering, P icture disks)
  397.          D emo version ??
  398.          M aking money
  399.          W itchCraft !
  400.       A dvanced features
  401.          T ype of fractal
  402.             (M andlebrot, B iomorph, C omet, W ave, P seudo cubic M,
  403.                S wordfish)
  404.          M ake a DEMO-version of FW
  405.          R eplace qwik-start files
  406.          EGA /VGA switch
  407.          A spect ratio
  408.       Q uit
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424. -----  SuperNatural Graphics / P.O.Box 9185 / Berkeley, CA   94709  -----
  425.                                                                           9
  426.                              Technical Stuff
  427.  
  428. About Computer Hardware and Speed:
  429.  
  430.       Some fractals take hours even with FW and a 486.  For magnifications
  431. of less than 1,000,000 FW uses the 32 bit integer multiplication provided by
  432. the 386 or 486 processor itself, which is even faster than floating point
  433. muliplication in the cooprocessor.  On an 8088 or 286 it uses the
  434. coprocessor if available and integer math otherwise.  All this is done for
  435. you automatically.  Beyond a magnification of 1,000,000 computation slows
  436. down drastically without a math coprocessor.
  437.  
  438.       We suggest you do all your "visual wandering", especially through the
  439. more complex regions, using the small (1/16 screen) images.  Then generate
  440. a medium (1/4 screen) image and use it for a final tune-up of control
  441. parameters and colors before creating a large (full-screen) image.  For the
  442. very long computations, remember you can use the "Quit-Yes-Restart" feature
  443. to complete your image in stages.
  444.  
  445.  
  446. File Types:
  447.  
  448.       An FW image can be stored three different ways:  As a standard .PCX
  449. file, As a .DWL file, or as a .DAT file.  FW .PCX files can be read by PC
  450. Paintbrush, WordPerfect, and many other programs.  But FW cannot read PCX
  451. files from other programs because they do not include the necessary
  452. coordinate information.  DWL files are the only type that contains dwell
  453. information, and these can only be made for medium and small images.  DAT
  454. files contain no image, only the parameters needed to recompute the image,
  455. but they are tiny so you can keep a lot of them.
  456.  
  457.  
  458. How do you make a DEMO COPY of FW.
  459.       1.   Make a normal DOS copy of your original diskettes.
  460.       2.   Run FW as you usually do.
  461.       3.   Select   MAIN menu : Advanced Features : Making a Demo-version.
  462.       4.   Put the COPY of your install diskette in your floppy drive.
  463.       5.   Tell FW the floppy drive letter when it asks for it.
  464.  
  465.  
  466. Directories:
  467.  
  468.       FW looks for its own PCX, DWL and DAT files in the directory you start
  469. it from.  If it finds some, then it assumes you want to work in that directory. 
  470. If it doesn't then it checks it's FW__PATH file to find which directory you
  471. last worked in, and changes to that one.  You can change directories while
  472. in FW; use  MAIN menu F C.
  473.  
  474.  
  475.  
  476.  
  477. -----  SuperNatural Graphics / P.O.Box 9185 / Berkeley, CA   94709  -----
  478.                                                                           10
  479.                            Ordering Information
  480.  
  481.  
  482. To purchase FW, send a valid serial number, and check for $24.95 to
  483.  
  484.            SuperNatural Graphics
  485.            P.O. Box 9185
  486.            Berkeley, CA    94709
  487.  
  488.  
  489. Note:      If the serial number includes the two-letter password, you can
  490.            take a $5 discount, but to do so you must include the correct
  491.            password.  If you do not include a valid serial number, then
  492.            the price is $29.95.
  493.  
  494. Please specify a disk size:
  495.  
  496.           A.  1.44M   3.5"    floppies
  497.           B.   720k   3.5"    floppies
  498.           C.   1.2M   5.25"   floppies
  499.           D.   360k   5.25"   floppies
  500.  
  501. In all cases you will receive approximately 2.6 Megabytes of files because
  502. FW includes a picture show.
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530. -----  SuperNatural Graphics / P.O.Box 9185 / Berkeley, CA   94709  -----
  531.