ICU-8.11.tar.gz
[apple/icu.git] / icuSources / samples / layout / readme.html
index a187879302da2e4a22b3eaf4a88054f42d32a9a6..fd108cca17ee9fdb5df9d03e63860b12b93f3985 100644 (file)
-<!-- 
-Copyright (c) 2001-2003 International Business Machines
-Corporation and others. All Rights Reserved.
--->
-
 <!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 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>
-&nbsp;
-<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
-&lt;icu&gt;\source\samples\layout and build it.</p>
-<p>On Linux systems, connect to &lt;top-build-dir&gt;/samples/layout
-and do "make all" &nbsp;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&nbsp; modify
-&lt;top-src-dir&gt;/samples/layout/Makefile.in to reference the files
-correctly for your system.<br>
-&nbsp; </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>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&nbsp; NCST site and download&nbsp;<a
- href="http://rohini.ncst.ernet.in/indix/download/font/raghu.ttf">
-raghu.ttf</a>. Be sure to look at the&nbsp;<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' &nbsp;<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>
+       <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>
+               &nbsp;
+               <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 
+                       &lt;icu&gt;\source\samples\layout and build it.</p>
+               <p>On Linux systems, connect to &lt;top-build-dir&gt;/samples/layout and do "make 
+                       all" &nbsp;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&nbsp; modify 
+                       &lt;top-src-dir&gt;/samples/layout/Makefile.in to reference the files correctly 
+                       for your system.<br>
+                       &nbsp;
+               </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&nbsp; NCST site and download&nbsp;<a href="http://rohini.ncst.ernet.in/indix/download/font/raghu.ttf">
+                               raghu.ttf</a>. Be sure to look at the&nbsp;<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' 
+                       &nbsp;<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>
-&nbsp; <br>
-&nbsp;
-</body>
+                       <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>
+               &nbsp;
+               <br>
+               &nbsp;
+       </body>
 </html>