paulscode.sound
Class SoundSystemJPCT

java.lang.Object
  extended by paulscode.sound.SoundSystem
      extended by paulscode.sound.SoundSystemJPCT

public class SoundSystemJPCT
extends SoundSystem

The SoundSystemJPCT class is a user-friendly extention of the core SoundSystem class. It is designed to be easily used with the jPCT API (for more information, visit http://www.jpct.net). In addition to the things which SoundSystem does, SoundSystemJPCT provides methods for binding sources to Object3D's and binding the listener to a Camera. A whole bunch of methods have been added to make source creation much easier than using the core SoundSystem class alone, by automatically using default settings any time a parameter is not specified. All SimpleVector arguments are assumed to be in the jPCT coordinate system, and are automatically converted into the SoundSystem coordinate system (y = -y, z = -z), so the user doesn't have to worry about keeping track of two different coordinate systems. Pluggins for LibraryLWJGLOpenAL, LibraryJavaSound, CodecWav, and CodecJOgg are automatically linked, so the user doesn't have to worry about pluggins either. The SoundSystemJPCT can be constructed by defining which sound library to use or by using the the built in compatibility checking. See SoundSystemConfig for more information about changing default settings.

SoundSystem License:

You are free to use this library for any purpose, commercial or otherwise. You may modify this library or source code, and distribute it any way you like, provided the following conditions are met:
1) You may not falsely claim to be the author of this library or any unmodified portion of it.
2) You may not copyright this library or a modified version of it and then sue me for copyright infringement.
3) If you modify the source code, you must clearly document the changes made before redistributing the modified source code, so other users know it is not the original code.
4) You are not required to give me credit for this library in any derived work, but if you do, you must also mention my website: http://www.paulscode.com
5) I the author will not be responsible for any damages (physical, financial, or otherwise) caused by the use if this library or any part of it.
6) I the author do not guarantee, warrant, or make any representations, either expressed or implied, regarding the use of this library or any part of it.

Author: Paul Lamb
http://www.paulscode.com


Field Summary
 
Fields inherited from class paulscode.sound.SoundSystem
className, commandQueue, commandThread, logger, randomNumberGenerator, soundLibrary
 
Constructor Summary
SoundSystemJPCT()
          Constructor: Create the sound system.
SoundSystemJPCT(java.lang.Class libraryClass)
          Constructor: Create the sound system using the specified library.
 
Method Summary
 java.lang.String backgroundMusic(java.lang.String filename)
          Creates a new permanant, streaming, looping priority source with zero attenuation.
 java.lang.String backgroundMusic(java.lang.String filename, boolean toLoop)
          Creates a new permanant, streaming, priority source with zero attenuation.
 void backgroundMusic(java.lang.String sourcename, java.lang.String filename)
          Creates a new permanant, streaming, looping priority source with zero attenuation.
 void backgroundMusic(java.lang.String sourcename, java.net.URL url, java.lang.String identifier)
          Creates a new permanant, streaming, looping priority source with zero attenuation.
 java.lang.String backgroundMusic(java.net.URL url, java.lang.String identifier)
          Creates a new permanant, streaming, looping priority source with zero attenuation.
 java.lang.String backgroundMusic(java.net.URL url, java.lang.String identifier, boolean toLoop)
          Creates a new permanant, streaming, priority source with zero attenuation.
 void bindListener(com.threed.jpct.Camera c)
          Binds the listener to the specified camera, so that when the camera's position or orientation changes, the listener automatically follows it.
 void bindSource(java.lang.String sourcename, com.threed.jpct.Object3D obj)
          Binds a source to an Object3D so that when the Object3D's position changes, the source automatically follows it.
 void cleanup()
          Ends the command thread, shuts down the sound system, and removes references to all instantiated objects.
 com.threed.jpct.SimpleVector convertCoordinates(com.threed.jpct.SimpleVector v)
          Converts a SimpleVector from jPCT coordinates into SoundSystem coordinates, and vice-versa.
protected  void init(java.lang.Class libraryClass)
          Loads the message logger, initializes the specified sound library, and starts the command thread.
