eu.bandm.sig.adlib

Class DataLineSink

java.lang.Object

eu.bandm.sig.adlib.DataLineSink

All Implemented Interfaces:

CompilableControlFlow, Realtime, Runnable

public class DataLineSink
extends Object
implements Realtime

This class realizes the connection between sig/adlib sound streams and one output channel of the Java runtime sound system.

ATTENTION This version is intented to be used in "real-time" with an execution "As Fast as Possible". It "sleeps()" when the (hardware) output line block, thus introducing the real time sampling rate into the execution of the network. This is correct FOR PARTICULAR USECASES, but NOT in general (e.g. when also blocking input channels are read by the sig network.)
FIXME split this code into segments/co-processes/threads and re-arrange them for these other use cases.
The output channel is an instance of SourceDataLine.
It must have been allocated from the sound system and comes with one particular fixed AudioFormat. This includes bit-depth, sampling rate and number of channels. If one of these parameter values is not supported by the current implementation, an IllegalArgumentException is thrown. (Esp. the number of FloatSignalSources applied to the constructor must correspond exactly to the number of channels of the output format.)
ml 20180222 umgearbeitet auf >1 ausgabekanal

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_BUFFER_SIZE
static long	DEFAULT_SLEEP_TIME_MS

Fields inherited from interface eu.bandm.sig.adlib.Realtime

DEFAULT_AFAP_INTERRUPT_LATENCY

Constructor Summary

Constructors

Constructor and Description
DataLineSink(FloatSignalSource source, SourceDataLine line) Deprecated.
DataLineSink(FloatSignalSource source, SourceDataLine line, int bufferSize) Deprecated.
DataLineSink(SourceDataLine line, FloatSignalSource... sources)
DataLineSink(SourceDataLine line, int bufferSize, FloatSignalSource... sources)

Method Summary

Modifier and Type	Method and Description
static AudioFormat	makeAudioFormat(float sampleFreq) Deprecated.
void	run() Processes an event.

Methods inherited from class java.lang.Object

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

Methods inherited from interface eu.bandm.sig.adlib.Realtime

adHoc, afap, afap, andThen, asAsynchronousSwingEvent, compileControlFlow, every, every, frequently, frequently, frequently, sequence, times, times

Field Detail

DEFAULT_BUFFER_SIZE

public static final int DEFAULT_BUFFER_SIZE

See Also:

Constant Field Values

DEFAULT_SLEEP_TIME_MS

public static final long DEFAULT_SLEEP_TIME_MS

See Also:

Constant Field Values

Constructor Detail

DataLineSink

@Deprecated
public DataLineSink(FloatSignalSource source,
                                SourceDataLine line)

Deprecated.

DataLineSink

public DataLineSink(SourceDataLine line,
                    FloatSignalSource... sources)

DataLineSink

@Deprecated
public DataLineSink(FloatSignalSource source,
                                SourceDataLine line,
                                int bufferSize)

Deprecated.

DataLineSink

public DataLineSink(SourceDataLine line,
                    int bufferSize,
                    FloatSignalSource... sources)

Method Detail

makeAudioFormat

@Deprecated
public static AudioFormat makeAudioFormat(float sampleFreq)

Deprecated.

The delivered Audioformat encapsulates sample frequncy, word width (here const =16), number of channels (here const =1), signed (here const=true), bigEndian (here const=true).

run

public void run()

Description copied from interface: Realtime

Processes an event.

Any implementation of this method should complete promptly and normally. In particular it must not block indefinitely.

Specified by:

run in interface Realtime

Specified by:

run in interface Runnable