| <!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en"> |
| <html> |
| <head> |
| <!-- |
| Copyright (c) 2001-2005 International Business Machines |
| Corporation and others. All Rights Reserved. |
| --> |
| <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 the ICU LayoutEngine demo</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 download them from |
| the web. To do this, you'll need access to a computer running Windows. Here's |
| how to get the fonts: |
| <p>First, download the Thai font. Go to <a href="http://www.into-asia.com/thai_language/thaifont/"> |
| into-asia.com</a> and click on the link for the Angsana font. This will |
| download a .ZIP file. Extract the font file, angsd___.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, the Code2000 Unicode font.Go to James Kass' |
| <a href="http://home.att.net/%7Ejameskass/">Unicode Support In Your Browser</a> |
| page and click on the link that says "Click Here to download Code2000 shareware |
| demo Unicode font." This will download a .ZIP file which contains CODE2000.TTF |
| and CODE2000.HTM. Expand this .ZIP file. If you're going to run the layout demo |
| on Linux, put the CODE2000.TTF file in the directory from which you'll run the |
| demo. On Windows, copy the font to your fonts folder.</p> |
| <p><span style="font-weight: bold;">Note:</span> |
| The Code2000 font is shareware. If you want to use it for longer than a trial |
| period, you should send a shareware fee to James. Directions for how to do this |
| are in CODE2000.HTM.</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> |
| <span style="font-family: monospace;">HANUNOO</span><br> |
| <tt>HEBREW</tt> |
| <br> |
| <tt>HIRAGANA</tt> |
| <br> |
| <span style="font-family: monospace;"></span><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<br> |
| </tt></blockquote>You can also use the script name "DEFAULT" to represent |
| all scripts which you don't explicitly list in the FontMap file.<br> |
| <br> |
| 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> |