A partial fix to issue 24.

- Rename AudioEngine.java, AudioEngine3D.java and AudioEngine3DL2.java to abstract class.


git-svn-id: https://svn.java.net/svn/j3d-core-utils~svn/trunk@25 9497e636-51bd-65ba-982d-a4982e1767a5

1 files changed, 9 insertions, 33 deletions

diff --git a/src/classes/share/com/sun/j3d/audioengines/AudioEngine3D.java b/src/classes/share/com/sun/j3d/audioengines/AudioEngine3D.java
index 2e495d5..3afdcc0 100644
--- a/src/classes/share/com/sun/j3d/audioengines/AudioEngine3D.java
+++ b/src/classes/share/com/sun/j3d/audioengines/AudioEngine3D.java
@@ -67,7 +67,7 @@ import java.util.ArrayList;
  * Subclass AudioEngine3DL2 instead.
  */
 
-public class AudioEngine3D extends AudioEngine implements AudioDevice3D
+public abstract class AudioEngine3D extends AudioEngine implements AudioDevice3D
 {
     /*
      *  Identifiers of sample associated with sound source
@@ -142,10 +142,7 @@ public class AudioEngine3D extends AudioEngine implements AudioDevice3D
      * Removes/clears associated sound data with this sound source node
      * @param index device specific reference number to device driver sample
      */  
-    public void clearSound(int index) {
-        // This method must be overridden by device specific implementation
-        return;
-    }
+    public abstract void clearSound(int index);
 
     /**
      * Set the transform for local to virtual world coordinate space
@@ -163,20 +160,14 @@ public class AudioEngine3D extends AudioEngine implements AudioDevice3D
      * @param index device specific reference number to device driver sample
      * @return status: < 0 denotes an error
      */
-    public int   startSample(int index) {
-        // This method must be overridden by device specific implementation
-        return -1;  // error if not overridden
-    }
+    public abstract int startSample(int index);
 
     /**
      * Stop sample playing on audio device
      * @param index device specific reference number to device driver sample
      * @return status: < 0 denotes an error
      */
-    public int   stopSample(int index) {
-        // This method must be overridden by device specific implementation
-        return -1;  // error if not overridden
-    }
+    public abstract int stopSample(int index);
 
     /**
      * Update sample. 
@@ -184,46 +175,31 @@ public class AudioEngine3D extends AudioEngine implements AudioDevice3D
      * @param index device specific reference number to device driver sample
      */
     // TODO: The update method exists on a TEMPORARY basis.
-    public void updateSample(int index) {
-        // This method must be overridden by device specific implementation
-        return;
-    }
+    public abstract void updateSample(int index);
 
     /**
      * Mute sample. 
      * @param index device specific reference number to device driver sample
      */
-    public void muteSample(int index) {
-        // This method must be overridden by device specific implementation
-        return;
-    }
+    public abstract void muteSample(int index);
 
     /**
      * Unmute sample. 
      * @param index device specific reference number to device driver sample
      */
-    public void unmuteSample(int index) {
-        // This method must be overridden by device specific implementation
-        return;
-    }
+    public abstract void unmuteSample(int index);
 
     /**
      * Pause sample. 
      * @param index device specific reference number to device driver sample
      */
-    public void pauseSample(int index) {
-        // This method must be overridden by device specific implementation
-        return;
-    }
+    public abstract void pauseSample(int index);
 
     /**
      * Unpause sample. 
      * @param index device specific reference number to device driver sample
      */
-    public void unpauseSample(int index) {
-        // This method must be overridden by device specific implementation
-        return;
-    }
+    public abstract void unpauseSample(int index);
     
     /*
      *