GCIN(1)

NAME
gcin, gcin-setup - an input method server

SYNOPSIS
gcin [-h|-v|--version]
gcin-setup

DESCRIPTION
gcin is an input method(IM) server, which focused mainly on Traditional Chinese. It is also very useful for Simplified Chinese, Japanese, and many other languages. IM table format of gcin is almost as same as those of scim and xcin. Users may append their IMs to gcin very easily. The "g" of gcin means that it features a better GTK+2 user interface.

gcin-setup is gcin's setting tool. However, its interface is Traditional Chinese only. Another configure method is writing conffiles in $HOME/.gcin/config. See the CONFFILES section below.

OPTIONS

-h, -v, --version
    Show version of gcin and exit. gcin-setup has no those options.

FILES

/usr/share/gcin/table/gtab.list
    Input methods available for gcin. You may copy it to $HOME/.gcin/ and edit it as you like. If you have no $HOME/.gcin/gtab.list, /usr/share/gcin/table/gtab.list will be used.

/usr/share/gcin/script/utf8-edit
    A file helps gcin finding text editors when needed. You may add any UTF-8 compatible text editor you like into it.

ENVIRONMENT VARIABLES

LC_CTYPE
    For bash: export LC_CTYPE=zh_TW.UTF-8
    For csh: setenv LC_CTYPE zh_TW.Big5

XMODIFIERS
    For bash: export XMODIFIERS=@im=gcin
    For csh: setenv XMODIFIERS @im=gcin

GTK_IM_MODULE
    For bash: export GTK_IM_MODULE=gcin
    For csh: setenv GTK_IM_MODULE gcin

QT_IM_MODULE
    For bash: export QT_IM_MODULE=gcin
    For csh: setenv QT_IM_MODULE gcin

GCIN_CONNECT_MSG_ON
    Display messages for socket connections.

GCIN_DBG_TMP
    Display additional debug messages.

GCIN_DUAL_XIM_OFF
    Disable dual XIM server feature.

GCIN_ERR_COREDUMP
    Option for debugging.

GCIN_IM_CLIENT_NO_AUTO_EXEC
    Disable gcin protocol's auto-evoked feature.

GCIN_TABLE_DIR
    Assign IM tables' directory other then /usr/share/gcin/table.

GCIN_XIM
    Assign gcin XIM server's XIM name.

CONFFILES
If you can read Traditional Chinese, use gcin-setup and skip this secion.

If you really want to write conffiles by hand, you may execute those commands:

mkdir -p $HOME/.gcin/config
echo zo > $HOME/.gcin/config/phonetic-keyboard

Thus you make a phonetic-keyboard file with content zo, which means you select standard style with 1234 selection method.

Available conffiles are listed below, and default options are showed bold.

If you use gcin-setup, those directories and files will be created automatically. You may not want to do it all by yourself.

$HOME/.gcin/config/phonetic-keyboard string
    Key codes arrangement style within Bopomofo and Tsin intelligent input method(Tsin IM).

OPTIONS MEANINGS
zo Standard style with 1234 selection method
zo-asdf Standard style with asdf selection method
et Eten style with 1234 selection method
et-asdf Eten style with asdf selection method
et26 Eten 26 keys style with 1234 selection method
et26-asdf Eten 26 keys style with asdf selection method
hsu Mr. Hsu's style (Kuo-Yin IM, Natural Bopomofo IM)
ibm IBM's style

$HOME/.gcin/config/tsin-chinese-english-toggle_key number
    Toggle key for Chinese/English Mode within Tsin IM.

OPTIONS MEANINGS
1 Caps Lock key
2 Tab key
4 Shift key(Not available under XIM mode).

$HOME/.gcin/config/tsin-space-opt number
    Function of Space key within Tsin IM.

OPTIONS MEANINGS
1 Select other same phonetic characters.
2 Send contents of editing area to application.

