On Thu, Apr 26, 2007 at 04:25:34PM -0700, Bill Kendrick wrote:
> On Wed, Apr 25, 2007 at 09:36:09PM -0700, Mark K. Kim wrote:
> > A brief explanation is that *.im files contain different key strokes
> > that generate the unicode. I call this "character mapping".
> I've documented this briefly in EXTENDING.html / .txt in CVS, thanks!
And so you don't have to dig, and so you can yell at me if I got any of
it wrong... :)
Alternative Input Methods
As of version 0.9.17, Tux Paint's "Text" tool can provide alternative
input methods for some languages. For example, when Tux Paint is running
with a Japanese locale, the right [Alt] can be pressed to change between
Latin, Romanized Hiragana and Katakana modes. This allows native
characters to be entered into the "Text" tool by typing one or more keys
on a keyboard with Latin characters (e.g., a US QWERTY keyboard).
To create an input method for a new locale, create a text file with a
name based on the locale (e.g., "ja" for Japanese), with ".im" as the
extension (e.g., "ja.im").
The ".im" file can have multiple character mapping sections for
different character mapping modes. For example, on a Japanese typing
system, typing [K] [A] in Hiragana mode generates a different Unicode
character than typing [K] [A] in Katakana mode.
Start each character mapping section with the word "section", the follow
it with the mappings, one per line. Each line should contain (separated
* the Unicode value of the character, in hexadecimal
* the keycode sequence (the ASCII characters that must be entered to
generate the Unicode character)
* a flag (or "-")
304B ka -
304C ga -
304D ki -
304E gi -
30AB ka -
30AC ga -
30AD ki -
30AE gi -
Note: Blank lines within the ".im" file will be ignored, as will any
text following a "#" (pound/hash) character -- it can be used to denote
comments, as seen in the example above.
Note: Flags must be set up on a per-locale basis (within the source
code, in "src/im.c"). For example, "b" is used in Korean to handle
Batchim, which may carry over to the next character.
Note: Additional input method support requires additions to Tux Paint's
source code (/src/im.c), and requires updates to the Makefile, to have
the ".im" files installed, for use at runtime.