1ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> 2ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<html> 3ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<head> 4ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<meta name="generator" content= 5ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru"HTML Tidy for Windows (vers 26 April 2007), see www.w3.org"> 6ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<meta http-equiv="Content-Type" content= 7ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru"text/html; charset=us-ascii"> 8ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<meta name="Copyright" content= 9ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru"Copyright (c) 2001-2007, International Business Machines Corporation and others. All Rights Reserved."> 10ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<meta name="Author" content="Eric Mader"> 11ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<meta name="GENERATOR" content= 12ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru"Mozilla/4.72 [en] (Windows NT 5.0; U) [Netscape]"> 13ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<title>Readme file for letest and gendata</title> 14ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru</head> 15ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<body> 16ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<h2>What are letest and gendata?</h2> 17ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruletest is a test program that you can use to verify the basic 18ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querufunctionality of the ICU LayoutEngine. It tests the LayoutEngine's 19ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruAPI and reads an XML file that contains test cases to test some of 20ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruthe features of the LayoutEngine. These test cases are not 21ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querucomprehensive, but they do test the most important features of 22ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru the LayoutEngine. When you have successfully run letest, you 23ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querucan use the ICU LayoutEngine in you application knowing that the 24ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querubasic functionality is working correctly.<br> 25ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<p>gendata is a program that is used by the ICU team to build the 26ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querufile letest.xml which contains the test cases. Unless you have 27ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruchanged your copy of the LayoutEngine and want to validate the 28ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruchanges on other platforms, there's no reason for you to run this 29ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruprogram.</p> 30ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<p>(The ICU team first runs a Windows application which uses the 31ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruICU LayoutEngine to display the text that letest uses. Once it has 32ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querubeen verified that the text is displayed correctly, gendata is run 33ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruto produce letest.xml, and then letest is run on Windows to verify 34ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruthat letest still works with the new data.)<br></p> 35ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<h2>How do I build letest?</h2> 36ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruFirst, you need to build ICU, including the LayoutEngine. 37ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<p>On Windows, letest is part of the allinone project, so a normal 38ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querubuild of ICU will also build letest. On UNIX systems, connect to 39ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<top-build-dir>/test/letest and do "make all" .<br></p> 40ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<h2>How do I run letest?</h2> 41ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruBefore you can run letest, you'll need to get the fonts it uses. 42ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruFor legal reasons, we can't include most of them with ICU, but you 43ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querucan download them from the web. To do this, you'll need access to a 44ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querucomputer running Windows. All of the fonts should be stored in 45ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<icu>/source/test/testdata. Here's how to get the fonts: 46ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<p>Download a recent version of the Java 2 Platform, Standard 47ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruEdition (J2SE) from <a href= 48ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru"http://java.sun.com/javase/downloads/index.html">java.sun.com</a>. 49ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruClick on the "Download" button for the version of Java that you 50ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruwant to download. The page offers both JDKs and JREs. (The JRE is 51ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querusufficient for letest.) The download page will have a link to the 52ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querulicense agreement. Be sure to read and understand the license 53ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruagreement, and then click on the Accept button. Download the 54ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querupackage and install it. You'll need one font. On Windows, it will 55ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querube in, for example, "C:\Program Files\Java\jdk1.6.0\jre\lib\fonts". 56ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruThe file you want is "LucidaSansRegular.ttf". Copy this file into 57ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruthe directory from which you'll run letest.<br></p> 58ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<p>Next is the Hindi font. Go to the NCST site and download 59ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<a href="http://tdil.mit.gov.in/download/Raghu.htm">raghu.ttf</a>. 60ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruWhen you hit the DOWNLOAD button on the page, it will open another 61ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruwindow which contains a disclaimer and a license agreement. Be sure 62ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruthat you understand and agree to all of this before you download 63ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruthe font. You can download raghu.ttf into the directory from which 64ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruyou'll run letest.<br></p> 65ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<p>Then download the Thai font. Go to <a href= 66ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru"http://www.into-asia.com/thai_language/thaifont/">into-asia.com</a> 67ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruand click on the link for the Angsana font. This will download a 68ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru.ZIP file. Extract the font file, angsd___.ttf, into the directory 69ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querufrom which you will run letest.<br></p> 70ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<p>There's still one more font to get, the Code2000 Unicode font. 71ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruGo to James Kass' <a href="http://www.code2000.net/">Unicode 72ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruSupport In Your Browser</a> page and click on the link that says 73ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru"Click Here to download Code2000 shareware demo Unicode font." This 74ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruwill download a .ZIP file which contains CODE2000.TTF and 75ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruCODE2000.HTM. Expand this .ZIP file and put the CODE2000.TTF file 76ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruin the directory from which you'll run letest.<br></p> 77ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<p><span style="font-weight: bold;">Note:</span> The Code2000 font 78ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruis shareware. If you want to use it for longer than a trial period, 79ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruyou should send a shareware fee to James. Directions for how to do 80ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruthis are in CODE2000.HTM.</p> 81ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<p>letest.xml references three other fonts:</p> 82ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<ul> 83ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<li>ARIALUNI.TTF is Microsoft's Arial Unicode MS font, which is 84ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querudistributed with Microsoft Office and is licensed only for use on 85ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruthe Windows operating system.</li> 86ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<li>Devamt.ttf is a proprietary font which cannot be freely 87ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querudownloaded.</li> 88ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<li>TestFont1.otf is included with ICU.</li> 89ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru</ul> 90ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruTo run letest type CTRL+F5 in Visual Studio, or "make check" in 91ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruUNIX. If everything's OK you should see something like this: 92ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<blockquote><tt> /<br> 93ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru /api/<br> 94ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru ---[OK] ---/api/ParameterTest<br> 95ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru ---[OK] ---/api/FactoryTest<br> 96ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru /layout/<br> 97ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru ---[OK] ---/layout/AccessTest<br> 98ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru ---[OK] ---/layout/DataDrivenTest<br> 99ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru /c_api/<br> 100ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru ---[OK] ---/c_api/ParameterTest<br> 101ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru ---[OK] ---/c_api/FactoryTest<br> 102ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru /c_layout/<br> 103ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru ---[OK] ---/c_layout/AccessTest<br> 104ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru ---[OK] ---/c_layout/DataDrivenTest<br> 105ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru<br> 106ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru[All tests passed successfully...]<br> 107ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruElapsed Time: 00:00:00.351<br></tt></blockquote> 108ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste QueruIf letest cannot open a font, it will print a warning message and 109ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruskip the test. letest will also check the version of the font you 110ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruhave to make sure it's the same one that was used to generate the 111ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Querutest case. If the version doesn't match, letest will print a 112ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queruwarning message and proceed with the test.<br> 113ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru</body> 114ac04d0bbe12b3ef54518635711412f178cb4d16Jean-Baptiste Queru</html> 115