Provided by: kon2_0.3.9b-20ubuntu1_amd64 
NAME
KON - Kanji cONsole emulator
SYNOPSYS
kon [ video ] [ -capability value ... ]
DESCRIPTION
KON is a program to display Kanji characters on a virtual console of Linux and FreeBSD.
KON uses pty(4) to hook the I/O for console, and displays Kanji characters by drawing the image of them
on VGA or DCGA.
KON can be invoked from another KON. In this situation, new KON runs on newly opened virtual console.
OPTIONS
KON has ability to interpret some options to specify the video driver to be used, or some other
environmental conditions. video is to specify one of video driver entries written in kon.cfg. If this
option is omitted, then NORMAL video driver is used. Some settings as such as CursorInterval can be
overridden by -capability options. For example,
% kon -CursorInterval 10
invokes the kon with setting the value of CursorInterval to 10.
CONFIGURATION
kon.cfg is the file to configure the behaviour of KON. Video drivers and Palettes used by KON is
specified in this file. The format of an entry for this file is:
EntryName:[Alias1:Alias2:...]
Value_for_Entry
There are no distinction about case (upper/lower) in EntryName. Any line for "Value_for_Entry" must
start with TAB. The part from # to the end of line, is treated as comment.
Types of "Value_for_Entry" are:
boolean On / Off (no distinction about upper/lower case)
choice select one from options (no distinction about upper/lower case)
numeric Decimal Number
string Each entry has it's special format.
Following two entries are essential in this configuration file:
NORMAL(string)
specify the video driver to be used. Available options are:
VGA driver for VGA, SVGA, EGA
VGAFM same above but with ability of font deformation
J3100SX driver for TOSHIBA J3100SX (DCGA)
VGA and VGAFM require some parameters for
VGA register value, screen size(Number of dots), Width(Number of characters), Hight(Number of
lines).
Users can use this entry to change the total number of characters to be displayed, but except for VGA
resolution(640x480), the number of characters that can be seen for the specified VGA register value,
depends the video cards. Default kon.cfg set NORMAL as an alias for the standard VGA, and has some
alternate entries for some video cards.
STARTUP(string)
specify the command to be invoked at the start of KON. One line for each commands, but multiple
lines can be specified. The command to load the fonts must be specified here. When the fonts for
ASCII alphanumeric have not been loaded, then VGA font is used.
for the fonts file which is not compressed
<fontloader> <Font file for ASCII alphanumeric>
<fontloader> <Kanji/Kana font file>
for the fonts file which is compressed
zcat <compressed font fine for ASCII alphanumeric> | <fontloader>
zcat <compressed font file for Kanji/Kana> | <fontloader>
Next entry is required when VGA or VGAFM is specified as video driver:
PELS(string)
specify the Pallete. The format is the pallette value(decimal) for R,G,B in each line, and 16
lines are there total. Default kon.cfg has STDPEL and REVPEL entries. STDPEL is the standard
palette, and REVPEL is the reverse. PELS can be specified as an alias for used entry.
Other entries are:
MOUSE(choice)
specify the mouse driver. Select a type of mouse from Microsoft, MouseSystems, BusMouse, MMSeries,
Logitech, None None is default.
MouseBaud(choice)
specify the baud rate for serial mouse. Select one from 1200, 2400, 4800, 9600. Default is 1200. This
is enabled when MOUSE is specified as others than NONE or BusMousees.
MouseDev(string)
specify the device name of Mouse. Default is /dev/mouse. This is enabled when MOUSE has the entry
other than None.
Mouse3Buttons(boolean)
specify if the Mouse is 3-button type. Default is Off.
HardScroll(boolean)
specify wheter hardware scroll is used or not. Default is On. This is effective for VGA, VGAFM,
J3100SX.
BeepCounter(numeric)
specify the length of beep sound in the unit of 1/100 sec. Default is 5.
CursorInterval(numeric)
specify the interval of cursor blinking in the unit of 1/10 sec. Default is 4. To stop the blinking,
specify 0.
SaveTime(numeric)
specify the amount of time to start the screen saver in the unit of minutes. Default is 4.
KanjiCursor(boolean)
specify if wide cursor is used on Kanji characters, or ot. Default is On.
CursorTop(numeric),CursorBottom(numeric)
specify the size of cursor box using these two entries.
0 +--------+
| |
|--------| <-- CursorTop
|********|
|********|
|********|
|********|
|********|
15 +--------+ <-- CursorBottom
These are effective for VGA, VGAFM, and CGA drivers.
BoxCursor(boolean)
specify if the shape of cursor is box or under line. Default is Off. Effective for only J3100SX
driver.
SavePlane3(boolean)
specify if the font data on 3rd page in VGA memory is saved. This is useful for Trident video cards.
Default is Off. Effective for VGA, VGAFM drivers.
VgaFontOffset(numeric)
specify the offset value for VGA font. Default is 0. When the VGA fonts are used as ASCII
alphanumeric font, there are some PCs the lower parts of characters are missing. In those
circumstance, this entry can be used to adjust the position of displayed characters.
Coding(string)
specify the default font and the coding in 1bit. The formats are:
<SB font> <DB font> [EUC|SJIS]
SB font and DB font can be selected from:
SB font: Single Byte font
ISO8859-1,ISO8859-2,ISO8859-3,ISO8859-4,ISO8859-5, ISO8859-6,ISO8859-7,ISO8859-8,ISO8859-9,
JISX0201.1976-0
DB font: Double Byte font
GB2312.1980-1,JISX0208.1983-0,KSC5601,BIG5
StartupMessage(boolean)
specify if the greeting message is shown at startup. Default is On.
Configuratino for High resolution screen.
When VGA or VGAFM is used as video driver, KON can use the wider space for text area with the fine-tuing
at kon.cfg.
EntryName:
<VGA or VGAFM>
[decimation factor for VGAFM]
<HR> <HS> <HE> <HFL> <VR> <VS> <VE> <VFL>
<Clock Number>
<Line Width - 1> <Line Numbers - 1>
Control parameter in 3rd line for VGAFM (2nd line for VGA) consists of 8 decimal numbers. These numbers
are similar as the video mode lines in XF86Config. KON can emulate text upto 800x600 resolution.
Screen control parameters:
HR total dot number in horizontal
HS the start point of horizontal sync
HE the end point of horizontal sync
HFL Total number of horizontal frames
VR number of vertical lines
VS the start point of vertical sync
VE the end point of vertical sync
VFL total number of vertical frames
Clock Number selects the clock frequency for the mode of that entry. Only lowest 2 bit is effective, i.e.
a number from 0 to 3 can be specified here. The last line specifies the area for text screen to emulate.
FILES
/etc/kon.cfg Configuratin file
/usr/share/fonts/kon/* Font files
See Also
NOTE
- When text screen is in high resolution mode at
the start of Linux, KON can not work
successfully since the size of VGA font is
different from usual.
- When multiple entries with same name in kon.cfg,
the first entry is used. The maximum length of one line
is 255 bytes.
AUTHORS
MANABE Takashi <manabe@papilio.tutics.tut.ac.jp> MAEDA Atusi <mad@nak.math.keio.ac.jp> KOMEDA Shinji <komeda@ics.es.osaka-u.ac.jp> YOSHIDA Kensyu <kensyu@rabbit.is.s.u-tokyo.ac.jp> obuk@MIX