紫光拼音输入法3.0 for Linux 引擎与用户端界面软件开发说明

bbefadmin

紫光拼音输入法3.0 for Linux
引擎与用户端界面软件开发说明

last updated 2002-8-26， Copyright (c) Thunisoft Co. Ltd.
===============================================================================

引擎
---------

输入法引擎实现按键信息到拼音汉字搜索功能。在对按键信息的处理过程中，
输入法引擎自己维护拼音串与候选字词，并在键入返回键(空格)的时候，获得
最终的输入结果串。

引擎程序：upimd
使用：
        Usage: upimd [options]
        Options:
          -start             : startup engine daemon
          -start [directory] : startup engine daemon, specify config/wordlib path
          -start -logmsg     : startup engine daemon, log engine message
          -stop              : stop engine daemon
          -version           : show version information
          -? or -help        : show this usage help

使用命令行“upimd start|stop”启动、停止输入法引擎。

引擎使用的默认配置文件、用户词库与数据文件目录为“/usr/local/unispim/”。


相关文件
----------

upimd                        引擎主程序
unispim.conf        输入法配置信息文件
chnsym.ini                中文符号定义文件
spewords.ini        特殊字词与短语定义文件
unispimsp.ini        双拼编码定义文件
unispimsp.ksc        双拼编码定义二进制文件，根据unispimsp.ini生成
                                如果修改了unispimsp.ini，可删除该文件，下次引擎启动时自动生成
syswl.dat                系统词库文件
usrwl.dat                用户词库文件，可重新从syswl.dat复制一份初始的
bcoc.dat                智能组词数据文件
hzfreq.dat                单字字频信息文件
hzcache.dat                单字缓存信息文件，第一次使用时生成


用户端界面软件开发
--------------------

用户端界面软件调用API接口：
头文件：upimagent.h - 函数原型与函数说明，常量定义
库文件：upimagent.o

示例文件：
upimdemo.cpp

示例文件运行：
启动引擎：upimd start
运行示例文件：upimdemo，按Ctrl-C退出
停止引擎：upimd stop

主要API说明：
upimSelect                输入法开关函数，用户端软件首先需要调用此函数连接引擎
upimSetContext        重置输入法上下文，第一次调用upimSelect(TRUE)时不需要调用此函数
upimOnKey                发送按键信息给输入法引擎
upimicGetProperty/upimicSetProperty        输入法上下文属性读取/设置
upimicInputString        取得输入法返回串
upimicCompString        取得输入拼音串(Compose)
upimicCandString        取得候选字词串(Candidate)

其它：
用户端界面的库中(upimagent)，使用消息队列与输入法引擎进行通信，如有必要，
增加系统的消息队列最大数限制(MSGMNI)。


输入法设置文件说明
--------------------
主要设置文件：unispim.conf
用户端界面程序通过读写unispim.conf读取/设置输入法相关属性。
如果在打开状态下设置了新的属性，则应该调用upimSetContext通知引擎重新读入设置。

设置说明：
#默认情况下，1表示TRUE，0表示FALSE
输入风格=0或者1，0为输入拼音串后按空格，1为即敲即现
用字母键选择候选字词=0或者1
使用双拼输入=0或者1
双拼输入时显示提示信息=0或者1
动态调整词频=0或者1
自动隐藏低频词=0或者1
动态调整字频=0或者1
最近输入字优先=0或者1
每页最多候选个数=3-9,缺省为5
中英文输入切换键=0或者1，0使用Shift，1使用Ctrl
回车键定义=0或者1，0为输入结果串，1为输入英文串
多个候选翻页键=0、1、2，0使用(,)和(.)，1使用(-)和(+)，2使用([)和(])
输入第二第三候选字词键=0或者1，0使用左右Shift，1使用左右Ctrl
以词定字选字键=0、1、2，0使用(,)和(.)，1使用(-)和(+)，2使用([)和(])
支持GBK大字符集=0或者1
输入简体汉字=0或者1，1为输入简体，0为输入繁体
智能组词=0或者1
智能组词自动记忆=0或者1
按前次输入动态调整字序=0或者1
数字后跟随英文符号=0或者1
记忆并可输入最近输入过的字词=0或者1
中文符号=0或者1
打开时默认为英文输入状态=0或者1
v状态可输入空格=0或者1，如果设置为1，v状态用回车键输入整个串
声母模糊音设置=x，x为以下的或组合，例如7表示设置了z=zh,c=ch,s=sh
        0x01        z=zh
        0x02        c=ch
        0x04        s=sh
        0x08        l=n
        0x10        k=g
        0x20        f=h
韵母模糊音设置=x，x为以下的或组合
        0x01        an=ang
        0x02        en=eng
        0x04        in=ing
        0x08        ian=iang
        0x10        uan=uang


#以下为兼容Windows的相关设置
光标跟随=0或者1
软键盘索引=0
软键盘开关键=a-z，表示Ctrl+Shift+开关键

小弓虽

哪里有得下，这个比较重要，呵呵！