1 .\" Copyright (c) 1992, 2000 Hellmuth Michaelis
2 .\" Copyright (c) 1992, 1994 Joerg Wunsch
4 .\" All rights reserved.
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
16 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18 .\" IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
19 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 .\" Last Edit-Date: [Mon Mar 27 17:17:50 2000]
28 .\" $FreeBSD: src/usr.sbin/pcvt/scon/scon.1,v 1.8.2.5 2001/12/14 16:48:11 ru Exp $
29 .\" $DragonFly: src/usr.sbin/pcvt/scon/Attic/scon.1,v 1.2 2003/06/17 04:29:59 dillon Exp $
36 .Nd controls screen modes for pcvt video driver
53 .Fl p Ar entry,red,green,blue
71 utility controls several aspects of the runtime behaviour of the pcvt vt220
74 The options are as follows:
77 Returns a string describing the video adaptor found by pcvt, the string
78 returned could be MDA, HGC, CGA, EGA, VGA or UNKNOWN.
80 Specify the screen number the current (displayed) screen should be switched
83 Specify the device filename (i.e. /dev/ttyv2) further operations specified on
84 the command line should be applied to.
86 Some programs which silently assume 24 lines when they run on a VT220 show
87 incorrect behaviour when the terminal has really 25 lines.
89 VT220 behaviour, it is possible to force pcvt to select only 24 lines when
90 it is running in 25-lines pure VT mode and/or in 28-lines HP-mode.
93 option requires one additional parameter, the string 'on' or 'off' to switch
94 this mode for a virtual screen on or off respectively.
95 This mode has no effect
96 if any other vertical resolutions are selected than the two above mentioned.
98 Prints a usage/help text.
100 Lists the current configuration of runtime changeable options and fixed
101 parameters (such as the type of the adaptor, and in case of a VGA adaptor,
102 the Manufacturer, Chipset and 132 column support) of the output portion
105 Returns a string describing the connected display monitor type found by pcvt,
106 the string returned can be MONO, COLOR or UNKNOWN.
108 Specify verbose operation of the program.
110 Switch the specified/current screen into a pure VT220 mode without recognizing
111 any HP escape sequences and without displaying function key labels.
113 Switch the specified/current screen into a mixed HP/VT220 mode.
115 in addition to the full VT220 emulation, the HP function key labels and the
116 escape sequences for handling the labels are available to the user.
118 Specify the number of character lines on the screen.
119 Possible parameters are
120 25, 28, 35, 40, 43 or 50. To use all this screen sizes, the fonts required
121 for proper operation of a desired size have to be downloaded to the EGA/VGA
123 This option is available only for EGA and VGA boards.
129 is mutually exclusive with
136 is available only for VGA boards.
137 Three flavors are available.
139 If used with argument
141 this flag will restore the default palette
142 (as installed by VGA ROM BIOS after hardware reset).
144 If used with argument
146 the current VGA DAC palette entries are listed.
148 the table index, values for red, green, and blue, and if there's a
149 known name for this entry, the color name.
151 slots (RGB values all zero) are omitted.
153 Otherwise, four comma-separated arguments are expected.
155 denotes the number of palette entry to be modified.
157 a number between 0 and 255, or the usual name of an associated color
159 The following values for red, green and blue are restricted to 0 through 63
160 due to VGA DAC conventions.
161 Note that the first delimiter within such an argument may be a colon
165 for better readability, but this violates common command argument
169 options may be specified if unambiguous.
173 will activate the screen saver.
174 The behaviour depends on
178 is given as 0, the screen saver is turned off.
181 is taken as a number of seconds to wait until activating the
185 option is only available if screen saver support has been compiled into
188 Sets 132 columns mode
189 (only available on VGA adaptors).
191 Sets 80 columns mode.
194 When switching between HP and VT mode, when switching the force 24 lines
195 mode on and off, or when switching between 80 and 132 columns operation,
196 the screen is cleared, the scrolling
197 region is reset and the cursor is placed in the home position.
200 .Dq Li scon Fl H s Ar 28
201 places the current screen into HP mode and sets the screen size to 28x80.
210 will result in green on gray output for normal text.
211 Note that normal text color is light gray, and not white as one might expect.
217 options collide somehow, this will change in a future release.