| <!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> |
| <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> |
| <p>To build the demo on Windows, just open the layout project in |
| <icu>\source\samples\layout and build it.</p> |
| <p>On Linux systems, connect to <top-build-dir>/samples/layout |
| and do "make all" To build the layout demo on Linux, you'll need |
| the gnome-libs-devel and freetype-devel packages, which should be part |
| of your Linux distribution. The demo uses the FreeType 1 library, and |
| the make files assume that the FreeType header files are in |
| /usr/include/freetype1, and that the freetype library is |
| /usr/lib/libttf.so. This is how RedHat Linux 7.2 installs FreeType 1. |
| If your system is different, you may need to add sym links to where the |
| files are stored on your system, or modify |
| <top-src-dir>/samples/layout/Makefile.in to reference the files |
| correctly for your system.<br> |
| </p> |
| <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://www.ibm.com/java"> IBM developerWorks Java technology zone</a> |
| page. From this page, follow the "Tools and products" link on the left |
| hand side, and then the link for the "IBM Developer Kit for Linux", or |
| the "IBM Developer Kit for Windows(R), Release 1.3.0". You'll need to |
| register with them if you haven't downloaded before. Download and |
| install the "Runtime Environment Package." You'll need one font 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 file you |
| want is "Thonburi.ttf" On Windows, copy this font file to your Fonts |
| folder, on Linux, copy this font file to the directory from which |
| you'll run the layout demo.</p> |
| <p>Next is the Hindi font. Go to the NCST site and download <a |
| href="http://rohini.ncst.ernet.in/indix/download/font/raghu.ttf"> |
| raghu.ttf</a>. Be sure to look at the <a |
| href="http://rohini.ncst.ernet.in/indix/download/font/README"> README</a> |
| file before you download the font. On Linux, you can download raghu.ttf |
| into the directory from which you'll run the layout demo. On Windows, |
| you'll need to install it in your Fonts folder.</p> |
| <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> |
| <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> |
| <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> |
| <p>That's it! Now all you have to do is run letest (CTRL+F5 in Visual |
| C++, or "./gnomelayout" in Linux) </p> |
| <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> |
| <p>Here is the list of legal script names: </p> |
| <blockquote><tt>ARABIC</tt> <br> |
| <tt>ARMENIAN</tt> <br> |
| <tt>BENGALI</tt> <br> |
| <tt>BOPOMOFO</tt> <br> |
| <span style="font-family: monospace;">BUHID</span><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> |
| <span style="font-family: monospace;">HANUNDOO</span><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> |
| <span style="font-family: monospace;">TAGALOG<br> |
| TAGBANWA</span><br> |
| <tt>TAMIL</tt> <br> |
| <tt>TELUGU</tt> <br> |
| <tt>THAANA</tt> <br> |
| <tt>THAI</tt> <br> |
| <tt>TIBETAN</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> |
