|
2
|
1 |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
|
2 |
<html>
|
|
|
3 |
<head>
|
|
|
4 |
<title>README - CodePointIM</title>
|
|
|
5 |
<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
|
|
|
6 |
</head>
|
|
|
7 |
<body>
|
|
|
8 |
<h1>Code Point Input Method</h1>
|
|
|
9 |
<p>
|
|
|
10 |
The Code Point Input Method is a simple input method that allows Unicode
|
|
|
11 |
characters to be entered using their code point or code unit values.
|
|
|
12 |
<p>
|
|
|
13 |
The input method accepts three different notations, all using hexadecimal
|
|
|
14 |
digits from the set [0-9a-fA-F]:
|
|
|
15 |
<br>
|
|
|
16 |
<ul>
|
|
|
17 |
<li>"\uxxxx": The standard Unicode escape notation of the Java programming
|
|
|
18 |
language. This notation allows input of code points up to U+FFFE; the illegal
|
|
|
19 |
code point U+FFFF is not allowed.</li>
|
|
|
20 |
<li>"\Uxxxxxx": An extended Unicode escape notation specific to this input
|
|
|
21 |
method. This notation allows direct input of any Unicode code Point except the
|
|
|
22 |
illegal code point U+FFFF. The uppercase "U" indicates that six hexadecimal
|
|
|
23 |
digits follow. "xxxxxx" must be between 000000 and 10FFFF.</li>
|
|
|
24 |
<li>"\uxxxx\uyyyy": Two consecutive standard Unicode escapes, together
|
|
|
25 |
representing a code point between U+10000 and U+10FFFF (a supplementary
|
|
|
26 |
character). "xxxx" must be between D800 and DBFF (that is, a high surrogate
|
|
|
27 |
value), "yyyy" between DC00 and DFFF (a low surrogate value).</li>
|
|
|
28 |
</ul>
|
|
|
29 |
In general, the input method passes characters through unchanged. However,
|
|
|
30 |
when the user types a "\", the input method enters composition mode. In
|
|
|
31 |
composition mode, the user types the desired code point using one of the
|
|
|
32 |
notations above, then types a space character to convert to the corresponding
|
|
|
33 |
Unicode character and commit. The input method then returns to pass-through
|
|
|
34 |
mode until another "\" character is entered.
|
|
|
35 |
<p>
|
|
|
36 |
While in composition mode, the user can use the left arrow, right arrow,
|
|
|
37 |
backspace, and delete keys to edit the sequence. The "\u" or "\U" characters
|
|
|
38 |
can only be deleted if they are not followed by hexadecimal digits in the
|
|
|
39 |
composition sequence. Deleting the initial "\u" or "\U" returns the input
|
|
|
40 |
method to pass-through mode.
|
|
|
41 |
<p>
|
|
|
42 |
Since the initial "\" character starts composition mode, a user must type two
|
|
|
43 |
"\" characters in order to add a single "\" to the text. When an initial "\"
|
|
|
44 |
has been entered, but the next character is not "u", "U", or "\", both the "\"
|
|
|
45 |
and the subsequent character are committed, and the input method returns to
|
|
|
46 |
pass-through mode. Also, typing a new line, or tab character at any time
|
|
|
47 |
during composition immediately commits the current composed text.
|
|
|
48 |
<p>
|
|
|
49 |
Input methods are extensions to the Java Runtime Environment; they cannot be
|
|
|
50 |
run as applications. Before you can use an input method, you have to install
|
|
|
51 |
it in the JRE, run an application that supports input methods (such as the
|
|
|
52 |
JFC demos Notepad and Stylepad), and select the input method. You can learn
|
|
|
53 |
more about these steps from the article
|
|
|
54 |
"<a href="http://javadesktop.org/articles/InputMethod/index.html">Using Input Methods on the Java Platform</a>"
|
|
|
55 |
and more about supplementary character support from the article
|
|
|
56 |
"<a href="http://java.sun.com/developer/technicalArticles/Intl/Supplementary/index.html">Supplementary Characters in the Java Platform</a>".
|
|
|
57 |
<p>
|
|
|
58 |
This input method requires JRE 5.0 or higher.
|
|
|
59 |
<br>
|
|
|
60 |
</body>
|
|
|
61 |
</html>
|