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