Debian Codegraph @

HELP

raw
1 You can use Kali to draw Escher-like tilings, infinite knots, frieze
2 patterns, and other cool stuff. It lets you draw patterns in any of
3 the 17 planar (wallpaper) or 7 frieze symmetry groups.
4
5 The newest version of Kali is always available for free via anonymous
6 ftp from the Geometry Center: (geom.umn.edu or 128.101.25.35). The
7 current version is 3.1, and runs under X Windows and SGIs. It is
8 copyrighted.
9
10
11 HISTORY
12
13 KALI was first written by Nina Amenta at UC Berkeley and ran under SGI
14 machines. Then it was later extended at the Geometry Center at the
15 University of Minnesota. Nina added the capability to move and delete
16 lines. Tamara Munzner added user interface panels using the public
17 domain Forms Library by Mark Overmars of the University of Utrecht
18 (available via anonymous ftp at archive.cs.ruu.nl). This older version
19 was known as Kali 2.1.
20
21 The newest version is Kali version 3.1. Ed H. Chi did the port to X
22 Windows, using an alpha version of the Xforms library (a port of SGI
23 forms library to X), and the vogl graphics library. The header files
24 were recreated, and the code was reorganized some what. Nina added
25 the frieze group, and Tamara changed the user interface to allow the
26 switch between the two groups. Stuart Levy of the Geometry Center
27 adapted it to a later XForms release, implemented editing (selection
28 and deletion) under X, and made it independent of vogl.
29
30
31 HOW IT WORKS
32
33 Every symmetry group is defined by a lattice and a set of two
34 generators, which are either a rotation, reflections, or glide
35 reflections. A pattern is just a list of lines. Each line is first
36 reflected (if there are any reflection or glide reflection generators)
37 and then all reflections are rotated (if there is a rotation
38 generator). Finally the resulting figure is redrawn around every
39 lattice point. The list of lines, the lattice, and the symmetry group
40 are written into the file when you save your picture. Kaliprint turns
41 this information into a Postscript file. Postscript is a format which
42 you can print on a laser printer or mail to your friends.
43
44
45 STARTUP
46
47 You can start up kali in frieze mode with "-f" or wallpaper mode with
48 "-w". The "-m" option disables switching between the two modes. The
49 default is "-w".
50
51
52 CHOOSING A WALLPAPER OR FRIEZE GROUP
53
54 To switch between the wallpaper group and the frieze group, click on
55 the choice panel at the top of the symmetry buttons. The choice panel
56 will change to either "Wallpaper Groups" or "Frieze Groups".
57
58
59 CHOOSING A SYMMETRY
60
61 Select the symmetry you wish to work in by clicking on one of the
62 symmetry button. Each icon shows some of the symmetries which your
63 pattern will contain. Each group is also labeled in Conway notation
64 and the traditional crystallographic notation.
65
66 Re-selecting the current symmetry group clears the window and throws
67 away your current drawing.
68
69
70 SUMMARY OF MOUSE AND KEYBOARD COMMANDS
71
72 Left Mouse (draw mode) -- Start/Continue drawing connected lines
73 Left Mouse (move mode) -- Move second endpoint of selected line
74 Middle Mouse (draw mode) -- Break connected lines, allow starting fresh
75 Middle Mouse (other modes) -- Delete selected line
76 Right Mouse (any mode) -- Select line
77
78 backspace/delete -- Delete selected line
79 Keys to choose modes: (d)raw (m)ove (r)otate (a)ngle (R)atio (z)oom
80 (<)load (>)save
81
82 DRAWING
83
84 Clicking the left mouse puts down points in your pattern. Once a
85 point is down, a new line "rubber-bands" from the point to the current
86 cursor position. Click the left mouse again to fix the second
87 endpoint of the current line and start the next one. Click the middle
88 mouse button to let go of the current rubber-banding line. Clicking
89 infrequently often gives nicer patterns.
90
91
92 TRANSFORMATIONS
93
94 ZOOM: You can scale your window by clicking on "Zoom". Now holding
95 down the left mouse button and moving the mouse left and right makes
96 your pattern bigger or smaller. When editing (see the next section) it
97 is often useful make the pattern very big, edit, and then shrink it
98 again.
99
100 ROTATE: Clicking "Rotate" lets you rotate the pattern within the
101 window. Again, hold down the left mouse and move it left and right.
102
103 ANGLE and RATIO: Some symmetry groups have some additional degrees of
104 freedom in the symmetry lattice. If the "Angle" or "Ratio" button is
105 activated, you can change the angle between the two vectors
106 forming the lattice, or the ratio between the lengths of the two
107 vectors, respectively.
108
109 You can always resize the window to fit your pattern into a
110 differently shaped rectangle by picking up its lower righthand corner.
111
112 To get back to Draw mode after a transformation, click on the "Draw"
113 button.
114
115
116 EDITING
117
118 Click the RIGHT mouse button to SELECT the line under the cursor.
119 It is highlighted in red.
120
121 Click the MIDDLE mouse button to DELETE the selected line, or
122 press the Backspace or Delete keys. After deleting, another line
123 (often the adjacent one) becomes highlighted, and can be deleted in turn.
124
125 Press the "Move" button to choose Move mode.
126 Then, click and drag the LEFT mouse button to move the nearest endpoint of
127 the selected line. You'll need to press the "Draw" button to resume drawing.
128
129
130 SAVING AND LOADING A PATTERN
131
132 SAVE: Click "Save" on the control panel to save your pattern. It will prompt
133 you for a name under which to save it, and puts it in a file with that
134 name.
135
136 LOAD: To load an old pattern, click "Load". It will ask you for the
137 name it was saved under. Some demonstration patterns to look at are
138 "weaving.kali", "turtles.kali", and "people.kali".
139
140 "Esc" clears the input panel in the popup window.
141
142
143 PRINTING A PATTERN
144
145 The "Print" button on the main kali panel will route a PostScript
146 version of the pattern to the printer defined by the "PRINTER"
147 environment variable. There is also a separate program for printing a
148 kali output file. From the Unix shell, type "kaliprint yourfile.kali | lpr"
149 replacing "yourfile.kali" with the name of the file containing your pattern.
150
151 The "Print To" button saves the current view in a Postscript file.
152 If instead of a file name you enter a UNIX command preceded by
153 a "|" vertical bar, (as in "| lpr -Potherprinter"), the Postscript
154 text is piped to that command.