Google
 

Poky环境的中文输入法实验二(XIM版本)

1 GTK输入法回顾

在GTK中,每个GtkEntry对象里都有一个指向输入法上下文对象的指针(GtkIMContext *)。 在初始化时,这个指针指向一个GtkIMMulticontext对象。

  entry->im_context = gtk_im_multicontext_new ();

在gtk_entry_set_visibility函数中,先解引用当前对象,然后根据visible属性,决定要创建的输入法上下文对象类型:

      if (visible)
        entry->im_context = gtk_im_multicontext_new ();
      else
        entry->im_context = gtk_im_context_simple_new ();

当visible为真时创建GtkIMMulticontext对象,当visible为假时创建GtkIMContextSimple对象。 GtkIMMulticontext和GtkIMContextSimple都是GtkIMContext的派生类。 GtkIMContextSimple实现了一个简单的表映射,不能动态加载输入法模块。GtkIMMulticontext可以动态加载输入法模块。

在实验一中我们实现了一个派生自GtkIMContext的输入法模块。GtkEntry通过GtkIMMulticontext对象加载了我们的输入法模块。 这个输入法模块与输入法服务器通信,使用GtkIMContext接口实现了中文输入。

如果一个编辑框不是GtkEntry对象,显然就不会加载GTK输入法模块,这时基于GTK版本的输入法就无法使用。 例如在poky的浏览器中,网页上的编辑框就不是基于GtkEntry的,无法使用GTK版本的输入法。

2 基于XIM的输入法

XIM(X Input Method)是X Window的输入法协议。如果系统的GUI方案是GTK+X,那么基于XIM的输入法就有更好的兼容性。 所谓“更好”也是相对的,如果系统的GUI方案是GTK+DirectFB,自然就用不着XIM。

XIM规定了输入法服务器和XIM客户程序的通信规程。只要通信双方都遵守规程,输入法就能正常运作。 有一个叫IMdkit的程序库可以简化服务器的开发。基于XIM的输入法通常都会使用这个开发于1994年的程序库。

GTK里面有一个叫imxim的输入法模块。这个模块在GtkIMContext接口的基础上实现XIM客户程序。 即它实现了GTK IM和XIM之间的接口转换。只要加载了这个模块,基于GtkEntry的编辑框也可以使用基于XIM的输入法。 imxim也是一个不错的XIM客户程序实例。

2.1 XIM运作机制

和基于gtk的输入法一样,要实现输入法总是要从编辑器里截获按键事件传递给服务器,服务器组字后把输入文本再送回编辑器。 在gtk输入法中,gtk im模块是客户,客户与服务器的通信协议是我们自己定义的。 在XIM中,客户和服务器的协议是XIM规范规定的。

上图来自谢东翰先生的《Xi18n 程式设计简介》。图中的序号标示出中文输入的典型步骤:

  1. 在基于X的系统中,键盘和显示都是X Server控制的。X Server检测到按键。
  2. X Server向客户窗口发送按键事件。
  3. 客户程序在X事件循环里用XFilterEvent函数过滤XIM服务器需要的事件。例如:
    	for (;;) {
    		XNextEvent (dpy, &event);
    		if (XFilterEvent (&event, None) == True) {
    			continue;
    		}
    		//处理X事件
    		......
    	}
    
  4. 如果Xlib找到了locale匹配的XIM服务器,而且服务器是激活的,XFilterEvent就会把相关事件交给XIM服务器。 如果用了IMdkit库,服务器就会收到XIM_FORWARD_EVENT等XIM呼叫。
  5. 用户在服务器的输入窗口完成组字,服务器调用IMdkit库的IMCommitString函数将输入文本送回客户程序。 服务器只处理自己需要的按键,其它按键可以用IMForwardEvent函数送回客户程序。

2.2 实现XIM输入法

在IMdkit库的帮助下,在服务器侧实现XIM接口还是比较简单的。用IMOpenIM创建XIM服务,登记回调函数(例如MyProtoHandler)。 当服务器接收到XIM呼叫时,回调函数会被调用。下面是典型的回调函数:

