toxiclibs 0.9.1 → 0.9.2

data/src/toxi/audio/MultiTimbralManager.java

@@ -1,162 +0,0 @@
-/*
- *   __               .__       .__  ._____.           
- * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
- * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
- *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
- *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
- *                   \/       \/             \/     \/ 
- *
- * Copyright (c) 2006-2011 Karsten Schmidt
- * 
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2.1 of the License, or (at your option) any later version.
- * 
- * http://creativecommons.org/licenses/LGPL/2.1/
- * 
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Lesser General Public License for more details.
- * 
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the Free Software
- * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
-* Modified and updated by Martin Prout December 2015
- */
-
-package toxi.audio;
-
-import java.util.logging.Level;
-import java.util.logging.Logger;
-
-/**
- * Implements a manager to play a number of shared samples in a multitimbral
- * manner without interrupting/restarting the playback of currently playing
- * sources. This is different to the default JOAL way of accessing sources
- * directly. The manager is keeping track of active sources and will attempt to
- * assign free ones for newly requested playbacks. If all voices are active, the
- * oldest one will be stopped and used as the newly requested voice.
- */
-public class MultiTimbralManager {
-
-    static class SourceState {
-
-        AudioSource src;
-        boolean isActive;
-        long startTime;
-
-        SourceState(AudioSource src) {
-            this.src = src;
-        }
-
-        void activate() {
-            isActive = true;
-            startTime = System.currentTimeMillis();
-        }
-
-        boolean updateStatus() {
-            isActive = isActive
-                    && (src.isLooping() || src.getBuffersProcessed() == 0);
-            return isActive;
-        }
-    }
-
-    private static final Logger logger = Logger
-            .getLogger(MultiTimbralManager.class.getName());
-    protected SourceState[] pool;
-    protected int maxSources;
-
-    protected int currIndex;
-
-    public MultiTimbralManager(JOALUtil liboal, int num) {
-        logger.log(Level.INFO, "attempting to allocate {0} audio voices", num);
-        AudioSource[] tmp = liboal.generateSources(num);
-        maxSources = tmp.length;
-        pool = new SourceState[maxSources];
-        for (int i = 0; i < maxSources; i++) {
-            AudioSource src = tmp[i];
-            src.setReferenceDistance(100);
-            src.setGain(1);
-            pool[i] = new SourceState(src);
-        }
-        logger.info("done. all sources created.");
-    }
-
-    /**
-     * Uses the class' logger to print out status information about the current
-     * usage of the managed audio sources.
-     */
-    public void debug() {
-        String sources = "";
-        int numActive = 0;
-        for (int i = 0; i < maxSources; i++) {
-            if (pool[i].isActive) {
-                sources += i + ",";
-                numActive++;
-            }
-        }
-        String info = "active sources: " + numActive;
-        logger.info(info);
-        logger.info(sources);
-    }
-
-    /**
-     * Attempts to find an available, currently unused {@link AudioSource}
-     * instance which can then be configured and played by the client
-     * application. If no free source is available the oldest playing one will
-     * be stopped and returned as free.
-     * 
-     * @return a free AudioSource instance
-     */
-    public AudioSource getNextVoice() {
-        boolean hasFreeSource = false;
-        int numIterations = 0;
-        int origID = currIndex;
-        int id;
-        // find first free slot...
-        do {
-            id = currIndex;
-            currIndex = (currIndex + 1) % maxSources;
-            if (pool[id].isActive) {
-                if (!pool[id].updateStatus()) {
-                    hasFreeSource = true;
-                }
-            } else {
-                hasFreeSource = true;
-            }
-            numIterations++;
-        } while (!hasFreeSource && numIterations < maxSources);
-        // use oldest slot if no free one is available
-        if (!hasFreeSource) {
-            long now = System.currentTimeMillis();
-            id = origID;
-            for (int i = 0; i < maxSources; i++) {
-                if (pool[i].startTime < now) {
-                    id = i;
-                    now = pool[i].startTime;
-                }
-            }
-            pool[id].src.stop();
-            logger.log(Level.WARNING, "no free src, using oldest slot #{0}", id);
-            currIndex = (id + 1) % maxSources;
-        }
-        pool[id].activate();
-        return pool[id].src;
-    }
-
-    /**
-     * Produces an array of status flags of used voices. Elements set to true
-     * indicate the voice is currently active/playing.
-     * 
-     * @return boolean array
-     */
-    public boolean[] getUsage() {
-        boolean[] usage = new boolean[maxSources];
-        for (int i = 0; i < maxSources; i++) {
-            usage[i] = pool[i].isActive;
-        }
-        return usage;
-    }
-}