$HOME/.gcin/config/tsin-phrase-pre-select boolean
    Show phrase pre-selection window within Tsin IM.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/phonetic-char-dynamic-sequence boolean
    Dynamic character sequence adjustment within Bopomofo and Tsin IM.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/pho-simple-window boolean
    Smaller window for Bopomofo and Tsin IM.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/pho-hide-row2 boolean
    Hide second row of Bopomofo and Tsin IMs' window.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/pho-in-row1 boolean
    Show key codes in first row of Bopomofo IM's window.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/phonetic-huge-tab boolean
    Use pho-huge.tab to input all of Traditional Chinese, Simplified Chinese, and Japanese Hanzi within Bopomofo and Tsin IM.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/tsin-tone-char-input boolean
    Input Bopomofo's tone sympols in Tsin IM.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/tsin-tab-phrase-end boolean
    Use Tab key to stop Tsin IM's phrase-auto-selection.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/tsin-buffer-size number
    Buffer size of editing area of Tsin IM. Default is 40.

$HOME/.gcin/config/tsin-phrase-line-color hex
    Color of phrase-underline within Tsin IM. Default is blue, #0000FF.

$HOME/.gcin/config/tsin-cursor-color hex
    Color of Tsin IM's cursor.

OPTIONS MEANINGS
#FF0000 Red
#00FF00 Green
#0000FF Blue
#FFFF00 Yellow
#FF00FF Magenta
#00FFFF Cyan

$HOME/.gcin/config/gcin-font-size number
    Font size of character-selection area. Default is 16.

$HOME/.gcin/config/gcin-font-size-symbol number
    Font size of symbol-selection window. Default is 12.

$HOME/.gcin/config/gcin-font-size-tsin-presel number
    Font size of phrase pre-selection window within Tsin IM. Default is 16.

$HOME/.gcin/config/gcin-font-size-tsin-pho-in number
    Font size of phonetic input area of Bopomofo and Tsin IM. Default is 10.

$HOME/.gcin/config/gcin-font-size-pho-near number
    Font size of Tsin IM's alike-phonetic character-selection area. Default is 14.

$HOME/.gcin/config/gcin-font-size-gtab-in number
    Font size of key codes input area of gtab IMs(Chanjei IM, Array IM, etc.). Default is 10.

$HOME/.gcin/config/gcin-font-name string
    Font used under gcin.

OPTIONS MEANINGS
sans Sans-serif
serif Serif

$HOME/.gcin/config/gcin-pop-up-win boolean
    Pop up window on the right lower corner of screen.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gcin-pop-up-win-abs-corner boolean
    Keep pop up window on the right lower corner of screen absolutely.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gcin-input-style boolean
    Window style of gcin.

OPTIONS MEANINGS
1 OverTheSpot
2 Root (Fixed index window)

$HOME/.gcin/config/gcin-root-x number
    Window place in X axis when window style is Root (Fixed index window). Default is 1600.

$HOME/.gcin/config/gcin-root-y number
    Window place in Y axis when window style is Root (Fixed index window). Default is 1200.

$HOME/.gcin/config/gcin-inner-frame boolean
    Show inner frame border of gcin window. If you want to apply some GTK's themes, you may want to toggle it on for better outlook.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gcin-status-tray boolean
    Show gcin's status in system tray.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gtab-dup-select-bell boolean
    Bell ring when multiple selections are available within gtab IMs.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gtab-space-auto-first number
    Function of Space Key within gtab IMs.

OPTIONS MEANINGS
0 Auto-selected by .gtab file's definition.
1 Send first character within Liu's IM(Boshiamy IM).
2 Send first character within character-selection area.
4 Does not send first character. (For Array IM)

