|
|
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.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.