data/src/toxi/audio/SoundListener.java

@@ -1,154 +0,0 @@
-/*
- *   __               .__       .__  ._____.           
- * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
- * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
- *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
- *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
- *                   \/       \/             \/     \/ 
- *
- * Copyright (c) 2006-2011 Karsten Schmidt
- * 
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2.1 of the License, or (at your option) any later version.
- * 
- * http://creativecommons.org/licenses/LGPL/2.1/
- * 
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Lesser General Public License for more details.
- * 
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the Free Software
- * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
- * Modified and updated by Martin Prout December 2015
- */
-
-package toxi.audio;
-
-import com.jogamp.openal.AL;
-import toxi.geom.Vec3D;
-
-/**
- * The concept of a SoundListener refers directly to the user's instance in the
- * virtual (audio) world. By setting the 3D position, velocity and orientation
- * of the listener, the underlying audio hardware can produce a realistic 3D
- * spatial sound simulation (incl. doppler effect, volume falloff etc.).
- * 
- * <p>
- * Like {@link AudioSource}, this class extends {@link Vec3D} and so if the
- * position of the listener is changed via the public x,y,z vector components,
- * the <code>updatePosition()</code> method needs to be called afterwards in
- * order to reflect these changes in the OpenAL context.
- */
-public final class SoundListener extends Vec3D {
-
-    protected JOALUtil liboal;
-
-    protected final float[] position = { 0.0f, 0.0f, 0.0f };
-    protected final float[] velocity = { 0.0f, 0.0f, 0.0f };
-    protected final float[] orient = { 0.0f, 1.0f, 0.0f, 0.0f, 0.0f, 1.0f };
-
-    protected SoundListener(JOALUtil lib) {
-        super();
-        liboal = lib;
-        setGain(1f);
-        setPosition(position);
-        setVelocity(velocity);
-        setOrientation(orient);
-    }
-
-    public final float[] getOrientation() {
-        return orient;
-    }
-
-    public final float[] getPosition() {
-        return position;
-    }
-
-    public final float[] getVelocity() {
-        return velocity;
-    }
-
-    public final SoundListener setGain(float gain) {
-        liboal.getAL().alListenerf(AL.AL_GAIN, gain);
-        return this;
-    }
-
-    public SoundListener setOrientation(float upX, float upY, float upZ,
-            float forwardX, float forwardY, float forwardZ) {
-        orient[0] = upX;
-        orient[1] = upY;
-        orient[2] = upZ;
-        orient[3] = forwardX;
-        orient[4] = forwardY;
-        orient[5] = forwardZ;
-        liboal.getAL().alListenerfv(AL.AL_ORIENTATION, orient, 0);
-        return this;
-    }
-
-    public SoundListener setOrientation(float[] o) {
-        if (o.length == 6) {
-            orient[0] = o[0];
-            orient[1] = o[1];
-            orient[2] = o[2];
-            orient[3] = o[3];
-            orient[4] = o[4];
-            orient[5] = o[5];
-            liboal.getAL().alListenerfv(AL.AL_ORIENTATION, orient, 0);
-        } else {
-            throw new IllegalArgumentException("wrong number of array elements");
-        }
-        return this;
-    }
-
-    public SoundListener setPosition(float xx, float yy, float zz) {
-        x = position[0] = xx;
-        y = position[1] = yy;
-        z = position[2] = zz;
-        liboal.getAL().alListenerfv(AL.AL_POSITION, position, 0);
-        return this;
-    }
-
-    public final SoundListener setPosition(float[] p) {
-        if (p.length == 3) {
-            x = position[0] = p[0];
-            y = position[1] = p[1];
-            z = position[2] = p[2];
-            liboal.getAL().alListenerfv(AL.AL_POSITION, position, 0);
-        } else {
-            throw new IllegalArgumentException("wrong number of elements");
-        }
-        return this;
-    }
-
-    public SoundListener setVelocity(float xx, float yy, float zz) {
-        velocity[0] = xx;
-        velocity[1] = yy;
-        velocity[2] = zz;
-        liboal.getAL().alListenerfv(AL.AL_VELOCITY, velocity, 0);
-        return this;
-    }
-
-    public final SoundListener setVelocity(float[] v) {
-        if (v.length == 3) {
-            velocity[0] = v[0];
-            velocity[1] = v[1];
-            velocity[2] = v[2];
-            liboal.getAL().alListenerfv(AL.AL_VELOCITY, velocity, 0);
-        } else {
-            throw new IllegalArgumentException("wrong number of elements");
-        }
-        return this;
-    }
-
-    public SoundListener updatePosition() {
-        position[0] = x;
-        position[1] = y;
-        position[2] = z;
-        liboal.getAL().alListenerfv(AL.AL_POSITION, position, 0);
-        return this;
-    }
-}

