Home | History | Annotate | only in /external/icu/icu4c/source/test/letest
Up to higher level directory
NameDateSize
cfonts.cpp21-Aug-20181.8K
cfonts.h21-Aug-2018999
cletest.c21-Aug-201828.5K
cletest.sln21-Aug-20181.2K
cletest.vcxproj21-Aug-201810.7K
cletest.vcxproj.filters21-Aug-20182.7K
cmaps.cpp21-Aug-20187.4K
cmaps.h21-Aug-20181.8K
FontObject.cpp21-Aug-20186.3K
FontObject.h21-Aug-20185.2K
FontTableCache.cpp21-Aug-20182.5K
FontTableCache.h21-Aug-2018991
gendata.cpp21-Aug-201813K
gendata.sln21-Aug-20181.2K
gendata.vcxproj21-Aug-201814.1K
gendata.vcxproj.filters21-Aug-20182K
gendata.xml21-Aug-201811.5K
letest.cpp21-Aug-201842.5K
letest.h21-Aug-20181.3K
letest.sln21-Aug-20182.1K
letest.vcxproj21-Aug-201814.7K
letest.vcxproj.filters21-Aug-20182.4K
letsutil.cpp21-Aug-20183K
letsutil.h21-Aug-20181.1K
Makefile.in21-Aug-20183.1K
PortableFontInstance.cpp21-Aug-201812.7K
PortableFontInstance.h21-Aug-20183.4K
readme.html21-Aug-20185.9K
sfnt.h21-Aug-20189.1K
SimpleFontInstance.cpp21-Aug-20183.2K
SimpleFontInstance.h21-Aug-20182K
testdata.cpp21-Aug-201849.3K
xmlreader.cpp21-Aug-20188.2K
xmlreader.h21-Aug-2018685

readme.html

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