protected  void linkDefaultLibrariesAndCodecs()
          Links with the default libraries (LibraryLWJGLOpenAL and LibraryJavaSound) and default codecs (CodecWav and CodecJOgg).
 void moveListener(com.threed.jpct.SimpleVector jPCTrelative)
          Moves the listener relative to the current location.
 void newSource(boolean priority, java.lang.String sourcename, java.lang.String filename, boolean toLoop)
          Creates a new non-streaming source at the origin.
 void newSource(boolean priority, java.lang.String sourcename, java.lang.String filename, boolean toLoop, int attmodel)
          Creates a new non-streaming source at the origin.
 void newSource(boolean priority, java.lang.String sourcename, java.lang.String filename, boolean toLoop, int attmodel, float distORroll)
          Creates a new non-streaming source at the origin.
 void newSource(boolean priority, java.lang.String sourcename, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a new non-streaming source at the specified position.
 void newSource(boolean priority, java.lang.String sourcename, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a new non-streaming source at the specified position.
 void newSource(boolean priority, java.lang.String sourcename, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a new non-streaming source at the specified position.
 void newSource(boolean priority, java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop)
          Creates a new non-streaming source at the origin.
 void newSource(boolean priority, java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel)
          Creates a new non-streaming source at the origin.
 void newSource(boolean priority, java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel, float distORroll)
          Creates a new non-streaming source at the origin.
 void newSource(boolean priority, java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a new non-streaming source at the specified position.
 void newSource(boolean priority, java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a new non-streaming source at the specified position.
 void newSource(boolean priority, java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a new non-streaming source at the specified position.
 void newSource(java.lang.String sourcename, java.lang.String filename, boolean toLoop)
          Creates a new non-streaming, non-priority source at the origin.
 void newSource(java.lang.String sourcename, java.lang.String filename, boolean toLoop, int attmodel)
          Creates a new non-streaming, non-priority source at the origin.
 void newSource(java.lang.String sourcename, java.lang.String filename, boolean toLoop, int attmodel, float distORroll)
          Creates a new non-streaming, non-priority source at the origin.
 void newSource(java.lang.String sourcename, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a new non-streaming, non-priority source at the specified position.
 void newSource(java.lang.String sourcename, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a new non-streaming, non-priority source at the specified position.
 void newSource(java.lang.String sourcename, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a new non-streaming, non-priority source at the specified position.
 void newSource(java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop)
          Creates a new non-streaming, non-priority source at the origin.
 void newSource(java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel)
          Creates a new non-streaming, non-priority source at the origin.
 void newSource(java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel, float distORroll)
          Creates a new non-streaming, non-priority source at the origin.
 void newSource(java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a new non-streaming, non-priority source at the specified position.
 void newSource(java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a new non-streaming, non-priority source at the specified position.
 void newSource(java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a new non-streaming, non-priority source at the specified position.
 void newStreamingSource(boolean priority, java.lang.String sourcename, java.lang.String filename, boolean toLoop)
          Creates a new streaming source.
 void newStreamingSource(boolean priority, java.lang.String sourcename, java.lang.String filename, boolean toLoop, int attmodel)
          Creates a new streaming source at the origin.
 void newStreamingSource(boolean priority, java.lang.String sourcename, java.lang.String filename, boolean toLoop, int attmodel, float distORroll)
          Creates a new streaming source at the origin.
 void newStreamingSource(boolean priority, java.lang.String sourcename, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a new streaming source at the specified position.
 void newStreamingSource(boolean priority, java.lang.String sourcename, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a new streaming source at the specified position.
 void newStreamingSource(boolean priority, java.lang.String sourcename, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a new streaming source at the specified position.
 void newStreamingSource(boolean priority, java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop)
          Creates a new streaming source.
 void newStreamingSource(boolean priority, java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel)
          Creates a new streaming source at the origin.
 void newStreamingSource(boolean priority, java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel, float distORroll)
          Creates a new streaming source at the origin.
 void newStreamingSource(boolean priority, java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a new streaming source at the specified position.
 void newStreamingSource(boolean priority, java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a new streaming source at the specified position.
 void newStreamingSource(boolean priority, java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a new streaming source at the specified position.
 void newStreamingSource(java.lang.String sourcename, java.lang.String filename, boolean toLoop)
          Creates a new streaming non-priority source at the origin.
 void newStreamingSource(java.lang.String sourcename, java.lang.String filename, boolean toLoop, int attmodel)
          Creates a new streaming non-priority source at the origin.
 void newStreamingSource(java.lang.String sourcename, java.lang.String filename, boolean toLoop, int attmodel, float distORroll)
          Creates a new streaming non-priority source at the origin.
 void newStreamingSource(java.lang.String sourcename, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a new streaming non-priority source at the specified position.
 void newStreamingSource(java.lang.String sourcename, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a new streaming non-priority source at the specified position.
 void newStreamingSource(java.lang.String sourcename, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a new streaming non-priority source at the specified position.
 void newStreamingSource(java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop)
          Creates a new streaming non-priority source at the origin.
 void newStreamingSource(java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel)
          Creates a new streaming non-priority source at the origin.
 void newStreamingSource(java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel, float distORroll)
          Creates a new streaming non-priority source at the origin.
 void newStreamingSource(java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a new streaming non-priority source at the specified position.
 void newStreamingSource(java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a new streaming non-priority source at the specified position.
 void newStreamingSource(java.lang.String sourcename, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a new streaming non-priority source at the specified position.
 java.lang.String quickPlay(boolean priority, java.lang.String filename, boolean toLoop)
          Creates a temporary source at the origin and plays it.
 java.lang.String quickPlay(boolean priority, java.lang.String filename, boolean toLoop, int attmodel)
          Creates a temporary source and plays it.
 java.lang.String quickPlay(boolean priority, java.lang.String filename, boolean toLoop, int attmodel, float distORroll)
          Creates a temporary source at the origin and plays it.
 java.lang.String quickPlay(boolean priority, java.lang.String filename, boolean toLoop, com.threed.jpct.Object3D object)
          Creates a temporary source, binds it to the specified Object3D, and plays.
 java.lang.String quickPlay(boolean priority, java.lang.String filename, boolean toLoop, com.threed.jpct.Object3D object, int attmodel)
          Creates a temporary source, binds it to the specified Object3D, and plays.
 java.lang.String quickPlay(boolean priority, java.lang.String filename, boolean toLoop, com.threed.jpct.Object3D object, int attmodel, float distOrRoll)
          Creates a temporary source, binds it to the specified Object3D, and plays it.
 java.lang.String quickPlay(boolean priority, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a temporary source and plays it.
 java.lang.String quickPlay(boolean priority, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a temporary source and plays it.
 java.lang.String quickPlay(boolean priority, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a temporary source and plays it.
 java.lang.String quickPlay(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop)
          Creates a temporary source at the origin and plays it.
 java.lang.String quickPlay(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel)
          Creates a temporary source and plays it.
 java.lang.String quickPlay(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel, float distORroll)
          Creates a temporary source at the origin and plays it.
 java.lang.String quickPlay(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.Object3D object)
          Creates a temporary source, binds it to the specified Object3D, and plays.
 java.lang.String quickPlay(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.Object3D object, int attmodel)
          Creates a temporary source, binds it to the specified Object3D, and plays.
 java.lang.String quickPlay(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.Object3D object, int attmodel, float distOrRoll)
          Creates a temporary source, binds it to the specified Object3D, and plays it.
 java.lang.String quickPlay(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a temporary source and plays it.
 java.lang.String quickPlay(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a temporary source and plays it.
 java.lang.String quickPlay(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a temporary source and plays it.
 java.lang.String quickPlay(java.lang.String filename, boolean toLoop)
          Creates a temporary, non-priority source at the origin and plays it.
 java.lang.String quickPlay(java.lang.String filename, boolean toLoop, int attmodel)
          Creates a temporary non-priority source at the origin and plays it.
 java.lang.String quickPlay(java.lang.String filename, boolean toLoop, int attmodel, float distORroll)
          Creates a temporary non-priority source at the origin and plays it.
 java.lang.String quickPlay(java.lang.String filename, boolean toLoop, com.threed.jpct.Object3D object)
          Creates a temporary non-priority source, binds it to the specified Object3D, and plays.
 java.lang.String quickPlay(java.lang.String filename, boolean toLoop, com.threed.jpct.Object3D object, int attmodel)
          Creates a temporary non-priority source, binds it to the specified Object3D, and plays.
 java.lang.String quickPlay(java.lang.String filename, boolean toLoop, com.threed.jpct.Object3D object, int attmodel, float distOrRoll)
          Creates a temporary non-priority source, binds it to the specified Object3D, and plays.
 java.lang.String quickPlay(java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a temporary non-priority source at the specified position and plays it.
 java.lang.String quickPlay(java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a temporary non-priority source and plays it.
 java.lang.String quickPlay(java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a temporary non-priority source and plays it.
 java.lang.String quickPlay(java.net.URL url, java.lang.String identifier, boolean toLoop)
          Creates a temporary, non-priority source at the origin and plays it.
 java.lang.String quickPlay(java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel)
          Creates a temporary non-priority source at the origin and plays it.
 java.lang.String quickPlay(java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel, float distORroll)
          Creates a temporary non-priority source at the origin and plays it.
 java.lang.String quickPlay(java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.Object3D object)
          Creates a temporary non-priority source, binds it to the specified Object3D, and plays.
 java.lang.String quickPlay(java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.Object3D object, int attmodel)
          Creates a temporary non-priority source, binds it to the specified Object3D, and plays.
 java.lang.String quickPlay(java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.Object3D object, int attmodel, float distOrRoll)
          Creates a temporary non-priority source, binds it to the specified Object3D, and plays.
 java.lang.String quickPlay(java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a temporary non-priority source at the specified position and plays it.
 java.lang.String quickPlay(java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a temporary non-priority source and plays it.
 java.lang.String quickPlay(java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a temporary non-priority source and plays it.
 java.lang.String quickStream(boolean priority, java.lang.String filename, boolean toLoop)
          Creates a temporary source at the origin and streams it.
 java.lang.String quickStream(boolean priority, java.lang.String filename, boolean toLoop, int attmodel)
          Creates a temporary source and streams it.
 java.lang.String quickStream(boolean priority, java.lang.String filename, boolean toLoop, int attmodel, float distORroll)
          Creates a temporary source at the origin and streams it.
 java.lang.String quickStream(boolean priority, java.lang.String filename, boolean toLoop, com.threed.jpct.Object3D object)
          Creates a temporary source, binds it to the specified Object3D, and streams it.
 java.lang.String quickStream(boolean priority, java.lang.String filename, boolean toLoop, com.threed.jpct.Object3D object, int attmodel)
          Creates a temporary source, binds it to the specified Object3D, and streams it.
 java.lang.String quickStream(boolean priority, java.lang.String filename, boolean toLoop, com.threed.jpct.Object3D object, int attmodel, float distOrRoll)
          Creates a temporary source, binds it to the specified Object3D, and streams it.
 java.lang.String quickStream(boolean priority, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a temporary source and streams it.
 java.lang.String quickStream(boolean priority, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a temporary source and streams it.
 java.lang.String quickStream(boolean priority, java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a temporary source and streams it.
 java.lang.String quickStream(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop)
          Creates a temporary source at the origin and streams it.
 java.lang.String quickStream(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel)
          Creates a temporary source and streams it.
 java.lang.String quickStream(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel, float distORroll)
          Creates a temporary source at the origin and streams it.
 java.lang.String quickStream(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.Object3D object)
          Creates a temporary source, binds it to the specified Object3D, and streams it.
 java.lang.String quickStream(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.Object3D object, int attmodel)
          Creates a temporary source, binds it to the specified Object3D, and streams it.
 java.lang.String quickStream(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.Object3D object, int attmodel, float distOrRoll)
          Creates a temporary source, binds it to the specified Object3D, and streams it.
 java.lang.String quickStream(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a temporary source and streams it.
 java.lang.String quickStream(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a temporary source and streams it.
 java.lang.String quickStream(boolean priority, java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a temporary source and streams it.
 java.lang.String quickStream(java.lang.String filename, boolean toLoop)
          Creates a temporary, non-priority source at the origin and streams it.
 java.lang.String quickStream(java.lang.String filename, boolean toLoop, int attmodel)
          Creates a temporary non-priority source at the origin and streams it.
 java.lang.String quickStream(java.lang.String filename, boolean toLoop, int attmodel, float distORroll)
          Creates a temporary non-priority source at the origin and streams it.
 java.lang.String quickStream(java.lang.String filename, boolean toLoop, com.threed.jpct.Object3D object)
          Creates a temporary non-priority source, binds it to the specified Object3D, and streams it.
 java.lang.String quickStream(java.lang.String filename, boolean toLoop, com.threed.jpct.Object3D object, int attmodel)
          Creates a temporary non-priority source, binds it to the specified Object3D, and streams it.
 java.lang.String quickStream(java.lang.String filename, boolean toLoop, com.threed.jpct.Object3D object, int attmodel, float distOrRoll)
          Creates a temporary non-priority source, binds it to the specified Object3D, and streams it.
 java.lang.String quickStream(java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a temporary non-priority source and streams it.
 java.lang.String quickStream(java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a temporary non-priority source and streams it.
 java.lang.String quickStream(java.lang.String filename, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a temporary non-priority source and streams it.
 java.lang.String quickStream(java.net.URL url, java.lang.String identifier, boolean toLoop)
          Creates a temporary, non-priority source at the origin and streams it.
 java.lang.String quickStream(java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel)
          Creates a temporary non-priority source at the origin and streams it.
 java.lang.String quickStream(java.net.URL url, java.lang.String identifier, boolean toLoop, int attmodel, float distORroll)
          Creates a temporary non-priority source at the origin and streams it.
 java.lang.String quickStream(java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.Object3D object)
          Creates a temporary non-priority source, binds it to the specified Object3D, and streams it.
 java.lang.String quickStream(java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.Object3D object, int attmodel)
          Creates a temporary non-priority source, binds it to the specified Object3D, and streams it.
 java.lang.String quickStream(java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.Object3D object, int attmodel, float distOrRoll)
          Creates a temporary non-priority source, binds it to the specified Object3D, and streams it.
 java.lang.String quickStream(java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition)
          Creates a temporary non-priority source and streams it.
 java.lang.String quickStream(java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel)
          Creates a temporary non-priority source and streams it.
 java.lang.String quickStream(java.net.URL url, java.lang.String identifier, boolean toLoop, com.threed.jpct.SimpleVector jPCTposition, int attmodel, float distOrRoll)
          Creates a temporary non-priority source and streams it.
 void releaseAllSources(com.threed.jpct.Object3D obj)
          Releases all sources bound to the specified Object3D.
 void releaseSource(java.lang.String sourcename)
          Releases the specified source from its bound Object3D.
 void setListenerOrientation(com.threed.jpct.Camera camera)
          Sets the listener's orientation to match the specified camera.
 void setListenerOrientation(com.threed.jpct.SimpleVector jPCTlook, com.threed.jpct.SimpleVector jPCTup)
          Sets the listener's orientation.
 void setListenerPosition(com.threed.jpct.SimpleVector jPCTposition)
          Moves the listener to the specified location.
 void setListenerVelocity(com.threed.jpct.SimpleVector velocity)
          Sets the listener's velocity, for use in Doppler effect.
 void setPosition(java.lang.String sourcename, com.threed.jpct.SimpleVector jPCTposition)
          Move a source to the specified location.
 void setVelocity(java.lang.String sourcename, com.threed.jpct.SimpleVector velocity)
          Sets the specified source's velocity, for use in Doppler effect.
 void tick()
          Re-aligns the listener to the camera and keeps sources following the Object3D's that they are bound to.
 
Methods inherited from class paulscode.sound.SoundSystem
activate, backgroundMusic, backgroundMusic, changeDopplerFactor, changeDopplerVelocity, checkFadeVolumes, CommandQueue, cull, currentLibrary, dequeueSound, errorCheck, errorMessage, fadeOut, fadeOut, fadeOutIn, fadeOutIn, feedRawAudioData, flush, getLastException, getListenerData, getMasterVolume, getPitch, getVolume, importantMessage, initialized, interruptCommandThread, libraryCompatible, loadSound, loadSound, loadSound, ManageSources, message, millisecondsPlayed, moveListener, newLibrary, newSource, newSource, newStreamingSource, newStreamingSource, pause, play, playing, playing, queueSound, queueSound, quickPlay, quickPlay, quickStream, quickStream, rawDataStream, removeSource, removeTemporarySources, rewind, setAttenuation, setDistOrRoll, setException, setListenerAngle, setListenerOrientation, setListenerPosition, setListenerVelocity, setLooping, setMasterVolume, setPitch, setPosition, setPriority, setTemporary, setVelocity, setVolume, snooze, stop, switchLibrary, turnListener, unloadSound
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SoundSystemJPCT

public SoundSystemJPCT()
Constructor: Create the sound system. If library priorities have not been defined, SoundSystemJPCT attempts to load the LWJGL binding of OpenAL first, and if that fails it trys JavaSound. If both fail, it switches to silent mode. See SoundSystemConfig for information about linking with sound libraries and codecs.


SoundSystemJPCT

public SoundSystemJPCT(java.lang.Class libraryClass)
                throws SoundSystemException
Constructor: Create the sound system using the specified library.

Parameters:
libraryClass - Type of library to use (must extend class 'Library'). See SoundSystemConfig for information about chosing a sound library.
Throws:
SoundSystemException
Method Detail

linkDefaultLibrariesAndCodecs

protected void linkDefaultLibrariesAndCodecs()
Links with the default libraries (LibraryLWJGLOpenAL and LibraryJavaSound) and default codecs (CodecWav and CodecJOgg).

Overrides:
linkDefaultLibrariesAndCodecs in class SoundSystem

init

protected void init(java.lang.Class libraryClass)
             throws SoundSystemException
Loads the message logger, initializes the specified sound library, and starts the command thread. Also instantiates the random number generator and the command queue, and sets className to "SoundSystemJPCT".

Overrides:
init in class SoundSystem
Parameters:
libraryClass - Library to initialize. See SoundSystemConfig for information about chosing a sound library.
Throws:
SoundSystemException

cleanup

public void cleanup()
Ends the command thread, shuts down the sound system, and removes references to all instantiated objects.

Overrides:
cleanup in class SoundSystem

tick

public void tick()
Re-aligns the listener to the camera and keeps sources following the Object3D's that they are bound to. This method should be called on the same thread that manipulates the Camera and Object3D's, to avoid synchronization-related errors. A good place to call tick() would be within the main game loop.


bindListener

public void bindListener(com.threed.jpct.Camera c)
Binds the listener to the specified camera, so that when the camera's position or orientation changes, the listener automatically follows it. NOTE: When using this method, it is necessary to call the tick() method within a loop running on the same thread which changes the specified Camera.

Parameters:
c - Camera to follow.

bindSource

public void bindSource(java.lang.String sourcename,
                       com.threed.jpct.Object3D obj)
Binds a source to an Object3D so that when the Object3D's position changes, the source automatically follows it. NOTE: When using this method, it is necessary to call the tick() method within a loop running on the same thread which changes the specified Object3D.

Parameters:
sourcename - The source's identifier.
obj - The object to follow.

releaseSource

public void releaseSource(java.lang.String sourcename)
Releases the specified source from its bound Object3D.

Parameters:
sourcename - The source's identifier.

releaseAllSources

public void releaseAllSources(com.threed.jpct.Object3D obj)
Releases all sources bound to the specified Object3D. This method should be called before deleting an Object3D with sources attached to it.

Parameters:
obj - Object3D to remove sources from.

backgroundMusic

public java.lang.String backgroundMusic(java.lang.String filename)
Creates a new permanant, streaming, looping priority source with zero attenuation.

Parameters:
filename - The name of the sound file to play at this source.
Returns:
The new source's name.

backgroundMusic

public java.lang.String backgroundMusic(java.lang.String filename,
                                        boolean toLoop)
Creates a new permanant, streaming, priority source with zero attenuation.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should the music loop, or play only once.
Returns:
The new source's name.

backgroundMusic

public void backgroundMusic(java.lang.String sourcename,
                            java.lang.String filename)
Creates a new permanant, streaming, looping priority source with zero attenuation.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.

backgroundMusic

public java.lang.String backgroundMusic(java.net.URL url,
                                        java.lang.String identifier)
Creates a new permanant, streaming, looping priority source with zero attenuation.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
Returns:
The new source's name.

backgroundMusic

public java.lang.String backgroundMusic(java.net.URL url,
                                        java.lang.String identifier,
                                        boolean toLoop)
Creates a new permanant, streaming, priority source with zero attenuation.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should the music loop, or play only once.
Returns:
The new source's name.

backgroundMusic

public void backgroundMusic(java.lang.String sourcename,
                            java.net.URL url,
                            java.lang.String identifier)
Creates a new permanant, streaming, looping priority source with zero attenuation.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.

newSource

public void newSource(java.lang.String sourcename,
                      java.lang.String filename,
                      boolean toLoop)
Creates a new non-streaming, non-priority source at the origin. Default values are used for attenuation.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.

newSource

public void newSource(boolean priority,
                      java.lang.String sourcename,
                      java.lang.String filename,
                      boolean toLoop)
Creates a new non-streaming source at the origin. Default values are used for attenuation.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.

newSource

public void newSource(java.lang.String sourcename,
                      java.lang.String filename,
                      boolean toLoop,
                      com.threed.jpct.SimpleVector jPCTposition)
Creates a new non-streaming, non-priority source at the specified position. Default values are used for attenuation.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.

newSource

public void newSource(boolean priority,
                      java.lang.String sourcename,
                      java.lang.String filename,
                      boolean toLoop,
                      com.threed.jpct.SimpleVector jPCTposition)
Creates a new non-streaming source at the specified position. Default values are used for attenuation.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.

newSource

public void newSource(java.lang.String sourcename,
                      java.lang.String filename,
                      boolean toLoop,
                      int attmodel)
Creates a new non-streaming, non-priority source at the origin. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.

newSource

public void newSource(boolean priority,
                      java.lang.String sourcename,
                      java.lang.String filename,
                      boolean toLoop,
                      int attmodel)
Creates a new non-streaming source at the origin. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.

newSource

public void newSource(java.lang.String sourcename,
                      java.lang.String filename,
                      boolean toLoop,
                      int attmodel,
                      float distORroll)
Creates a new non-streaming, non-priority source at the origin. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newSource

public void newSource(boolean priority,
                      java.lang.String sourcename,
                      java.lang.String filename,
                      boolean toLoop,
                      int attmodel,
                      float distORroll)
Creates a new non-streaming source at the origin. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newSource

public void newSource(java.lang.String sourcename,
                      java.lang.String filename,
                      boolean toLoop,
                      com.threed.jpct.SimpleVector jPCTposition,
                      int attmodel)
Creates a new non-streaming, non-priority source at the specified position. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.

newSource

public void newSource(boolean priority,
                      java.lang.String sourcename,
                      java.lang.String filename,
                      boolean toLoop,
                      com.threed.jpct.SimpleVector jPCTposition,
                      int attmodel)
Creates a new non-streaming source at the specified position. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.

newSource

public void newSource(java.lang.String sourcename,
                      java.lang.String filename,
                      boolean toLoop,
                      com.threed.jpct.SimpleVector jPCTposition,
                      int attmodel,
                      float distOrRoll)
Creates a new non-streaming, non-priority source at the specified position. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newSource

public void newSource(boolean priority,
                      java.lang.String sourcename,
                      java.lang.String filename,
                      boolean toLoop,
                      com.threed.jpct.SimpleVector jPCTposition,
                      int attmodel,
                      float distOrRoll)
Creates a new non-streaming source at the specified position. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newSource

public void newSource(java.lang.String sourcename,
                      java.net.URL url,
                      java.lang.String identifier,
                      boolean toLoop)
Creates a new non-streaming, non-priority source at the origin. Default values are used for attenuation.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.

newSource

public void newSource(boolean priority,
                      java.lang.String sourcename,
                      java.net.URL url,
                      java.lang.String identifier,
                      boolean toLoop)
Creates a new non-streaming source at the origin. Default values are used for attenuation.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.

newSource

public void newSource(java.lang.String sourcename,
                      java.net.URL url,
                      java.lang.String identifier,
                      boolean toLoop,
                      com.threed.jpct.SimpleVector jPCTposition)
Creates a new non-streaming, non-priority source at the specified position. Default values are used for attenuation.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.

newSource

public void newSource(boolean priority,
                      java.lang.String sourcename,
                      java.net.URL url,
                      java.lang.String identifier,
                      boolean toLoop,
                      com.threed.jpct.SimpleVector jPCTposition)
Creates a new non-streaming source at the specified position. Default values are used for attenuation.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.

newSource

public void newSource(java.lang.String sourcename,
                      java.net.URL url,
                      java.lang.String identifier,
                      boolean toLoop,
                      int attmodel)
Creates a new non-streaming, non-priority source at the origin. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.

newSource

public void newSource(boolean priority,
                      java.lang.String sourcename,
                      java.net.URL url,
                      java.lang.String identifier,
                      boolean toLoop,
                      int attmodel)
Creates a new non-streaming source at the origin. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.

newSource

public void newSource(java.lang.String sourcename,
                      java.net.URL url,
                      java.lang.String identifier,
                      boolean toLoop,
                      int attmodel,
                      float distORroll)
Creates a new non-streaming, non-priority source at the origin. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newSource

public void newSource(boolean priority,
                      java.lang.String sourcename,
                      java.net.URL url,
                      java.lang.String identifier,
                      boolean toLoop,
                      int attmodel,
                      float distORroll)
Creates a new non-streaming source at the origin. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newSource

public void newSource(java.lang.String sourcename,
                      java.net.URL url,
                      java.lang.String identifier,
                      boolean toLoop,
                      com.threed.jpct.SimpleVector jPCTposition,
                      int attmodel)
Creates a new non-streaming, non-priority source at the specified position. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.

newSource

public void newSource(boolean priority,
                      java.lang.String sourcename,
                      java.net.URL url,
                      java.lang.String identifier,
                      boolean toLoop,
                      com.threed.jpct.SimpleVector jPCTposition,
                      int attmodel)
Creates a new non-streaming source at the specified position. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.

newSource

public void newSource(java.lang.String sourcename,
                      java.net.URL url,
                      java.lang.String identifier,
                      boolean toLoop,
                      com.threed.jpct.SimpleVector jPCTposition,
                      int attmodel,
                      float distOrRoll)
Creates a new non-streaming, non-priority source at the specified position. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newSource

public void newSource(boolean priority,
                      java.lang.String sourcename,
                      java.net.URL url,
                      java.lang.String identifier,
                      boolean toLoop,
                      com.threed.jpct.SimpleVector jPCTposition,
                      int attmodel,
                      float distOrRoll)
Creates a new non-streaming source at the specified position. See SoundSystemConfig for more information about Attenuation, fade distance, and rolloff factor.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newStreamingSource

public void newStreamingSource(java.lang.String sourcename,
                               java.lang.String filename,
                               boolean toLoop)
Creates a new streaming non-priority source at the origin. Default values are used for attenuation.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.

newStreamingSource

public void newStreamingSource(boolean priority,
                               java.lang.String sourcename,
                               java.lang.String filename,
                               boolean toLoop)
Creates a new streaming source. Default values are used for attenuation.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.

newStreamingSource

public void newStreamingSource(java.lang.String sourcename,
                               java.lang.String filename,
                               boolean toLoop,
                               com.threed.jpct.SimpleVector jPCTposition)
Creates a new streaming non-priority source at the specified position. Default values are used for attenuation.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.

newStreamingSource

public void newStreamingSource(boolean priority,
                               java.lang.String sourcename,
                               java.lang.String filename,
                               boolean toLoop,
                               com.threed.jpct.SimpleVector jPCTposition)
Creates a new streaming source at the specified position. Default values are used for attenuation.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.

newStreamingSource

public void newStreamingSource(java.lang.String sourcename,
                               java.lang.String filename,
                               boolean toLoop,
                               int attmodel)
Creates a new streaming non-priority source at the origin. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.

newStreamingSource

public void newStreamingSource(boolean priority,
                               java.lang.String sourcename,
                               java.lang.String filename,
                               boolean toLoop,
                               int attmodel)
Creates a new streaming source at the origin. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.

newStreamingSource

public void newStreamingSource(java.lang.String sourcename,
                               java.lang.String filename,
                               boolean toLoop,
                               int attmodel,
                               float distORroll)
Creates a new streaming non-priority source at the origin.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newStreamingSource

public void newStreamingSource(boolean priority,
                               java.lang.String sourcename,
                               java.lang.String filename,
                               boolean toLoop,
                               int attmodel,
                               float distORroll)
Creates a new streaming source at the origin.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newStreamingSource

public void newStreamingSource(java.lang.String sourcename,
                               java.lang.String filename,
                               boolean toLoop,
                               com.threed.jpct.SimpleVector jPCTposition,
                               int attmodel)
Creates a new streaming non-priority source at the specified position. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.

newStreamingSource

public void newStreamingSource(boolean priority,
                               java.lang.String sourcename,
                               java.lang.String filename,
                               boolean toLoop,
                               com.threed.jpct.SimpleVector jPCTposition,
                               int attmodel)
Creates a new streaming source at the specified position. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.

newStreamingSource

public void newStreamingSource(java.lang.String sourcename,
                               java.lang.String filename,
                               boolean toLoop,
                               com.threed.jpct.SimpleVector jPCTposition,
                               int attmodel,
                               float distOrRoll)
Creates a new streaming non-priority source at the specified position.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newStreamingSource

public void newStreamingSource(boolean priority,
                               java.lang.String sourcename,
                               java.lang.String filename,
                               boolean toLoop,
                               com.threed.jpct.SimpleVector jPCTposition,
                               int attmodel,
                               float distOrRoll)
Creates a new streaming source at the specified position.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newStreamingSource

public void newStreamingSource(java.lang.String sourcename,
                               java.net.URL url,
                               java.lang.String identifier,
                               boolean toLoop)
Creates a new streaming non-priority source at the origin. Default values are used for attenuation.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.

newStreamingSource

public void newStreamingSource(boolean priority,
                               java.lang.String sourcename,
                               java.net.URL url,
                               java.lang.String identifier,
                               boolean toLoop)
Creates a new streaming source. Default values are used for attenuation.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.

newStreamingSource

public void newStreamingSource(java.lang.String sourcename,
                               java.net.URL url,
                               java.lang.String identifier,
                               boolean toLoop,
                               com.threed.jpct.SimpleVector jPCTposition)
Creates a new streaming non-priority source at the specified position. Default values are used for attenuation.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.

newStreamingSource

public void newStreamingSource(boolean priority,
                               java.lang.String sourcename,
                               java.net.URL url,
                               java.lang.String identifier,
                               boolean toLoop,
                               com.threed.jpct.SimpleVector jPCTposition)
Creates a new streaming source at the specified position. Default values are used for attenuation.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.

newStreamingSource

public void newStreamingSource(java.lang.String sourcename,
                               java.net.URL url,
                               java.lang.String identifier,
                               boolean toLoop,
                               int attmodel)
Creates a new streaming non-priority source at the origin. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.

newStreamingSource

public void newStreamingSource(boolean priority,
                               java.lang.String sourcename,
                               java.net.URL url,
                               java.lang.String identifier,
                               boolean toLoop,
                               int attmodel)
Creates a new streaming source at the origin. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.

newStreamingSource

public void newStreamingSource(java.lang.String sourcename,
                               java.net.URL url,
                               java.lang.String identifier,
                               boolean toLoop,
                               int attmodel,
                               float distORroll)
Creates a new streaming non-priority source at the origin.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newStreamingSource

public void newStreamingSource(boolean priority,
                               java.lang.String sourcename,
                               java.net.URL url,
                               java.lang.String identifier,
                               boolean toLoop,
                               int attmodel,
                               float distORroll)
Creates a new streaming source at the origin.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newStreamingSource

public void newStreamingSource(java.lang.String sourcename,
                               java.net.URL url,
                               java.lang.String identifier,
                               boolean toLoop,
                               com.threed.jpct.SimpleVector jPCTposition,
                               int attmodel)
Creates a new streaming non-priority source at the specified position. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.

newStreamingSource

public void newStreamingSource(boolean priority,
                               java.lang.String sourcename,
                               java.net.URL url,
                               java.lang.String identifier,
                               boolean toLoop,
                               com.threed.jpct.SimpleVector jPCTposition,
                               int attmodel)
Creates a new streaming source at the specified position. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.

newStreamingSource

public void newStreamingSource(java.lang.String sourcename,
                               java.net.URL url,
                               java.lang.String identifier,
                               boolean toLoop,
                               com.threed.jpct.SimpleVector jPCTposition,
                               int attmodel,
                               float distOrRoll)
Creates a new streaming non-priority source at the specified position.

Parameters:
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

newStreamingSource

public void newStreamingSource(boolean priority,
                               java.lang.String sourcename,
                               java.net.URL url,
                               java.lang.String identifier,
                               boolean toLoop,
                               com.threed.jpct.SimpleVector jPCTposition,
                               int attmodel,
                               float distOrRoll)
Creates a new streaming source at the specified position.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
sourcename - A unique identifier for this source. Two sources may not use the same sourcename.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".

quickPlay

public java.lang.String quickPlay(java.lang.String filename,
                                  boolean toLoop)
Creates a temporary, non-priority source at the origin and plays it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.lang.String filename,
                                  boolean toLoop)
Creates a temporary source at the origin and plays it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.lang.String filename,
                                  boolean toLoop,
                                  com.threed.jpct.SimpleVector jPCTposition)
Creates a temporary non-priority source at the specified position and plays it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.lang.String filename,
                                  boolean toLoop,
                                  com.threed.jpct.SimpleVector jPCTposition)
Creates a temporary source and plays it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.lang.String filename,
                                  boolean toLoop,
                                  int attmodel)
Creates a temporary non-priority source at the origin and plays it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.lang.String filename,
                                  boolean toLoop,
                                  int attmodel)
Creates a temporary source and plays it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.lang.String filename,
                                  boolean toLoop,
                                  int attmodel,
                                  float distORroll)
Creates a temporary non-priority source at the origin and plays it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.lang.String filename,
                                  boolean toLoop,
                                  int attmodel,
                                  float distORroll)
Creates a temporary source at the origin and plays it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.lang.String filename,
                                  boolean toLoop,
                                  com.threed.jpct.SimpleVector jPCTposition,
                                  int attmodel)
Creates a temporary non-priority source and plays it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.lang.String filename,
                                  boolean toLoop,
                                  com.threed.jpct.SimpleVector jPCTposition,
                                  int attmodel)
Creates a temporary source and plays it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.lang.String filename,
                                  boolean toLoop,
                                  com.threed.jpct.SimpleVector jPCTposition,
                                  int attmodel,
                                  float distOrRoll)
Creates a temporary non-priority source and plays it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.lang.String filename,
                                  boolean toLoop,
                                  com.threed.jpct.SimpleVector jPCTposition,
                                  int attmodel,
                                  float distOrRoll)
Creates a temporary source and plays it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.lang.String filename,
                                  boolean toLoop,
                                  com.threed.jpct.Object3D object)
Creates a temporary non-priority source, binds it to the specified Object3D, and plays. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.lang.String filename,
                                  boolean toLoop,
                                  com.threed.jpct.Object3D object)
Creates a temporary source, binds it to the specified Object3D, and plays. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.lang.String filename,
                                  boolean toLoop,
                                  com.threed.jpct.Object3D object,
                                  int attmodel)
Creates a temporary non-priority source, binds it to the specified Object3D, and plays. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.lang.String filename,
                                  boolean toLoop,
                                  com.threed.jpct.Object3D object,
                                  int attmodel)
Creates a temporary source, binds it to the specified Object3D, and plays. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.lang.String filename,
                                  boolean toLoop,
                                  com.threed.jpct.Object3D object,
                                  int attmodel,
                                  float distOrRoll)
Creates a temporary non-priority source, binds it to the specified Object3D, and plays. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.lang.String filename,
                                  boolean toLoop,
                                  com.threed.jpct.Object3D object,
                                  int attmodel,
                                  float distOrRoll)
Creates a temporary source, binds it to the specified Object3D, and plays it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop)
Creates a temporary, non-priority source at the origin and plays it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop)
Creates a temporary source at the origin and plays it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  com.threed.jpct.SimpleVector jPCTposition)
Creates a temporary non-priority source at the specified position and plays it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  com.threed.jpct.SimpleVector jPCTposition)
Creates a temporary source and plays it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  int attmodel)
Creates a temporary non-priority source at the origin and plays it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  int attmodel)
Creates a temporary source and plays it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  int attmodel,
                                  float distORroll)
Creates a temporary non-priority source at the origin and plays it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  int attmodel,
                                  float distORroll)
Creates a temporary source at the origin and plays it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  com.threed.jpct.SimpleVector jPCTposition,
                                  int attmodel)
Creates a temporary non-priority source and plays it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  com.threed.jpct.SimpleVector jPCTposition,
                                  int attmodel)
Creates a temporary source and plays it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  com.threed.jpct.SimpleVector jPCTposition,
                                  int attmodel,
                                  float distOrRoll)
Creates a temporary non-priority source and plays it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  com.threed.jpct.SimpleVector jPCTposition,
                                  int attmodel,
                                  float distOrRoll)
Creates a temporary source and plays it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  com.threed.jpct.Object3D object)
Creates a temporary non-priority source, binds it to the specified Object3D, and plays. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  com.threed.jpct.Object3D object)
Creates a temporary source, binds it to the specified Object3D, and plays. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  com.threed.jpct.Object3D object,
                                  int attmodel)
Creates a temporary non-priority source, binds it to the specified Object3D, and plays. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  com.threed.jpct.Object3D object,
                                  int attmodel)
Creates a temporary source, binds it to the specified Object3D, and plays. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  com.threed.jpct.Object3D object,
                                  int attmodel,
                                  float distOrRoll)
Creates a temporary non-priority source, binds it to the specified Object3D, and plays. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickPlay

public java.lang.String quickPlay(boolean priority,
                                  java.net.URL url,
                                  java.lang.String identifier,
                                  boolean toLoop,
                                  com.threed.jpct.Object3D object,
                                  int attmodel,
                                  float distOrRoll)
Creates a temporary source, binds it to the specified Object3D, and plays it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.lang.String filename,
                                    boolean toLoop)
Creates a temporary, non-priority source at the origin and streams it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.lang.String filename,
                                    boolean toLoop)
Creates a temporary source at the origin and streams it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.lang.String filename,
                                    boolean toLoop,
                                    com.threed.jpct.SimpleVector jPCTposition)
Creates a temporary non-priority source and streams it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.lang.String filename,
                                    boolean toLoop,
                                    com.threed.jpct.SimpleVector jPCTposition)
Creates a temporary source and streams it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.lang.String filename,
                                    boolean toLoop,
                                    int attmodel)
Creates a temporary non-priority source at the origin and streams it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.lang.String filename,
                                    boolean toLoop,
                                    int attmodel)
Creates a temporary source and streams it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.lang.String filename,
                                    boolean toLoop,
                                    int attmodel,
                                    float distORroll)
Creates a temporary non-priority source at the origin and streams it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.lang.String filename,
                                    boolean toLoop,
                                    int attmodel,
                                    float distORroll)
Creates a temporary source at the origin and streams it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.lang.String filename,
                                    boolean toLoop,
                                    com.threed.jpct.SimpleVector jPCTposition,
                                    int attmodel)
Creates a temporary non-priority source and streams it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.lang.String filename,
                                    boolean toLoop,
                                    com.threed.jpct.SimpleVector jPCTposition,
                                    int attmodel)
Creates a temporary source and streams it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.lang.String filename,
                                    boolean toLoop,
                                    com.threed.jpct.SimpleVector jPCTposition,
                                    int attmodel,
                                    float distOrRoll)
