ameba.captcha.audio

类 Sample

java.lang.Object

ameba.captcha.audio.Sample

public class Sample
extends Object

Class representing a sound sample, typically read in from a file. Note that at this time this class only supports wav files with the following characteristics:

• Sample rate: 16KHz
• Sample size: 16 bits
• Channels: 1
• Signed: true
• Big Endian: false

Data files in other formats will cause an IllegalArgumentException to be thrown.

作者:

James Childers

字段概要

字段

限定符和类型	字段和说明
static AudioFormat	SC_AUDIO_FORMAT

构造器概要

构造器

构造器和说明
Sample(InputStream is)

方法概要

方法

限定符和类型	方法和说明
byte[]	asByteArray() Return the interleaved samples as a byte[].
static byte[]	asByteArray(long sampleCount, double[] sample) Helper method to convert a double[] to a byte[] in a format that can be used by AudioInputStream.
void	decodeBytes(byte[] audioBytes, double[] audioSamples)
AudioInputStream	getAudioInputStream()
void	getChannelSamples(int channel, double[] interleavedSamples, double[] channelSamples) Extract samples of a particular channel from interleavedSamples and copy them into channelSamples
AudioFormat	getFormat()
double[]	getInterleavedSamples()
double[]	getInterleavedSamples(long begin, long end, double[] samples) Get the interleaved decoded samples for all channels, from sample index begin (included) to sample index end (excluded) and copy them into samples.
long	getSampleCount() Return the number of samples of all channels
void	getStereoSamples(double[] leftSamples, double[] rightSamples) Convenience method.
String	toString()

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细资料

SC_AUDIO_FORMAT

public static final AudioFormat SC_AUDIO_FORMAT

构造器详细资料

Sample

public Sample(InputStream is)

方法详细资料

asByteArray

public static final byte[] asByteArray(long sampleCount,
                 double[] sample)

Helper method to convert a double[] to a byte[] in a format that can be used by AudioInputStream. Typically this will be used with a Sample that has been modified from its original.

参数:

sample - sample

sampleCount - sampleCount

返回:

A byte[] representing a sample

另请参阅:

Yak Shaving

getAudioInputStream

public AudioInputStream getAudioInputStream()

getFormat

public AudioFormat getFormat()

getSampleCount

public long getSampleCount()

Return the number of samples of all channels

返回:

The number of samples for all channels

getInterleavedSamples

public double[] getInterleavedSamples()

getInterleavedSamples

public double[] getInterleavedSamples(long begin,
                             long end,
                             double[] samples)
                               throws IOException,
                                      IllegalArgumentException

Get the interleaved decoded samples for all channels, from sample index begin (included) to sample index end (excluded) and copy them into samples. end must not exceed getSampleCount(), and the number of samples must not be so large that the associated byte array cannot be allocated

参数:

begin - begin

end - end

samples - samples

返回:

samples bytes

抛出:

IOException - IOException

IllegalArgumentException - IllegalArgumentException

getChannelSamples

public void getChannelSamples(int channel,
                     double[] interleavedSamples,
                     double[] channelSamples)

Extract samples of a particular channel from interleavedSamples and copy them into channelSamples

参数:

channel - channel

interleavedSamples - interleavedSamples

channelSamples - channelSamples

getStereoSamples

public void getStereoSamples(double[] leftSamples,
                    double[] rightSamples)
                      throws IOException

Convenience method. Extract left and right channels for common stereo files. leftSamples and rightSamples must be of size getSampleCount()

参数:

leftSamples - leftSamples

rightSamples - rightSamples

抛出:

IOException - IOException

decodeBytes

public void decodeBytes(byte[] audioBytes,
               double[] audioSamples)

asByteArray

public final byte[] asByteArray()

Return the interleaved samples as a byte[].

返回:

The interleaved samples

toString

public String toString()

覆盖:

toString 在类中 Object