/* |
|
* Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved. |
|
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
|
* |
|
* This code is free software; you can redistribute it and/or modify it |
|
* under the terms of the GNU General Public License version 2 only, as |
|
* published by the Free Software Foundation. Oracle designates this |
|
* particular file as subject to the "Classpath" exception as provided |
|
* by Oracle in the LICENSE file that accompanied this code. |
|
* |
|
* This code is distributed in the hope that it will be useful, but WITHOUT |
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
* version 2 for more details (a copy is included in the LICENSE file that |
|
* accompanied this code). |
|
* |
|
* You should have received a copy of the GNU General Public License version |
|
* 2 along with this work; if not, write to the Free Software Foundation, |
|
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
|
* |
|
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
|
* or visit www.oracle.com if you need additional information or have any |
|
* questions. |
|
*/ |
|
package com.sun.media.sound; |
|
import java.io.File; |
|
import java.io.InputStream; |
|
import java.io.IOException; |
|
import java.io.DataInputStream; |
|
import java.net.URL; |
|
import javax.sound.sampled.AudioFileFormat; |
|
import javax.sound.sampled.AudioInputStream; |
|
import javax.sound.sampled.UnsupportedAudioFileException; |
|
import javax.sound.sampled.spi.AudioFileReader; |
|
/** |
|
* Abstract File Reader class. |
|
* |
|
* @author Jan Borgersen |
|
*/ |
|
abstract class SunFileReader extends AudioFileReader { |
|
// buffer size for temporary input streams |
|
protected static final int bisBufferSize = 4096; |
|
/** |
|
* Constructs a new SunFileReader object. |
|
*/ |
|
SunFileReader() { |
|
} |
|
// METHODS TO IMPLEMENT AudioFileReader |
|
/** |
|
* Obtains the audio file format of the input stream provided. The stream must |
|
* point to valid audio file data. In general, audio file providers may |
|
* need to read some data from the stream before determining whether they |
|
* support it. These parsers must |
|
* be able to mark the stream, read enough data to determine whether they |
|
* support the stream, and, if not, reset the stream's read pointer to its original |
|
* position. If the input stream does not support this, this method may fail |
|
* with an IOException. |
|
* @param stream the input stream from which file format information should be |
|
* extracted |
|
* @return an <code>AudioFileFormat</code> object describing the audio file format |
|
* @throws UnsupportedAudioFileException if the stream does not point to valid audio |
|
* file data recognized by the system |
|
* @throws IOException if an I/O exception occurs |
|
* @see InputStream#markSupported |
|
* @see InputStream#mark |
|
*/ |
|
abstract public AudioFileFormat getAudioFileFormat(InputStream stream) throws UnsupportedAudioFileException, IOException; |
|
/** |
|
* Obtains the audio file format of the URL provided. The URL must |
|
* point to valid audio file data. |
|
* @param url the URL from which file format information should be |
|
* extracted |
|
* @return an <code>AudioFileFormat</code> object describing the audio file format |
|
* @throws UnsupportedAudioFileException if the URL does not point to valid audio |
|
* file data recognized by the system |
|
* @throws IOException if an I/O exception occurs |
|
*/ |
|
abstract public AudioFileFormat getAudioFileFormat(URL url) throws UnsupportedAudioFileException, IOException; |
|
/** |
|
* Obtains the audio file format of the File provided. The File must |
|
* point to valid audio file data. |
|
* @param file the File from which file format information should be |
|
* extracted |
|
* @return an <code>AudioFileFormat</code> object describing the audio file format |
|
* @throws UnsupportedAudioFileException if the File does not point to valid audio |
|
* file data recognized by the system |
|
* @throws IOException if an I/O exception occurs |
|
*/ |
|
abstract public AudioFileFormat getAudioFileFormat(File file) throws UnsupportedAudioFileException, IOException; |
|
/** |
|
* Obtains an audio stream from the input stream provided. The stream must |
|
* point to valid audio file data. In general, audio file providers may |
|
* need to read some data from the stream before determining whether they |
|
* support it. These parsers must |
|
* be able to mark the stream, read enough data to determine whether they |
|
* support the stream, and, if not, reset the stream's read pointer to its original |
|
* position. If the input stream does not support this, this method may fail |
|
* with an IOException. |
|
* @param stream the input stream from which the <code>AudioInputStream</code> should be |
|
* constructed |
|
* @return an <code>AudioInputStream</code> object based on the audio file data contained |
|
* in the input stream. |
|
* @throws UnsupportedAudioFileException if the stream does not point to valid audio |
|
* file data recognized by the system |
|
* @throws IOException if an I/O exception occurs |
|
* @see InputStream#markSupported |
|
* @see InputStream#mark |
|
*/ |
|
abstract public AudioInputStream getAudioInputStream(InputStream stream) throws UnsupportedAudioFileException, IOException; |
|
/** |
|
* Obtains an audio stream from the URL provided. The URL must |
|
* point to valid audio file data. |
|
* @param url the URL for which the <code>AudioInputStream</code> should be |
|
* constructed |
|
* @return an <code>AudioInputStream</code> object based on the audio file data pointed |
|
* to by the URL |
|
* @throws UnsupportedAudioFileException if the URL does not point to valid audio |
|
* file data recognized by the system |
|
* @throws IOException if an I/O exception occurs |
|
*/ |
|
abstract public AudioInputStream getAudioInputStream(URL url) throws UnsupportedAudioFileException, IOException; |
|
/** |
|
* Obtains an audio stream from the File provided. The File must |
|
* point to valid audio file data. |
|
* @param file the File for which the <code>AudioInputStream</code> should be |
|
* constructed |
|
* @return an <code>AudioInputStream</code> object based on the audio file data pointed |
|
* to by the File |
|
* @throws UnsupportedAudioFileException if the File does not point to valid audio |
|
* file data recognized by the system |
|
* @throws IOException if an I/O exception occurs |
|
*/ |
|
abstract public AudioInputStream getAudioInputStream(File file) throws UnsupportedAudioFileException, IOException; |
|
// HELPER METHODS |
|
/** |
|
* rllong |
|
* Protected helper method to read 64 bits and changing the order of |
|
* each bytes. |
|
* @param DataInputStream |
|
* @return 32 bits swapped value. |
|
* @exception IOException |
|
*/ |
|
final int rllong(DataInputStream dis) throws IOException { |
|
int b1, b2, b3, b4 ; |
|
int i = 0; |
|
i = dis.readInt(); |
|
b1 = ( i & 0xFF ) << 24 ; |
|
b2 = ( i & 0xFF00 ) << 8; |
|
b3 = ( i & 0xFF0000 ) >> 8; |
|
b4 = ( i & 0xFF000000 ) >>> 24; |
|
i = ( b1 | b2 | b3 | b4 ); |
|
return i; |
|
} |
|
/** |
|
* big2little |
|
* Protected helper method to swap the order of bytes in a 32 bit int |
|
* @param int |
|
* @return 32 bits swapped value |
|
*/ |
|
final int big2little(int i) { |
|
int b1, b2, b3, b4 ; |
|
b1 = ( i & 0xFF ) << 24 ; |
|
b2 = ( i & 0xFF00 ) << 8; |
|
b3 = ( i & 0xFF0000 ) >> 8; |
|
b4 = ( i & 0xFF000000 ) >>> 24; |
|
i = ( b1 | b2 | b3 | b4 ); |
|
return i; |
|
} |
|
/** |
|
* rlshort |
|
* Protected helper method to read 16 bits value. Swap high with low byte. |
|
* @param DataInputStream |
|
* @return the swapped value. |
|
* @exception IOException |
|
*/ |
|
final short rlshort(DataInputStream dis) throws IOException { |
|
short s=0; |
|
short high, low; |
|
s = dis.readShort(); |
|
high = (short)(( s & 0xFF ) << 8) ; |
|
low = (short)(( s & 0xFF00 ) >>> 8); |
|
s = (short)( high | low ); |
|
return s; |
|
} |
|
/** |
|
* big2little |
|
* Protected helper method to swap the order of bytes in a 16 bit short |
|
* @param int |
|
* @return 16 bits swapped value |
|
*/ |
|
final short big2littleShort(short i) { |
|
short high, low; |
|
high = (short)(( i & 0xFF ) << 8) ; |
|
low = (short)(( i & 0xFF00 ) >>> 8); |
|
i = (short)( high | low ); |
|
return i; |
|
} |
|
/** Calculates the frame size for PCM frames. |
|
* Note that this method is appropriate for non-packed samples. |
|
* For instance, 12 bit, 2 channels will return 4 bytes, not 3. |
|
* @param sampleSizeInBits the size of a single sample in bits |
|
* @param channels the number of channels |
|
* @return the size of a PCM frame in bytes. |
|
*/ |
|
static final int calculatePCMFrameSize(int sampleSizeInBits, int channels) { |
|
return ((sampleSizeInBits + 7) / 8) * channels; |
|
} |
|
} |