SJXM(1) — NEWS-OS Programmer’s Manual

NAME

sjxm − Japanese input method server for X Window System

SYNOPSIS

sjxm [ −toolkitoption ... ] [ −help ] [ −server hostname ] [ −no_auto_replace ] [ −ignore_preedit_color ] [ −ignore_status_color ]

DESCRIPTION

The Japanese language input method server sjxm performs kana-kanji conversions for applications running under X Window System using data transfers between processes using sj3serv and sockets.

sjxm uses applications running under X Window System and the XLC or XIMP protocol to transfer data and converts received alphabetic or katakana input into kanji. The converted results are then returned to the applications.

When started, sjxm reads in the alphabet-kana conversion file .sjxmrk in the directory specified by the SJXMRK environment variable and follows the rules it contains when performing conversions. If this file is not present, it searches for another rule file, first $HOME/$LANG/.sjxmrk, then $HOME/.sjxmrk, and reads it in instead. If none of the above rule files is found, the defaults are used.

OPTIONS

In addition to all of the standard X Toolkit command line options, sjxm also accepts the followings.

−help Displays a description of the available options. sjxm is not activated.

−server hostname
This option specifies the hostname of the server to be connected to. If this option is omitted and no server is specified by either the environment variable SJ3SERV or in the resource file, a connection with the localhost server will be attempted. sjxm is activated even if all attempts to connect to a server are unsuccessful, but no kana-kanji conversions are possible in this case.

−no_auto_replace
When this option is specified, the input method server will not automatically estimate the next cursor position and move to it as soon as the conversion character string has been decided when “over-the-spot conversion” is being used.

−ignore_preedit_color
When this option is specified, the input method server will ignore the color of the preedit area requested by the application.

−ignore_status_color
When this option is specified, the input method server will ignore the color of the status area requested by the application.

RESOURCES

The main resources that can be set using sjxm are as follows:

server (class Server)
Specifies the hostname of the server to be connected to.

autoReplae (class AutoReplace)
If this resource is set to True, the input method server automatically estimates the next cursor position and moves to it as soon as the conversion character string has been decided when “over-the-spot conversion” is being used. The default setting is True.

ignorePreeditColor (class IgnorePreeditColor)
If this resource is set to True, the input method server automatically ignores the color of the preedit area requested by the application. The default setting is False.

ignoreStatusColor (class IgnoreStatusColor)
If this resource is set to True, the input method server automatically ignores the color of the status area requested by the application. The default setting is False.

wrapToSelect (class WrapToSelect)
Specifies the number of conversions to allow before a list of phrase candidates is displayed. The default is 3.

initialMode (class InitialMode)
Specifies the initial input mode when conversion starts. The available mode settings are as follows: ZenkakuHiragana, ZenkakuKatakana, HankakuKatakana, ZenkakuAlpha, HankakuAlpha, SJIS, EUC, JIS and KUTEN. The default is ZenkakuHiragana.

defaultCode (class DefaultCode)
Specifies the initial input code in code input status. The available code settings are as follows: SJIS, EUC, JIS and KUTEN. The default is SJIS.

SelectDialog∗visibleItemCount (class VisibleItemCount)
Specifies the number of conversion candidates for over-the-spot conversion. The default is 5.

sjxm (class Sjxm)

hankakuAlpha (class HankakuAlpha)

zenkakuAlpha (class ZenkakuAlpha)

hankakuKatakana (class HankakuKatakana)

zenkakuKatakana (class ZenkakuKatakana)

zenkakuHiragana (class ZenkakuHiragana)

shiftJis (class ShiftJis)

euc (class Euc)

jis (class Jis)

kuten (class Kuten)
These resources specify status display character strings.

F1.labelString (class LabelString)

F2.labelString (class LabelString)

F3.labelString (class LabelString)

F4.labelString (class LabelString)

F5.labelString (class LabelString)

F6.labelString (class LabelString)

F7.labelString (class LabelString)

F8.labelString (class LabelString)

F9.labelString (class LabelString)

F10.labelString (class LabelString)
These resources specify function key display character strings.

processStartKeys (class ProcessStartKeys)
Specifies the conversion processing start keys. More than one conversion processing start key may be specified, but the first one specified will be employed if the XLC protocol is in use. For example, if the start key specification is Ctrl+\, Ctrl<Key>backslash will be used as the start key combination. The syntax for process start key assignments is as follows.

processStartKeys= event{"\n"event}

event= [modifier_list]"<Key>"detail

modifier_list= {["!"]modifier}|"None"

detail= <event specific details>

• If no modifier_list is specified, pressing modifier has no effect. • If a modifier list is preceded by an exclamation mark (!), detail is valid only when that modifier list is pressed. • If more than one modifier is specified and there are no exclamation mark designations, detail is valid when any of the specified modifier keys is pressed. Pressing unspecified modifier keys has no effect. • If a modifier is designated with a tilde (~), the detail is valid when that modifier is not being pressed. • The specification "None" means that no modifier is pressed.

KEY BINDINGS

Key bindings for sjxm are specified by the translations contained in resource files. The actions that can be specified in the sjxm translation table are as follows.

Action

Function

