*** UNIX MANUAL PAGE BROWSER ***

PAINT(9.1) PAINT(9.1) NAME paint - draw pictures in a layer SYNOPSIS paint DESCRIPTION Paint is a program for artistic interactive drawing. Buttons 1 and 2 draw in different ways, e.g. depositing and erasing paint. Button 3 gets a menu. Certain menu items contain arrows, which if touched call submenus. Moving off the right of a submenu causes it to disappear. Some items toggle a state on and off; a appears in the abnormal state. Pressing button 1 while holding button 3 gets a short help message for the menu item. The top-level menu contains: Style -> Different kinds of brush strokes Operation -> Ways of putting paint on canvas Texture -> Things to do to the texture pattern Brush -> Things to do to the paintbrush Canvas -> Things to do to the whole picture State -> Change things saved in .paintstate Fill Fill an area of the picture Green Erase the entire picture Mask Display mask instead of image Exit The Style submenu: Paint Multiple brush spots while holding button 1 or 2 Circles Circles; press at center and release at circumference Lines Rubber-band brush lines Curves Continuous strokes while holding button 1 or 2 Line Style -> Solid, dotted, dashed, etc. lines Entries in the Line Style sub-submenu are strings of and dot that de- scribe dotted and dashed lines. stands for the brush on the button pushed, stands for the brush on the other button; for no brush at all. The string is cycled through at successive points when drawing Lines, Curves, or Circles. Thus means a solid line, means a 1 in 4 dotted line, and means 4-pixel dashes. The Operation submenu assigns a pair of operations for buttons 1 and 2. A hidden `mask' plane describes the shape that has been painted; black pixels in the mask are inside, green outside. Likewise, the brush con- sists of a pair of rectangular image and mask planes. There are 11 ef- fective operations to combine the part of the brush inside its mask with the part of the picture it sits on (see the Porter/Duff paper for details); selected pairs can be assigned to the buttons: Above/Erase Button 1 paints on top, Button 2 erases Below/Erase Button 1 paints behind, Button 2 erases Above/Below Button 1 paints on top, Button 2 behind Inside/Erase Button 1 paints inside, Button 2 erases Brush/Clear Special effects AoutB/AinB Special effects BinA/BatopA Special effects Xor/Above Special effects Above paints on top of the picture, as in `normal' paint programs. Below paints underneath--only in places that were not previously cov- ered. Inside paints on top, but only inside the already-painted part. The other 7 operations are best described as `special effects'. Try them out to see what they do, or look at the Porter/Duff paper. Texture facilities paint with a repeating 16x16 pattern instead of copies of a brush. The Texture submenu contains: Texture Turn texturing on or off Make Pick a texture from the picture Negate Reverse the texture's green and black Save Name a texture and copy it into a file Library -> List and and retrieve textures in library Get Type a name and get a texture from a file Make gives a 16x16 square cursor with which to pick a texture. The Brush submenu has the same items for brushes. Make allows you to sweep out a region to use as a brush. The Canvas submenu contains Negate, Save, Library, and Get, in this case pertaining to entire pictures. A library picture is saved in a file containing the image plane then the mask plane in bitfile(9.5) format. The file .paintstate in the current directory remembers the names of the current brush, texture, and libraries between sessions. The State submenu displays the library names at the bottom of the layer, where they can be edited: Brushes Name the brush directory Pictures Name the picture directory Textures Name the texture directory The Fill menu item gives an arrowhead cursor. If you touch down with button 3 at a point not painted, the rookwise-connected region contain- ing it will fill with black. On completion, the black will be replaced by the current texture. While the region is filling, any button click aborts the operation. The current selections from the Brush Library, Style, Operation, Tex- ture, and Line Style menus are marked with a and are displayed in the information box at the bottom of the layer. FILES the default brush library the default texture library state of terminated program SEE ALSO mbits(6), bitfile(9.5), brush(9.1), cip(9.1), ped(9.1) Thomas Porter and Tom Duff, `Compositing Digital Images,' Siggraph '84 Proceedings PAINT(9.1)