Creates a temporary non-priority source and streams it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.lang.String filename,
                                    boolean toLoop,
                                    com.threed.jpct.SimpleVector jPCTposition,
                                    int attmodel,
                                    float distOrRoll)
Creates a temporary source and streams it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.lang.String filename,
                                    boolean toLoop,
                                    com.threed.jpct.Object3D object)
Creates a temporary non-priority source, binds it to the specified Object3D, and streams it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.lang.String filename,
                                    boolean toLoop,
                                    com.threed.jpct.Object3D object)
Creates a temporary source, binds it to the specified Object3D, and streams it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.lang.String filename,
                                    boolean toLoop,
                                    com.threed.jpct.Object3D object,
                                    int attmodel)
Creates a temporary non-priority source, binds it to the specified Object3D, and streams it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.lang.String filename,
                                    boolean toLoop,
                                    com.threed.jpct.Object3D object,
                                    int attmodel)
Creates a temporary source, binds it to the specified Object3D, and streams it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.lang.String filename,
                                    boolean toLoop,
                                    com.threed.jpct.Object3D object,
                                    int attmodel,
                                    float distOrRoll)
Creates a temporary non-priority source, binds it to the specified Object3D, and streams it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.lang.String filename,
                                    boolean toLoop,
                                    com.threed.jpct.Object3D object,
                                    int attmodel,
                                    float distOrRoll)
