| <!doctype html public "-//w3c//dtd html 4.0 transitional//en"> |
| <html> |
| <head> |
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
| <meta name="Author" content="Eric Mader"> |
| <meta name="GENERATOR" content="Mozilla/4.72 [en] (Windows NT 5.0; U) [Netscape]"> |
| <title>ScriptRun readme</title> |
| </head> |
| <body> |
| |
| <h2> |
| What is scrptrun and srtest?</h2> |
| The ICU LayoutEngine must be called with text in a single script. scrptrun.h |
| and scrptrun.cpp implement the ScriptRun class, which can be used to find |
| runs of text that is in a single script. It uses a basic iteration interface. |
| <p>srtest is a little program that tests ScriptRun. You can use it as an |
| example of how to use ScriptRun. Here's what the output should look like: |
| <blockquote><font face="Courier New,Courier"><font size=-1>Script 'DEVANAGARI' |
| from 0 to 9.</font></font> |
| <br><font face="Courier New,Courier"><font size=-1>Script 'ARABIC' from |
| 9 to 17.</font></font> |
| <br><font face="Courier New,Courier"><font size=-1>Script 'CYRILLIC' from |
| 17 to 25.</font></font> |
| <br><font face="Courier New,Courier"><font size=-1>Script 'LATIN' from |
| 25 to 33.</font></font> |
| <br><font face="Courier New,Courier"><font size=-1>Script 'HAN' from 33 |
| to 35.</font></font> |
| <br><font face="Courier New,Courier"><font size=-1>Script 'HIRAGANA' from |
| 35 to 41.</font></font> |
| <br><font face="Courier New,Courier"><font size=-1>Script 'KATAKANA' from |
| 41 to 45.</font></font> |
| <br><font face="Courier New,Courier"><font size=-1>Script 'DESERET' from |
| 45 to 53.</font></font></blockquote> |
| |
| <h2> |
| How do I build scrptrun and srtest?</h2> |
| To use ScriptRun in your application, copy scrptrun.h and scrptrun.cpp |
| to your source directory, and use them just as if they were part of your |
| application. ScriptRun is so small that it's not worth making it into a |
| separate library. |
| <p>Building srtest is easy, on Windows build the srtest workspace in <icu>\source\extra\scrptrun. |
| On UNIX, connect to <top-build-dir>/extra/scrptrun and do "make all" |
| <h2> |
| Notes</h2> |
| |
| <ul> |
| <li> |
| ScriptRun is based on <a href="http://www.unicode.org/unicode/reports/tr24/">Unicode |
| Technical Report #24</a> but the implementation is not complete. In particular |
| it doesn't handle paired punctuation correctly. A complete implemetation |
| will be added to ICU in the future.</li> |
| |
| <li> |
| Because ScriptRun is designed to be used with the LayoutEngine, it uses |
| the LayoutEngine's coding conventions instead of ICU's coding conventions.</li> |
| </ul> |
| |
| </body> |
| </html> |