$HOME/.gcin/config/gtab-auto-select-by_phrase boolean
    Auto-selection by Tsin phrase database within gtab IMs.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gtab-pre-select boolean
    Show auto-selection suggest from Tsin phrase database within gtab IMs.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gtab-press-full-auto-send boolean
    Auto-send character when key codes input area is full. For gtab IMs.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gtab-disp-partial-match boolean
    Display partial matched characters within gtab IMs.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gtab-simple-win boolean
    Smaller window for gtab IMs.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gtab-disp-key-codes boolean
    Show all possible key codes of character within gtab IMs.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gtab-disp-im-name boolean
    Display input method name within gtab IMs.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gtab-invalid-key-in boolean
    Clear key codes input area when invalid key and Space key are pressed.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gtab-shift-phrase-key boolean
    Use Shift single key to input Alt-Shift phrases within gtab IMs.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gtab-hide-row2 boolean
    Hide second row of gtab IMs' window.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gtab-in-row1 boolean
    Show key codes in first row of gtab IMs' window.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gtab-capslock-in-eng boolean
    Input English/Numbers/Symbols directly when Caps Lock key is ON (Within gtab IMs).

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/default-input-method number
    Default IM when gcin is called.

OPTIONS MEANINGS
0 Internal character code IM
1 Chanjei IM version 3
2 Chanjei IM version 5
3 Bopomofo IM
4 Chanjei IM version 3, easy symbols
5 Pinyin IM
6 Tsin IM
7 Dayi IM
8 Array IM, 30 keys version
9 Liu's IM(Boshiamy IM)
10 Simple Chanjei IM
11 Japanese Kana and Kanji IM
12 Greek letters IM

$HOME/.gcin/config/gcin-flags-im-enabled number
    Available IMs to be cyclic selected by Control-Shift.

OPTIONS MEANINGS
2147483647 All IMs are enable.
2147475456 All IMs are disabled.

         1 Ctrl-Alt-0 Internal character code IM
         2 Ctrl-Alt-1 Chanjei IM version 3
         4 Ctrl-Alt-2 Chanjei IM version 5
         8 Ctrl-Alt-3 Bopomofo IM is available
        16 Ctrl-Alt-4 Chanjei IM version 3, easy symbols
        32 Ctrl-Alt-5 Pinyin IM
        64 Ctrl-Alt-6 Tsin IM
       128 Ctrl-Alt-7 Dayi IM
       256 Ctrl-Alt-8 Array IM, 30 keys version
       512 Ctrl-Alt-9 Liu's IM(Boshiamy IM)
      1024 Ctrl-Alt-- Simple Chanjei IM
      2048 Ctrl-Alt-= Japanese Kana and Kanji IM
      4096 Ctrl-Alt-` Greek letters IM

2147475456 add number of IMs, then you get your own setup number. For example, you want only Bopomofo, Tsin, and Array IM. So you calculate 2147475456 + 8 + 64 + 256 = 2147475784.

echo 2147475784 > $HOME/.gcin/config/gcin-flags-im-enabled

Then you get it.

$HOME/.gcin/config/gcin-im-toggle-keys number
    Toggle Key for IM window ON/OFF.

OPTIONS MEANINGS
0 Control-Space
1 Shift-Space
2 Alt-Space
3 Windows-Space

$HOME/.gcin/config/gcin-remote-client boolean
    Remote application client support(using port 9999-). If you want to use gcin under su or sudo environment, you should toggle this option ON.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/gcin-shift-space-eng-full boolean
    Toggle into double-wide English character mode with Shift-Space.

OPTIONS MEANINGS
1 ON
0 OFF

$HOME/.gcin/config/left-right-button-tips boolean
    Show button tips when mouse cursor stays on gcin window. Default is ON, but it will be set into OFF after gcin-setup is executed once.

OPTIONS MEANINGS
1 ON
0 OFF

SEE ALSO
gcin2tab(1), phoa2d(1), phod2a(1), tsa2d32(1), tsd2a32(1), sim2trad(1), trad2sim(1), tslearn(1), juyin-learn(1), gcin-gb-toggle(1)

AUTHORS

Edward Der-Hua Liu <cp76@csie.nctu.edu.tw>
    Wrote gcin and associated tools.

Friend of Chanjei IM, Malaysia <www.chinesecj.com>
    Author of original Chanjei IM version 5 table.

Dayi Co., Ltd. <http://www.dayi.com>
    Author of Dayi IM.