upstream version 1.2.2
[debian/freetts] / demo / JSAPI / JTime / README.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
3 <!--
4
5 /**
6  * Copyright 2001,2003 Sun Microsystems, Inc.
7  * 
8  * See the file "license.terms" for information on usage and
9  * redistribution of this file, and for a DISCLAIMER OF ALL 
10  * WARRANTIES.
11  */
12
13 -->
14
15 <html>
16     <head><title>JSAPI Time Demo</title></head>
17     <body>
18         <center>
19             <table bgcolor="#FFCC66" width="100%">
20                 <tr>
21                     <td align=center width="100%">
22                         <h1>JSAPI Time Demo</h1>
23                     </td>
24                 </tr>
25             </table>
26         </center>
27
28         <p>This demo provides a simple example of using JSAPI to tell
29         the time using the high quality FreeTTS cluster unit selection
30         voice.</p>
31
32         <p><b>NOTE</b>: To build and run this JSAPI demo, you must 
33         <a href="../../../docs/jsapi_setup.html">set up your environment to
34         use JSAPI</a>.
35
36         <h3>Building</h3>
37         <p>To build this demo, merely type the following in a shell from
38         any directory in the FreeTTS hierarchy:
39         <ul>
40             <code>ant -find demo.xml</code>
41         </ul>
42         <p>Doing so will create
43         <code>bin/JTime.jar</code> under the top level
44         directory.  You can run the demo 
45         using <code>java -jar</code> (see "Running" below).
46
47         <h3>Running</h3>
48         <p>To run this demo, type the following command from a command
49         window at the top level FreeTTS directory:</p>
50         <ul>
51             <p><code>java -jar bin/JTime.jar</code></p>
52         </ul>
53
54         <p>You should hear the current time and see the following prompt:</p>
55         <ul>
56             <li><b>Enter time (HH:MM):</b></li>
57         </ul>
58
59         <p>Enter the time in a format as follows:</p>
60         <ul>
61             <li><b>Enter time (HH:MM): 12:35</b></li>
62         </ul>
63
64         <p>You should hear "The time is now exactly twenty-five to one
65         in the afternoon".</p> 
66         <p><img src="../../../docs/images/speaker1.gif"> Click <a
67         href="../../../docs/audio/12-35.au">AU</a> or <a
68         href="../../../docs/audio/12-35.wav">WAV</a> to listen to it.</p>
69
70         <h3>Specifying a Voice</h3> 
71
72         <p>By default, this application will use the "alan" voice
73         that comes with the lib/cmu_time_awb.jar file.  As of this
74         release, the "alan" voice is the only time voice that comes
75         with FreeTTS.</p>
76         <p>We now have, however, the ability for you to
77         create your own FreeTTS voices.  See the 
78         <a href="../../../tools/FestVoxToFreeTTS/README.html">
79         FestVoxToFreeTTS</a> documentation for creating your own
80         voice.  Once you create your own voice, place its jar
81         file in the lib directory and  specify the name of the 
82         voice as the first (and only) parameter on the command line 
83         (replace "myvoicename" with the name of your new voice):</p>
84         <ul>
85             <p><code>java -jar bin/JTime.jar myvoicename</code>
86         </ul>
87     
88         <hr>
89
90         <p>See the <a href="../../../license.terms">license terms</a>
91         and <a href="../../../acknowledgments.txt">acknowledgments</a>.
92         <br>
93         Copyright 2001,2003 Sun Microsystems, Inc.  All Rights
94         Reserved.  Use is subject to license terms.</p>
95     </body>
96 </html>