com.tagtraum.jipes

Interface SignalPullProcessor<I,O>

Type Parameters:

I - type of the input values

O - type of the output values

All Superinterfaces:

SignalSource<O>

All Known Implementing Classes:

AbstractSignalProcessor, Aggregate, Channel, ConstantQTransform, DCT, Decimate, Downsample, FFT, FrameNumberFilter, IFFT, Interpolate, Mapping, Mel, Mono, MultiBand, NoopSignalProcessor, Novelty, OLA, Resample, SlidingWindow, Upsample

public interface SignalPullProcessor<I,O>
extends SignalSource<O>

Capable of processing a given object (most likely a data buffer of type I (input), for example a float[], and returning another object of type O (output). This processor follows the pull model, i.e. the data flow is controlled from the end of the processing pipeline. If your pipeline must contain forks/splits, to treat bands or channels separately, this is not a suitable approach. Consider using SignalProcessors in combination with a SignalSplit.

Typically you specify an SignalSource and set it as the generator for an SignalPullProcessor. Then call SignalSource.read() to pull the data through the SignalPullProcessor from the SignalSource.

Every pull processor is also a source. To apply multiple processing steps (e.g. stereo to mono, low pass filtering, downsampling), you can chain multiple processors.

Author:

Hendrik Schreiber

See Also:

SignalProcessor

Method Summary

Modifier and Type	Method and Description
<I2> SignalPullProcessor<I2,I>	connectTo(SignalPullProcessor<I2,I> source) Sets the source to use for this SignalPullProcessor.
void	connectTo(SignalSource<I> source) Sets the source to use for this SignalPullProcessor.
SignalSource<I>	getConnectedSource() Get the current source/generator.

Methods inherited from interface com.tagtraum.jipes.SignalSource

read, reset

Method Detail

connectTo

<I2> SignalPullProcessor<I2,I> connectTo(SignalPullProcessor<I2,I> source)

Sets the source to use for this SignalPullProcessor.

Because the method returns its parameter, it encourages method chaining to build processing chains/pipelines.

Type Parameters:

I2 - input type of the source processor

Parameters:

source - source

Returns:

the just set source, if it is a SignalPullProcessor

connectTo

void connectTo(SignalSource<I> source)

Sets the source to use for this SignalPullProcessor.

Parameters:

source - source

getConnectedSource

SignalSource<I> getConnectedSource()

Get the current source/generator.

Returns:

source