| java.lang.Object
 com.sun.j3d.audioengines.AudioEngine
com.sun.j3d.audioengines.AudioEngine3D
com.sun.j3d.audioengines.AudioEngine3DL2
All known Subclasses: com.sun.j3d.audioengines.javasound.JavaSoundMixer, org.jdesktop.j3d.audioengines.joal.JOALMixer,
| AudioEngine3DL2 | | abstract public class AudioEngine3DL2 extends AudioEngine3D implements AudioDevice3DL2(Code) | | The AudioEngine3DL2 Class defines an audio output device that generates
sound 'image' from high-level sound parameters passed to it during
scene graph.
The methods in this class are meant to be optionally overridden by an
extended class. This extended class would provice device specific code.
Error checking on all parameters passed to these methods is already
explicitly being done by the Java 3D core code that calls these methods.
These methods should NOT be called by any application if the audio engine
is associated with a Physical Environment used by Java3D Core.
since:
Java 3D 1.3 |
| Method Summary | |
| abstract public void | pause()
Pauses audio device engine without closing the device and associated
threads. | | abstract public void | resume()
Resumes audio device engine (if previously paused) without
reinitializing the device. | | public void | setDecayFilter(float frequencyCutoff)
Set reverb decay filter.
This provides for frequencies above the given cutoff frequency to be
attenuated during reverb decay at a different rate than frequencies
below this value. | | public void | setDecayTime(float time)
Set reverb decay time. | | public void | setDensity(float density)
Set reverb density. | | public void | setDiffusion(float diffusion)
Set reverb diffusion. | | abstract public void | setGain(float scaleFactor)
Set overall gain control of all sounds playing on the audio device. | | public void | setObstructionFilter(int index, float frequencyCutoff)
Set the obstruction filter control.
This provides for frequencies above the given cutoff frequency
to be attenuated, during while the gain of an obstruction signal
is being calculated, at a different rate than frequencies
below this value.
There is no corresponding Core AuralAttributes method at this time.
Parameters:
index - device specific reference to device driver sample
Parameters:
frequencyCutoff - value of frequencies in Hertz above which alow-pass filter is applied. | | public void | setObstructionGain(int index, float scaleFactor)
Set the obstruction gain control. | | public void | setOcclusionFilter(int index, float frequencyCutoff)
Set the occlusion filter control.
This provides for frequencies above the given cutoff frequency
to be attenuated, during while the gain of an occluded signal
is being calculated, at a different rate than frequencies below
this value.
There is no corresponding Core AuralAttributes method at this time.
Parameters:
index - device specific reference to device driver sample
Parameters:
frequencyCutoff - value of frequencies in Hertz above which alow-pass filter is applied. | | public void | setOcclusionGain(int index, float scaleFactor)
Set the occlusion gain control. | | public void | setRateScaleFactor(int index, float scaleFactor)
Set scale factor applied to sample playback rate for a particular sound
associated with the audio device. | | public void | setReflectionDelay(float reflectionDelay)
Sets the early reflection delay time.
In this form, the parameter specifies the delay time between each order
of reflection (while reverberation is being rendered) explicitly given
in milliseconds. | | public void | setReverbCoefficient(float coefficient)
Set late reflection (referred to as 'reverb') attenuation. |
| AudioEngine3DL2 | | public AudioEngine3DL2(PhysicalEnvironment physicalEnvironment)(Code) | | Construct a new AudioEngine3DL2 with the specified PhysicalEnvironment.
Parameters:
physicalEnvironment - the physical environment object where wewant access to this device. |
| pause | | abstract public void pause()(Code) | | Pauses audio device engine without closing the device and associated
threads.
Causes all cached sounds to be paused and all streaming sounds to be
stopped.
|
| resume | | abstract public void resume()(Code) | | Resumes audio device engine (if previously paused) without
reinitializing the device.
Causes all paused cached sounds to be resumed and all streaming
sounds restarted.
|
| setDecayFilter | | public void setDecayFilter(float frequencyCutoff)(Code) | | Set reverb decay filter.
This provides for frequencies above the given cutoff frequency to be
attenuated during reverb decay at a different rate than frequencies
below this value. Thus, defining a different reverb decay curve for
frequencies above the cutoff value.
Parameters:
frequencyCutoff - value of frequencies in Hertz above which alow-pass filter is applied.
See Also: AuralAttributes.setDecayFilter |
| setDecayTime | | public void setDecayTime(float time)(Code) | | Set reverb decay time.
Defines the reverberation decay curve.
Parameters:
time - decay time in milliseconds
See Also: AuralAttributes.setDecayTime |
| setDensity | | public void setDensity(float density)(Code) | | Set reverb density.
This defines the modal density (also referred to as 'spectral
coloration').
The value of this parameter is expressed as a percent of the audio
device's minimum-to-maximum values for this reverb parameter.
Parameters:
density - reverb density expressed as a percentage,within the range of 0.0 and 1.0
See Also: AuralAttributes.setDensity |
| setDiffusion | | public void setDiffusion(float diffusion)(Code) | | Set reverb diffusion.
This defines the echo dispersement (also referred to as 'echo density').
The value of this reverb parameter is expressed as a percent of the
audio device's minimum-to-maximum values.
Parameters:
diffusion - percentage expressed within the range of 0.0 and 1.0
See Also: AuralAttributes.setDiffusion |
| setGain | | abstract public void setGain(float scaleFactor)(Code) | | Set overall gain control of all sounds playing on the audio device.
Parameters:
scaleFactor - scale factor applied to calculated amplitudes forall sounds playing on this device |
| setObstructionFilter | | public void setObstructionFilter(int index, float frequencyCutoff)(Code) | | Set the obstruction filter control.
This provides for frequencies above the given cutoff frequency
to be attenuated, during while the gain of an obstruction signal
is being calculated, at a different rate than frequencies
below this value.
There is no corresponding Core AuralAttributes method at this time.
Parameters:
index - device specific reference to device driver sample
Parameters:
frequencyCutoff - value of frequencies in Hertz above which alow-pass filter is applied. |
| setObstructionGain | | public void setObstructionGain(int index, float scaleFactor)(Code) | | Set the obstruction gain control. This method allows for attenuating
sound waves traveling between the sound source and the listener
obstructed by objects. Direct sound signals/waves for obstructed sound
source are attenuated but not indirect (reflected) waves.
There is no corresponding Core AuralAttributes method at this time.
Parameters:
index - device specific reference to device driver sample
Parameters:
scaleFactor - non-negative factor applied to direct sound gain |
| setOcclusionFilter | | public void setOcclusionFilter(int index, float frequencyCutoff)(Code) | | Set the occlusion filter control.
This provides for frequencies above the given cutoff frequency
to be attenuated, during while the gain of an occluded signal
is being calculated, at a different rate than frequencies below
this value.
There is no corresponding Core AuralAttributes method at this time.
Parameters:
index - device specific reference to device driver sample
Parameters:
frequencyCutoff - value of frequencies in Hertz above which alow-pass filter is applied. |
| setOcclusionGain | | public void setOcclusionGain(int index, float scaleFactor)(Code) | | Set the occlusion gain control. This method allows for attenuating
sound waves traveling between the sound source and the listener
occluded by objects. Both direct and indirect sound signals/waves
for occluded sound sources are attenuated.
There is no corresponding Core AuralAttributes method at this time.
Parameters:
index - device specific reference to device driver sample
Parameters:
scaleFactor - non-negative factor applied to direct sound gain |
| setRateScaleFactor | | public void setRateScaleFactor(int index, float scaleFactor)(Code) | | Set scale factor applied to sample playback rate for a particular sound
associated with the audio device.
Changing the device sample rate affects both the pitch and speed.
This scale factor is applied to ALL sound types.
Changes (scales) the playback rate of a sound independent of
Doppler rate changes.
Parameters:
index - device specific reference to device driver sample
Parameters:
scaleFactor - non-negative factor applied to calculated amplitudes for all sounds playing on this device
See Also: Sound.setRateScaleFactor |
| setReflectionDelay | | public void setReflectionDelay(float reflectionDelay)(Code) | | Sets the early reflection delay time.
In this form, the parameter specifies the delay time between each order
of reflection (while reverberation is being rendered) explicitly given
in milliseconds.
Parameters:
reflectionDelay - time between each order of early reflection
See Also: AuralAttributes.setReflectionDelay |
| setReverbCoefficient | | public void setReverbCoefficient(float coefficient)(Code) | | Set late reflection (referred to as 'reverb') attenuation.
This scale factor is applied to iterative, indistinguishable
late reflections that constitute the tail of reverberated sound in
the aural environment.
This parameter, along with the early reflection coefficient, defines
the reflective/absorptive characteristic of the surfaces in the
current listening region.
Parameters:
coefficient - late reflection attenuation factor
See Also: AuralAttributes.setReverbCoefficient |
| Methods inherited from com.sun.j3d.audioengines.AudioEngine3D | abstract public void clearSound(int index)(Code)(Java Doc)
public AuralParameters getAuralParameters()(Code)(Java Doc)
public int getNumberOfChannelsUsed(int index)(Code)(Java Doc)
public int getNumberOfChannelsUsed(int index, boolean muteFlag)(Code)(Java Doc)
public Sample getSample(int index)(Code)(Java Doc)
public long getSampleDuration(int index)(Code)(Java Doc)
protected ArrayList getSampleList()(Code)(Java Doc)
public int getSampleListSize()(Code)(Java Doc)
public long getStartTime(int index)(Code)(Java Doc)
public View getView()(Code)(Java Doc)
abstract public void muteSample(int index)(Code)(Java Doc)
abstract public void pauseSample(int index)(Code)(Java Doc)
public int prepareSound(int soundType, MediaContainer soundData)(Code)(Java Doc)
public void setAngularAttenuation(int index, int filterType, double[] angle, float[] attenuationScaleFactor, float[] filterCutoff)(Code)(Java Doc)
public void setDirection(int index, Vector3d direction)(Code)(Java Doc)
public void setDistanceFilter(int filterType, double[] dist, float[] filterCutoff)(Code)(Java Doc)
public void setDistanceGain(int index, double[] frontDistance, float[] frontAttenuationScaleFactor, double[] backDistance, float[] backAttenuationScaleFactor)(Code)(Java Doc)
public void setFrequencyScaleFactor(float scaleFactor)(Code)(Java Doc)
public void setLoop(int index, int count)(Code)(Java Doc)
public void setPosition(int index, Point3d position)(Code)(Java Doc)
public void setReflectionCoefficient(float coefficient)(Code)(Java Doc)
public void setReverbDelay(float reverbDelay)(Code)(Java Doc)
public void setReverbOrder(int reverbOrder)(Code)(Java Doc)
public void setRolloff(float rolloff)(Code)(Java Doc)
public void setSampleGain(int index, float scaleFactor)(Code)(Java Doc)
public void setVelocityScaleFactor(float scaleFactor)(Code)(Java Doc)
public void setView(View reference)(Code)(Java Doc)
public void setVworldXfrm(int index, Transform3D trans)(Code)(Java Doc)
abstract public int startSample(int index)(Code)(Java Doc)
abstract public int stopSample(int index)(Code)(Java Doc)
abstract public void unmuteSample(int index)(Code)(Java Doc)
abstract public void unpauseSample(int index)(Code)(Java Doc)
abstract public void updateSample(int index)(Code)(Java Doc)
|
|
|