Package net.avadeaux.klipspringer.encoder

Class FlacChannelStreamLine

java.lang.Object

net.avadeaux.klipspringer.encoder.PlayerState

net.avadeaux.klipspringer.encoder.ChannelStreamLine

net.avadeaux.klipspringer.encoder.EncoderChannelStreamLine

net.avadeaux.klipspringer.encoder.FlacChannelStreamLine

All Implemented Interfaces:

AutoCloseable, DataLine, Line, SourceDataLine

public class FlacChannelStreamLine
extends EncoderChannelStreamLine

Channel stream line for FLAC encoding.

Nested Class Summary

Nested classes/interfaces inherited from class net.avadeaux.klipspringer.encoder.EncoderChannelStreamLine

EncoderChannelStreamLine.EncoderFactory

Nested classes/interfaces inherited from interface javax.sound.sampled.DataLine

DataLine.Info

Field Summary

Fields inherited from class net.avadeaux.klipspringer.encoder.EncoderChannelStreamLine

buf

Fields inherited from class net.avadeaux.klipspringer.encoder.ChannelStreamLine

bc, bips, bsam, byps, dsam, esam, fs

Constructor Summary

Constructors

Constructor	Description
FlacChannelStreamLine(WritableByteChannel bc, AudioFormat format, boolean ogg, int comprLev, long writeAheadMillis, long timeoutMillis, int bufferSamples, int clientbufBytes)	Constructs a line for encoding either native FLAC or Ogg FLAC.

Method Summary

Modifier and Type	Method	Description
protected void	finish(long handle)
protected void	free(long handle)
protected long	outputSamples(long handle)
int	write(byte[] b, int off, int len)
protected void	writeBuffer(long handle, int samples)

Methods inherited from class net.avadeaux.klipspringer.encoder.EncoderChannelStreamLine

available, bufferedSamples, close, finish, flush, getBufferSize, outputSamples, writeBuffer

Methods inherited from class net.avadeaux.klipspringer.encoder.ChannelStreamLine

addLineListener, drain, getControl, getControls, getFormat, getFramePosition, getLevel, getLineInfo, getLongFramePosition, getMicrosecondPosition, isActive, isControlSupported, isRunning, open, open, open, removeLineListener, start, stop

Methods inherited from class net.avadeaux.klipspringer.encoder.PlayerState

isOpen, onClose, playedMillis, playedMillis, waitForPlayed

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.sound.sampled.Line

isOpen

Constructor Details

FlacChannelStreamLine

public FlacChannelStreamLine(WritableByteChannel bc,
 AudioFormat format,
 boolean ogg,
 int comprLev,
 long writeAheadMillis,
 long timeoutMillis,
 int bufferSamples,
 int clientbufBytes)
                      throws IOException,
UnsupportedAudioFileException

Constructs a line for encoding either native FLAC or Ogg FLAC. The clientbufBytes parameter exists because FLAC playing in some web browser stalls if it has less than a certain number of bytes to play, presumably because they wait for a buffer to fill. Recommended value is at least 32000 if the reciever is a web browser, which can corresponds to minutes of audio for highly compressible data (like silence). It can be 0 if receiver is known not to wait for any buffer to fill up.

Parameters:

bc - the channel to stream to, which must be non-blocking

format - audio format of the PCM data written to this line

ogg - true for Ogg FLAC, false for native FLAC

comprLev - FLAC compression level

writeAheadMillis - limit for how much to write ahead of what receiver has played; use Long.MAX_VALUE for unlimited

timeoutMillis - time to wait when when write-ahead limit is reached

bufferSamples - size of line buffer in number of sample frames

clientbufBytes - at least the size of any receiver buffer size

Throws:

IOException

UnsupportedAudioFileException

Method Details

write

public int write(byte[] b,
 int off,
 int len)

writeBuffer

protected void writeBuffer(long handle,
 int samples)
                    throws IOException

Specified by:

writeBuffer in class EncoderChannelStreamLine

Throws:

IOException

finish

protected void finish(long handle)
               throws IOException

Specified by:

finish in class EncoderChannelStreamLine

Throws:

IOException

free

protected void free(long handle)

Specified by:

free in class EncoderChannelStreamLine

outputSamples

protected long outputSamples(long handle)

Specified by:

outputSamples in class EncoderChannelStreamLine