输入法的主导模块以动态连接库(libimpi.a)的形式存在，和各输入法模块连接成单独的可执行文件。模块层次如下图：
对于每一个具体的输入法，只需要按照一定的数据结构就可以链接成为新的可执行文件，并且添加到炎黄中文平台上。这些数据结构包括外部变量和外部函数。
1、外部变量
数组extcode[]：字符串类型，表示输入的外码串；
数组candstr[]：字符串类型，表示重码的待选串；
数组result[]：字符串类型，表示得到的结果串；
数组imname[]：字符串类型，表示输入法的名称；
数组imdscrpt[]：字符串类型，表示对输入法的描述。
变量maxeclen：整型，表示外码的最大长度；
变量eclen：整型，表示外码的长度。
这些变量的定义如下所示：
引用:extern int maxeclen; /* The maximum length of external code */
extern int eclen; /* The length of external code */
extern char extcode[]; /* External code */
extern char candstr[]; /* Candinate string */
extern char result[]; /* Result string */
2、外部函数
外部函数一共有四个，它们分别是IMInit（）、IMCleanup（）、IMSelect（）和IMFilter（）。这四个函数的定义分别如下所示：
引用:int IMInit();
int IMClearup();
int IMSelect(int select);
int IMFilter(int ch);
其中IMInit（）函数用来完成输入法的初始化工作；IMClearup（）函数用来对输入法被释放时的情况进行处理； IMSelect（）函数用来处理当前输入法被选中的情况；IMFilter（）是输入法的核心函数，用来对接收的字符串进行过滤，得到正确的输入结果。
下面以区位输入法为例对此进行简单的介绍：
准备工作
首先需要取得libimpi.a文件，然后可以创建一个qvwei目录。
代码编写
编译一个qvwei.c文件，接着对输入法进行初始化，这时候的qvwei.c如下所示。
引用:/* The qvwei input method
*/
#include
#include
#include
#include
#include "impi.h"
char imname[] = "区位";
char imdscrpt[] = "区位输入法";
static void reset();
static void append(int ch);
static void comp_appe(int prevch, int ch);
int IMInit()
{
return 0;
}
int IMClearup()
{
return 0;
}
int IMSelect(select)
int select;
{
return 0;
}
int IMFilter(ch)
int ch;
{
}
接下来的工作就是编写IMInit（）、IMClearup（）、IMSelect（）和IMFilter（）这四个函数了。
在IMInit（）函数中添加如下的代码：
引用:maxeclen = 5;
reset();
return 0;
由于区位输入法比较简单，IMClearup（）和IMSelect（）函数都不需要额外添加代码，在IMFilter（）这个函数中加入如下的处理代码：
引用:candstr[0] = '\0';
result[0] = '\0';
/* process currnet keystroke */
if (isdigit(ch))
{
if ((eclen == 1) || (eclen == 3))
comp_appe(extcode[eclen - 1], ch);
else
append(ch);
if (eclen == 4)
{
int qv, wei;
qv = (extcode[0] - '0') * 10 + (extcode[1] - '0');
wei = (extcode[2] - '0') * 10 + (extcode[3] - '0');
reset();
result[0] = qv + 0xa0;
result[1] = wei + 0xa0;
result[2] = '\0';
}
}
else
{
if ((ch == KEY_BACKSPACE) && (eclen > 0))
extcode[--eclen] = '\0';
else
{
result[0] = ch;
result[1] = '\0';
}
}
/* generate candinates */
if ((eclen > 0) && (eclen < 4))
{
int qv, wei, i, w;
char buf[3];
char *p;
if (eclen > 1)
qv = (extcode[0] - '0') * 10 + (extcode[1] - '0');
else if (extcode[0] == '0')
qv = 1;
else
qv = (extcode[0] - '0') * 10;
wei = (eclen < 3) ? 0 : (extcode[2] - '0') * 10;
p = candstr;
for (i = 0; i <= 9; i++)
{
w = wei + i;
if ((w > 0) && (w <= 94))
{
buf[0] = qv + 0xa0;
buf[1] = wei + i + 0xa0;
buf[2] = '\0';
p += sprintf(p, " %d: %s", i, buf);
}
}
}
return 0;
上面的代码中用到了另外三个函数，这三个函数可以定义为局部函数，它们的实现代码如下所示：
引用:static void reset(void)
{
eclen = 0;
extcode[0] = '\0';
candstr[0] = '\0';
result[0] = '\0';
}
static void append(ch)
int ch;
{
extcode[eclen++] = ch;
extcode[eclen] = '\0';
}
static void comp_appe(prevch, ch)
int prevch;
int ch;
{
if (prevch == '0')
{
if (ch != '0')
append(ch);
}
else if (prevch == '9')
{
if (ch <= '4')
append(ch);
}
else
append(ch);
}
把上面的代码拼接起来，就是一个完整的qvwei.c文件。
编译和链接
最后可以编写一个MakeFile来创建可执行的输入法文件。一个Makefile的例子如下所示：
引用:qvwei:
cc -c qvwei.c
cc -o $@ qvwei.o libimpi.a
strip $@
rm -f *.o
然后只需要在这个目录下键入make，就可以创建一个可执行的qvwei文件。在运行炎黄中文平台之后运行这个qvwei文件，就可以把这个输入法添加到炎黄中文平台中，平台会自动给这个输入法分配切换快捷键。
注意事项：
1：随同打包的还有四个文件，它们分别是impi.c、impi.h、incommon.c和imcommon.h，它们的作用是用来生成 libimpi.a。提供这四个函数源代码的用意是方便用户对输入法的理解。但是绝对不要改变这四个文件并且重新编译libimi.a，否则炎黄中文平台有可能无法识别新生成的输入法。
2：以上只是一个简单的示例，针对不同的输入法类型，输入法的核心代码可能要复杂得多。
oracle_java 于 2006-08-29 21:00:56发表:
ding!