auditory.sampled

Class AbstractBufferedSoundBinaryOp

java.lang.Object

auditory.sampled.AbstractBufferedSoundOp

auditory.sampled.AbstractBufferedSoundBinaryOp

All Implemented Interfaces:

BufferedSoundBinaryOp

Direct Known Subclasses:

AddOp, MultiplyOp

public abstract class AbstractBufferedSoundBinaryOp
extends AbstractBufferedSoundOp
implements BufferedSoundBinaryOp

An abstract class that implements the BufferedSoundBinaryOp interface. This method can be extended by classes that want to implement the BufferedSoundBinaryOp interface.

Version:

1.0

Author:

Prof. David Bernstein, James Madison University

See Also:

"The Design and Implementation of Multimedia Software © 2011"

Constructor Summary

Constructors

Constructor and Description
AbstractBufferedSoundBinaryOp()

Method Summary

Modifier and Type	Method and Description
abstract void	applyFilter(double[] source1, double[] source2, double[] destination) Apply the filter (sample-by-sample).
void	applyFilter(java.util.Iterator<double[]> source1, java.util.Iterator<double[]> source2, java.util.Iterator<double[]> destination) Apply the filter to all of the channels.
BufferedSound	filter(BufferedSound src1, BufferedSound src2, BufferedSound dest) A two-source/one-destination filter.

Methods inherited from class auditory.sampled.AbstractBufferedSoundOp

createCompatibleDestinationSound

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractBufferedSoundBinaryOp

public AbstractBufferedSoundBinaryOp()

Method Detail

applyFilter

public abstract void applyFilter(double[] source1,
                                 double[] source2,
                                 double[] destination)

Apply the filter (sample-by-sample). This method must be implemented by concrete children.

Parameters:

source1 - The signal from source1

source2 - The signal from source2

destination - The destination signals

applyFilter

public void applyFilter(java.util.Iterator<double[]> source1,
                        java.util.Iterator<double[]> source2,
                        java.util.Iterator<double[]> destination)

Apply the filter to all of the channels.

Parameters:

source1 - The signals from source1

source2 - The signals from source2

destination - The destination signals

filter

public BufferedSound filter(BufferedSound src1,
                            BufferedSound src2,
                            BufferedSound dest)
                     throws java.lang.IllegalArgumentException

A two-source/one-destination filter. If the destination is null, a BufferedSound with an appropriate AudioFormat and length is created and returned.

Specified by:

filter in interface BufferedSoundBinaryOp

Parameters:

src1 - One operand (i.e., one sound to operate on)

src2 - The other operand (i.e., other sound to operate on)

dest - An empty sound to hold the result (or null)

Throws:

java.lang.IllegalArgumentException - if the sounds don't match