Creates a temporary source, binds it to the specified Object3D, and streams it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
filename - The name of the sound file to play at this source.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop)
Creates a temporary, non-priority source at the origin and streams it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop)
Creates a temporary source at the origin and streams it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    com.threed.jpct.SimpleVector jPCTposition)
Creates a temporary non-priority source and streams it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    com.threed.jpct.SimpleVector jPCTposition)
Creates a temporary source and streams it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    int attmodel)
Creates a temporary non-priority source at the origin and streams it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    int attmodel)
Creates a temporary source and streams it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    int attmodel,
                                    float distORroll)
Creates a temporary non-priority source at the origin and streams it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    int attmodel,
                                    float distORroll)
Creates a temporary source at the origin and streams it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
attmodel - Attenuation model to use.
distORroll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    com.threed.jpct.SimpleVector jPCTposition,
                                    int attmodel)
Creates a temporary non-priority source and streams it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    com.threed.jpct.SimpleVector jPCTposition,
                                    int attmodel)
Creates a temporary source and streams it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    com.threed.jpct.SimpleVector jPCTposition,
                                    int attmodel,
                                    float distOrRoll)
Creates a temporary non-priority source and streams it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    com.threed.jpct.SimpleVector jPCTposition,
                                    int attmodel,
                                    float distOrRoll)
