X-Git-Url: https://git.saurik.com/apple/icu.git/blobdiff_plain/b75a7d8f3b4adbae880cab104ce2c6a50eee4db2..b25be06635768807f8f693286fa73bb2297bb06c:/icuSources/samples/layout/readme.html?ds=sidebyside diff --git a/icuSources/samples/layout/readme.html b/icuSources/samples/layout/readme.html index a1878793..1db4e306 100644 --- a/icuSources/samples/layout/readme.html +++ b/icuSources/samples/layout/readme.html @@ -1,153 +1,161 @@ - + -
- - - + + + +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.
-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"
-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" 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.
-
Download the 1.3 version of the JDK from the IBM developerWorks Java technology zone -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.
-Next is the Hindi font. Go to the NCST site and download -raghu.ttf. Be sure to look at the README -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.
-There's still one more font to get, the Code2000 Unicode font.Go to -James Kass' Unicode -Support In Your Browser 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.
-Note: 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.
-That's it! Now all you have to do is run letest (CTRL+F5 in Visual -C++, or "./gnomelayout" in Linux)
-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.
-Here is the list of legal script names:
-ARABIC-You can also use the script name "DEFAULT" to represent all scripts -which you don't explicitly list in the FontMap file.
- ARMENIAN
- BENGALI
- BOPOMOFO
- BUHID
- CANADIAN_ABORIGINAL
- CHEROKEE
- CYRILLIC
- DESERET
- DEVANAGARI
- ETHIOPIC
- GEORGIAN
- GOTHIC
- GREEK
- GUJARATI
- GURMUKHI
- HAN
- HANGUL
- HANUNOO
- HEBREW
- HIRAGANA
- KANNADA
- KATAKANA
- KHMER
- LATIN
- MALAYALAM
- MONGOLIAN
- MYANMAR
- OGHAM
- OLD_ITALIC
- ORIYA
- RUNIC
- SINHALA
- SYRIAC
- TAGALOG
-TAGBANWA
- TAMIL
- TELUGU
- THAANA
- THAI
- TIBETAN
- YI
-
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.
+ +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.
+ +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"
+ +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". 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.
+ +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:
+ +First, download the Thai font. Go to freelang.net and + click on the link for the Courier Thai font. This will download a .ZIP file. + Extract the Courpro.ttf font. On Windows, copy this font file to your + Fonts folder (note the name of the font after it is installed), on Linux, copy this font file to the directory from which + you'll run the layout demo.
+ +Next is the Hindi font. Download the font from Raghindi. On Linux, you can download the font into the + directory from which you'll run the layout demo. On Windows, you'll need to + install it in your Fonts folder.
+ +There's still one more font to get, the Code2000 Unicode font. Go to James + Kass' Unicode Support In Your + Browser 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.
+ +Note: 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.
+ +Be sure that your FontMap.GDI (on Windows) or FontMap.Gnome file (on Linux) contains accurate
+ font names for each script type. For example, the following is a valid FontMap.GDI (assuming you have the correct fonts):
+
DEVANAGARI: Raghindi
THAI: Courier MonoThai
DEFAULT: Code2000
Note that only the Code2000 default font is strictly necessary,
+ and that the other two can simply be commented out by a '#' if you do not wish to use them.
Also note that the FontMap and the sample.txt files have to be in the same directory as the layout executable.
+ +That's it! Now all you have to do is run letest (CTRL+F5 in Visual C++, or + "./gnomelayout" in Linux)
+ +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.
+ +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.
+ +Here is the list of legal script names:
+ ++ ARABIC+ +
+ ARMENIAN
+ BENGALI
+ BOPOMOFO
+ BUHID
+ CANADIAN_ABORIGINAL
+ CHEROKEE
+ CYRILLIC
+ DESERET
+ DEVANAGARI
+ ETHIOPIC
+ GEORGIAN
+ GOTHIC
+ GREEK
+ GUJARATI
+ GURMUKHI
+ HAN
+ HANGUL
+ HANUNOO
+ HEBREW
+ HIRAGANA
+ KANNADA
+ KATAKANA
+ KHMER
+ LATIN
+ MALAYALAM
+ MONGOLIAN
+ MYANMAR
+ OGHAM
+ OLD_ITALIC
+ ORIYA
+ RUNIC
+ SINHALA
+ SYRIAC
+ TAGALOG
+ TAGBANWA
+ TAMIL
+ TELUGU
+ THAANA
+ THAI
+ TIBETAN
+ YI
+
You can also use the script name "DEFAULT" to represent all scripts which + you don't explicitly list in the FontMap file.
+ +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.