1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/os/textandloc/fontservices/textshaperplugin/test/letest/readme.html Fri Jun 15 03:10:57 2012 +0200
1.3 @@ -0,0 +1,89 @@
1.4 +<!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en">
1.5 +<html>
1.6 +<head>
1.7 + <meta http-equiv="Content-Type"
1.8 + content="text/html; charset=iso-8859-1">
1.9 + <meta name="Copyright"
1.10 + content="Copyright (c) 2001-2003, International Business Machines Corporation and others. All Rights Reserved.">
1.11 + <meta name="Author" content="Eric Mader">
1.12 + <meta name="GENERATOR"
1.13 + content="Mozilla/4.72 [en] (Windows NT 5.0; U) [Netscape]">
1.14 + <title>Readme file for letest and gendata</title>
1.15 +</head>
1.16 +<body>
1.17 +<h2> What are letest and gendata?</h2>
1.18 +letest is a program you can use to verify that you have built and
1.19 +installed the ICU LayoutEngine correctly. The test is not comprehensive,
1.20 +it just verifies that the results of laying out some Devanagari, Arabic
1.21 +and Thai text are as expected. Once this test has passed, you can use
1.22 +the ICU LayoutEngine in your application knowing that it has been
1.23 +correctly installed and that the basic functionality is in place.
1.24 +<p>gendata is a program that is used by the ICU team to build the
1.25 +source file testdata.cpp, which contains the expected results of running
1.26 +letest. Unless you have changed your copy of the LayoutEngine and want
1.27 +to validate the changes on other platforms, there's no reason for you
1.28 +to run this program. </p>
1.29 +<p>(The ICU team first runs a Windows application which uses the ICU
1.30 +LayoutEngine to display the text that letest uses. Once it has been
1.31 +verified that the text is displayed correctly, gendata is run to produce
1.32 +testdata.cpp, and then letest is run on Windows to verify that letest
1.33 +still works with the new data.) <br>
1.34 + </p>
1.35 +<h2> How do I build letest?</h2>
1.36 +First, you need to build ICU, including the LayoutEngine.
1.37 +<p>On Windows, the layout project should be listed as a dependency of
1.38 +all, so layout will build when you build all. If it doesn't for some
1.39 +reason, just select the layout project in the project toolbar and build
1.40 +it. </p>
1.41 +<p>On UNIX systems, you need to add the "--enable-layout=yes" option
1.42 +when you invoke the runConfigureICU script. When you've done that,
1.43 +layout should build when you do "make all install" </p>
1.44 +<p>To build letest on Windows, just open the letest project in
1.45 +<icu>\source\test\letest and build it. On UNIX systems, connect to
1.46 +<top-build-dir>/test/letest and do "make all" <br>
1.47 + </p>
1.48 +<h2> How do I run letest?</h2>
1.49 +Before you can run letest, you'll need to get the fonts it uses. For
1.50 +legal reasons, we can't include them with ICU, but you can download them
1.51 +from the web. To do this, you'll need access to a computer running
1.52 +Windows. Here's how to get the fonts:
1.53 +<p>Download the 1.3 version of the JDK from the<a
1.54 + href="http://www.ibm.com/java"> IBM developerWorks Java technology zone</a>
1.55 +page. From this page, follow the "Tools and products" link on the left
1.56 +hand side, and then the link for the "IBM Developer Kit for Linux", or
1.57 +the "IBM Developer Kit for Windows(R), Release 1.3.0". You'll need to
1.58 +register with them if you haven't downloaded before. Download and
1.59 +install the "Runtime Environment Package." You'll need two fonts from
1.60 +this package. If you've let the installer use it's defaults, the fonts
1.61 +will be in C:\Program Files\IBM\Java13\jre\lib\fonts. The files you want
1.62 +are "LucidaSansRegular.ttf" and "Thonburi.ttf" Copy these font files to
1.63 +the directory from which you'll run letest.<br>
1.64 +</p>
1.65 +<p>Next is the Hindi font. Go to the NCST site and download <a
1.66 + href="http://rohini.ncst.ernet.in/indix/download/font/raghu.ttf">
1.67 +raghu.ttf</a>. Be sure to look at the <a
1.68 + href="http://rohini.ncst.ernet.in/indix/download/font/README"> README</a>
1.69 +file before you download the font. You can download raghu.ttf into the
1.70 +directory from which you'll run letest.<br>
1.71 +</p>
1.72 +<p>There's still one more font to get, the Code2000 Unicode font.Go to
1.73 +James Kass' <a href="http://home.att.net/%7Ejameskass/">Unicode
1.74 +Support In Your Browser</a> page and click on the link that says "Click
1.75 +Here to download Code2000 shareware demo Unicode font." This will
1.76 +download a .ZIP file which contains CODE2000.TTF and CODE2000.HTM.
1.77 +Expand this .ZIP file and put the CODE2000.TTF file in the directory
1.78 +from which you'll run letest.<br>
1.79 +</p>
1.80 +<p><span style="font-weight: bold;">Note:</span> The Code2000 font is
1.81 +shareware. If you want to use it for longer than a trial period, you
1.82 +should send a shareware fee to James. Directions for how to do this are
1.83 +in CODE2000.HTM.</p>
1.84 +<p>That's it! Now all you have to do is run letest (CTRL+F5 in Visual
1.85 +C++, or "./letest" in UNIX) If everything's OK you should see
1.86 +something like this: </p>
1.87 +<blockquote><tt>Test 0, font = raghu.ttf... passed.</tt> <br>
1.88 + <tt>Test 1, font = CODE2000.TTF... passed.</tt> <br>
1.89 + <tt>Test 2, font = LucidaSansRegular.ttf... passed.</tt> <br>
1.90 + <tt>Test 3, font = Thonburi.ttf... passed.</tt></blockquote>
1.91 +</body>
1.92 +</html>