12e5b6d6dSopenharmony_ci<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> 22e5b6d6dSopenharmony_ci<html> 32e5b6d6dSopenharmony_ci<head> 42e5b6d6dSopenharmony_ci<meta name="generator" content= 52e5b6d6dSopenharmony_ci"HTML Tidy for Windows (vers 26 April 2007), see www.w3.org"> 62e5b6d6dSopenharmony_ci<meta http-equiv="Content-Type" content= 72e5b6d6dSopenharmony_ci"text/html; charset=us-ascii"> 82e5b6d6dSopenharmony_ci<meta name="Copyright" content= 92e5b6d6dSopenharmony_ci"Copyright (C) 2016 and later: Unicode, Inc. and others. License & terms of use: http://www.unicode.org/copyright.html"> 102e5b6d6dSopenharmony_ci<!-- meta name="Copyright" content= 112e5b6d6dSopenharmony_ci"Copyright (c) 2001-2007, International Business Machines Corporation and others. All Rights Reserved." --> 122e5b6d6dSopenharmony_ci<meta name="Author" content="Eric Mader"> 132e5b6d6dSopenharmony_ci<meta name="GENERATOR" content= 142e5b6d6dSopenharmony_ci"Mozilla/4.72 [en] (Windows NT 5.0; U) [Netscape]"> 152e5b6d6dSopenharmony_ci<title>Readme file for letest and gendata</title> 162e5b6d6dSopenharmony_ci</head> 172e5b6d6dSopenharmony_ci<body> 182e5b6d6dSopenharmony_ci<h2>What are letest and gendata?</h2> 192e5b6d6dSopenharmony_ciletest is a test program that you can use to verify the basic 202e5b6d6dSopenharmony_cifunctionality of the ICU LayoutEngine. It tests the LayoutEngine's 212e5b6d6dSopenharmony_ciAPI and reads an XML file that contains test cases to test some of 222e5b6d6dSopenharmony_cithe features of the LayoutEngine. These test cases are not 232e5b6d6dSopenharmony_cicomprehensive, but they do test the most important features of 242e5b6d6dSopenharmony_ci the LayoutEngine. When you have successfully run letest, you 252e5b6d6dSopenharmony_cican use the ICU LayoutEngine in you application knowing that the 262e5b6d6dSopenharmony_cibasic functionality is working correctly.<br> 272e5b6d6dSopenharmony_ci<p>gendata is a program that is used by the ICU team to build the 282e5b6d6dSopenharmony_cifile letest.xml which contains the test cases. Unless you have 292e5b6d6dSopenharmony_cichanged your copy of the LayoutEngine and want to validate the 302e5b6d6dSopenharmony_cichanges on other platforms, there's no reason for you to run this 312e5b6d6dSopenharmony_ciprogram.</p> 322e5b6d6dSopenharmony_ci<p>(The ICU team first runs a Windows application which uses the 332e5b6d6dSopenharmony_ciICU LayoutEngine to display the text that letest uses. Once it has 342e5b6d6dSopenharmony_cibeen verified that the text is displayed correctly, gendata is run 352e5b6d6dSopenharmony_cito produce letest.xml, and then letest is run on Windows to verify 362e5b6d6dSopenharmony_cithat letest still works with the new data.)<br></p> 372e5b6d6dSopenharmony_ci<h2>How do I build letest?</h2> 382e5b6d6dSopenharmony_ciFirst, you need to build ICU, including the LayoutEngine. 392e5b6d6dSopenharmony_ci<p>On Windows, letest is part of the allinone project, so a normal 402e5b6d6dSopenharmony_cibuild of ICU will also build letest. On UNIX systems, connect to 412e5b6d6dSopenharmony_ci<top-build-dir>/test/letest and do "make all" .<br></p> 422e5b6d6dSopenharmony_ci<h2>How do I run letest?</h2> 432e5b6d6dSopenharmony_ciBefore you can run letest, you'll need to get the fonts it uses. 442e5b6d6dSopenharmony_ciFor legal reasons, we can't include most of them with ICU, but you 452e5b6d6dSopenharmony_cican download them from the web. To do this, you'll need access to a 462e5b6d6dSopenharmony_cicomputer running Windows. All of the fonts should be stored in 472e5b6d6dSopenharmony_ci<icu>/source/test/testdata. Here's how to get the fonts: 482e5b6d6dSopenharmony_ci<p>Download a recent version of the Java 2 Platform, Standard 492e5b6d6dSopenharmony_ciEdition (J2SE) from <a href= 502e5b6d6dSopenharmony_ci"http://java.sun.com/javase/downloads/index.html">java.sun.com</a>. 512e5b6d6dSopenharmony_ciClick on the "Download" button for the version of Java that you 522e5b6d6dSopenharmony_ciwant to download. The page offers both JDKs and JREs. (The JRE is 532e5b6d6dSopenharmony_cisufficient for letest.) The download page will have a link to the 542e5b6d6dSopenharmony_cilicense agreement. Be sure to read and understand the license 552e5b6d6dSopenharmony_ciagreement, and then click on the Accept button. Download the 562e5b6d6dSopenharmony_cipackage and install it. You'll need one font. On Windows, it will 572e5b6d6dSopenharmony_cibe in, for example, "C:\Program Files\Java\jdk1.6.0\jre\lib\fonts". 582e5b6d6dSopenharmony_ciThe file you want is "LucidaSansRegular.ttf". Copy this file into 592e5b6d6dSopenharmony_cithe directory from which you'll run letest.<br></p> 602e5b6d6dSopenharmony_ci<p>Next is the Hindi font. Go to the NCST site and download 612e5b6d6dSopenharmony_ci<a href="http://tdil.mit.gov.in/download/Raghu.htm">raghu.ttf</a>. 622e5b6d6dSopenharmony_ciWhen you hit the DOWNLOAD button on the page, it will open another 632e5b6d6dSopenharmony_ciwindow which contains a disclaimer and a license agreement. Be sure 642e5b6d6dSopenharmony_cithat you understand and agree to all of this before you download 652e5b6d6dSopenharmony_cithe font. You can download raghu.ttf into the directory from which 662e5b6d6dSopenharmony_ciyou'll run letest.<br></p> 672e5b6d6dSopenharmony_ci<p>Then download the Thai font. Go to <a href= 682e5b6d6dSopenharmony_ci"http://www.into-asia.com/thai_language/thaifont/">into-asia.com</a> 692e5b6d6dSopenharmony_ciand click on the link for the Angsana font. This will download a 702e5b6d6dSopenharmony_ci.ZIP file. Extract the font file, angsd___.ttf, into the directory 712e5b6d6dSopenharmony_cifrom which you will run letest.<br></p> 722e5b6d6dSopenharmony_ci<p>There's still one more font to get, the Code2000 Unicode font. 732e5b6d6dSopenharmony_ciGo to James Kass' <a href="http://www.code2000.net/">Unicode 742e5b6d6dSopenharmony_ciSupport In Your Browser</a> page and click on the link that says 752e5b6d6dSopenharmony_ci"Click Here to download Code2000 shareware demo Unicode font." This 762e5b6d6dSopenharmony_ciwill download a .ZIP file which contains CODE2000.TTF and 772e5b6d6dSopenharmony_ciCODE2000.HTM. Expand this .ZIP file and put the CODE2000.TTF file 782e5b6d6dSopenharmony_ciin the directory from which you'll run letest.<br></p> 792e5b6d6dSopenharmony_ci<p><span style="font-weight: bold;">Note:</span> The Code2000 font 802e5b6d6dSopenharmony_ciis shareware. If you want to use it for longer than a trial period, 812e5b6d6dSopenharmony_ciyou should send a shareware fee to James. Directions for how to do 822e5b6d6dSopenharmony_cithis are in CODE2000.HTM.</p> 832e5b6d6dSopenharmony_ci<p>letest.xml references three other fonts:</p> 842e5b6d6dSopenharmony_ci<ul> 852e5b6d6dSopenharmony_ci<li>ARIALUNI.TTF is Microsoft's Arial Unicode MS font, which is 862e5b6d6dSopenharmony_cidistributed with Microsoft Office and is licensed only for use on 872e5b6d6dSopenharmony_cithe Windows operating system.</li> 882e5b6d6dSopenharmony_ci<li>Devamt.ttf is a proprietary font which cannot be freely 892e5b6d6dSopenharmony_cidownloaded.</li> 902e5b6d6dSopenharmony_ci<li>TestFont1.otf is included with ICU.</li> 912e5b6d6dSopenharmony_ci</ul> 922e5b6d6dSopenharmony_ciTo run letest type CTRL+F5 in Visual Studio, or "make check" in 932e5b6d6dSopenharmony_ciUNIX. If everything's OK you should see something like this: 942e5b6d6dSopenharmony_ci<blockquote><tt> /<br> 952e5b6d6dSopenharmony_ci /api/<br> 962e5b6d6dSopenharmony_ci ---[OK] ---/api/ParameterTest<br> 972e5b6d6dSopenharmony_ci ---[OK] ---/api/FactoryTest<br> 982e5b6d6dSopenharmony_ci /layout/<br> 992e5b6d6dSopenharmony_ci ---[OK] ---/layout/AccessTest<br> 1002e5b6d6dSopenharmony_ci ---[OK] ---/layout/DataDrivenTest<br> 1012e5b6d6dSopenharmony_ci /c_api/<br> 1022e5b6d6dSopenharmony_ci ---[OK] ---/c_api/ParameterTest<br> 1032e5b6d6dSopenharmony_ci ---[OK] ---/c_api/FactoryTest<br> 1042e5b6d6dSopenharmony_ci /c_layout/<br> 1052e5b6d6dSopenharmony_ci ---[OK] ---/c_layout/AccessTest<br> 1062e5b6d6dSopenharmony_ci ---[OK] ---/c_layout/DataDrivenTest<br> 1072e5b6d6dSopenharmony_ci<br> 1082e5b6d6dSopenharmony_ci[All tests passed successfully...]<br> 1092e5b6d6dSopenharmony_ciElapsed Time: 00:00:00.351<br></tt></blockquote> 1102e5b6d6dSopenharmony_ciIf letest cannot open a font, it will print a warning message and 1112e5b6d6dSopenharmony_ciskip the test. letest will also check the version of the font you 1122e5b6d6dSopenharmony_cihave to make sure it's the same one that was used to generate the 1132e5b6d6dSopenharmony_citest case. If the version doesn't match, letest will print a 1142e5b6d6dSopenharmony_ciwarning message and proceed with the test.<br> 1152e5b6d6dSopenharmony_ci</body> 1162e5b6d6dSopenharmony_ci</html> 117