data/src/toxi/audio/SynthUtil.java

@@ -1,109 +0,0 @@
-/*
- *   __               .__       .__  ._____.           
- * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
- * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
- *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
- *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
- *                   \/       \/             \/     \/ 
- *
- * Copyright (c) 2006-2011 Karsten Schmidt
- * 
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2.1 of the License, or (at your option) any later version.
- * 
- * http://creativecommons.org/licenses/LGPL/2.1/
- * 
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Lesser General Public License for more details.
- * 
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the Free Software
- * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
- * Modified and updated by Martin Prout December 2015
- */
-package toxi.audio;
-
-import java.nio.ByteBuffer;
-
-/**
- * This class provides static conversion tools for translating normalized
- * floating point wave data into 16bit PCM.
- */
-public class SynthUtil {
-
-    public static AudioBuffer floatArrayTo16bitBuffer(JOALUtil audioSys,
-            float[] raw, int rate) {
-        byte[] pcm = floatArrayTo16bitPCM(raw);
-        AudioBuffer buffer = audioSys.generateBuffers(1)[0];
-        buffer.configure(ByteBuffer.wrap(pcm), AudioBuffer.Format.MONO16, rate);
-        return buffer;
-    }
-
-    public static byte[] floatArrayTo16bitPCM(float[] raw) {
-        byte[] sample = new byte[raw.length * 2];
-        for (int i = 0, j = 0; i < raw.length; i++) {
-            int pcm = (int) (raw[i] * 0x8000);
-            sample[j++] = (byte) (pcm & 0xff);
-            sample[j++] = (byte) (pcm >> 8 & 0xff);
-        }
-        return sample;
-    }
-
-    public static AudioBuffer floatArrayTo16bitStereoBuffer(JOALUtil audioSys,
-            float[] raw, int rate) {
-        byte[] pcm = floatArrayTo16bitPCM(raw);
-        AudioBuffer buffer = audioSys.generateBuffers(1)[0];
-        buffer.configure(ByteBuffer.wrap(pcm), AudioBuffer.Format.STEREO16,
-                rate);
-        return buffer;
-    }
-
-    public static AudioBuffer floatArrayTo8bitBuffer(JOALUtil audioSys,
-            float[] raw, int rate) {
-        byte[] pcm = floatArrayTo8bitPCM(raw);
-        AudioBuffer buffer = audioSys.generateBuffers(1)[0];
-        buffer.configure(ByteBuffer.wrap(pcm), AudioBuffer.Format.MONO8, rate);
-        return buffer;
-    }
-
-    public static byte[] floatArrayTo8bitPCM(float[] raw) {
-        byte[] sample = new byte[raw.length];
-        for (int i = 0; i < raw.length; i++) {
-            sample[i] = (byte) (raw[i] * 0x7f + 0x80);
-        }
-        return sample;
-    }
-
-    public static AudioBuffer floatArrayTo8bitStereoBuffer(JOALUtil audioSys,
-            float[] raw, int rate) {
-        byte[] pcm = floatArrayTo8bitPCM(raw);
-        AudioBuffer buffer = audioSys.generateBuffers(1)[0];
-        buffer.configure(ByteBuffer.wrap(pcm), AudioBuffer.Format.STEREO8, rate);
-        return buffer;
-    }
-
-    /**
-     * Merges the two given mono arrays into an interleaved stereo array in
-     * left-right order.
-     *
-     * @param left
-     * @param right
-     * @return stereo array
-     */
-    public static float[] joinMonoFloatArrays(float[] left, float[] right) {
-        if (left.length != right.length) {
-            throw new IllegalArgumentException(
-                    "left & right channels need to be of equal size");
-        }
-        float[] stereo = new float[left.length * 2];
-        for (int i = 0, j = 0; i < left.length; i++, j += 2) {
-            stereo[j] = left[i];
-            stereo[j + 1] = right[i];
-        }
-        return stereo;
-    }
-}