|
|
1.1 root 1: .TH BRUSH 9.1
2: .CT 1 games
3: .SH NAME
4: brush \- painting program
5: .SH SYNOPSIS
6: .B brush
7: [
8: .B -f
9: .I fontdir
10: ]
11: [
12: .B -p
13: .I picdir
14: ]
15: [
16: .B -t
17: .I texdir
18: ]
19: .SH DESCRIPTION
20: .I Brush
21: paints images under mouse control.
22: Options are
23: .TP
24: .B -f
25: font directory
26: .RF ( /usr/jerq/font
27: by default)
28: .PD 0
29: .TP
30: .B -p
31: the directory in which to keep pictures
32: (current directory by default)
33: .TP
34: .B -t
35: texture directory, where brushes and shades live
36: (current directory by default)
37: .PD
38: .PP
39: In general, button 1 draws, button 2 erases;
40: the cursor assumes the shape of the current brush.
41: Button 3 is used to select options, sweep out areas,
42: or cancel operations in progress.
43: .PP
44: The borders on either side of the drawing area contain menus of
45: available shades and brushes.
46: The current brush and shade are outlined by boxes.
47: To choose another, click button 3 at it.
48: .PP
49: The top border contains
50: a help area,
51: drawing options,
52: and certain commands.
53: Selections are made by pointing with button 3.
54: Some cycle through options; others bring up menus.
55: The items are:
56: .TP
57: help
58: Icons in three boxes indicate what buttons
59: 1, 2, and 3 will do at any given time:
60: .PD
61: .IP
62: .nf
63: .ta \w'\f5square with arrow 'u
64: paintbrush draw with this button
65: pencil eraser erase with this button
66: menu with cursor menu on this button
67: thumbs down cancel or finish an operation
68: pointing hand indicate a point
69: square with arrow sweep a rectangle
70: circle with arrow sweep a circle
71: skull exit the program
72: .fi
73: .DT
74: .TP
75: smooth
76: Smooth the contours of magnified images.
77: .TP
78: align
79: Force circles, discs, text, and other images
80: to align with texture cell boundaries.
81: .TP
82: .B image
83: Manipulate the
84: `current image',
85: (box, ellipse, etc.)\&
86: selected from the drawing menu described below.
87: Button 3 makes the image disappear, reserved for future use.
88: The image menu contains:
89: .RS
90: .TF magnify
91: .TP
92: .B same
93: Bring back the current image.
94: .TP
95: .B magnify
96: Sweep a rectangle indicating the
97: size of the magnified image.
98: The numbers that appear are horizontal and vertical
99: magnification factors.
100: .TP
101: .B shrink
102: Shrink to 1/4 size.
103: Indicate whether image is shaded or black & white.
104: .TP
105: .B flip
106: Reflect left-right or top-bottom.
107: .TP
108: .B rotate
109: Rotate counterclockwise or clockwise 90 degrees.
110: .TP
111: .B slant
112: Drag the current image rectangle into a parallelogram.
113: .TP
114: .B outline
115: Replace the current image with its outline.
116: .TP
117: .B shadow
118: Draw a `shadow' behind the current image.
119: .TP
120: .B shadow
121: Draw a `shadow' behind the current image.
122: .TP
123: .B new
124: Make a new image by copying a rectangular portion of the screen.
125: .RE
126: .PD
127: .TF Smooth
128: .IP
129: To move an image on the screen, select
130: .B new
131: from the
132: .B image
133: menu.
134: Sweep the area to be moved, click button 2 to erase it,
135: move it, and click button 1 to draw it.
136: .PD
137: .TP
138: drawing style
139: Select continuous curves, dotted lines,
140: disconnected dots, or an `airbrush' effect when painting.
141: .PD 0
142: .TP
143: constrain
144: Select freehand (wavy-line icon) or
145: horizontal-vertical drawing (angular icon).
146: .PD
147: .TP
148: reflect
149: Draw symmetric figures.
150: The icon shows the symmetries:
151: .B x=0
152: (left-right),
153: .B y=0
154: (top-bottom),
155: or
156: .BR both ,
157: relative to the center of the screen.
158: .PD0
159: .TP
160: draw mode
161: Set the drawing mode to one of
162: .BR or ,
163: .BR xor ,
164: .BR store ,
165: .BR and ,
166: .B copy
167: (preserves interior whitespace of images).
168: .TP
169: text style
170: Set the text style to one of
171: .BR normal ,
172: .BR outline ,
173: .BR bold ,
174: .BR shadow ,
175: .BR italic .
176: .TP
177: font name
178: Set the text font.
179: Menu selection
180: .B new
181: prompts for a font name
182: from the font directory.
183: .PD
184: .TP
185: .B i/o
186: Interact with host machine.
187: Menu items are:
188: .PD 0
189: .RS
190: .TF recall
191: .TP
192: .B save
193: Copy screen, brushes, or shades to a file.
194: Prompts for a file name, starting with the default picture
195: directory (if any).
196: Backspace past this if you wish to save elsewhere;
197: hit return to quit.
198: Next sweep a rectangle to be saved.
199: Bitmaps are saved in
200: .IR bitfile (9.5)
201: format.
202: .TP
203: .B recall
204: Prompts for a file name.
205: The recalled picture becomes the
206: current image.
207: .TP
208: .B exit
209: Leave the program.
210: Confirm by
211: two clicks on button 3.
212: .PD
213: .RE
214: .PP
215: The menu on button 3 in the drawing area contains these selections:
216: .TF Smooth
217: .TP
218: .B lines
219: Indicate first point, then position cursor with rubber band line
220: for subsequent lines.
221: Button 1 draws, button 2 erases.
222: .PD
223: .TP
224: .B curves
225: Indicate first control point, then position cursor with rubber band line
226: for subsequent control points.
227: A curve (spline) will be drawn (erased) using these control points,
228: depending on whether the last button hit is button 1 (draw), or button 2 (erase).
229: .PD 0
230: .TP
231: .B box
232: .TP
233: .B ellipse
234: .TP
235: .B disc
236: (A disc is a filled ellipse).
237: Sweep a rectangle;
238: numbers show the dimensions.
239: A single dot marks the center of an ellipse.
240: The image becomes the current image;
241: use buttons 1 and 2 to draw or erase with it.
242: .PD
243: .TP
244: .B string
245: Type in text.
246: The string becomes the current image.
247: .TP
248: .B texture
249: Sweep a rectangle.
250: The current image
251: becomes a rectangle of this size textured with current shade.
252: .TP
253: .B fill
254: Sweep a rectangle, then indicate interior seed points
255: using button 1, or button 3 to quit.
256: Enclosed regions will be filled with current shade.
257: Any button cancels the fill.
258: .PD 0
259: .TP
260: .B clear
261: .TP
262: .B invert
263: Sweep a rectangle to be cleared or color-inverted.
264: .PD
265: .TP
266: .B fade
267: Sweep a rectangle.
268: Holding button 2 will fade this area, as if
269: erasing in
270: spray paint mode with
271: a random pattern instead of a shade.
272: .PD 0
273: .TP
274: .B new brush
275: .TP
276: .B new shade
277: Menu select whether to edit or snarf from screen (with button 3).
278: If editing,
279: the current brush (shade) will appear magnified in upper left corner.
280: Edit with buttons 1 and 2, quit with 3.
281: Several `spare' brushes appear at the bottom of the brush menu.
282: .PD
283: .TP
284: .B details
285: Select an area with box cursor to be magnified for detailed editing.
286: .PD
287: .SH "SEE ALSO"
288: .IR paint (9.1),
289: .IR mbits (6),
290: .IR bitfile (9.5)
291: .SH BUGS
292: The smoothing operation fully smooths only
293: for magnification factors that are powers of two.
294: .br
295: Bitmaps moved off the top or bottom
296: of the physical screen can pick up noise.
297: .br
298: .B Copy
299: mode generates a mask the first time a given image is moved.
300: This can take a while for large images.
301: Be patient.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.