Copyright: Released under the GNU General Public License, version 2,
dated June 1991, worded by the Free Software Foundation.
Please read the file COPYING. (GNU)
----------------------------------------------------------------------------
USAGE :
In your shell type :
./src/interxim &
export XMODIFIERS="@im=interxim"
your_application
In your application press <SHIFT><SpaceBar> to open a converter window.
Click on the setup button. Click on the first top left button to select
a kmap (Keyboard Map) converter (these are located in the ./kmap directory
of the source tarball).
Click on the font button to select a list of font to use to display
your strings.
Validate with ok.
You can now type your strings in your application.
You can switch between converter using <F1>..<F12> function keys.
Use <CTRL>k or <RETURN> to flush the string buffer.
Press <SHIFT><SpaceBar> to close the converter window.
You have a question ?
mail to : oksid@bluewin.ch
--------------------------------------------------------------------------
WARNING : if you use the "C" locale with XFree86 < 4.1.0 you must never
call XCloseIM() or XDestroyIC() !!!
--------------------------------------------------------------------------
The program "your_application" MUST support Unicode keysyms. The only
known softwares that support Unicode keysyms are:
XUtf8 library ( http://www.oksid.ch/xutf8/ )
fltk-utf8 library ( http://www.oksid.ch/fltk-utf/ )
The Xd640 project ( http://www.oksid.ch/xd640/ )
Yudit ( http://www.yudit.org )
To support Unicode keysyms the application must have these lines in its
keyboard event handler :
event_handler ()
{
len = Xutf8LookupString(xim_ic, &xevent.xkey,
buf, 127, &keysym, &status);
if (len == 0 && (keysym & 0xFF000000) == 0x01000000) {
len = unicode_to_utf8 (keysym & 0x00FFFFFF, buf);
}
}
int unicode_to_utf8 (long ucs, char *buf)
{
/* buf must be at least 5 byte long */
if (ucs < 0x000080) {
buf[0] = ucs;
return 1;
} else if (ucs < 0x000800) {
buf[0] = 0xC0 | (ucs >> 6);
buf[1] = 0x80 | (ucs & 0x3F);
return 2;
} else if (ucs < 0x010000) {
buf[0] = 0xE0 | (ucs >> 12);
buf[1] = 0x80 | ((ucs >> 6) & 0x3F);
buf[2] = 0x80 | (ucs & 0x3F);
return 3;
} else if (ucs < 0x00200000) {
buf[0] = 0xF0 | (ucs >> 18);
buf[1] = 0x80 | ((ucs >> 12) & 0x3F);
buf[2] = 0x80 | ((ucs >> 6) & 0x3F);
buf[3] = 0x80 | (ucs & 0x3F);
buf[3] = 0x80 | (ucs & 0x3F);
return 4;
} else if (ucs < 0x01000000) {
buf[0] = 0xF8 | (ucs >> 24);
buf[1] = 0x80 | ((ucs >> 18) & 0x3F);
buf[2] = 0x80 | ((ucs >> 12) & 0x3F);
buf[3] = 0x80 | ((ucs >> 6) & 0x3F);
buf[4] = 0x80 | (ucs & 0x3F);
return 5;
}
return 0;
}
--------------------------------------------------------------------------
IMdkit directory comes from the xcin distribution.
( http://xcin.linux.org.tw )
kmap directory comes from the yudit distribution.
( http://www.yudit.org/ )
Special thanks to Gaspar Sinai for his freebacks and his great work on Yudit.