1 import java.awt.image.SampleModel;
\r
3 import FileOutputStream;
\r
6 * 11/19/04 1.0 moved to LGPL.
\r
7 * 29/01/00 Initial version. mdm@techie.com
\r
8 *-----------------------------------------------------------------------
\r
9 * This program is free software; you can redistribute it and/or modify
\r
10 * it under the terms of the GNU Library General Public License as published
\r
11 * by the Free Software Foundation; either version 2 of the License, or
\r
12 * (at your option) any later version.
\r
14 * This program is distributed in the hope that it will be useful,
\r
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
\r
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
\r
17 * GNU Library General Public License for more details.
\r
19 * You should have received a copy of the GNU Library General Public
\r
20 * License along with this program; if not, write to the Free Software
\r
21 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
\r
22 *----------------------------------------------------------------------
\r
26 * The <code>Player</code> class implements a simple player for playback of an
\r
27 * MPEG audio stream.
\r
29 * @author Mat McGowan
\r
33 // REVIEW: the audio device should not be opened until the
\r
34 // first MPEG audio frame has been decoded.
\r
35 @LATTICE("B<DE,DE<ST,DE<HE,HE<ST,ST<FR")
\r
36 public class Player {
\r
38 * The current frame number.
\r
41 private int frame = 0;
\r
44 * The MPEG audio bitstream.
\r
46 // private Bitstream bitstream;
\r
49 * The MPEG audio decoder.
\r
51 /* final */@LOC("DE")
\r
52 private Decoder decoder;
\r
55 * The AudioDevice the audio samples are written to.
\r
57 // private AudioDevice audio;
\r
60 * Has the player been closed?
\r
63 private boolean closed = false;
\r
66 * Has the player played back all frames from the stream?
\r
69 private boolean complete = false;
\r
72 private int lastPosition = 0;
\r
75 private long sampleNumber;
\r
78 * Creates a new <code>Player</code> instance.
\r
80 public Player() throws JavaLayerException {
\r
84 public Player(AudioDevice device) throws JavaLayerException {
\r
85 // bitstream = new Bitstream(stream);
\r
86 decoder = new Decoder();
\r
88 // if (device!=null)
\r
94 // FactoryRegistry r = FactoryRegistry.systemRegistry();
\r
95 // audio = r.createAudioDevice();
\r
98 device.open(decoder);
\r
101 public void play() throws JavaLayerException {
\r
102 play(Integer.MAX_VALUE);
\r
106 * Plays a number of MPEG audio frames.
\r
109 * The number of frames to play.
\r
110 * @return true if the last frame was played, or false if there are more
\r
113 @LATTICE("OUT<THIS,THIS<IN,IN*,THISLOC=THIS")
\r
115 public boolean play(@LOC("IN") int frames) throws JavaLayerException {
\r
116 @LOC("OUT") boolean ret = true;
\r
118 // initialization before ssjava loop
\r
119 @LOC("THIS,Player.FR") boolean init = true;
\r
120 @LOC("THIS,Player.ST") Header h = BitstreamWrapper.readFrame();
\r
124 System.out.println("Gobble sentinel: +++");
\r
126 @LOC("IN") int count = 0;
\r
127 SSJAVA: while (count++ < 2147483646) {
\r
131 ret = decodeFrame(init, h);
\r
135 h = BitstreamWrapper.readFrame();
\r
139 * if (!ret) { // last frame, ensure all data flushed to the audio device.
\r
140 * AudioDevice out = audio; if (out!=null) { out.flush(); synchronized
\r
141 * (this) { complete = (!closed); close(); } } }
\r
147 * Cloases this player. Any audio currently playing is stopped immediately.
\r
150 public synchronized void close() {
\r
152 * AudioDevice out = audio; if (out!=null) { closed = true; audio = null; //
\r
153 * this may fail, so ensure object state is set up before // calling this
\r
154 * method. out.close(); lastPosition = out.getPosition(); try {
\r
155 * bitstream.close(); } catch (BitstreamException ex) { } }
\r
160 * Returns the completed status of this player.
\r
162 * @return true if all available MPEG audio frames have been decoded, or false
\r
165 public synchronized boolean isComplete() {
\r
170 * Retrieves the position in milliseconds of the current audio sample being
\r
171 * played. This method delegates to the <code>
\r
172 * AudioDevice</code> that is used by this player to sound the decoded audio
\r
175 public int getPosition() {
\r
176 // int position = lastPosition;
\r
178 // AudioDevice out = audio;
\r
181 // position = out.getPosition();
\r
183 // return position;
\r
188 * Decodes a single frame.
\r
190 * @return true if there are no more frames to decode, false otherwise.
\r
192 @LATTICE("C<THIS,O<THIS,THIS<IN,C*,THISLOC=THIS,RETURNLOC=O,GLOBALLOC=THIS")
\r
193 protected boolean decodeFrame(@LOC("THIS,Player.FR") boolean init, @LOC("THIS,Player.ST") Header h)
\r
194 throws JavaLayerException {
\r
196 // AudioDevice out = audio;
\r
200 // Header h = bitstream.readFrame();
\r
206 // @LOC("O") SampleBuffer output = (SampleBuffer) decoder.decodeFrame(h);
\r
207 decoder.decodeFrame(h);
\r
210 // synchronized (this)
\r
215 // out.write(output.getBuffer(), 0, output.getBufferLength());
\r
219 // bitstream.closeFrame();
\r
220 } catch (RuntimeException ex) {
\r
221 throw new JavaLayerException("Exception decoding audio frame", ex);
\r
224 * catch (IOException ex) {
\r
225 * System.out.println("exception decoding audio frame: "+ex); return false;
\r
226 * } catch (BitstreamException bitex) {
\r
227 * System.out.println("exception decoding audio frame: "+bitex); return
\r
228 * false; } catch (DecoderException decex) {
\r
229 * System.out.println("exception decoding audio frame: "+decex); return
\r
236 public void DEBUG_OUTPUT() {
\r
237 // it looks like there is left and right channel interleaved into the
\r
238 // output buffer, so only sample one channel (stride=2)
\r
239 short[] outbuf = SampleBufferWrapper.getBuffer();
\r
240 for (int i = 0; i < SampleBufferWrapper.getBufferLength(); i = i + 2) {
\r
241 System.out.println(sampleNumber + " " + outbuf[i]);
\r