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.