| <!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> |