|
1 <!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en"> |
|
2 <html> |
|
3 <head> |
|
4 <meta http-equiv="Content-Type" |
|
5 content="text/html; charset=iso-8859-1"> |
|
6 <meta name="Copyright" |
|
7 content="Copyright (c) 2001-2003, International Business Machines Corporation and others. All Rights Reserved."> |
|
8 <meta name="Author" content="Eric Mader"> |
|
9 <meta name="GENERATOR" |
|
10 content="Mozilla/4.72 [en] (Windows NT 5.0; U) [Netscape]"> |
|
11 <title>Readme file for letest and gendata</title> |
|
12 </head> |
|
13 <body> |
|
14 <h2> What are letest and gendata?</h2> |
|
15 letest is a program you can use to verify that you have built and |
|
16 installed the ICU LayoutEngine correctly. The test is not comprehensive, |
|
17 it just verifies that the results of laying out some Devanagari, Arabic |
|
18 and Thai text are as expected. Once this test has passed, you can use |
|
19 the ICU LayoutEngine in your application knowing that it has been |
|
20 correctly installed and that the basic functionality is in place. |
|
21 <p>gendata is a program that is used by the ICU team to build the |
|
22 source file testdata.cpp, which contains the expected results of running |
|
23 letest. Unless you have changed your copy of the LayoutEngine and want |
|
24 to validate the changes on other platforms, there's no reason for you |
|
25 to run this program. </p> |
|
26 <p>(The ICU team first runs a Windows application which uses the ICU |
|
27 LayoutEngine to display the text that letest uses. Once it has been |
|
28 verified that the text is displayed correctly, gendata is run to produce |
|
29 testdata.cpp, and then letest is run on Windows to verify that letest |
|
30 still works with the new data.) <br> |
|
31 </p> |
|
32 <h2> How do I build letest?</h2> |
|
33 First, you need to build ICU, including the LayoutEngine. |
|
34 <p>On Windows, the layout project should be listed as a dependency of |
|
35 all, so layout will build when you build all. If it doesn't for some |
|
36 reason, just select the layout project in the project toolbar and build |
|
37 it. </p> |
|
38 <p>On UNIX systems, you need to add the "--enable-layout=yes" option |
|
39 when you invoke the runConfigureICU script. When you've done that, |
|
40 layout should build when you do "make all install" </p> |
|
41 <p>To build letest on Windows, just open the letest project in |
|
42 <icu>\source\test\letest and build it. On UNIX systems, connect to |
|
43 <top-build-dir>/test/letest and do "make all" <br> |
|
44 </p> |
|
45 <h2> How do I run letest?</h2> |
|
46 Before you can run letest, you'll need to get the fonts it uses. For |
|
47 legal reasons, we can't include them with ICU, but you can download them |
|
48 from the web. To do this, you'll need access to a computer running |
|
49 Windows. Here's how to get the fonts: |
|
50 <p>Download the 1.3 version of the JDK from the<a |
|
51 href="http://www.ibm.com/java"> IBM developerWorks Java technology zone</a> |
|
52 page. From this page, follow the "Tools and products" link on the left |
|
53 hand side, and then the link for the "IBM Developer Kit for Linux", or |
|
54 the "IBM Developer Kit for Windows(R), Release 1.3.0". You'll need to |
|
55 register with them if you haven't downloaded before. Download and |
|
56 install the "Runtime Environment Package." You'll need two fonts from |
|
57 this package. If you've let the installer use it's defaults, the fonts |
|
58 will be in C:\Program Files\IBM\Java13\jre\lib\fonts. The files you want |
|
59 are "LucidaSansRegular.ttf" and "Thonburi.ttf" Copy these font files to |
|
60 the directory from which you'll run letest.<br> |
|
61 </p> |
|
62 <p>Next is the Hindi font. Go to the NCST site and download <a |
|
63 href="http://rohini.ncst.ernet.in/indix/download/font/raghu.ttf"> |
|
64 raghu.ttf</a>. Be sure to look at the <a |
|
65 href="http://rohini.ncst.ernet.in/indix/download/font/README"> README</a> |
|
66 file before you download the font. You can download raghu.ttf into the |
|
67 directory from which you'll run letest.<br> |
|
68 </p> |
|
69 <p>There's still one more font to get, the Code2000 Unicode font.Go to |
|
70 James Kass' <a href="http://home.att.net/%7Ejameskass/">Unicode |
|
71 Support In Your Browser</a> page and click on the link that says "Click |
|
72 Here to download Code2000 shareware demo Unicode font." This will |
|
73 download a .ZIP file which contains CODE2000.TTF and CODE2000.HTM. |
|
74 Expand this .ZIP file and put the CODE2000.TTF file in the directory |
|
75 from which you'll run letest.<br> |
|
76 </p> |
|
77 <p><span style="font-weight: bold;">Note:</span> The Code2000 font is |
|
78 shareware. If you want to use it for longer than a trial period, you |
|
79 should send a shareware fee to James. Directions for how to do this are |
|
80 in CODE2000.HTM.</p> |
|
81 <p>That's it! Now all you have to do is run letest (CTRL+F5 in Visual |
|
82 C++, or "./letest" in UNIX) If everything's OK you should see |
|
83 something like this: </p> |
|
84 <blockquote><tt>Test 0, font = raghu.ttf... passed.</tt> <br> |
|
85 <tt>Test 1, font = CODE2000.TTF... passed.</tt> <br> |
|
86 <tt>Test 2, font = LucidaSansRegular.ttf... passed.</tt> <br> |
|
87 <tt>Test 3, font = Thonburi.ttf... passed.</tt></blockquote> |
|
88 </body> |
|
89 </html> |