![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to art CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Plan 9 NeXT] / lucent / sys / man / 1|
Return to art CVS log | Up to [Plan 9 NeXT] / lucent / sys / man / 1 |
1.1 root 1: .TH ART 1
2: . \" /*% troff -man % | lp -du
3: .CT 1 graphics
4: .SH NAME
5: art, art2pic \- edit line-art
6: .SH SYNOPSIS
7: .B art
8: [
9: .B -f
10: .I font
11: ]
12: [
13: .B -b
14: .I picture
15: ]
16: .PP
17: .B art2pic
18: .I file
19: .SH DESCRIPTION
20: .I Art
21: is an interactive program to create precise line-art in the style of
22: .IR pic (1).
23: It is mostly mouse-operated, with a few commands entered from the keyboard.
24: It divides its window into four areas:
25: a menu bar at the top,
26: a one-line rectangle immediately below for echoing typed-in characters,
27: another one-line rectangle below that for printing messages,
28: and a large area at the bottom for displaying the drawing.
29: The
30: .B -b
31: option displays the specified
32: .I picture
33: (in the format of
34: .IR picfile (9.6))
35: as a background for the drawing.
36: .PP
37: A small caret, whose apex is the
38: .IR "current point" ,
39: appears on the screen.
40: The lines, arcs, and other elements of a drawing are
41: constructed by placing the caret at each of a sequence of points that define the
42: item. When the caret moves, two other markers (a square and a cross) trail it,
43: showing its previous positions. Items on the screen
44: near the caret attract it. Important points on items, like endpoints or
45: intersections, pull harder than more mundane points, making precise
46: alignment easy.
47: .PP
48: On request,
49: .I art
50: will automatically construct alignment lines and circles,
51: which it displays more faintly than items in the drawing.
52: Certain lines and points in a drawing are
53: .IR hot .
54: .I Art
55: constructs circles of given radii and lines of given slopes
56: at hot points, and parallels at given distances from hot lines
57: and lines at given angles to their endpoints.
58: Menus pulled down from the menu bar
59: control what alignment items are constructed.
60: Items are automatically heated when added to the drawing
61: and will be heated or cooled on command.
62: .PP
63: The `important points' on a line segment to which the
64: caret preferentially gravitates are its endpoints and midpoint.
65: On a circle, the center is important.
66: On an arc, the endpoints are important.
67: On a box, the corners, the midpoints of the sides and the center are important.
68: Likewise, on a piece of text, the corners, midpoints and center of its bounding
69: box are important.
70: On a spline, the control points are important,
71: and in a group, the important points of the group members are important.
72: .PP
73: Whenever button 1 is pressed, the caret follows the mouse cursor.
74: On release, the item the caret is touching, if any, is
75: selected and highlighted. If more than one item touches the caret, clicking button
76: 1 repeatedly will cycle through them.
77: .PP
78: Pressing button 2 pops up a menu of commands that add new items to the drawing.
79: Every item is described by several
80: .IR "control points" :
81: a line by its endpoints, a circular arc by its endpoints and a third point on the arc,
82: and so forth. A new item is specified by moving the caret in turn to each
83: control point but the last, selecting a menu entry with button two, then using
84: button 1 to place the caret
85: on the last control point.
86: (Buttons 2 and 3 will cancel the command.)
87: While the caret is being dragged to the last control point,
88: .I art
89: displays and updates the item on the screen (``rubber-banding'').
90: In all cases, after making an addition to the drawing, the new item becomes the
91: current selection.
92: The button 2 menu operations are
93: .TF parallels
94: .TP
95: .B line
96: Add a line segment to the drawing. The two control points are the segment's endpoints.
97: .TP
98: .B circle
99: Add a circle to the drawing. The first control point is the center.
100: The second is a point on the circumference.
101: .TP
102: .B arc
103: Add a circular arc to the drawing. The endpoints are the first and third control points.
104: The second control point is an interior point of the arc.
105: .TP
106: .B box
107: Add a rectangle to the drawing. The box's sides are vertical and horizontal. The
108: two control points are two diagonally opposite corners.
109: .TP
110: .B spline
111: Add a spline curve to the drawing, or extend an existing spline.
112: Splines are a little more complicated than other items because they may have any
113: number of control points.
114: If the current selection is not a spline, there are two control points \(em
115: the ends of a new spline. When a spline is selected, the
116: .B spline
117: button adds a new control point to the end of the spline closest to the selected point.
118: .TP
119: .B group
120: Add a group to the drawing. The two control points are the diagonally opposite
121: corners of a rectangle.
122: Any item partially or completely contained in the rectangle is made part of the group.
123: Henceforth the group acts as a monolithic item and may be moved, deleted or copied
124: as a unit. The
125: .BR open ,
126: .B close
127: and
128: .B flatten
129: commands (on button 3) allow manipulation of the items within a group.
130: Groups may be nested within other groups.
131: .PP
132: Button 3's menu has commands to manipulate the current selection.
133: .TF parallels
134: .TP
135: .B delete
136: Remove the selection from the drawing. If the whole drawing is selected,
137: .I art
138: asks for confirmation by pressing mouse button 3. Buttons 1 and 2 cancel the command.
139: .TP
140: .B heat
141: Heat the selected item.
142: .TP
143: .B copy
144: Create a duplicate of the selected item. The duplicate must be dragged to its intended
145: position using button 1. Buttons 2 and 3 cancel the command.
146: .TP
147: .B edit
148: Change the indicated point of the selected item. Button 1 adjusts the point.
149: Buttons 2 and 3 cancel the command. This command's behavior depends on the
150: kind of item and the point at which it is selected.
151: .IP
152: If a line is selected near an endpoint, that endpoint moves and the other remains
153: fixed. Both endpoints of a line selected near its midpoint move\(emits length and
154: slope do not change.
155: .IP
156: If a circle selected at its center, it translates without changing its radius.
157: If selected on its circumference, its radius changes but its center remains fixed.
158: .IP
159: The control point of an arc or spline nearest the selection point is modified.
160: .IP
161: If a box is selected near a corner, that corner moves and the other remains fixed.
162: If selected near the middle of an edge, the edge moves, but the opposite edge remains
163: fixed. If selected near its center, the whole box moves without changing its size
164: or shape.
165: .IP
166: A group or a piece of text translates, regardless of the selection point.
167: .TP
168: .B open
169: The selection must be a group. All commands now operate on the members of the
170: group.
171: .TP
172: .B close
173: The most-recently opened group is closed.
174: Any changes made while it was open are propagated to other copies.
175: .TP
176: .B flatten
177: The selection must be a group.
178: The items in the group are inserted in its place in the drawing.
179: This undoes the effect of the
180: .B group
181: command. Other copies of the group are unaffected.
182: .PP
183: Keyboard commands:
184: .TF parallels
185: .TP
186: .B "t text
187: Add text to the drawing. The text is in the current font and is drawn centered
188: on the caret.
189: .TP
190: .BI "f " name
191: Set the current typeface.
192: .I Name
193: is the name of a font file.
194: Subdirectories of
195: .B /lib/font/bit
196: contain many appropriate fonts.
197: .TP
198: .B D
199: Redraw the display.
200: .TP
201: .B q
202: Quit.
203: .I Art
204: exits, without asking for confirmation.
205: .TP
206: .BR "w " [ \f2file\f1 ]
207: Write the drawing into a file in
208: .I art
209: format.
210: .I File
211: defaults to the last file mentioned in a read or write command.
212: .I Art
213: files may be converted to
214: .IR pic (1)
215: format by the
216: .I art2pic
217: command.
218: .TP
219: .BR "r " [ \f2file\f1 ]
220: Read a drawing from a file.
221: .I File
222: defaults to the last file mentioned in a read or write command.
223: .TP
224: .B c
225: Cool everything. Every hot item is cooled.
226: .TP
227: .B a
228: Select all items. The entire drawing is selected.
229: .TP
230: .B d
231: Drop anchor. The
232: .I anchor
233: is the fixed point for the not-yet-implemented rotate and scale commands.
234: .PP
235: Menus pulled down from the menu bar contain commands that alter how
236: .IR art
237: responds to user interaction.
238: .TF parallels
239: .TP
240: .B slopes
241: Most of the entries in this menu are numbers, representing angles in degrees.
242: Those that are marked with a star are the inclination from horizontal of alignment
243: lines constructed at each hot point of the drawing. Selecting a number toggles
244: the star on and off. The
245: .B measure
246: button measures the slope of the line connecting the most recent two points selected
247: with the caret. The measurement is printed, and a corresponding new entry is made
248: in the menu.
249: .TP
250: .B angles
251: This menu behaves much like the
252: .B slopes
253: menu. Items marked with a star are angles at which alignment lines are drawn
254: through the endpoints of hot lines. The
255: .B measure
256: button measures the angle indicated by the most recent three points selected with the caret.
257: .TP
258: .B parallels
259: Items marked with a star are distances at which alignment lines are drawn parallel
260: to hot lines. The
261: .B measure
262: button measures the distance between the most recent two points selected with the caret.
263: Distances are nominally in inches, but the program believes the display pitch to be
264: 100 pixels per inch.
265: .TP
266: .B circles
267: Items marked with a star are radii of alignment circles drawn with centers at
268: hot points. The
269: .B measure
270: button measures the distance between the most recent two points selected with the caret.
271: .TP
272: .B grid
273: Items in this menu activate a rectangular grid of gravitating points.
274: They have labels like
275: .BR 0,0+.1,.1 .
276: The first pair of numbers is the coordinate of a point on the grid; the other
277: pair is the
278: .I x
279: and
280: .I y
281: displacements of other points.
282: The
283: .B off
284: item disables the grid (the default situation).
285: .B Measure
286: creates a custom-measured grid using the last two positions of the caret as
287: diagonally adjacent grid-points.
288: .TP
289: .B gravity
290: The starred entry on this menu is the maximum distance that the caret will move from
291: the mouse cursor to snap to an item on the screen.
292: .TP
293: .B heating
294: The
295: .B "heat new
296: button toggles whether objects are automatically heated when created or modified.
297: The item is marked with a star if set, as it is initially.
298: .SH SOURCE
299: .B /sys/src/cmd/art
300: .SH "SEE ALSO"
301: .IR tweak (1)
302: .SH BUGS
303: Needs two or more bits per pixel.
304: Doesn't compute intersections of splines with circles or arcs.
305: No filled regions, line styles or arrowheads.
306: Doesn't save construction lines in files.
307: Because it draws in xor mode when rubber-banding, lines can momentarily disappear.
308: Tracks slowly in large drawings.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.