home *** CD-ROM | disk | FTP | other *** search
/ Graphics 16,000 / graphics-16000.iso / sgi / editors / kali.lha / kali / HELP < prev    next >
Text File  |  1992-10-11  |  4KB  |  92 lines
  1. You can use Kali to draw Escher-like tilings, infinite knots, and
  2. other cool stuff. It lets you draw patterns in all of the 17 planar
  3. symmetry groups.  It was written by Nina Amenta at UC Berkeley.  It
  4. was later extended at the Geometry Center at the University of
  5. Minnesota: the capability to move lines was added, and Tamara Munzner
  6. added user interface panels using the public domain Forms Library by
  7. Mark Overmars of the University of Utrecht, which is available via
  8. anonymous ftp at archive.cs.ruu.nl.
  9.  
  10. Kali is available for free via anonymous ftp from the Geometry Center:
  11. (geom.umn.edu or 128.101.25.31).  It is copyrighted.
  12.  
  13.               CHOOSING A SYMMETRY GROUP: 
  14. Select the symmetry group you wish to work in by clicking on one of
  15. the icons on the control panel.  Each icon shows some of the
  16. symmetries which your pattern will contain.  Each group is also
  17. labeled in Conway notation and the traditional crystallographic
  18. notation.
  19.  
  20. Re-selecting the current symmetry group clears the window and throws
  21. away your pattern.
  22.  
  23.                    DRAWING: 
  24. Clicking the left mouse puts down points in your pattern.  Once a
  25. point is down, a new line "rubber-bands" from the point to the current
  26. cursor position.  Click the left mouse again to fix the second
  27. endpoint of the current line and start the next one.
  28.  
  29. Clicking infrequently often gives nicer patterns.
  30.  
  31. Click the middle mouse to let go of the current rubber-banding line.
  32.  
  33.                TRANSFORMATIONS:
  34. You can scale your by clicking on "Zoom".  Now holding down the left
  35. mouse button and moving the mouse left and right makes your pattern
  36. bigger or smaller.  When editing (see the next section) it is often
  37. useful make the pattern very big, edit, and then shrink it again.
  38.  
  39. Clicking "Rotate" lets you rotate the pattern within the window.
  40. Again, hold down the left mouse and move it left and right.  Some
  41. symmetry groups have some additional degrees of freedom in the
  42. symmetry lattice.  If the "Angle" or "Ratio" button has black letters,
  43. you can change the angle between the two vectors forming the lattice,
  44. or the ratio between the lengths of the two vectors, respectively.
  45.  
  46. You can always resize the window to fit your pattern into a
  47. differently shaped rectangle by picking up its lower righthand corner.
  48.  
  49. To get back to Draw mode after a transformation, click on the "Draw"
  50. button.
  51.  
  52.                    EDITING:
  53. Click on the "Delete" control panel button to get into Delete mode.
  54. Now clicking the right mouse highlights the line closest to the
  55. cursor.  To delete the highlighted line, click the middle mouse.  To
  56. select another line, move the mouse and click right again.  Clicking
  57. on "Move" puts you in Move mode.  Again, clicking the right mouse
  58. highlights the closest line.  To pick up the nearest endpoint of the
  59. highlighted line, click the left mouse. To put the endpoint down
  60. somewhere new, click the left mouse. This is handy for tidying up your
  61. patterns.
  62.  
  63. To get back to Draw mode, click on "Draw".
  64.  
  65.               SAVING A PATTERN:
  66. Click "Save" on the control panel to save your pattern. It will prompt
  67. you for a name under which to save it, and puts it in a file with that
  68. name.  You have to save your pattern before you can print it out.
  69.  
  70. To look at (or edit!) an old pattern, click "Load". It will ask you
  71. for the name it was saved under. Some demonstration patterns to look at are
  72. "weaving.kali", "turtles.kali", and "people.kali".
  73.  
  74. "Esc" clears the input panel in the popup window.
  75.  
  76.              PRINTING A PATTERN:
  77. There is a separate program for printing. From the Unix shell, type
  78. "kaliprint filename | lpr", only replace the word "filename" with the
  79. name of the file containing your pattern.
  80.  
  81.                 HOW IT WORKS:
  82. Every symmetry group is defined by a lattice and a set of two
  83. generators, which are either a rotation, reflections, or glide
  84. reflections. A pattern is just a list of lines.  Each line is first
  85. reflected (if there are any reflection or glide reflection generators)
  86. and then all reflections are rotated (if there is a rotation
  87. generator). Finally the resulting figure is redrawn around every
  88. lattice point.  The list of lines, the lattice, and the symmetry group
  89. are written into the file when you save your picture.  Kaliprint turns
  90. this information into a Postscript file.  Postscript is a format which
  91. you can print on a laser printer or mail to your friends.
  92.