add a cleanup script to elide the non-free jsapi binary blob from the sources
[debian/freetts] / javadoc / com / sun / speech / freetts / audio / RawFileAudioPlayer.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">\r
2 <!--NewPage-->\r
3 <HTML>\r
4 <HEAD>\r
5 <!-- Generated by javadoc (build 1.4.2_16) on Mon Mar 09 18:20:29 CET 2009 -->\r
6 <TITLE>\r
7 RawFileAudioPlayer (FreeTTS 1.2)\r
8 </TITLE>\r
9 \r
10 <META NAME="keywords" CONTENT="com.sun.speech.freetts.audio.RawFileAudioPlayer class">\r
11 \r
12 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">\r
13 \r
14 <SCRIPT type="text/javascript">\r
15 function windowTitle()\r
16 {\r
17     parent.document.title="RawFileAudioPlayer (FreeTTS 1.2)";\r
18 }\r
19 </SCRIPT>\r
20 \r
21 </HEAD>\r
22 \r
23 <BODY BGCOLOR="white" onload="windowTitle();">\r
24 \r
25
26 <!-- ========= START OF TOP NAVBAR ======= -->\r
27 <A NAME="navbar_top"><!-- --></A>
28 <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
29 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">\r
30 <TR>\r
31 <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">\r
32 <A NAME="navbar_top_firstrow"><!-- --></A>
33 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">\r
34   <TR ALIGN="center" VALIGN="top">\r
35   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>\r
36   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>\r
37   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>\r
38   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>\r
39   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>\r
40   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>\r
41   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>\r
42   </TR>\r
43 </TABLE>\r
44 </TD>\r
45 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>\r
46 </EM>\r
47 </TD>\r
48 </TR>\r
49 \r
50 <TR>\r
51 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">\r
52 &nbsp;<A HREF="../../../../../com/sun/speech/freetts/audio/NullAudioPlayer.html" title="class in com.sun.speech.freetts.audio"><B>PREV CLASS</B></A>&nbsp;\r
53 &nbsp;<A HREF="../../../../../com/sun/speech/freetts/audio/SingleFileAudioPlayer.html" title="class in com.sun.speech.freetts.audio"><B>NEXT CLASS</B></A></FONT></TD>\r
54 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">\r
55   <A HREF="../../../../../index.html" target="_top"><B>FRAMES</B></A>  &nbsp;\r
56 &nbsp;<A HREF="RawFileAudioPlayer.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;\r
57 &nbsp;<SCRIPT type="text/javascript">\r
58   <!--\r
59   if(window==top) {\r
60     document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');\r
61   }\r
62   //-->\r
63 </SCRIPT>\r
64 <NOSCRIPT>\r
65   <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>\r
66 </NOSCRIPT>
67 \r
68 </FONT></TD>\r
69 </TR>\r
70 <TR>\r
71 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">\r
72   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>\r
73 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">\r
74 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>\r
75 </TR>\r
76 </TABLE>\r
77 <A NAME="skip-navbar_top"></A>
78 <!-- ========= END OF TOP NAVBAR ========= -->\r
79 \r
80 <HR>\r
81 <!-- ======== START OF CLASS DATA ======== -->\r
82 <H2>\r
83 <FONT SIZE="-1">\r
84 com.sun.speech.freetts.audio</FONT>\r
85 <BR>\r
86 Class RawFileAudioPlayer</H2>\r
87 <PRE>\r
88 java.lang.Object\r
89   <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by"><B>com.sun.speech.freetts.audio.RawFileAudioPlayer</B>\r
90 </PRE>\r
91 <DL>\r
92 <DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></DD>\r
93 </DL>\r
94 <HR>\r
95 <DL>\r
96 <DT>public class <B>RawFileAudioPlayer</B><DT>extends java.lang.Object<DT>implements <A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></DL>\r
97 \r
98 <P>\r
99 Provides an implementation of <code>AudioPlayer</code> that sends
100  all audio data to the given file.\r
101 <P>\r
102 \r
103 <P>\r
104 <HR>\r
105 \r
106 <P>\r
107 <!-- ======== NESTED CLASS SUMMARY ======== -->\r
108 \r
109 \r
110 <!-- =========== FIELD SUMMARY =========== -->\r
111 \r
112 \r
113 <!-- ======== CONSTRUCTOR SUMMARY ======== -->\r
114 \r
115 <A NAME="constructor_summary"><!-- --></A>
116 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">\r
117 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
118 <TD COLSPAN=2><FONT SIZE="+2">\r
119 <B>Constructor Summary</B></FONT></TD>\r
120 </TR>\r
121 <TR BGCOLOR="white" CLASS="TableRowColor">\r
122 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#RawFileAudioPlayer()">RawFileAudioPlayer</A></B>()</CODE>\r
123 \r
124 <BR>\r
125 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a default audio player for an AudioFileFormat of type
126  WAVE.  </TD>\r
127 </TR>\r
128 <TR BGCOLOR="white" CLASS="TableRowColor">\r
129 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#RawFileAudioPlayer(java.lang.String)">RawFileAudioPlayer</A></B>(java.lang.String&nbsp;path)</CODE>\r
130 \r
131 <BR>\r
132 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Constructs a NullAudioPlayer</TD>\r
133 </TR>\r
134 </TABLE>\r
135 &nbsp;\r
136 <!-- ========== METHOD SUMMARY =========== -->\r
137 \r
138 <A NAME="method_summary"><!-- --></A>
139 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">\r
140 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
141 <TD COLSPAN=2><FONT SIZE="+2">\r
142 <B>Method Summary</B></FONT></TD>\r
143 </TR>\r
144 <TR BGCOLOR="white" CLASS="TableRowColor">\r
145 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
146 <CODE>&nbsp;void</CODE></FONT></TD>\r
147 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#begin(int)">begin</A></B>(int&nbsp;size)</CODE>\r
148 \r
149 <BR>\r
150 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Starts the output of a set of data</TD>\r
151 </TR>\r
152 <TR BGCOLOR="white" CLASS="TableRowColor">\r
153 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
154 <CODE>&nbsp;void</CODE></FONT></TD>\r
155 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#cancel()">cancel</A></B>()</CODE>\r
156 \r
157 <BR>\r
158 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Cancels all queued output. </TD>\r
159 </TR>\r
160 <TR BGCOLOR="white" CLASS="TableRowColor">\r
161 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
162 <CODE>&nbsp;void</CODE></FONT></TD>\r
163 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#close()">close</A></B>()</CODE>\r
164 \r
165 <BR>\r
166 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Waits for all audio playback to stop, and closes this AudioPlayer.</TD>\r
167 </TR>\r
168 <TR BGCOLOR="white" CLASS="TableRowColor">\r
169 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
170 <CODE>&nbsp;boolean</CODE></FONT></TD>\r
171 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#drain()">drain</A></B>()</CODE>\r
172 \r
173 <BR>\r
174 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Waits for all queued audio to be played</TD>\r
175 </TR>\r
176 <TR BGCOLOR="white" CLASS="TableRowColor">\r
177 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
178 <CODE>&nbsp;boolean</CODE></FONT></TD>\r
179 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#end()">end</A></B>()</CODE>\r
180 \r
181 <BR>\r
182 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Marks the end of a set of data</TD>\r
183 </TR>\r
184 <TR BGCOLOR="white" CLASS="TableRowColor">\r
185 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
186 <CODE>&nbsp;javax.sound.sampled.AudioFormat</CODE></FONT></TD>\r
187 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#getAudioFormat()">getAudioFormat</A></B>()</CODE>\r
188 \r
189 <BR>\r
190 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Retrieves the audio format for this player</TD>\r
191 </TR>\r
192 <TR BGCOLOR="white" CLASS="TableRowColor">\r
193 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
194 <CODE>&nbsp;long</CODE></FONT></TD>\r
195 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#getTime()">getTime</A></B>()</CODE>\r
196 \r
197 <BR>\r
198 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Gets the amount of played since the last resetTime
199  Currently not supported.</TD>\r
200 </TR>\r
201 <TR BGCOLOR="white" CLASS="TableRowColor">\r
202 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
203 <CODE>&nbsp;float</CODE></FONT></TD>\r
204 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#getVolume()">getVolume</A></B>()</CODE>\r
205 \r
206 <BR>\r
207 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the current volume.</TD>\r
208 </TR>\r
209 <TR BGCOLOR="white" CLASS="TableRowColor">\r
210 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
211 <CODE>&nbsp;void</CODE></FONT></TD>\r
212 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#pause()">pause</A></B>()</CODE>\r
213 \r
214 <BR>\r
215 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Pauses the audio output</TD>\r
216 </TR>\r
217 <TR BGCOLOR="white" CLASS="TableRowColor">\r
218 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
219 <CODE>&nbsp;void</CODE></FONT></TD>\r
220 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#reset()">reset</A></B>()</CODE>\r
221 \r
222 <BR>\r
223 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Prepares for another batch of output. </TD>\r
224 </TR>\r
225 <TR BGCOLOR="white" CLASS="TableRowColor">\r
226 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
227 <CODE>&nbsp;void</CODE></FONT></TD>\r
228 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#resetTime()">resetTime</A></B>()</CODE>\r
229 \r
230 <BR>\r
231 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Resets the audio clock</TD>\r
232 </TR>\r
233 <TR BGCOLOR="white" CLASS="TableRowColor">\r
234 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
235 <CODE>&nbsp;void</CODE></FONT></TD>\r
236 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#resume()">resume</A></B>()</CODE>\r
237 \r
238 <BR>\r
239 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Resumes audio output</TD>\r
240 </TR>\r
241 <TR BGCOLOR="white" CLASS="TableRowColor">\r
242 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
243 <CODE>&nbsp;void</CODE></FONT></TD>\r
244 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#setAudioFormat(javax.sound.sampled.AudioFormat)">setAudioFormat</A></B>(javax.sound.sampled.AudioFormat&nbsp;format)</CODE>\r
245 \r
246 <BR>\r
247 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the audio format for this player</TD>\r
248 </TR>\r
249 <TR BGCOLOR="white" CLASS="TableRowColor">\r
250 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
251 <CODE>&nbsp;void</CODE></FONT></TD>\r
252 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#setVolume(float)">setVolume</A></B>(float&nbsp;volume)</CODE>\r
253 \r
254 <BR>\r
255 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the current volume.</TD>\r
256 </TR>\r
257 <TR BGCOLOR="white" CLASS="TableRowColor">\r
258 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
259 <CODE>&nbsp;void</CODE></FONT></TD>\r
260 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#showMetrics()">showMetrics</A></B>()</CODE>\r
261 \r
262 <BR>\r
263 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Shows metrics for this audio player</TD>\r
264 </TR>\r
265 <TR BGCOLOR="white" CLASS="TableRowColor">\r
266 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
267 <CODE>&nbsp;void</CODE></FONT></TD>\r
268 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#startFirstSampleTimer()">startFirstSampleTimer</A></B>()</CODE>\r
269 \r
270 <BR>\r
271 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Starts the first sample timer</TD>\r
272 </TR>\r
273 <TR BGCOLOR="white" CLASS="TableRowColor">\r
274 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
275 <CODE>&nbsp;boolean</CODE></FONT></TD>\r
276 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#write(byte[])">write</A></B>(byte[]&nbsp;audioData)</CODE>\r
277 \r
278 <BR>\r
279 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Writes the given bytes to the audio stream</TD>\r
280 </TR>\r
281 <TR BGCOLOR="white" CLASS="TableRowColor">\r
282 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
283 <CODE>&nbsp;boolean</CODE></FONT></TD>\r
284 <TD><CODE><B><A HREF="../../../../../com/sun/speech/freetts/audio/RawFileAudioPlayer.html#write(byte[], int, int)">write</A></B>(byte[]&nbsp;bytes,
285       int&nbsp;offset,
286       int&nbsp;size)</CODE>\r
287 \r
288 <BR>\r
289 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Writes the given bytes to the audio stream</TD>\r
290 </TR>\r
291 </TABLE>\r
292 &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
293 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">\r
294 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">\r
295 <TD><B>Methods inherited from class java.lang.Object</B></TD>\r
296 </TR>\r
297 <TR BGCOLOR="white" CLASS="TableRowColor">\r
298 <TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>\r
299 </TR>\r
300 </TABLE>\r
301 &nbsp;\r
302 <P>\r
303 \r
304 <!-- ============ FIELD DETAIL =========== -->\r
305 \r
306 \r
307 <!-- ========= CONSTRUCTOR DETAIL ======== -->\r
308 \r
309 <A NAME="constructor_detail"><!-- --></A>
310 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">\r
311 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
312 <TD COLSPAN=1><FONT SIZE="+2">\r
313 <B>Constructor Detail</B></FONT></TD>\r
314 </TR>\r
315 </TABLE>\r
316 \r
317 <A NAME="RawFileAudioPlayer()"><!-- --></A><H3>\r
318 RawFileAudioPlayer</H3>\r
319 <PRE>\r
320 public <B>RawFileAudioPlayer</B>()
321                    throws java.io.IOException</PRE>\r
322 <DL>\r
323 <DD>Creates a default audio player for an AudioFileFormat of type
324  WAVE.  Reads the "com.sun.speech.freetts.AudioPlayer.baseName"
325  property for the base filename to use, and will produce files
326  of the form &lt;baseName>.raw.  The default value for the
327  base name is "freetts".\r
328 <P>\r
329 </DL>\r
330 <HR>\r
331 \r
332 <A NAME="RawFileAudioPlayer(java.lang.String)"><!-- --></A><H3>\r
333 RawFileAudioPlayer</H3>\r
334 <PRE>\r
335 public <B>RawFileAudioPlayer</B>(java.lang.String&nbsp;path)
336                    throws java.io.IOException</PRE>\r
337 <DL>\r
338 <DD>Constructs a NullAudioPlayer\r
339 <P>\r
340 </DL>\r
341 \r
342 <!-- ============ METHOD DETAIL ========== -->\r
343 \r
344 <A NAME="method_detail"><!-- --></A>
345 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">\r
346 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
347 <TD COLSPAN=1><FONT SIZE="+2">\r
348 <B>Method Detail</B></FONT></TD>\r
349 </TR>\r
350 </TABLE>\r
351 \r
352 <A NAME="setAudioFormat(javax.sound.sampled.AudioFormat)"><!-- --></A><H3>\r
353 setAudioFormat</H3>\r
354 <PRE>\r
355 public void <B>setAudioFormat</B>(javax.sound.sampled.AudioFormat&nbsp;format)</PRE>\r
356 <DL>\r
357 <DD>Sets the audio format for this player\r
358 <P>\r
359 <DD><DL>\r
360 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#setAudioFormat(javax.sound.sampled.AudioFormat)">setAudioFormat</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
361 </DD>\r
362 <DD><DL>\r
363 <DT><B>Parameters:</B><DD><CODE>format</CODE> - the audio format</DL>\r
364 </DD>\r
365 </DL>\r
366 <HR>\r
367 \r
368 <A NAME="getAudioFormat()"><!-- --></A><H3>\r
369 getAudioFormat</H3>\r
370 <PRE>\r
371 public javax.sound.sampled.AudioFormat <B>getAudioFormat</B>()</PRE>\r
372 <DL>\r
373 <DD>Retrieves the audio format for this player\r
374 <P>\r
375 <DD><DL>\r
376 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#getAudioFormat()">getAudioFormat</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
377 </DD>\r
378 <DD><DL>\r
379
380 <DT><B>Returns:</B><DD>the current audio format.</DL>\r
381 </DD>\r
382 </DL>\r
383 <HR>\r
384 \r
385 <A NAME="cancel()"><!-- --></A><H3>\r
386 cancel</H3>\r
387 <PRE>\r
388 public void <B>cancel</B>()</PRE>\r
389 <DL>\r
390 <DD>Cancels all queued output. Current 'write' call will return
391  false\r
392 <P>\r
393 <DD><DL>\r
394 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#cancel()">cancel</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
395 </DD>\r
396 <DD><DL>\r
397 </DL>\r
398 </DD>\r
399 </DL>\r
400 <HR>\r
401 \r
402 <A NAME="pause()"><!-- --></A><H3>\r
403 pause</H3>\r
404 <PRE>\r
405 public void <B>pause</B>()</PRE>\r
406 <DL>\r
407 <DD>Pauses the audio output\r
408 <P>\r
409 <DD><DL>\r
410 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#pause()">pause</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
411 </DD>\r
412 <DD><DL>\r
413 </DL>\r
414 </DD>\r
415 </DL>\r
416 <HR>\r
417 \r
418 <A NAME="reset()"><!-- --></A><H3>\r
419 reset</H3>\r
420 <PRE>\r
421 public void <B>reset</B>()</PRE>\r
422 <DL>\r
423 <DD>Prepares for another batch of output. Larger groups of output
424  (such as all output associated with a single FreeTTSSpeakable)
425  should be grouped between a reset/drain pair.\r
426 <P>\r
427 <DD><DL>\r
428 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#reset()">reset</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
429 </DD>\r
430 <DD><DL>\r
431 </DL>\r
432 </DD>\r
433 </DL>\r
434 <HR>\r
435 \r
436 <A NAME="resume()"><!-- --></A><H3>\r
437 resume</H3>\r
438 <PRE>\r
439 public void <B>resume</B>()</PRE>\r
440 <DL>\r
441 <DD>Resumes audio output\r
442 <P>\r
443 <DD><DL>\r
444 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#resume()">resume</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
445 </DD>\r
446 <DD><DL>\r
447 </DL>\r
448 </DD>\r
449 </DL>\r
450 <HR>\r
451 \r
452 <A NAME="close()"><!-- --></A><H3>\r
453 close</H3>\r
454 <PRE>\r
455 public void <B>close</B>()</PRE>\r
456 <DL>\r
457 <DD>Waits for all audio playback to stop, and closes this AudioPlayer.\r
458 <P>\r
459 <DD><DL>\r
460 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#close()">close</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
461 </DD>\r
462 <DD><DL>\r
463 </DL>\r
464 </DD>\r
465 </DL>\r
466 <HR>\r
467 \r
468 <A NAME="getVolume()"><!-- --></A><H3>\r
469 getVolume</H3>\r
470 <PRE>\r
471 public float <B>getVolume</B>()</PRE>\r
472 <DL>\r
473 <DD>Returns the current volume.\r
474 <P>\r
475 <DD><DL>\r
476 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#getVolume()">getVolume</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
477 </DD>\r
478 <DD><DL>\r
479
480 <DT><B>Returns:</B><DD>the current volume (between 0 and 1)</DL>\r
481 </DD>\r
482 </DL>\r
483 <HR>\r
484 \r
485 <A NAME="setVolume(float)"><!-- --></A><H3>\r
486 setVolume</H3>\r
487 <PRE>\r
488 public void <B>setVolume</B>(float&nbsp;volume)</PRE>\r
489 <DL>\r
490 <DD>Sets the current volume.\r
491 <P>\r
492 <DD><DL>\r
493 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#setVolume(float)">setVolume</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
494 </DD>\r
495 <DD><DL>\r
496 <DT><B>Parameters:</B><DD><CODE>volume</CODE> - the current volume (between 0 and 1)</DL>\r
497 </DD>\r
498 </DL>\r
499 <HR>\r
500 \r
501 <A NAME="write(byte[])"><!-- --></A><H3>\r
502 write</H3>\r
503 <PRE>\r
504 public boolean <B>write</B>(byte[]&nbsp;audioData)</PRE>\r
505 <DL>\r
506 <DD>Writes the given bytes to the audio stream\r
507 <P>\r
508 <DD><DL>\r
509 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#write(byte[])">write</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
510 </DD>\r
511 <DD><DL>\r
512 <DT><B>Parameters:</B><DD><CODE>audioData</CODE> - array of audio data
513 <DT><B>Returns:</B><DD><code>true</code> of the write completed successfully, 
514         <code> false </code>if the write was cancelled.</DL>\r
515 </DD>\r
516 </DL>\r
517 <HR>\r
518 \r
519 <A NAME="begin(int)"><!-- --></A><H3>\r
520 begin</H3>\r
521 <PRE>\r
522 public void <B>begin</B>(int&nbsp;size)</PRE>\r
523 <DL>\r
524 <DD>Starts the output of a set of data\r
525 <P>\r
526 <DD><DL>\r
527 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#begin(int)">begin</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
528 </DD>\r
529 <DD><DL>\r
530 <DT><B>Parameters:</B><DD><CODE>size</CODE> - the size of data between now and the end</DL>\r
531 </DD>\r
532 </DL>\r
533 <HR>\r
534 \r
535 <A NAME="end()"><!-- --></A><H3>\r
536 end</H3>\r
537 <PRE>\r
538 public boolean <B>end</B>()</PRE>\r
539 <DL>\r
540 <DD>Marks the end of a set of data\r
541 <P>\r
542 <DD><DL>\r
543 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#end()">end</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
544 </DD>\r
545 <DD><DL>\r
546
547 <DT><B>Returns:</B><DD><code>true</code> if the audio was output properly, 
548                 <code> false</code> if the output was canceled 
549                 or interrupted.</DL>\r
550 </DD>\r
551 </DL>\r
552 <HR>\r
553 \r
554 <A NAME="write(byte[], int, int)"><!-- --></A><H3>\r
555 write</H3>\r
556 <PRE>\r
557 public boolean <B>write</B>(byte[]&nbsp;bytes,
558                      int&nbsp;offset,
559                      int&nbsp;size)</PRE>\r
560 <DL>\r
561 <DD>Writes the given bytes to the audio stream\r
562 <P>\r
563 <DD><DL>\r
564 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#write(byte[], int, int)">write</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
565 </DD>\r
566 <DD><DL>\r
567 <DT><B>Parameters:</B><DD><CODE>bytes</CODE> - audio data to write to the device<DD><CODE>offset</CODE> - the offset into the buffer<DD><CODE>size</CODE> - the size into the buffer
568 <DT><B>Returns:</B><DD><code>true</code> of the write completed successfully, 
569         <code> false </code>if the write was cancelled.</DL>\r
570 </DD>\r
571 </DL>\r
572 <HR>\r
573 \r
574 <A NAME="startFirstSampleTimer()"><!-- --></A><H3>\r
575 startFirstSampleTimer</H3>\r
576 <PRE>\r
577 public void <B>startFirstSampleTimer</B>()</PRE>\r
578 <DL>\r
579 <DD>Starts the first sample timer\r
580 <P>\r
581 <DD><DL>\r
582 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#startFirstSampleTimer()">startFirstSampleTimer</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
583 </DD>\r
584 <DD><DL>\r
585 </DL>\r
586 </DD>\r
587 </DL>\r
588 <HR>\r
589 \r
590 <A NAME="drain()"><!-- --></A><H3>\r
591 drain</H3>\r
592 <PRE>\r
593 public boolean <B>drain</B>()</PRE>\r
594 <DL>\r
595 <DD>Waits for all queued audio to be played\r
596 <P>\r
597 <DD><DL>\r
598 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#drain()">drain</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
599 </DD>\r
600 <DD><DL>\r
601
602 <DT><B>Returns:</B><DD><code>true</code> if the audio played to completion,
603         <code> false </code>if the audio was stopped</DL>\r
604 </DD>\r
605 </DL>\r
606 <HR>\r
607 \r
608 <A NAME="getTime()"><!-- --></A><H3>\r
609 getTime</H3>\r
610 <PRE>\r
611 public long <B>getTime</B>()</PRE>\r
612 <DL>\r
613 <DD>Gets the amount of played since the last resetTime
614  Currently not supported.\r
615 <P>\r
616 <DD><DL>\r
617 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#getTime()">getTime</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
618 </DD>\r
619 <DD><DL>\r
620
621 <DT><B>Returns:</B><DD>the amount of audio in milliseconds</DL>\r
622 </DD>\r
623 </DL>\r
624 <HR>\r
625 \r
626 <A NAME="resetTime()"><!-- --></A><H3>\r
627 resetTime</H3>\r
628 <PRE>\r
629 public void <B>resetTime</B>()</PRE>\r
630 <DL>\r
631 <DD>Resets the audio clock\r
632 <P>\r
633 <DD><DL>\r
634 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#resetTime()">resetTime</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
635 </DD>\r
636 <DD><DL>\r
637 </DL>\r
638 </DD>\r
639 </DL>\r
640 <HR>\r
641 \r
642 <A NAME="showMetrics()"><!-- --></A><H3>\r
643 showMetrics</H3>\r
644 <PRE>\r
645 public void <B>showMetrics</B>()</PRE>\r
646 <DL>\r
647 <DD>Shows metrics for this audio player\r
648 <P>\r
649 <DD><DL>\r
650 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html#showMetrics()">showMetrics</A></CODE> in interface <CODE><A HREF="../../../../../com/sun/speech/freetts/audio/AudioPlayer.html" title="interface in com.sun.speech.freetts.audio">AudioPlayer</A></CODE></DL>\r
651 </DD>\r
652 <DD><DL>\r
653 </DL>\r
654 </DD>\r
655 </DL>\r
656 <!-- ========= END OF CLASS DATA ========= -->\r
657 <HR>\r
658 \r
659
660 <!-- ======= START OF BOTTOM NAVBAR ====== -->\r
661 <A NAME="navbar_bottom"><!-- --></A>
662 <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
663 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">\r
664 <TR>\r
665 <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">\r
666 <A NAME="navbar_bottom_firstrow"><!-- --></A>
667 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">\r
668   <TR ALIGN="center" VALIGN="top">\r
669   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>\r
670   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>\r
671   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>\r
672   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>\r
673   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>\r
674   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>\r
675   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>\r
676   </TR>\r
677 </TABLE>\r
678 </TD>\r
679 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>\r
680 </EM>\r
681 </TD>\r
682 </TR>\r
683 \r
684 <TR>\r
685 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">\r
686 &nbsp;<A HREF="../../../../../com/sun/speech/freetts/audio/NullAudioPlayer.html" title="class in com.sun.speech.freetts.audio"><B>PREV CLASS</B></A>&nbsp;\r
687 &nbsp;<A HREF="../../../../../com/sun/speech/freetts/audio/SingleFileAudioPlayer.html" title="class in com.sun.speech.freetts.audio"><B>NEXT CLASS</B></A></FONT></TD>\r
688 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">\r
689   <A HREF="../../../../../index.html" target="_top"><B>FRAMES</B></A>  &nbsp;\r
690 &nbsp;<A HREF="RawFileAudioPlayer.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;\r
691 &nbsp;<SCRIPT type="text/javascript">\r
692   <!--\r
693   if(window==top) {\r
694     document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');\r
695   }\r
696   //-->\r
697 </SCRIPT>\r
698 <NOSCRIPT>\r
699   <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>\r
700 </NOSCRIPT>
701 \r
702 </FONT></TD>\r
703 </TR>\r
704 <TR>\r
705 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">\r
706   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>\r
707 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">\r
708 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>\r
709 </TR>\r
710 </TABLE>\r
711 <A NAME="skip-navbar_bottom"></A>
712 <!-- ======== END OF BOTTOM NAVBAR ======= -->\r
713 \r
714 <HR>\r
715 \r
716 </BODY>\r
717 </HTML>\r