Class LameStream

java.lang.Object

net.avadeaux.klipspringer.codec.ExternalEncodedStream

net.avadeaux.klipspringer.codec.LameStream

All Implemented Interfaces:

Closeable, AutoCloseable, AudioStream, Device.Player, PcmWriter

public class LameStream
extends ExternalEncodedStream

Audio stream that sends MP3 encoded data to a channel. Also doubles as file encoder class when created via fileEncoder.

Nested Class Summary

Nested classes/interfaces inherited from interface net.avadeaux.klipspringer.codec.AudioStream

AudioStream.Factory

Field Summary

Fields

Modifier and Type	Field	Description
static final Device.BitLayout	BIT_LAYOUT	The bit layout for PCM data sent to an MP3 stream.

Constructor Summary

Constructors

Constructor	Description
LameStream(PcmFormat format, int bitrate, int quality, int bufferFrames, double writeaheadSecs, double timeoutSecs, WritableByteChannel channel, Executor keepAlivePool, double keepAliveTimeoutSecs)	Creates a FLAC stream with the given specifications and destination channel.

Method Summary

Modifier and Type	Method	Description
static PcmWriter	fileEncoder(String fileName, PcmFormat dataFormat, int bitrate, int quality)	Gets a player that encodes to a file rather than a stream.
Device.BitLayout	layout()	Gets the bit layout expected by the player.
String	quality()	Gets the bitrate specified for this stream.
static PcmFormat	selectFormat(AudioFormat fmt)	Selects format suitable for LAME streaming with the same semantics as PcmFormat.Selector.selectFormat(AudioFormat).

Methods inherited from class net.avadeaux.klipspringer.codec.ExternalEncodedStream

close, drain, format, playedMillis, streaming, write

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.avadeaux.klipspringer.codec.Device.Player

bufferedFrames, canPause, pause, unpause

Field Details

BIT_LAYOUT

public static final Device.BitLayout BIT_LAYOUT

The bit layout for PCM data sent to an MP3 stream.

Constructor Details

LameStream

public LameStream(PcmFormat format,
 int bitrate,
 int quality,
 int bufferFrames,
 double writeaheadSecs,
 double timeoutSecs,
 WritableByteChannel channel,
 Executor keepAlivePool,
 double keepAliveTimeoutSecs)
           throws IOException

Creates a FLAC stream with the given specifications and destination channel.

If keepAliveExec is non-null, it is used by ExternalEncodedStream.close() to execute a wait loop that terminates when either the recipient has sent callback notification of having played (almost) all the data it has been sent, or no callback is made for keepAliveTimeoutSecs seconds. (See also ExternalEncodedStream.drain().)

Throws:

IOException

Method Details

selectFormat

public static PcmFormat selectFormat(AudioFormat fmt)
                              throws UnsupportedFormatException

Selects format suitable for LAME streaming with the same semantics as PcmFormat.Selector.selectFormat(AudioFormat).

Throws:

UnsupportedFormatException

layout

public Device.BitLayout layout()

Description copied from interface: Device.Player

Gets the bit layout expected by the player. If the player is produced by a Factory, the layout should match the value returned by Device.Player.Factory.layout(PcmFormat), and if the player is associated with a device, this should match what is returned by Device.layout(PcmFormat). Default returns Device.BitLayout.LSB. Default returns Device.BitLayout.LSB.

quality

public String quality()

Gets the bitrate specified for this stream.

fileEncoder

public static PcmWriter fileEncoder(String fileName,
 PcmFormat dataFormat,
 int bitrate,
 int quality)
                             throws IOException

Gets a player that encodes to a file rather than a stream.

Throws:

IOException