man(1) Manual page archive


     BRUSH(9.1)                                             BRUSH(9.1)

     NAME
          brush - painting program

     SYNOPSIS
          brush [ -f fontdir ] [ -p picdir ] [ -t texdir ]

     DESCRIPTION
          Brush paints images under mouse control.  Options are

          -f   font directory by default)
          -p   the directory in which to keep pictures (current direc-
               tory by default)
          -t   texture directory, where brushes and shades live (cur-
               rent directory by default)

          In general, button 1 draws, button 2 erases; the cursor
          assumes the shape of the current brush.  Button 3 is used to
          select options, sweep out areas, or cancel operations in
          progress.

          The borders on either side of the drawing area contain menus
          of available shades and brushes.  The current brush and
          shade are outlined by boxes.  To choose another, click but-
          ton 3 at it.

          The top border contains a help area, drawing options, and
          certain commands.  Selections are made by pointing with but-
          ton 3.  Some cycle through options; others bring up menus.
          The items are:

          help Icons in three boxes indicate what buttons 1, 2, and 3
               will do at any given time:

               paintbrush         draw with this button
               pencil eraser      erase with this button
               menu with cursor   menu on this button
               thumbs down        cancel or finish an operation
               pointing hand      indicate a point
               square with arrow  sweep a rectangle
               circle with arrow  sweep a circle
               skull              exit the program

          smooth
               Smooth the contours of magnified images.

          align
               Force circles, discs, text, and other images to align
               with texture cell boundaries.

          image

     BRUSH(9.1)                                             BRUSH(9.1)

               Manipulate the `current image', (box, ellipse, etc.)
               selected from the drawing menu described below.  Button
               3 makes the image disappear, reserved for future use.
               The image menu contains:

               same     Bring back the current image.
               magnify  Sweep a rectangle indicating the size of the
                        magnified image.  The numbers that appear are
                        horizontal and vertical magnification factors.
               shrink   Shrink to 1/4 size.  Indicate whether image is
                        shaded or black & white.
               flip     Reflect left-right or top-bottom.
               rotate   Rotate counterclockwise or clockwise 90
                        degrees.
               slant    Drag the current image rectangle into a paral-
                        lelogram.
               outline  Replace the current image with its outline.
               shadow   Draw a `shadow' behind the current image.
               shadow   Draw a `shadow' behind the current image.
               new      Make a new image by copying a rectangular por-
                        tion of the screen.

                  To move an image on the screen, select new from the
                  image menu.  Sweep the area to be moved, click but-
                  ton 2 to erase it, move it, and click button 1 to
                  draw it.

          drawing style
                  Select continuous curves, dotted lines, disconnected
                  dots, or an `airbrush' effect when painting.
          constrain
                  Select freehand (wavy-line icon) or horizontal-
                  vertical drawing (angular icon).

          reflect Draw symmetric figures.  The icon shows the symme-
                  tries: x=0 (left-right), y=0 (top-bottom), or both,
                  relative to the center of the screen.
          draw mode
                  Set the drawing mode to one of or, xor, store, and,
                  copy (preserves interior whitespace of images).
          text style
                  Set the text style to one of normal, outline, bold,
                  shadow, italic.
          font name
                  Set the text font.  Menu selection new prompts for a
                  font name from the font directory.

          i/o     Interact with host machine.  Menu items are:
                  save    Copy screen, brushes, or shades to a file.
                          Prompts for a file name, starting with the
                          default picture directory (if any).  Back-
                          space past this if you wish to save

     BRUSH(9.1)                                             BRUSH(9.1)

                          elsewhere; hit return to quit.  Next sweep a
                          rectangle to be saved.  Bitmaps are saved in
                          bitfile(9.5) format.
                  recall  Prompts for a file name.  The recalled pic-
                          ture becomes the current image.
                  exit    Leave the program.  Confirm by two clicks on
                          button 3.

          The menu on button 3 in the drawing area contains these
          selections:

          lines   Indicate first point, then position cursor with rub-
                  ber band line for subsequent lines.  Button 1 draws,
                  button 2 erases.

          curves  Indicate first control point, then position cursor
                  with rubber band line for subsequent control points.
                  A curve (spline) will be drawn (erased) using these
                  control points, depending on whether the last button
                  hit is button 1 (draw), or button 2 (erase).
          box
          ellipse
          disc    (A disc is a filled ellipse).  Sweep a rectangle;
                  numbers show the dimensions.  A single dot marks the
                  center of an ellipse.  The image becomes the current
                  image; use buttons 1 and 2 to draw or erase with it.

          string  Type in text.  The string becomes the current image.

          texture Sweep a rectangle.  The current image becomes a
                  rectangle of this size textured with current shade.

          fill    Sweep a rectangle, then indicate interior seed
                  points using button 1, or button 3 to quit.
                  Enclosed regions will be filled with current shade.
                  Any button cancels the fill.
          clear
          invert  Sweep a rectangle to be cleared or color-inverted.

          fade    Sweep a rectangle.  Holding button 2 will fade this
                  area, as if erasing in spray paint mode with a ran-
                  dom pattern instead of a shade.
          new brush
          new shade
                  Menu select whether to edit or snarf from screen
                  (with button 3).  If editing, the current brush
                  (shade) will appear magnified in upper left corner.
                  Edit with buttons 1 and 2, quit with 3.  Several
                  `spare' brushes appear at the bottom of the brush
                  menu.

          details Select an area with box cursor to be magnified for

     BRUSH(9.1)                                             BRUSH(9.1)

                  detailed editing.

     SEE ALSO
          paint(9.1), mbits(6), bitfile(9.5)

     BUGS
          The smoothing operation fully smooths only for magnification
          factors that are powers of two.
          Bitmaps moved off the top or bottom of the physical screen
          can pick up noise.
          Copy mode generates a mask the first time a given image is
          moved.  This can take a while for large images.  Be patient.