add-term

Add term to user dictionarycode-input & Input code code-select & Input code from table conversion & Kana-kanji conversion decide & Decide delete & Delete the character preceding the cursor delete-term & Delete term recorded in user dictionary divided-delete & Divide character preceding the cursor into Roman letters and delete down & Move cursor to next line edit & Reedit conversion character string phrase em-alphanumeric & Change to full-width alphanumeric characters em-hiragana & Change to full-width hiragana characters em-katakana & Change to full-width katakana characters en-alphanumeric & Change to half-width alphanumeric characters en-katakana & Change to half-width katakana characters end & Move cursor to end of character string expand & Expand length of conversion character string next & Move cursor to next character no-conversion & Change to no-conversion status previous & Move cursor to previous character reconnect & sj3serv change reconversion & Reconvert reduce & Reduce length of conversion character string scroll-down & Display next group of character candidates scroll-up & Display previous group of character candidates through & Pass characters to application toggle & Hiragana → full-width katakana → half-width katakana →
& full-width alphanumeric → half-width alphanumeric → hiragana → ... top & Move cursor to top of character string up & Move cursor to previous line wrap-back & Return to previous candidate

By specifying arguments for actions, the triggering of actions when specific sjxm internal conditions are valid can be limited. sjxm has 11 internal conditions.

Condition

Meaning

INIT

After conversion processing is activated and before kana input has been receivedCONVERSION & Kana-kanji conversion CODE & Code is input from a table WRAP & Table of next conversion candidates is displayed at the phrase display position SELECT & Table of conversion candidates is displayed ADD & Word added to user dictionary DELETE & Word deleted from user dictionary EDIT & Reediting of phrase SERVER & Setting of sj3serv hostname ERROR & Error display

If no arguments are specified for an action, it will be considered valid no matter what the internal condition. The relationships between actions and internal conditions are illustrated in the table below. Internal conditions are identified by the first three letters of their names. In cases where nothing is indicated, settings are ignored even if they are made. Items shown in the table in the format (INTERNAL CONDITION) indicate that when the action in question is called, the sjxm internal condition changes to the condition shown within parentheses. Items shown in the table in the format [INTERNAL CONDITION] indicate that in some cases the change in condition can result in (∗1) conversion end status or (∗2) a return to the preceding condition.

	Internal condition
Action	INI	INT	CON	WRA	SEL	ADD	DEL	EDI	COD	SER
add-term			(ADD)	(ADD)						code-input &○ &○ & & & & & &○ & & code-select &(COD)&(COD)& & & & & &(COD)& & conversion &(CON)&(WRA)&[SEL]&○ & & & &(CON)& & decide &(INI)&(INI)&(INI)&(CON)&(CON)&(CON)&(CON)&○ & & delete &[INI]& & & & &○ &○ &○ &○ &○ delete-term & & &(DEL)&(DEL)& divided-delete & &[INI]& & & &○ &○ &○ &○ & down & & & & &○ & & & &○ & edit & & &(EDI)&(EDI)& & & & & & em-alphanumeric &○ &○ &○ &(CON)& & & &○ & & em-hiragana &○ &○ &○ &(CON)& & & &○ & & em-katakana &○ &○ &○ &(CON)& & & &○ & & en-alphanumeric &○ &○ &○ &(CON)& & & &○ & & en-katakana &○ &○ &○ &(CON)& & & &○ & & end & &○ &○ &○ &○ &○ &○ &○ &○ &○ expand & & &○ &(CON)& &○ &○ & & & next & &○ &○ &○ &○ &○ &○ &○ &○ &○ no-conversion & & &○ &(CON)& & & & & & previous & &○ &○ &○ &○ &○ &○ &○ &○ &○ reconnect &(SER)&(SER)&(SER)& & & & & & & reconversion &(INT)&○ & & & & & & & & reduce & & &○ &(CON)& &○ &○ & & & scroll-down & & & & &○ & & & &○ & scroll-up & & & & &○ & & & &○ & through &○ & & & & & & & & & toggle &○ &○ &○ &(CON)& & & &○ & & top & &○ &○ &○ &○ &○ &○ &○ &○ &○ up & & & & &○ & & & &○ & wrap-back & & &○ &○ & & & & & &

ENVIRONMENT VARIABLES

SJ3SERV Contains the hostname of the server to be connected to.

SJXMRK Contains the name of the directory containing the alphabet-kana conversion rule definition file.

FILES

/usr/sony/dict/sj3/user/$USER/private.dic
Kana-kanji conversion user dictionary

/usr/sony/dict/sj3/user/$USER/study.dat
Kana-kanji conversion study file

/usr/lib/X11/sjxm/sjxmrk
Default alphabet-kana conversion rule definition file

$HOME/.sjxmrk

$HOME/$LANG/.sjxmrk

$SJXMRK/.sjxmrk
User-defined alphabet-kana conversion rule definition files

/usr/lib/X11/ja_JP.SJIS/app-defaults/Sjxm

/usr/lib/X11/ja_JP.EUC/app-defaults/Sjxm
Resource files

COPYRIGHT

NEWS-OSRelease 4.2.1R

Museum

Related Articles