| <!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>Readme file for letest and gendata</title> |
| </head> |
| <body> |
| |
| <h2> |
| What is the layout demo?</h2> |
| The layout demo displays a paragraph of text that is laid out using the |
| LayoutEngine. There are two versions of this demo, "layout.exe" which runs |
| on Windows 2000, and "gnomelayout" which runs on Linux. Both programs read |
| a file containing the Unicode text to display, and a file that says which |
| font to use to display each script. |
| <br> |
| <h2> |
| How do I build the layout demo?</h2> |
| First, you need to build ICU, including the LayoutEngine. |
| <p>On Windows, the layout project should be listed as a dependency of all, |
| so layout will build when you build all. If it doesn't for some reason, |
| just select the layout project in the project toolbar and build it. |
| <p>On Linux systems, you need to add the "--enable-layout=yes" option when |
| you invoke the runConfigureICU script. When you've done that, layout should |
| build when you do "make all install" |
| <p>To build the demo on Windows, just open the layout project in <icu>\source\samples\layout |
| and build it. On Linux systems, connect to <top-build-dir>/samples/layout |
| and do "make all" |
| <br> |
| <h2> |
| How do I run the demo?</h2> |
| Before you can run the demo, you'll need to get the fonts it uses. For |
| legal reasons, we can't include these fonts with ICU, but you can get them |
| for free from the web. To do this, you'll need access to a computer running |
| Windows. Here's how to get the fonts: |
| <p>Download the 1.3 version of the JDK from the <a href="http://www7b.boulder.ibm.com/wsdd/wspvtindex.html">IBM |
| WebSphere preview technologies</a> page. From this page, follow the "Download" |
| link on the right had side. You'll need to register with them if you haven't |
| downloaded before. Download and install the "Runtime Environment Package." |
| You'll need three fonts from this package. If you've let the installer |
| use it's defaults, the fonts will be in C:\Program Files\IBM\Java13\jre\lib\fonts. |
| The files you want are "Devamt.ttf" "LucidaSansRegular.ttf" and "Thonburi.ttf" |
| On Windows, copy these font files to your Fonts folder, on LInux, copy |
| these font files to the directory from which you'll run the layout demo. |
| <p>There's still one more font to get. Go to the Microsoft <a href="http://www.microsoft.com/typography/fontpack/default.htm">TrueType |
| core fonts for the Web</a> page and download the "Times New Roman" font. |
| This will download an installer program, called "Times32.exe" which will |
| install the Times New Roman fonts in your fonts folder. (If you've already |
| got these fonts in you fonts folder, you may want to move them to another |
| folder before you install these fonts.) |
| <p>NOTE: this installer will display an End User License Agreement (EULA) |
| which you must accept before proceeding. Be sure that you read and understand |
| this agreement before you install the font. |
| <p>After you run the installer program, it will add the Times Roman fonts |
| to your fonts folder. If you're going to run the demo on Linux, open the |
| Fonts folder and copy the "Times New Roman" font (the file name will be |
| "Times.TTF") to the directory from which you'll run the demo. |
| <p>That's it! Now all you have to do is run letest (CTRL+F5 in Visual C++, |
| or "./gnomelayout" in Linux) |
| <h2> |
| How can I customize the layout demo?</h2> |
| The text that the layout demo displays is read from the file "Sample.txt." |
| You can change the text by editing this file using a Unicode-aware text |
| editor. (it is in UTF8 format with a BOM as the first character; the demo |
| can also read UTF16 and UTF32 format files) Remember that the text will |
| be displayed in a single paragraph; you can include CR and LF characters |
| in the text, but they will be ignored. |
| <p>If you add scripts to the text other than Arabic, Devanagari, Latin |
| or Thai, you'll need to find a font which contains the characters in that |
| script, and add an entry to the FontMap file ("FontMap.GDI" on Windows, |
| "FontMap.Gnome" on Linux) This file contains a single entry per line. Each |
| entry contains a script name followed by a colon, and then a font name. |
| <p>Here is the list of legal script names: |
| <blockquote><tt>ARABIC</tt> |
| <br><tt>ARMENIAN</tt> |
| <br><tt>BENGALI</tt> |
| <br><tt>BOPOMOFO</tt> |
| <br><tt>CANADIAN-ABORIGINAL</tt> |
| <br><tt>CHEROKEE</tt> |
| <br><tt>CYRILLIC</tt> |
| <br><tt>DESERET</tt> |
| <br><tt>DEVANAGARI</tt> |
| <br><tt>ETHIOPIC</tt> |
| <br><tt>GEORGIAN</tt> |
| <br><tt>GOTHIC</tt> |
| <br><tt>GREEK</tt> |
| <br><tt>GUJARATI</tt> |
| <br><tt>GURMUKHI</tt> |
| <br><tt>HAN</tt> |
| <br><tt>HANGUL</tt> |
| <br><tt>HEBREW</tt> |
| <br><tt>HIRAGANA</tt> |
| <br><tt>KANNADA</tt> |
| <br><tt>KATAKANA</tt> |
| <br><tt>KHMER</tt> |
| <br><tt>LATIN</tt> |
| <br><tt>MALAYALAM</tt> |
| <br><tt>MONGOLIAN</tt> |
| <br><tt>MYANMAR</tt> |
| <br><tt>OGHAM</tt> |
| <br><tt>OLD-ITALIC</tt> |
| <br><tt>ORIYA</tt> |
| <br><tt>RUNIC</tt> |
| <br><tt>SINHALA</tt> |
| <br><tt>SYRIAC</tt> |
| <br><tt>TAMIL</tt> |
| <br><tt>TELUGU</tt> |
| <br><tt>THAANA</tt> |
| <br><tt>THAI</tt> |
| <br><tt>TIBETAN</tt> |
| <br><tt>UCAS</tt> |
| <br><tt>YI</tt></blockquote> |
| On Windows use the full name of the font as it appears in the Windows Fonts |
| folder (eg. "Times New Roman") On Linux, use the file name of the font |
| file (e.g. "Times.TTF") If you're running on Windows, you'll need to install |
| the new fonts in your Fonts folder. If you're running on Linux, put them |
| in the directory from which you'll run the demo. |
| <br> |
| <br> |
| </body> |
| </html> |
