com.tagtraum.jipes.audio

Interface AudioSpectrum

All Superinterfaces:

AudioBuffer

All Known Implementing Classes:

AbstractAudioSpectrum, InstantaneousFrequencySpectrum, LinearFrequencySpectrum, LogFrequencySpectrum, MelSpectrum, MultiBandSpectrum

public interface AudioSpectrum
extends AudioBuffer

Read-only representation of an (audio) spectrum.

Date: 1/13/11 Time: 2:19 PM

Author:

Hendrik Schreiber

Method Summary

Modifier and Type	Method and Description
AudioSpectrum	derive(float[] real, float[] imaginary) Creates a copy of this spectrum, but replaces its values with the given real and imaginary data.
int	getBin(float frequency) Computes a bin/index number for the given frequency.
float[]	getFrequencies() Array with frequency values in Hz corresponding to the bin numbers.
float	getFrequency(int bin) Returns the frequency of a given bin.

Methods inherited from interface com.tagtraum.jipes.audio.AudioBuffer

clone, getAudioFormat, getData, getFrameNumber, getImaginaryData, getMagnitudes, getNumberOfSamples, getPowers, getRealData, getTimestamp, getTimestamp

Method Detail

getFrequencies

float[] getFrequencies()

Array with frequency values in Hz corresponding to the bin numbers.

This array is meant for reading only. Do not manipulate it!

Returns:

array with frequencies - length may be numberOfSamples/2 due to symmetry

See Also:

getFrequency(int)

getFrequency

float getFrequency(int bin)

Returns the frequency of a given bin. If you need the frequencies for the whole spectrum you might rather use getFrequencies(), as it is more efficient.

Parameters:

bin - bin number

Returns:

frequency in Hz

See Also:

getFrequencies()

getBin

int getBin(float frequency)

Computes a bin/index number for the given frequency.

Parameters:

frequency - frequency

Returns:

bin

derive

AudioSpectrum derive(float[] real,
                     float[] imaginary)

Creates a copy of this spectrum, but replaces its values with the given real and imaginary data. The original object remains unchanged.

Specified by:

derive in interface AudioBuffer

Parameters:

real - real data

imaginary - imaginary data

Returns:

derived copy