Creates a temporary source and streams it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
jPCTposition - SimpleVector containing jPCT coordinates.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    com.threed.jpct.Object3D object)
Creates a temporary non-priority source, binds it to the specified Object3D, and streams it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    com.threed.jpct.Object3D object)
Creates a temporary source, binds it to the specified Object3D, and streams it. Default values are used for attenuation. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    com.threed.jpct.Object3D object,
                                    int attmodel)
Creates a temporary non-priority source, binds it to the specified Object3D, and streams it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    com.threed.jpct.Object3D object,
                                    int attmodel)
Creates a temporary source, binds it to the specified Object3D, and streams it. Default value is used for either fade-distance or rolloff factor, depending on the value of parameter 'attmodel'. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    com.threed.jpct.Object3D object,
                                    int attmodel,
                                    float distOrRoll)
Creates a temporary non-priority source, binds it to the specified Object3D, and streams it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

quickStream

public java.lang.String quickStream(boolean priority,
                                    java.net.URL url,
                                    java.lang.String identifier,
                                    boolean toLoop,
                                    com.threed.jpct.Object3D object,
                                    int attmodel,
                                    float distOrRoll)
Creates a temporary source, binds it to the specified Object3D, and streams it. After the source finishes playing, it is removed. Returns a randomly generated name for the new source. NOTE: to make a source created by this method permanant, call the setActive() method using the return value for sourcename.

