ABCDEFGHIJKLMNOPQRSTUVWXYZ

kon

KON(1)                                                                  KON(1)



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 charac-
       ters 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 spec-
       ify 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  com-
           mand  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  speci-
           fied 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 speci-
       fied here.  The last line specifies the area for text  screen  to  emu-
       late.

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



4th Berkeley Distribution         Sep 5, 1996                           KON(1)