intl/icu/source/extra/scrptrun/readme.html@6474c204b198 (annotated)
intl/icu/source/extra/scrptrun/readme.html
Wed, 31 Dec 2014 06:09:35 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Wed, 31 Dec 2014 06:09:35 +0100
- changeset 0
- 6474c204b198
- permissions
- -rw-r--r--
Cloned upstream origin tor-browser at tor-browser-31.3.0esr-4.5-1-build1
revision ID fc1c9ff7c1b2defdbc039f12214767608f46423f for hacking purpose.
| michael@0 | 1 | <!doctype html public "-//w3c//dtd html 4.0 transitional//en"> |
| michael@0 | 2 | <html> |
| michael@0 | 3 | <head> |
| michael@0 | 4 | <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
| michael@0 | 5 | <meta name="Copyright" content="Copyright (c) 2002, International Business Machines Corporation and others. All Rights Reserved."> |
| michael@0 | 6 | <meta name="Author" content="Eric Mader"> |
| michael@0 | 7 | <meta name="GENERATOR" content="Mozilla/4.72 [en] (Windows NT 5.0; U) [Netscape]"> |
| michael@0 | 8 | <title>ScriptRun readme</title> |
| michael@0 | 9 | </head> |
| michael@0 | 10 | <body> |
| michael@0 | 11 | |
| michael@0 | 12 | <h2> |
| michael@0 | 13 | What is scrptrun and srtest?</h2> |
| michael@0 | 14 | The ICU LayoutEngine must be called with text in a single script. scrptrun.h |
| michael@0 | 15 | and scrptrun.cpp implement the ScriptRun class, which can be used to find |
| michael@0 | 16 | runs of text that is in a single script. It uses a basic iteration interface. |
| michael@0 | 17 | <p>srtest is a little program that tests ScriptRun. You can use it as an |
| michael@0 | 18 | example of how to use ScriptRun. Here's what the output should look like: |
| michael@0 | 19 | <blockquote><font face="Courier New,Courier"><font size=-1>Script 'DEVANAGARI' |
| michael@0 | 20 | from 0 to 9.</font></font> |
| michael@0 | 21 | <br><font face="Courier New,Courier"><font size=-1>Script 'ARABIC' from |
| michael@0 | 22 | 9 to 17.</font></font> |
| michael@0 | 23 | <br><font face="Courier New,Courier"><font size=-1>Script 'CYRILLIC' from |
| michael@0 | 24 | 17 to 25.</font></font> |
| michael@0 | 25 | <br><font face="Courier New,Courier"><font size=-1>Script 'LATIN' from |
| michael@0 | 26 | 25 to 33.</font></font> |
| michael@0 | 27 | <br><font face="Courier New,Courier"><font size=-1>Script 'HAN' from 33 |
| michael@0 | 28 | to 35.</font></font> |
| michael@0 | 29 | <br><font face="Courier New,Courier"><font size=-1>Script 'HIRAGANA' from |
| michael@0 | 30 | 35 to 41.</font></font> |
| michael@0 | 31 | <br><font face="Courier New,Courier"><font size=-1>Script 'KATAKANA' from |
| michael@0 | 32 | 41 to 45.</font></font> |
| michael@0 | 33 | <br><font face="Courier New,Courier"><font size=-1>Script 'DESERET' from |
| michael@0 | 34 | 45 to 53.</font></font></blockquote> |
| michael@0 | 35 | |
| michael@0 | 36 | <h2> |
| michael@0 | 37 | How do I build scrptrun and srtest?</h2> |
| michael@0 | 38 | To use the ScriptRun class in a Windows application, just include scrptrun.h |
| michael@0 | 39 | and scrptrun.cpp right out of the <icu>\source\extra\scrptrun directory |
| michael@0 | 40 | into your project. You'll also need to add the <icu>\source]extra\scrptrun |
| michael@0 | 41 | directory to the "Additional include directories" section of the "Preprocessor" |
| michael@0 | 42 | category on the "C/C++" tab in the project settings. |
| michael@0 | 43 | <p>On UNIX systems the simplest thing to do is to just copy scrptrun.h |
| michael@0 | 44 | and scrptrun.cpp into your source directory. If you want to use them from |
| michael@0 | 45 | <icu>/source/extra/scrpturn, it's a bit trickier: the default dependency |
| michael@0 | 46 | rules don't work on source files in a different directory. You need to |
| michael@0 | 47 | add separate dependency rules for scrptrun.o and scrptrun.d. See <icu>/source/samples/layout/Makefile.in |
| michael@0 | 48 | for an example of how to do this. You'll also have to add -I$(top_srcdir)/extra/scrptrun |
| michael@0 | 49 | to your compiler flags so that the compiler can find scrptrun.h. If your |
| michael@0 | 50 | application has to build on multiple UNIX platforms, it might be difficult |
| michael@0 | 51 | to wirte dependency rules that will work correctly on all platforms. In |
| michael@0 | 52 | that case, you're probably better off copying the scrpturn files to your |
| michael@0 | 53 | source directory. |
| michael@0 | 54 | <p>Building srtest is easy, on Windows build the srtest workspace in <icu>\source\extra\scrptrun. |
| michael@0 | 55 | On UNIX, connect to <top-build-dir>/extra/scrptrun and do "make all" |
| michael@0 | 56 | <h2> |
| michael@0 | 57 | Notes</h2> |
| michael@0 | 58 | |
| michael@0 | 59 | <ul> |
| michael@0 | 60 | <li> |
| michael@0 | 61 | ScriptRun is based on <a href="http://www.unicode.org/unicode/reports/tr24/">Unicode |
| michael@0 | 62 | Technical Report #24</a> but the implementation is not complete. In particular |
| michael@0 | 63 | the support for paired punctuation is only a prototype. A complete implementation |
| michael@0 | 64 | will be added to ICU in the future.</li> |
| michael@0 | 65 | </ul> |
| michael@0 | 66 | |
| michael@0 | 67 | </body> |
| michael@0 | 68 | </html> |
