Return to paint.9 CVS log

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

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

1.1     ! root        1: .TH PAINT 9.1
        !             2: .CT 1 games
        !             3: .SH NAME
        !             4: paint \- draw pictures in a layer
        !             5: .SH SYNOPSIS
        !             6: .B paint
        !             7: .SH DESCRIPTION
        !             8: .PP
        !             9: .I Paint
        !            10: is a program for artistic interactive drawing.
        !            11: Buttons 1 and 2 draw in different ways,
        !            12: e.g. depositing and erasing paint.
        !            13: Button 3 gets a menu.
        !            14: Certain menu items contain arrows, which if touched call submenus.
        !            15: Moving off the right of a submenu causes it to disappear.
        !            16: Some items toggle a state on and off; a
        !            17: .L *
        !            18: appears in the abnormal state.
        !            19: Pressing button 1 while holding button 3 gets a short help
        !            20: message for the menu item.
        !            21: The top-level menu contains:
        !            22: .PP
        !            23: .de fq
        !            24: \f5\\$1\fR     \\$2    \\$3 \\$4 \\$5 \\$6
        !            25: ..
        !            26: .nf
        !            27: .ta \w'\f5Line style\fP 'u +\w'\(-> 'u
        !            28: .fq Style \(-> "Different kinds of brush strokes"
        !            29: .fq Operation \(-> "Ways of putting paint on canvas"
        !            30: .fq Texture \(-> "Things to do to the texture pattern"
        !            31: .fq Brush \(-> "Things to do to the paintbrush"
        !            32: .fq Canvas \(-> "Things to do to the whole picture"
        !            33: .fq State \(-> "Change things saved in \fI.paintstate\fP"
        !            34: .fq Fill "" "Fill an area of the picture"
        !            35: .fq Green "" "Erase the entire picture"
        !            36: .fq Mask "" "Display mask instead of image"
        !            37: .fq Exit
        !            38: .fi
        !            39: .PP
        !            40: The
        !            41: .B Style
        !            42: submenu:
        !            43: .PP
        !            44: .nf
        !            45: .fq Paint "" "Multiple brush spots while holding button 1 or 2
        !            46: .fq Circles "" "Circles; press at center and release at circumference
        !            47: .fq Lines "" "Rubber-band brush lines
        !            48: .fq Curves "" "Continuous strokes while holding button 1 or 2
        !            49: .fq "Line Style" \(-> "Solid, dotted, dashed, etc. lines
        !            50: .fi
        !            51: .PP
        !            52: Entries in the
        !            53: .B Line Style
        !            54: sub-submenu are strings of 
        !            55: .LR A s, 
        !            56: .LR B s
        !            57: and dot that
        !            58: describe dotted and dashed lines.
        !            59: .L A
        !            60: stands for the brush on the button pushed,
        !            61: .L B
        !            62: stands for the brush on the other button; 
        !            63: .L .
        !            64: for
        !            65: no brush at all.
        !            66: The string is cycled through at successive points when drawing
        !            67: Lines, Curves, or Circles.
        !            68: Thus 
        !            69: .L A
        !            70: means a solid line,
        !            71: .L A...
        !            72: means a 1 in 4 dotted
        !            73: line, and
        !            74: .L AAAA....
        !            75: means 4-pixel dashes.
        !            76: .PP
        !            77: The
        !            78: .B Operation
        !            79: submenu assigns a pair of operations for buttons 1 and 2.
        !            80: A hidden `mask' plane describes the shape that has been painted;
        !            81: black pixels in the mask are inside, green outside.
        !            82: Likewise, the brush
        !            83: consists of a pair of rectangular image and mask planes.
        !            84: There are 11 effective operations to combine the part of the brush
        !            85: inside its mask
        !            86: with the part of the picture it sits on (see
        !            87: the Porter/Duff paper for details); selected pairs can be assigned to the
        !            88: buttons:
        !            89: .PP
        !            90: .nf
        !            91: .ta \w'\f5Line style\fP \(-> 'u
        !            92: .fq Above/Erase "Button 1 paints on top, Button 2 erases
        !            93: .fq Below/Erase "Button 1 paints behind, Button 2 erases
        !            94: .fq Above/Below "Button 1 paints on top, Button 2 behind
        !            95: .fq Inside/Erase "Button 1 paints inside, Button 2 erases
        !            96: .fq Brush/Clear "Special effects
        !            97: .fq AoutB/AinB "Special effects
        !            98: .fq BinA/BatopA "Special effects
        !            99: .fq Xor/Above "Special effects
        !           100: .fi
        !           101: .PP
        !           102: .B Above
        !           103: paints on top of the picture, as in
        !           104: `normal' paint programs.
        !           105: .PP
        !           106: .B Below
        !           107: paints underneath\(emonly in places that were not
        !           108: previously covered.
        !           109: .PP
        !           110: .B Inside
        !           111: paints on top, but only inside the already-painted part.
        !           112: .PP
        !           113: The other 7 operations are best described as `special effects'.
        !           114: Try them out
        !           115: to see what they do, or look at the Porter/Duff paper.
        !           116: .PP
        !           117: Texture
        !           118: facilities paint with a repeating 16\(mu16 pattern instead of copies of
        !           119: a brush.
        !           120: The
        !           121: .B Texture
        !           122: submenu contains:
        !           123: .PP
        !           124: .nf
        !           125: .ta \w'\f5Line style\fP 'u +\w'\(-> 'u
        !           126: .fq Texture "" "Turn texturing on or off
        !           127: .fq Make "" "Pick a texture from the picture
        !           128: .fq Negate "" "Reverse the texture's green and black
        !           129: .fq Save "" "Name a texture and copy it into a file
        !           130: .fq Library \(-> "List and and retrieve textures in library
        !           131: .fq Get "" "Type a name and get a texture from a file
        !           132: .fi
        !           133: .PP
        !           134: .B Make
        !           135: gives a 16\(mu16 square cursor with which to pick
        !           136: a texture.
        !           137: .PP
        !           138: The
        !           139: .B Brush
        !           140: submenu has the same items
        !           141: for brushes.
        !           142: .B Make
        !           143: allows you to sweep out a region to use as a brush.
        !           144: .PP
        !           145: The
        !           146: .B Canvas
        !           147: submenu contains
        !           148: .BR Negate ,
        !           149: .BR Save ,
        !           150: .BR Library ,
        !           151: and
        !           152: .BR Get ,
        !           153: in this case pertaining to entire pictures.
        !           154: A library picture
        !           155: is saved in a file containing the image plane then the
        !           156: mask plane in
        !           157: .IR bitfile (9.5)
        !           158: format.
        !           159: .PP
        !           160: The file
        !           161: .B .paintstate
        !           162: in the current directory remembers
        !           163: the names of the current brush, texture,
        !           164: and libraries between sessions.
        !           165: The
        !           166: .B State
        !           167: submenu displays the library names at the bottom
        !           168: of the layer, where they can be edited:
        !           169: .PP
        !           170: .nf
        !           171: .ta \w'\f5Line style\fP \(-> 'u
        !           172: .fq Brushes  "" "Name the brush directory
        !           173: .fq Pictures  "" "Name the picture directory
        !           174: .fq Textures  "" "Name the texture directory
        !           175: .fi
        !           176: .PP
        !           177: The
        !           178: .B Fill
        !           179: menu item gives an arrowhead cursor.
        !           180: If you touch down with button 3 at a point not painted,
        !           181: the rookwise-connected
        !           182: region containing it will fill with black.
        !           183: On completion, the
        !           184: black will be replaced by the current texture.
        !           185: While the region is filling, any button click aborts the operation.
        !           186: .PP
        !           187: The current selections from the
        !           188: .BR "Brush Library" ,
        !           189: .BR Style ,
        !           190: .BR Operation ,
        !           191: .BR Texture ,
        !           192: and
        !           193: .B "Line Style"
        !           194: menus are marked with a 
        !           195: .LR * ,
        !           196: and are displayed in the information box
        !           197: at the bottom of the layer.
        !           198: .SH FILES
        !           199: .TF /usr/jerq/lib/paint/brush
        !           200: .TP
        !           201: .F /usr/jerq/lib/paint/brush
        !           202: the default brush library
        !           203: .TP
        !           204: .F /usr/jerq/lib/paint/tex
        !           205: the default texture library
        !           206: .TP
        !           207: .F \&.paintstate
        !           208: state of terminated program
        !           209: .SH SEE ALSO
        !           210: .IR mbits (6),
        !           211: .IR bitfile (9.5), 
        !           212: .IR brush (9.1),
        !           213: .IR cip (9.1),
        !           214: .IR ped (9.1)
        !           215: .br
        !           216: Thomas Porter and Tom Duff,
        !           217: `Compositing Digital Images,'
        !           218: Siggraph '84 Proceedings

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