Module org.refcodes.audio

Package org.refcodes.audio

Interface SoundSampleWriter<B extends SoundSampleWriter<B>>

Type Parameters:

B - The SoundSampleWriter implementing this SoundSampleWriter.

All Superinterfaces:

AutoCloseable, org.refcodes.io.RowWriter<SoundSample>, SampleWriter<SoundSample,B>, SamplingRateAccessor, SamplingRateAccessor.SamplingRateBuilder<B>, SamplingRateAccessor.SamplingRateMutator, SamplingRateAccessor.SamplingRateProperty

All Known Implementing Classes:

CsvSoundSampleWriter, LineOutSoundSampleWriter, WavSoundSampleWriter

public interface SoundSampleWriter<B extends SoundSampleWriter<B>>
extends SampleWriter<SoundSample,B>

The SoundSampleWriter writes sound samples to a stream or a file.

Nested Class Summary

Nested classes/interfaces inherited from interface org.refcodes.audio.SamplingRateAccessor

SamplingRateAccessor.SamplingRateBuilder<B extends SamplingRateAccessor.SamplingRateBuilder<B>>, SamplingRateAccessor.SamplingRateMutator, SamplingRateAccessor.SamplingRateProperty

Method Summary

Modifier and Type	Method	Description
void	writeNext(double... aSample)	Writes the next samples, one sample for each channel.
void	writeNext(SoundSample aSample)	Writes the next samples, one sample for each channel.

Methods inherited from interface org.refcodes.audio.SampleWriter

close

Methods inherited from interface org.refcodes.audio.SamplingRateAccessor

getSamplingRate

Methods inherited from interface org.refcodes.audio.SamplingRateAccessor.SamplingRateBuilder

withSamplingRate

Methods inherited from interface org.refcodes.audio.SamplingRateAccessor.SamplingRateMutator

setSamplingRate

Methods inherited from interface org.refcodes.audio.SamplingRateAccessor.SamplingRateProperty

letSamplingRate

Method Details

writeNext

void writeNext(double... aSample)
        throws IOException

Writes the next samples, one sample for each channel. Provide one sample for mono audio, two samples for stereo audio and so on. In case you provide more or less samples than channels being supported by the writer, then it is up to the writer whether to duplicate the samples or calculate an average or the like.

Parameters:

aSample - The samples, one for each channel.

Throws:

IOException - thrown in case writing the sample caused an I/O related problem.

writeNext

void writeNext(SoundSample aSample)
        throws IOException

Writes the next samples, one sample for each channel. Provide one sample for mono audio, two samples for stereo audio and so on. In case you provide more or less samples than channels being supported by the writer, then it is up to the writer whether to duplicate the samples or calculate an average or the like.

Specified by:

writeNext in interface org.refcodes.io.RowWriter<B extends SoundSampleWriter<B>>

Specified by:

writeNext in interface SampleWriter<SoundSample,B extends SoundSampleWriter<B>>

Parameters:

aSample - The samples, one for each channel.

Throws:

IOException - thrown in case writing the sample caused an I/O related problem.