kon - Online in the Cloud

PROGRAM:

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.

Use kon online using onworks.net services