man(1) Manual page archive


     PAINT(9.1)                                             PAINT(9.1)

     NAME
          paint - draw pictures in a layer

     SYNOPSIS
          paint

     DESCRIPTION
          Paint is a program for artistic interactive drawing.  But-
          tons 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 `A's,
          `B's and dot that describe dotted and dashed lines.  `A'
          stands for the brush on the button pushed, `B' stands for
          the brush on the other button; `.'  for no brush at all.
          The string is cycled through at successive points when draw-
          ing Lines, Curves, or Circles.  Thus `A' means a solid line,
          `A...'  means a 1 in 4 dotted line, and `AAAA....'  means
          4-pixel dashes.

          The Operation submenu assigns a pair of operations for but-
          tons 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 consists of a pair of
          rectangular image and mask planes.  There are 11 effective

     PAINT(9.1)                                             PAINT(9.1)

          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 previ-
          ously covered.

          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 16×16 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 16×16 square cursor with which to pick a tex-
          ture.

          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 pic-
          ture 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:

     PAINT(9.1)                                             PAINT(9.1)

          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 containing it will fill with black.  On
          completion, the black will be replaced by the current tex-
          ture.  While the region is filling, any button click aborts
          the operation.

          The current selections from the Brush Library, Style,
          Operation, Texture, 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