static Bool MyProtoHandler (XIMS ims, IMProtocol * call_data)
{
	switch (call_data->major_code) {
	case XIM_OPEN:
		return MyOpenHandler ((IMOpenStruct *) call_data);
	case XIM_CLOSE:
		return MyCloseHandler ((IMOpenStruct *) call_data);
		break;
	case XIM_FORWARD_EVENT:
		ProcessKey (ims, (IMForwardEventStruct *) call_data);
		return True;

	// IC管理
	case XIM_CREATE_IC:
		return MyCreateICHandler ((IMChangeICStruct *) call_data);
	case XIM_DESTROY_IC:
		return MyDestroyICHandler ((IMChangeICStruct *) call_data);
	case XIM_GET_IC_VALUES:
		return MyGetICValuesHandler ((IMChangeICStruct *) call_data);
	case XIM_SET_IC_VALUES:
		return MySetICValuesHandler ((IMChangeICStruct *) call_data);
		break;

	// 焦点
	case XIM_SET_IC_FOCUS:
		return MySetFocusHandler (ims, (IMChangeFocusStruct *) call_data);
	case XIM_UNSET_IC_FOCUS:
		return MyUnsetFocusHandler (ims, (IMChangeICStruct *) call_data);;
		
	case XIM_TRIGGER_NOTIFY:
		return MyTriggerNotifyHandler((IMTriggerNotifyStruct *) call_data);
	default:
		DEBUGP("major_code=%d\n", call_data->major_code);
		break;
	}
	return True;
}

应用程序打开和关闭连接时,服务器收到XIM_OPEN和XIM_CLOSE。IC代表输入上下文,即客户程序中的一个编辑框。 只有先处理好IC,服务器才能收到XIM_FORWARD_EVENT,即按键事件。 XIM呼叫的处理方法可以参照IMdkit例程或其它输入法程序。

在实验一中,我们已经实现了基于gtk的输入法。现在只要将服务器接口部分用XIM实现就可以了。 服务器接口部分使用输入法引擎的以下接口:

  1. 打开和关闭输入法。

    void ime_enable(void);
    void ime_disable(void);
    

    在打开/关闭连接和获得/失去焦点时调用。在基于GTK的输入法中,我把输入法开关状态保存在gtk im模块里面。 在XIM版本中,我们要在服务器用链表保存每个客户的输入法开关状态。

  2. 输入按键。

    boolean ime_mgr_input(void *user, int c);
    

    第一个参数是可以标识客户的句柄,第二个参数是输入的字符。返回值表示按键是否已经处理。 如果按键需要进一步处理,该函数返回FALSE,服务器接口调用IMForwardEvent将按键事件送回客户程序。

  3. 根据光标位置移动输入窗口。

    void ime_move_input(int cursor_x, int cursor_y, int cursor_h);
    

    在XIM_SET_IC_VALUES呼叫中得到光标位置后调用ime_move_input。在gtk版本中,我们可以得到光标高度。 在XIM版本,我不知道怎么获取光标高度,只好用固定值。

服务器接口部分要对外提供两个接口:

  1. 由主程序调用的初始化接口。

    int ime_svr_init(void);
    

    返回值小于0表示初始化失败,否则成功。

  2. 由输入法引擎调用的文本提交接口。

    void ime_svr_send(void *user, const char *str);
    

    输入法引擎使用这个接口提交输入文本,第一个参数是由ime_mgr_input传入的客户句柄。 ime_svr_send用IMCommitString将输入文本送到客户程序。

改写服务器接口部分后,XIM版本的输入法就可以运行了。 不算IMdkit库,XIM版本服务器接口部分有539行代码。gtk版本的服务器接口部分有265行代码。 相对而言,还是XIM版本麻烦一些。

3 webkit上的测试问题

在poky环境测试,GTK的编辑框里当然可以正常使用,例如:

在网页的编辑框里可以输入中文,但是光标跟随无效,例如:

poky里的浏览器是一个叫web2的小程序,只有740行代码。这个小程序使用了webkit引擎。 我打开打印后发现,在连接webkit的网页编辑框时,服务器可以收到:

但是收不到

光标跟随是根据XIM_SET_IC_VALUES呼叫中的光标位置实现的,收不到XIM_SET_IC_VALUES,自然就不会移动输入窗口。 收不到XIM_UNSET_IC_FOCUS对输入法状态切换也会有影响。

前面说过,XIM是客户和服务器之间的协议,必须双方都遵守协议,输入法才能正常工作。 从现象看,webkit上的输入法问题是webkit的编辑器控件没有很好地实现XIM协议引起的。

4 结束语

我重新构建poky,恢复了对XIM的支持,然后为XIM接口写了一个服务器接口,实现了基于XIM接口的输入法。 XIM版本的输入法适合于使用X的环境,它要求客户程序遵守XIM协议。 从现象看,浏览器引擎webkit的编辑器控件没有很好地实现XIM协议。

 

Google
 

个人主页留言本我的空间我的程序 fmdd@263.net