Return to brush.9 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man9

Annotation of researchv10dc/man/adm/man9/brush.9, revision 1.1

1.1     ! root        1: .TH BRUSH 9.1
        !             2: .CT 1 games
        !             3: .SH NAME
        !             4: brush \- painting program
        !             5: .SH SYNOPSIS
        !             6: .B brush
        !             7: [
        !             8: .B -f
        !             9: .I fontdir
        !            10: ]
        !            11: [
        !            12: .B -p
        !            13: .I picdir
        !            14: ]
        !            15: [
        !            16: .B -t
        !            17: .I texdir
        !            18: ]
        !            19: .SH DESCRIPTION
        !            20: .I Brush
        !            21: paints images under mouse control.
        !            22: Options are
        !            23: .TP
        !            24: .B -f
        !            25: font directory 
        !            26: .RF ( /usr/jerq/font
        !            27: by default)
        !            28: .PD 0
        !            29: .TP
        !            30: .B -p
        !            31: the directory in which to keep pictures
        !            32: (current directory by default)
        !            33: .TP
        !            34: .B -t
        !            35: texture directory, where brushes and shades live
        !            36: (current directory by default)
        !            37: .PD
        !            38: .PP
        !            39: In general, button 1 draws, button 2 erases;
        !            40: the cursor assumes the shape of the current brush.
        !            41: Button 3 is used to select options, sweep out areas,
        !            42: or cancel operations in progress.
        !            43: .PP
        !            44: The borders on either side of the drawing area contain menus of
        !            45: available shades and brushes.
        !            46: The current brush and shade are outlined by boxes.
        !            47: To choose another, click button 3 at it.
        !            48: .PP
        !            49: The top border contains
        !            50: a help area,
        !            51: drawing options,
        !            52: and certain commands.
        !            53: Selections are made by pointing with button 3.
        !            54: Some cycle through options; others bring up menus.
        !            55: The items are:
        !            56: .TP
        !            57: help
        !            58: Icons in three boxes indicate what buttons
        !            59: 1, 2, and 3 will do at any given time:
        !            60: .PD
        !            61: .IP
        !            62: .nf
        !            63: .ta \w'\f5square with arrow  'u
        !            64: paintbrush     draw with this button
        !            65: pencil eraser  erase with this button
        !            66: menu with cursor       menu on this button
        !            67: thumbs down    cancel or finish an operation
        !            68: pointing hand  indicate a point
        !            69: square with arrow      sweep a rectangle
        !            70: circle with arrow      sweep a circle
        !            71: skull  exit the program
        !            72: .fi
        !            73: .DT
        !            74: .TP
        !            75: smooth
        !            76: Smooth the contours of magnified images.
        !            77: .TP
        !            78: align
        !            79: Force circles, discs, text, and other images
        !            80: to align with texture cell boundaries.
        !            81: .TP
        !            82: .B image
        !            83: Manipulate the
        !            84: `current image',
        !            85: (box, ellipse, etc.)\&
        !            86: selected from the drawing menu described below.
        !            87: Button 3 makes the image disappear, reserved for future use.
        !            88: The image menu contains:
        !            89: .RS
        !            90: .TF magnify
        !            91: .TP
        !            92: .B same
        !            93: Bring back the current image.
        !            94: .TP
        !            95: .B magnify
        !            96: Sweep a rectangle indicating the
        !            97: size of the magnified image.
        !            98: The numbers that appear are horizontal and vertical
        !            99: magnification factors.
        !           100: .TP
        !           101: .B shrink
        !           102: Shrink to 1/4 size.
        !           103: Indicate whether image is shaded or black & white.
        !           104: .TP
        !           105: .B flip
        !           106: Reflect left-right or top-bottom.
        !           107: .TP
        !           108: .B rotate
        !           109: Rotate counterclockwise or clockwise 90 degrees.
        !           110: .TP
        !           111: .B slant
        !           112: Drag the current image rectangle into a parallelogram.
        !           113: .TP
        !           114: .B outline
        !           115: Replace the current image with its outline.
        !           116: .TP
        !           117: .B shadow
        !           118: Draw a `shadow' behind the current image.
        !           119: .TP
        !           120: .B shadow
        !           121: Draw a `shadow' behind the current image.
        !           122: .TP
        !           123: .B new
        !           124: Make a new image by copying a rectangular portion of the screen.
        !           125: .RE
        !           126: .PD
        !           127: .TF Smooth
        !           128: .IP 
        !           129: To move an image on the screen, select
        !           130: .B new
        !           131: from the
        !           132: .B image
        !           133: menu.
        !           134: Sweep the area to be moved, click button 2 to erase it,
        !           135: move it, and click button 1 to draw it.
        !           136: .PD 
        !           137: .TP
        !           138: drawing style
        !           139: Select continuous curves, dotted lines,
        !           140: disconnected dots, or an `airbrush' effect when painting.
        !           141: .PD 0
        !           142: .TP
        !           143: constrain
        !           144: Select freehand (wavy-line icon) or 
        !           145: horizontal-vertical drawing (angular icon).
        !           146: .PD
        !           147: .TP
        !           148: reflect
        !           149: Draw symmetric figures.
        !           150: The icon shows the symmetries:
        !           151: .B x=0
        !           152: (left-right), 
        !           153: .B y=0
        !           154: (top-bottom),
        !           155: or
        !           156: .BR both ,
        !           157: relative to the center of the screen.
        !           158: .PD0
        !           159: .TP
        !           160: draw mode
        !           161: Set the drawing mode to one of
        !           162: .BR or ,
        !           163: .BR xor ,
        !           164: .BR store ,
        !           165: .BR and ,
        !           166: .B copy
        !           167: (preserves interior whitespace of images).
        !           168: .TP
        !           169: text style
        !           170: Set the text style to one of
        !           171: .BR normal ,
        !           172: .BR outline ,
        !           173: .BR bold ,
        !           174: .BR shadow ,
        !           175: .BR italic .
        !           176: .TP
        !           177: font name
        !           178: Set the text font.
        !           179: Menu selection
        !           180: .B new
        !           181: prompts for a font name
        !           182: from the font directory.
        !           183: .PD
        !           184: .TP
        !           185: .B i/o
        !           186: Interact with host machine.
        !           187: Menu items are:
        !           188: .PD 0
        !           189: .RS
        !           190: .TF recall
        !           191: .TP
        !           192: .B save
        !           193: Copy screen, brushes, or shades to a file.
        !           194: Prompts for a file name, starting with the default picture
        !           195: directory (if any).
        !           196: Backspace past this if you wish to save elsewhere;
        !           197: hit return to quit.
        !           198: Next sweep a rectangle to be saved.
        !           199: Bitmaps are saved in
        !           200: .IR bitfile (9.5)
        !           201: format.
        !           202: .TP
        !           203: .B recall
        !           204: Prompts for a file name.
        !           205: The recalled picture becomes the
        !           206: current image.
        !           207: .TP
        !           208: .B exit
        !           209: Leave the program.
        !           210: Confirm by
        !           211: two clicks on button 3.
        !           212: .PD
        !           213: .RE
        !           214: .PP
        !           215: The menu on button 3 in the drawing area contains these selections:
        !           216: .TF Smooth
        !           217: .TP
        !           218: .B lines
        !           219: Indicate first point, then position cursor with rubber band line
        !           220: for subsequent lines.
        !           221: Button 1 draws, button 2 erases.
        !           222: .PD
        !           223: .TP
        !           224: .B curves
        !           225: Indicate first control point, then position cursor with rubber band line
        !           226: for subsequent control points.
        !           227: A curve (spline) will be drawn (erased) using these control points,
        !           228: depending on whether the last button hit is button 1 (draw), or button 2 (erase).
        !           229: .PD 0
        !           230: .TP
        !           231: .B box
        !           232: .TP
        !           233: .B ellipse
        !           234: .TP
        !           235: .B disc
        !           236: (A disc is a filled ellipse).
        !           237: Sweep a rectangle;
        !           238: numbers show the dimensions.
        !           239: A single dot marks the center of an ellipse.
        !           240: The image becomes the current image;
        !           241: use buttons 1 and 2 to draw or erase with it.
        !           242: .PD
        !           243: .TP
        !           244: .B string
        !           245: Type in text.
        !           246: The string becomes the current image.
        !           247: .TP
        !           248: .B texture
        !           249: Sweep a rectangle.
        !           250: The current image
        !           251: becomes a rectangle of this size textured with current shade.
        !           252: .TP
        !           253: .B fill
        !           254: Sweep a rectangle, then indicate interior seed points
        !           255: using button 1, or button 3 to quit.
        !           256: Enclosed regions will be filled with current shade.
        !           257: Any button cancels the fill.
        !           258: .PD 0
        !           259: .TP
        !           260: .B clear
        !           261: .TP
        !           262: .B invert
        !           263: Sweep a rectangle to be cleared or color-inverted.
        !           264: .PD
        !           265: .TP
        !           266: .B fade
        !           267: Sweep a rectangle.
        !           268: Holding button 2 will fade this area, as if
        !           269: erasing in
        !           270: spray paint mode with
        !           271: a random pattern instead of a shade.
        !           272: .PD 0
        !           273: .TP
        !           274: .B new brush
        !           275: .TP
        !           276: .B new shade
        !           277: Menu select whether to edit or snarf from screen (with button 3).
        !           278: If editing,
        !           279: the current brush (shade) will appear magnified in upper left corner.
        !           280: Edit with buttons 1 and 2, quit with 3.
        !           281: Several `spare' brushes appear at the bottom of the brush menu.
        !           282: .PD
        !           283: .TP
        !           284: .B details
        !           285: Select an area with box cursor to be magnified for detailed editing.
        !           286: .PD
        !           287: .SH "SEE ALSO"
        !           288: .IR paint (9.1),
        !           289: .IR mbits (6),
        !           290: .IR bitfile (9.5)
        !           291: .SH BUGS
        !           292: The smoothing operation fully smooths only
        !           293: for magnification factors that are powers of two.
        !           294: .br
        !           295: Bitmaps moved off the top or bottom
        !           296: of the physical screen can pick up noise.
        !           297: .br
        !           298: .B Copy
        !           299: mode generates a mask the first time a given image is moved.
        !           300: This can take a while for large images.
        !           301: Be patient.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.