![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to paint.9 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / man / adm / man9|
Return to paint.9 CVS log | Up to [Research Unix] / researchv10dc / man / adm / man9 |
1.1 root 1: .TH PAINT 9.1
2: .CT 1 games
3: .SH NAME
4: paint \- draw pictures in a layer
5: .SH SYNOPSIS
6: .B paint
7: .SH DESCRIPTION
8: .PP
9: .I Paint
10: is a program for artistic interactive drawing.
11: Buttons 1 and 2 draw in different ways,
12: e.g. depositing and erasing paint.
13: Button 3 gets a menu.
14: Certain menu items contain arrows, which if touched call submenus.
15: Moving off the right of a submenu causes it to disappear.
16: Some items toggle a state on and off; a
17: .L *
18: appears in the abnormal state.
19: Pressing button 1 while holding button 3 gets a short help
20: message for the menu item.
21: The top-level menu contains:
22: .PP
23: .de fq
24: \f5\\$1\fR \\$2 \\$3 \\$4 \\$5 \\$6
25: ..
26: .nf
27: .ta \w'\f5Line style\fP 'u +\w'\(-> 'u
28: .fq Style \(-> "Different kinds of brush strokes"
29: .fq Operation \(-> "Ways of putting paint on canvas"
30: .fq Texture \(-> "Things to do to the texture pattern"
31: .fq Brush \(-> "Things to do to the paintbrush"
32: .fq Canvas \(-> "Things to do to the whole picture"
33: .fq State \(-> "Change things saved in \fI.paintstate\fP"
34: .fq Fill "" "Fill an area of the picture"
35: .fq Green "" "Erase the entire picture"
36: .fq Mask "" "Display mask instead of image"
37: .fq Exit
38: .fi
39: .PP
40: The
41: .B Style
42: submenu:
43: .PP
44: .nf
45: .fq Paint "" "Multiple brush spots while holding button 1 or 2
46: .fq Circles "" "Circles; press at center and release at circumference
47: .fq Lines "" "Rubber-band brush lines
48: .fq Curves "" "Continuous strokes while holding button 1 or 2
49: .fq "Line Style" \(-> "Solid, dotted, dashed, etc. lines
50: .fi
51: .PP
52: Entries in the
53: .B Line Style
54: sub-submenu are strings of
55: .LR A s,
56: .LR B s
57: and dot that
58: describe dotted and dashed lines.
59: .L A
60: stands for the brush on the button pushed,
61: .L B
62: stands for the brush on the other button;
63: .L .
64: for
65: no brush at all.
66: The string is cycled through at successive points when drawing
67: Lines, Curves, or Circles.
68: Thus
69: .L A
70: means a solid line,
71: .L A...
72: means a 1 in 4 dotted
73: line, and
74: .L AAAA....
75: means 4-pixel dashes.
76: .PP
77: The
78: .B Operation
79: submenu assigns a pair of operations for buttons 1 and 2.
80: A hidden `mask' plane describes the shape that has been painted;
81: black pixels in the mask are inside, green outside.
82: Likewise, the brush
83: consists of a pair of rectangular image and mask planes.
84: There are 11 effective operations to combine the part of the brush
85: inside its mask
86: with the part of the picture it sits on (see
87: the Porter/Duff paper for details); selected pairs can be assigned to the
88: buttons:
89: .PP
90: .nf
91: .ta \w'\f5Line style\fP \(-> 'u
92: .fq Above/Erase "Button 1 paints on top, Button 2 erases
93: .fq Below/Erase "Button 1 paints behind, Button 2 erases
94: .fq Above/Below "Button 1 paints on top, Button 2 behind
95: .fq Inside/Erase "Button 1 paints inside, Button 2 erases
96: .fq Brush/Clear "Special effects
97: .fq AoutB/AinB "Special effects
98: .fq BinA/BatopA "Special effects
99: .fq Xor/Above "Special effects
100: .fi
101: .PP
102: .B Above
103: paints on top of the picture, as in
104: `normal' paint programs.
105: .PP
106: .B Below
107: paints underneath\(emonly in places that were not
108: previously covered.
109: .PP
110: .B Inside
111: paints on top, but only inside the already-painted part.
112: .PP
113: The other 7 operations are best described as `special effects'.
114: Try them out
115: to see what they do, or look at the Porter/Duff paper.
116: .PP
117: Texture
118: facilities paint with a repeating 16\(mu16 pattern instead of copies of
119: a brush.
120: The
121: .B Texture
122: submenu contains:
123: .PP
124: .nf
125: .ta \w'\f5Line style\fP 'u +\w'\(-> 'u
126: .fq Texture "" "Turn texturing on or off
127: .fq Make "" "Pick a texture from the picture
128: .fq Negate "" "Reverse the texture's green and black
129: .fq Save "" "Name a texture and copy it into a file
130: .fq Library \(-> "List and and retrieve textures in library
131: .fq Get "" "Type a name and get a texture from a file
132: .fi
133: .PP
134: .B Make
135: gives a 16\(mu16 square cursor with which to pick
136: a texture.
137: .PP
138: The
139: .B Brush
140: submenu has the same items
141: for brushes.
142: .B Make
143: allows you to sweep out a region to use as a brush.
144: .PP
145: The
146: .B Canvas
147: submenu contains
148: .BR Negate ,
149: .BR Save ,
150: .BR Library ,
151: and
152: .BR Get ,
153: in this case pertaining to entire pictures.
154: A library picture
155: is saved in a file containing the image plane then the
156: mask plane in
157: .IR bitfile (9.5)
158: format.
159: .PP
160: The file
161: .B .paintstate
162: in the current directory remembers
163: the names of the current brush, texture,
164: and libraries between sessions.
165: The
166: .B State
167: submenu displays the library names at the bottom
168: of the layer, where they can be edited:
169: .PP
170: .nf
171: .ta \w'\f5Line style\fP \(-> 'u
172: .fq Brushes "" "Name the brush directory
173: .fq Pictures "" "Name the picture directory
174: .fq Textures "" "Name the texture directory
175: .fi
176: .PP
177: The
178: .B Fill
179: menu item gives an arrowhead cursor.
180: If you touch down with button 3 at a point not painted,
181: the rookwise-connected
182: region containing it will fill with black.
183: On completion, the
184: black will be replaced by the current texture.
185: While the region is filling, any button click aborts the operation.
186: .PP
187: The current selections from the
188: .BR "Brush Library" ,
189: .BR Style ,
190: .BR Operation ,
191: .BR Texture ,
192: and
193: .B "Line Style"
194: menus are marked with a
195: .LR * ,
196: and are displayed in the information box
197: at the bottom of the layer.
198: .SH FILES
199: .TF /usr/jerq/lib/paint/brush
200: .TP
201: .F /usr/jerq/lib/paint/brush
202: the default brush library
203: .TP
204: .F /usr/jerq/lib/paint/tex
205: the default texture library
206: .TP
207: .F \&.paintstate
208: state of terminated program
209: .SH SEE ALSO
210: .IR mbits (6),
211: .IR bitfile (9.5),
212: .IR brush (9.1),
213: .IR cip (9.1),
214: .IR ped (9.1)
215: .br
216: Thomas Porter and Tom Duff,
217: `Compositing Digital Images,'
218: Siggraph '84 Proceedings
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.