1 .TH PAINT 1
2 .CT 1 graphics
3 .SH NAME
4 paint \- create image files by drawing with a mouse or other pointing device
5 .SH SYNOPSIS
6 .B paint
7 [
8 .I file
9 ]
10 .SH DESCRIPTION
11 .I Paint
12 displays a canvas upon which can be drawn lines using the mouse holding
13 down buttons 1 or 2 for foreground or background color.  The canvas
14 may be moved with button 3.  Colors and brush sizes may be selected by
15 clicking on the palette at the bottom of the screen with buttons 1 or 2.
16 .PP
17 If the optional
18 .I file
19 argument is specified, then it is read and used as the canvas.
20 .I Paint
21 only recognizes Plan 9 bitmap format (see
22 .MR image (6) ).
23 .PP
24 A number of immediate keyboard commands are recognized:
25 .TP
26 .B u
27 Undos the previous action.
28 .TP
29 .B c
30 Clears the canvas with the background color.
31 .TP
32 .B 1-9
33 Select brush size.
34 .TP
35 .B f
36 Select flood fill brush.
37 .TP
38 .B +
39 Doubles magnification.
40 .TP
41 .B -
42 Halves magnification.
43 .TP
44 .B esc
45 Centers the canvas and resets magnification.
46 .PP
47 Hitting any other key on the keyboard shows a command prompt
48 where the following commands may be entered:
49 .TP
50 .BI r file
51 Reads the canvas from
52 .I file.
53 .TP
54 .BI w file
55 Writes the canvas to
56 .I file.
57 .TP
58 .BI < command
59 Executes
60 .I command
61 and reads the canvas from its standard output.
62 .TP
63 .BI > command
64 Executes
65 .I command
66 and writes the canvas to its standard input.
67 .TP
68 .BI | command
69 Transforms the canvas by piping it thru
70 .I command.
71 .TP
72 .B q
73 Quits the program.
74 .SH SOURCE
75 .B /sys/src/cmd/paint.c
76 .SH "SEE ALSO"
77 .MR resample (1) ,
78 .MR rotate (1) ,
79 .MR crop (1) ,
80 .MR jpg (1) ,
81 .MR page (1) ,
82 .MR image (6)
83 .SH HISTORY
84 .I Paint
85 first appeared in 9front (October, 2011).