Parameters:
priority - Setting this to true will prevent other sounds from overriding this one.
url - URL handle to the sound file to stream at this source.
identifier - Filename/identifier of the file referenced by the URL.
toLoop - Should this source loop, or play only once.
object - Object3D for this source to follow.
attmodel - Attenuation model to use.
distOrRoll - Either the fading distance or rolloff factor, depending on the value of "attmodel".
Returns:
The new sorce's name.

setPosition

public void setPosition(java.lang.String sourcename,
                        com.threed.jpct.SimpleVector jPCTposition)
Move a source to the specified location.

Parameters:
sourcename - Identifier for the source.
jPCTposition - SimpleVector containing jPCT coordinates.

moveListener

public void moveListener(com.threed.jpct.SimpleVector jPCTrelative)
Moves the listener relative to the current location.

Parameters:
jPCTrelative - SimpleVector containing jPCT coordinates.

setListenerPosition

public void setListenerPosition(com.threed.jpct.SimpleVector jPCTposition)
Moves the listener to the specified location.

Parameters:
jPCTposition - SimpleVector containing jPCT coordinates.

setListenerOrientation

public void setListenerOrientation(com.threed.jpct.SimpleVector jPCTlook,
                                   com.threed.jpct.SimpleVector jPCTup)
Sets the listener's orientation.

Parameters:
jPCTlook - normalized SimpleVector representing the "look" direction (in jPCT coordinates).
jPCTup - normalized SimpleVector representing the "up" direction (in jPCT coordinates).

setListenerOrientation

public void setListenerOrientation(com.threed.jpct.Camera camera)
Sets the listener's orientation to match the specified camera.

Parameters:
camera - Camera to match.

setVelocity

public void setVelocity(java.lang.String sourcename,
                        com.threed.jpct.SimpleVector velocity)
Sets the specified source's velocity, for use in Doppler effect. See SoundSystemConfig for more information about Doppler effect.

Parameters:
sourcename - The source's name.
velocity - Velocity vector in jPCT world-space.

setListenerVelocity

public void setListenerVelocity(com.threed.jpct.SimpleVector velocity)
Sets the listener's velocity, for use in Doppler effect. See SoundSystemConfig for more information about Doppler effect.

Parameters:
velocity - Velocity vector in jPCT world-space.

convertCoordinates

public com.threed.jpct.SimpleVector convertCoordinates(com.threed.jpct.SimpleVector v)
Converts a SimpleVector from jPCT coordinates into SoundSystem coordinates, and vice-versa. (y = -y and z = -z)