com.jsyn.util

Class SampleLoader

java.lang.Object

com.jsyn.util.SampleLoader

public class SampleLoader
extends java.lang.Object

Load a FloatSample from various sources. The default loader uses custom code to load WAV or AIF files. Supported data formats are 16, 24 and 32 bit PCM, and 32-bit float. Compressed formats such as unsigned 8-bit, uLaw, A-Law and MP3 are not support. If you need to load one of those files try setJavaSoundPreferred(true). Or convert it to a supported format using Audacity or Sox or some other sample file tool. Here is an example of loading a sample from a file.

 
     File sampleFile = new File("guitar.wav");
     FloatSample sample = SampleLoader.loadFloatSample( sampleFile );
 
 

Author:

Phil Burk (C) 2011 Mobileer Inc

Constructor Summary

Constructors

Constructor and Description
SampleLoader()

Method Summary

Modifier and Type	Method and Description
static void	decodeBigF32ToF32(byte[] audioBytes, int offset, int numBytes, float[] data, int outputOffset)
static void	decodeBigI16ToF32(byte[] audioBytes, int offset, int numBytes, float[] data, int outputOffset)
static void	decodeBigI24ToF32(byte[] audioBytes, int offset, int numBytes, float[] data, int outputOffset) Decode 24 bit samples from a BigEndian byte array into a float array.
static void	decodeBigI32ToF32(byte[] audioBytes, int offset, int numBytes, float[] data, int outputOffset)
static void	decodeLittleF32ToF32(byte[] audioBytes, int offset, int numBytes, float[] data, int outputOffset)
static void	decodeLittleI16ToF32(byte[] audioBytes, int offset, int numBytes, float[] data, int outputOffset)
static void	decodeLittleI24ToF32(byte[] audioBytes, int offset, int numBytes, float[] data, int outputOffset)
static void	decodeLittleI32ToF32(byte[] audioBytes, int offset, int numBytes, float[] data, int outputOffset)
static boolean	isJavaSoundPreferred()
static FloatSample	loadFloatSample(java.io.File fileIn) Load a FloatSample from a File object.
static FloatSample	loadFloatSample(java.io.InputStream inputStream) Load a FloatSample from an InputStream.
static FloatSample	loadFloatSample(java.net.URL url) Load a FloatSample from a URL..
static void	setJavaSoundPreferred(boolean javaSoundPreferred) If set true then the audio file parser from JavaSound will be used.

Methods inherited from class java.lang.Object

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

Constructor Detail

SampleLoader

public SampleLoader()

Method Detail

loadFloatSample

public static FloatSample loadFloatSample(java.io.File fileIn)
                                   throws java.io.IOException

Load a FloatSample from a File object.

Throws:

java.io.IOException

loadFloatSample

public static FloatSample loadFloatSample(java.io.InputStream inputStream)
                                   throws java.io.IOException

Load a FloatSample from an InputStream. This is handy when loading Resources from a JAR file.

Throws:

java.io.IOException

loadFloatSample

public static FloatSample loadFloatSample(java.net.URL url)
                                   throws java.io.IOException

Load a FloatSample from a URL.. This is handy when loading Resources from a website.

Throws:

java.io.IOException

isJavaSoundPreferred

public static boolean isJavaSoundPreferred()

setJavaSoundPreferred

public static void setJavaSoundPreferred(boolean javaSoundPreferred)

If set true then the audio file parser from JavaSound will be used. Note that JavaSound cannot load audio files containing floating point data. But it may be able to load some compressed data formats such as uLaw. Note: JavaSound is not supported on Android.

Parameters:

javaSoundPreferred -

decodeBigI24ToF32

public static void decodeBigI24ToF32(byte[] audioBytes,
                                     int offset,
                                     int numBytes,
                                     float[] data,
                                     int outputOffset)

Decode 24 bit samples from a BigEndian byte array into a float array. The samples will be normalized into the range -1.0 to +1.0.

Parameters:

audioBytes - raw data from an audio file

offset - first element of byte array

numBytes - number of bytes to process

data - array to be filled with floats

outputOffset - first element of float array to be filled

decodeBigI16ToF32

public static void decodeBigI16ToF32(byte[] audioBytes,
                                     int offset,
                                     int numBytes,
                                     float[] data,
                                     int outputOffset)

decodeBigF32ToF32

public static void decodeBigF32ToF32(byte[] audioBytes,
                                     int offset,
                                     int numBytes,
                                     float[] data,
                                     int outputOffset)

decodeBigI32ToF32

public static void decodeBigI32ToF32(byte[] audioBytes,
                                     int offset,
                                     int numBytes,
                                     float[] data,
                                     int outputOffset)

decodeLittleF32ToF32

public static void decodeLittleF32ToF32(byte[] audioBytes,
                                        int offset,
                                        int numBytes,
                                        float[] data,
                                        int outputOffset)

decodeLittleI32ToF32

public static void decodeLittleI32ToF32(byte[] audioBytes,
                                        int offset,
                                        int numBytes,
                                        float[] data,
                                        int outputOffset)

decodeLittleI24ToF32

public static void decodeLittleI24ToF32(byte[] audioBytes,
                                        int offset,
                                        int numBytes,
                                        float[] data,
                                        int outputOffset)

decodeLittleI16ToF32

public static void decodeLittleI16ToF32(byte[] audioBytes,
                                        int offset,
                                        int numBytes,
                                        float[] data,
                                        int outputOffset)