Some changes to bring OpenAL code in line with OpenGL code: use a

Java object to represent each OpenAL object (listener, sources, 
and buffers) and delete the OpenAL object if the Java object is 
garbage-collected.  Added the full range of listener and source 
settings.


git-svn-id: svn+ssh://src.earth.threerings.net/nenya/trunk@653 ed5b42cb-e716-0410-a449-f6a68f950b19

src/java/com/threerings/openal/Buffer.java

@@ -0,0 +1,113 @@
+//
+// $Id$
+//
+// Nenya library - tools for developing networked games
+// Copyright (C) 2002-2007 Three Rings Design, Inc., All Rights Reserved
+// http://www.threerings.net/code/nenya/
+//
+// 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.
+//
+// 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+package com.threerings.openal;
+
+import java.nio.ByteBuffer;
+import java.nio.IntBuffer;
+import java.nio.ShortBuffer;
+
+import org.lwjgl.BufferUtils;
+import org.lwjgl.openal.AL10;
+
+/**
+ * Represents an OpenAL buffer object.
+ */
+public class Buffer
+{
+    /**
+     * Creates a new buffer for the specified sound manager.
+     */
+    public Buffer (SoundManager soundmgr)
+    {
+        _soundmgr = soundmgr;
+        IntBuffer idbuf = BufferUtils.createIntBuffer(1);
+        AL10.alGenBuffers(idbuf);
+        _id = idbuf.get(0);
+    }
+
+    /**
+     * Returns this buffer's OpenAL identifier.
+     */
+    public final int getId ()
+    {
+        return _id;
+    }
+
+    /**
+     * Sets the data in this buffer.
+     */
+    public void setData (int format, ByteBuffer data, int frequency)
+    {
+        AL10.alBufferData(_id, format, data, frequency);
+    }
+
+    /**
+     * Sets the data in this buffer.
+     */
+    public void setData (int format, IntBuffer data, int frequency)
+    {
+        AL10.alBufferData(_id, format, data, frequency);
+    }
+
+    /**
+     * Sets the data in this buffer.
+     */
+    public void setData (int format, ShortBuffer data, int frequency)
+    {
+        AL10.alBufferData(_id, format, data, frequency);
+    }
+
+    /**
+     * Returns the size of this buffer.
+     */
+    public int getSize ()
+    {
+        return AL10.alGetBufferi(_id, AL10.AL_SIZE);
+    }
+
+    /**
+     * Deletes this buffer, rendering it unusable.
+     */
+    public void delete ()
+    {
+        IntBuffer idbuf = BufferUtils.createIntBuffer(1);
+        idbuf.put(_id).rewind();
+        AL10.alDeleteBuffers(idbuf);
+        _id = 0;
+    }
+
+    @Override // documentation inherited
+    protected void finalize ()
+        throws Throwable
+    {
+        super.finalize();
+        if (_id > 0) {
+            _soundmgr.bufferFinalized(_id);
+        }
+    }
+
+    /** The sound manager responsible for this buffer. */
+    protected SoundManager _soundmgr;
+
+    /** The OpenAL identifier for this buffer. */
+    protected int _id;
+}