home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 304.lha / Slicer_v1.0 / Slicer.doc < prev    next >
Text File  |  1980-12-05  |  8KB  |  191 lines
  1.  
  2.    Slicer   1.0   copyright   1988   by   Gary Teachout
  3.  
  4.    Slicer computes and displays images of the Mandelbrot and Julia sets.
  5. The Mandelbrot set is a two dimensional slice or cross section of a four
  6. dimensional object. The Julia sets are slices of the same object with
  7. a different orientation. Slicer works in all posible four dimensional
  8. orientations. Unlike many Mandelbrot programs that generate pictures
  9. directly Slicer computes and stores an array of raw data which it may
  10. then render into pictures in a number of ways.
  11.  
  12.    Slicer works with two types of files picture files and slice files.
  13. Picture files are IFF ILBM ( not compressed ) and include a nonstandard
  14. chunk containing the specs used to create the picture. Slice files
  15. contain specs and raw data.
  16.  
  17.    The Slicer directory contains four example files. Three picture files
  18. called Mandelbrot, Julia, and Slicer_Title. One Slice file called Slice.
  19.  
  20.    Internally Slicer maintains two sets of specifications ( specs ).
  21. Working slice specs are those used to compute raw data and include the
  22. status of the computation. New specs are a copy of the specs from the
  23. file most recently loaded ( slice or picture ) and may be changed from
  24. edit mode or by selecting a region of a picture.
  25.  
  26.    Slicer has five modes. Edit specs mode for entering or editing slice
  27. specifications, show specs mode for checking status of computation,
  28. execute mode for computing raw data, display mode for rendering pictures
  29. from raw data, picture mode for viewing picture files previously rendered.
  30.  
  31. The Specs Window:
  32.  
  33.    The meaning of this information is explained item by item.
  34.  
  35.    working mode:        Tells you that what you see are either new specs
  36.                         or working slice specs.
  37.  
  38.    name of slice:       AmigaDOS file name of this slice.
  39.                      
  40.    project status:      Tells if the computation has begun or is complete.
  41.  
  42.    grid size     x: y:  Dimensions of the array of raw data in pixels.
  43.  
  44.    grid position x: y:  Coordinates of next ellement to be computed.
  45.  
  46.    aspect ratio:        Pixel aspect ratio at which this slice
  47.                         will be displayed.
  48.  
  49.    limit:               Maximum number of iterations.
  50.  
  51.    magnification:       Magnification or zoom factor.
  52.  
  53.    location             Four dimensional coordinates of the center of
  54.                         the image. 
  55.                         X:    Real part of z.
  56.                         Y:    Imaginary part of z.
  57.                         A:    Real part of c.
  58.                         B:    Imaginary part of c.
  59.  
  60.    orintation           A four dimensional set of orthogonal basis vectors.
  61.                         These are important only to hard core enthusiasts.
  62.  
  63. The Specs Window Menus:
  64.  
  65.    menu           \
  66.       item         >    Menus are described in outline form.
  67.         subitem   /     Many selections will request an input.
  68.  
  69.    project
  70.       load
  71.          from specs     Copy new specs into working slice specs. Allocate
  72.                         memory for raw data. Enter show working specs mode.
  73.          slice file     Load working slice specs and raw data from file.
  74.          picture        Enter picture mode. Load picture file.
  75.       save
  76.          new specs      Save new specs to file.
  77.          slice file     Save working slice specs and raw data to file.
  78.       quit              End program.
  79.  
  80.    edit                 Enter or change new specs.
  81.       rename            Change file name.
  82.       set grid
  83.          size x         Set width of array in pixels.
  84.          size y         Set height of array in pixels.
  85.          aspect ratio   Set aspect ratio of intended display.
  86.          320 200 0.88   Low res        \
  87.          320 400 1.76   Low res lace    \
  88.          640 200 0.88   High res         >   Set size and aspect ratio
  89.          640 400 0.44   High res lace   /    for Amiga display.
  90.          520 350 0.44   One meg system /
  91.       set limit         Set maximum number of iterations.
  92.       magnification     Set scale or zoom factor.
  93.       location
  94.          X              \
  95.          Y               \    Set four dimensional location
  96.          A               /    of center of the slice.
  97.          B              /
  98.       orintation
  99.          Mandelbrot     \     Slice is parallel to Mandelbrot set.
  100.          Julia           \    Slice is a Julia set.
  101.          X  A             \
  102.          X  B             /   All six orintations perpendicular
  103.          Y  A            /    to each other.
  104.          Y  B           /
  105.       Vx                \
  106.       Vy                 \    Set orintation basis vector coordinates.
  107.       Va                 /    This is if you are good at geometry.
  108.       Vb                /
  109.  
  110.    turtle               Use turtle geometry to change location and
  111.                         orintation.
  112.       move
  113.          Va  -->        \
  114.          Vb  -->        /     Move slice perpendicular.
  115.          Vx  -->        Move slice right.
  116.          Vy  -->        Move slice up.
  117.       rotate
  118.          Vx  -->  Va    \
  119.          Vx  -->  Vb     \
  120.          Vy  -->  Va      \
  121.          Vy  -->  Vb      /   Change angle of slice.
  122.          Va  -->  Vb     /
  123.          Vx  -->  Vy    /
  124.  
  125.    mode
  126.       edit new specs    Enter edit new specs mode.
  127.       compute slice
  128.          execute        Compute raw data for current working slice.
  129.          halt           Stop computation.
  130.          halt & save    Stop computation and save slice file.
  131.       display slice
  132.          320 X 200      \
  133.          320 X 400       \
  134.          640 X 200       /    Enter display mode render working slice.
  135.          640 X 400      /
  136.       show specs        Display current working slice specs.
  137.  
  138. The Display Window:
  139.  
  140.       The display window is a borderless full screen window in its
  141.    own screen. All colors are available for the picture so some
  142.    color combinations will make the menus hard to read.
  143.       You may select a region you wish to zoom in on by placing the
  144.    mouse pointer in the center of the region pressing the select button
  145.    and moving the mouse in any direction. When you relese the button the
  146.    specs to compute the highlighted region are stored in the new specs.
  147.  
  148. The Display Window Menus:
  149.  
  150.    picture
  151.       save picture      Save picture as IFF ILBM file.
  152.       exit              Exit picture mode return to specs window.
  153.  
  154.    palette
  155.       interleved
  156.                         Select from preset palettes.
  157.       shaded
  158.                         Select from preset palettes.
  159.       adjustable
  160.          palette        Custom palette.
  161.          adjust         Activate palette adjusting gadgets.
  162.       black back        Set background color to black.
  163.       rotate
  164.          1 + up         \
  165.          1 + down       /     Shift contents of palette exept background.
  166.          0 + up         \
  167.          0 + doun       /     Shift Contents of palette.
  168.       invert
  169.          1 +            Invert contents of palette exept background.
  170.          0 +            Invert contents of palette.
  171.  
  172.    render               Render menu available in display slice mode only.
  173.       linear            \
  174.       log                \
  175.       log 2               \   Lots of ways to render a slice.
  176.       log 4               /   You will just have to try these.
  177.       topo               /
  178.       topo r            /
  179.  
  180.  
  181.    I hope that this program and its documentation are not too intimidating.
  182. I wrote it to do things I wanted it to do at the expense of user
  183. friendlyness.
  184.  
  185.    Slicer is copyrighted but may be distributed freely.
  186.  
  187.    Gary Teachout 
  188.    10532   66 place   W
  189.    Everett   Wa   98204
  190.  
  191.