Mercurial > jmeCapture

annotate src/com/aurellem/capture/audio/AudioSendRenderer.java @ 16:87f818f58975

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
more work on Advanced documentation
author Robert McIntyre <rlm@mit.edu>
date Fri, 28 Oct 2011 22:24:10 -0700
parents 8a6b1684f536
children 5249c8a9603c 9f58273090df
rev   line source
rlm@11 1 package com.aurellem.capture.audio;
rlm@11 2
rlm@11 3 import java.lang.reflect.Field;
rlm@11 4 import java.nio.ByteBuffer;
rlm@11 5 import java.util.HashMap;
rlm@11 6 import java.util.Vector;
rlm@11 7 import java.util.concurrent.CountDownLatch;
rlm@11 8 import java.util.logging.Level;
rlm@11 9 import java.util.logging.Logger;
rlm@11 10
rlm@11 11 import org.lwjgl.LWJGLException;
rlm@11 12 import org.lwjgl.openal.AL;
rlm@11 13 import org.lwjgl.openal.AL10;
rlm@11 14 import org.lwjgl.openal.ALCdevice;
rlm@11 15 import org.lwjgl.openal.OpenALException;
rlm@11 16
rlm@11 17 import com.aurellem.send.AudioSend;
rlm@11 18 import com.jme3.audio.Listener;
rlm@11 19 import com.jme3.audio.lwjgl.LwjglAudioRenderer;
rlm@11 20 import com.jme3.math.Vector3f;
rlm@11 21 import com.jme3.util.BufferUtils;
rlm@11 22
rlm@11 23 public class AudioSendRenderer
rlm@11 24
rlm@11 25 extends LwjglAudioRenderer implements MultiListener {
rlm@11 26
rlm@11 27 private AudioSend audioSend;
rlm@11 28
rlm@11 29 /**
rlm@11 30 * Keeps track of all the listeners which have been registered so far.
rlm@11 31 * The first element is <code>null</code>, which represents the zeroth
rlm@11 32 * LWJGL listener which is created automatically.
rlm@11 33 */
rlm@11 34 public Vector<Listener> listeners = new Vector<Listener>();
rlm@11 35
rlm@11 36 public void initialize(){
rlm@11 37 super.initialize();
rlm@11 38 listeners.add(null);
rlm@11 39 }
rlm@11 40
rlm@11 41 /**
rlm@11 42 * This is to call the native methods which require the OpenAL device ID.
rlm@11 43 * currently it is obtained through reflection.
rlm@11 44 */
rlm@11 45 private long deviceID;
rlm@11 46
rlm@11 47 /**
rlm@11 48 * To ensure that <code>deviceID<code> and <code>listeners<code> are
rlm@11 49 * properly initialized before any additional listeners are added.
rlm@11 50 */
rlm@11 51 private CountDownLatch latch = new CountDownLatch(1);
rlm@11 52
rlm@11 53 /**
rlm@11 54 * Each listener (including the main LWJGL listener) can be registered
rlm@11 55 * with a <code>SoundProcessor</code>, which this Renderer will call whenever
rlm@11 56 * there is new audio data to be processed.
rlm@11 57 */
rlm@11 58 public HashMap<Listener, SoundProcessor> soundProcessorMap =
rlm@11 59 new HashMap<Listener, SoundProcessor>();
rlm@11 60
rlm@11 61
rlm@11 62 /**
rlm@11 63 * Create a new slave context on the recorder device which will render all the
rlm@11 64 * sounds in the main LWJGL context with respect to this listener.
rlm@11 65 */
rlm@11 66 public void addListener(Listener l) {
rlm@11 67 try {this.latch.await();}
rlm@11 68 catch (InterruptedException e) {e.printStackTrace();}
rlm@11 69 audioSend.addListener();
rlm@11 70 this.listeners.add(l);
rlm@11 71 }
rlm@11 72
rlm@11 73 /**
rlm@11 74 * Whenever new data is rendered in the perspective of this listener,
rlm@11 75 * this Renderer will send that data to the SoundProcessor of your choosing.
rlm@11 76 */
rlm@11 77 public void registerSoundProcessor(Listener l, SoundProcessor sp) {
rlm@11 78 this.soundProcessorMap.put(l, sp);
rlm@11 79 }
rlm@11 80
rlm@11 81 /**
rlm@11 82 * Registers a SoundProcessor for the main LWJGL context. IF all you want to
rlm@11 83 * do is record the sound you would normally hear in your application, then
rlm@11 84 * this is the only method you have to worry about.
rlm@11 85 */
rlm@11 86 public void registerSoundProcessor(SoundProcessor sp){
rlm@11 87 // register a sound processor for the default listener.
rlm@11 88 this.soundProcessorMap.put(null, sp);
rlm@11 89 }
rlm@11 90
rlm@11 91 private static final Logger logger =
rlm@11 92 Logger.getLogger(AudioSendRenderer.class.getName());
rlm@11 93
rlm@11 94
rlm@11 95
rlm@11 96 /**
rlm@11 97 * Instead of taking whatever device is available on the system, this call
rlm@11 98 * creates the "Multiple Audio Send" device, which supports multiple listeners in a limited
rlm@11 99 * capacity. For each listener, the device renders it not to the sound device, but
rlm@11 100 * instead to buffers which it makes available via JNI.
rlm@11 101 */
rlm@11 102 public void initInThread(){
rlm@11 103 try{
rlm@11 104 if (!AL.isCreated()){
rlm@11 105 AL.create("Multiple Audio Send", 44100, 60, false);
rlm@11 106 }
rlm@11 107 }catch (OpenALException ex){
rlm@11 108 logger.log(Level.SEVERE, "Failed to load audio library", ex);
rlm@11 109 System.exit(1);
rlm@11 110 return;
rlm@11 111 }catch (LWJGLException ex){
rlm@11 112 logger.log(Level.SEVERE, "Failed to load audio library", ex);
rlm@11 113 System.exit(1);
rlm@11 114 return;
rlm@11 115 }
rlm@11 116 super.initInThread();
rlm@11 117
rlm@11 118 ALCdevice device = AL.getDevice();
rlm@11 119
rlm@11 120 // RLM: use reflection to grab the ID of our device for use later.
rlm@11 121 try {
rlm@11 122 Field deviceIDField;
rlm@11 123 deviceIDField = ALCdevice.class.getDeclaredField("device");
rlm@11 124 deviceIDField.setAccessible(true);
rlm@11 125 try {deviceID = (Long)deviceIDField.get(device);}
rlm@11 126 catch (IllegalArgumentException e) {e.printStackTrace();}
rlm@11 127 catch (IllegalAccessException e) {e.printStackTrace();}
rlm@11 128 deviceIDField.setAccessible(false);}
rlm@11 129 catch (SecurityException e) {e.printStackTrace();}
rlm@11 130 catch (NoSuchFieldException e) {e.printStackTrace();}
rlm@11 131
rlm@11 132 this.audioSend = new AudioSend(this.deviceID);
rlm@11 133
rlm@11 134 // The LWJGL context must be established as the master context before
rlm@11 135 // any other listeners can be created on this device.
rlm@11 136 audioSend.initDevice();
rlm@11 137 // Now, everything is initialized, and it is safe to add more listeners.
rlm@11 138 latch.countDown();
rlm@11 139 }
rlm@11 140
rlm@11 141
rlm@11 142 public void cleanup(){
rlm@11 143 for(SoundProcessor sp : this.soundProcessorMap.values()){
rlm@11 144 sp.cleanup();
rlm@11 145 }
rlm@11 146 super.cleanup();
rlm@11 147 }
rlm@11 148
rlm@11 149 public void updateAllListeners(){
rlm@11 150 for (int i = 0; i < this.listeners.size(); i++){
rlm@11 151 Listener lis = this.listeners.get(i);
rlm@11 152 if (null != lis){
rlm@11 153 Vector3f location = lis.getLocation();
rlm@11 154 Vector3f velocity = lis.getVelocity();
rlm@11 155 Vector3f orientation = lis.getUp();
rlm@11 156 float gain = lis.getVolume();
rlm@11 157 audioSend.setNthListener3f(AL10.AL_POSITION,
rlm@11 158 location.x, location.y, location.z, i);
rlm@11 159 audioSend.setNthListener3f(AL10.AL_VELOCITY,
rlm@11 160 velocity.x, velocity.y, velocity.z, i);
rlm@11 161 audioSend.setNthListener3f(AL10.AL_ORIENTATION,
rlm@11 162 orientation.x, orientation.y, orientation.z, i);
rlm@11 163 audioSend.setNthListenerf(AL10.AL_GAIN, gain, i);
rlm@11 164 }
rlm@11 165 }
rlm@11 166 }
rlm@11 167
rlm@11 168
rlm@11 169 public final static int BYTES_PER_SAMPLE = 4;
rlm@11 170 private ByteBuffer buffer = BufferUtils.createByteBuffer(4096);
rlm@11 171
rlm@11 172 public void dispatchAudio(float tpf){
rlm@11 173 int samplesToGet = (int) (tpf * 44100);
rlm@11 174 try {latch.await();}
rlm@11 175 catch (InterruptedException e) {e.printStackTrace();}
rlm@11 176 audioSend.step(samplesToGet);
rlm@11 177 updateAllListeners();
rlm@11 178
rlm@11 179 for (int i = 0; i < this.listeners.size(); i++){
rlm@11 180 buffer.clear();
rlm@11 181 audioSend.getSamples(buffer, samplesToGet, i);
rlm@11 182 SoundProcessor sp =
rlm@11 183 this.soundProcessorMap.get(this.listeners.get(i));
rlm@11 184 if (null != sp){sp.process(buffer, samplesToGet*BYTES_PER_SAMPLE);}
rlm@11 185 }
rlm@11 186
rlm@11 187 }
rlm@11 188
rlm@11 189 public void update(float tpf){
rlm@11 190 super.update(tpf);
rlm@11 191 dispatchAudio(tpf);
rlm@11 192 }
rlm@11 193
rlm@11 194 }
rlm@11 195