Annotation of researchv10dc/man/adm/man9/blitblt.9, revision 1.1.1.1

1.1       root        1: .TH BLITBLT 9.1
                      2: .CT 1 comm_other
                      3: .SH NAME
                      4: blitblt, menudrop \- save or print a screen image
                      5: .SH SYNOPSIS
                      6: .B blitblt
                      7: [
                      8: .B -p
                      9: .I command
                     10: ]
                     11: .PP
                     12: .B menudrop
                     13: .SH DESCRIPTION
                     14: .I Blitblt
                     15: copies a selected area of a
                     16: .IR mux (9.1)
                     17: screen into a file
                     18: or to a program.
                     19: It is menu-driven off button 3 to select a
                     20: rectangular area and to treat it by flipping the
                     21: border from wide to narrow and back, inverting video,
                     22: saving the selcted area in a file, or sending 
                     23: it to a program, usually for printing.
                     24: Details of certain menu items:
                     25: .nr xx \w'\f5sweep rectangle\f1'u+2n/1n
                     26: .TP \n(xx
                     27: .TP
                     28: .B choose layer
                     29: .br
                     30: .ns
                     31: .TP
                     32: .B layer rectangle
                     33: One gets the bits of a layer, obscured or not; the other
                     34: gets screen bits including superposed layers.
                     35: .TP
                     36: .B run/halt
                     37: Restart or stop the terminal
                     38: process in the selected layer.
                     39: .TP
                     40: .B write file
                     41: Write the selected area into a file or pipe in
                     42: .IR bitfile (9.5)
                     43: format.
                     44: The filename is typed 
                     45: at the bottom of the
                     46: .I blitblt
                     47: layer.
                     48: A bare newline repeats the previous name.
                     49: If the first character is
                     50: .LR | ,
                     51: the remainder of
                     52: the line is taken as a shell command to pipe into.
                     53: (A likely command is
                     54: .BR |lp 
                     55: for hard copy.)
                     56: .TP
                     57: .BI | " command"
                     58: Pipe the selected area to the
                     59: .I command
                     60: specified by the
                     61: .B -p
                     62: option.
                     63: .PP
                     64: .I Menudrop
                     65: may be used with
                     66: .IR blitblt
                     67: to make images containing `menus'
                     68: as fraudulent overlaid layers.
                     69: The program is menu-driven off button 3:
                     70: .nr xx \w'\f5drop menu\f1'u+2n/1n
                     71: .TP \n(xx
                     72: .B drop menu
                     73: A
                     74: .RI non- mux
                     75: menu selected in another window will be drawn 
                     76: and will remain on screen after
                     77: the button selecting the menu has been released.
                     78: Subsequent menu selections
                     79: will delete the previous menu layer and create a new one.
                     80: Once such a menu-bearing layer is present, the
                     81: .I menudrop
                     82: menu changes to allow cursor placement, highlighting of menu items, 
                     83: lifting of the displayed menu, etc.
                     84: The functionality of the program using the menu is not affected.
                     85: .TP
                     86: .B mux menus
                     87: The next click of button 1 or 2 will drop the corresponding (non-functional)
                     88: .I mux
                     89: menu at the mouse position.
                     90: .TP
                     91: .B exit
                     92: .I Menudrop
                     93: will exit in a clean manner.
                     94: .SH EXAMPLES
                     95: .TP
                     96: .L blitlblt -p lp
                     97: .br
                     98: .ns
                     99: .TP
                    100: .L
                    101: blitblt -p "lp -p bpost"
                    102: Arrange for piping output to a laser printer: a good
                    103: way, and a surefire way.
                    104: .SH SEE ALSO
                    105: .IR mbits (6),
                    106: .IR bitfile (9.5)
                    107: .SH BUGS
                    108: Animated layers result in broken images.
                    109: Use the
                    110: .B halt
                    111: function.
                    112: .br
                    113: If a pipe request fails, the
                    114: .I blitblt
                    115: layer becomes unusable.
                    116: .br
                    117: The default 
                    118: .I command
                    119: for
                    120: .L "write file"
                    121: is obsolete.
                    122: .br
                    123: Deleting a
                    124: .I menudrop
                    125: layer, rather than exiting through the menu, can crash the terminal.
                    126: .br
                    127: Programs that use private menu packages are unaffected by
                    128: .IR menudrop ;
                    129: using a debugger to stop a program in midmenu may
                    130: get the same effect.

unix.superglobalmegacorp.com

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