audioengine3d.html

JAVA多媒体开发类库说明

<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - device specific reference number to device driver sample</DL>
</DD>
</DL>
<HR>

<A NAME="pauseSample(int)"><!-- --></A><H3>
pauseSample</H3>
<PRE>
public abstract void <B>pauseSample</B>(int&nbsp;index)</PRE>
<DL>
<DD>Pause sample.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html#pauseSample(int)">pauseSample</A></CODE> in interface <CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - device specific reference number to device driver sample</DL>
</DD>
</DL>
<HR>

<A NAME="unpauseSample(int)"><!-- --></A><H3>
unpauseSample</H3>
<PRE>
public abstract void <B>unpauseSample</B>(int&nbsp;index)</PRE>
<DL>
<DD>Unpause sample.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html#unpauseSample(int)">unpauseSample</A></CODE> in interface <CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - device specific reference number to device driver sample</DL>
</DD>
</DL>
<HR>

<A NAME="setSampleGain(int, float)"><!-- --></A><H3>
setSampleGain</H3>
<PRE>
public void <B>setSampleGain</B>(int&nbsp;index,
                          float&nbsp;scaleFactor)</PRE>
<DL>
<DD>Set gain scale factor applied to sample.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html#setSampleGain(int, float)">setSampleGain</A></CODE> in interface <CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - device specific reference number to device driver sample<DD><CODE>scaleFactor</CODE> - floating point multiplier applied to sample amplitude</DL>
</DD>
</DL>
<HR>

<A NAME="setLoop(int, int)"><!-- --></A><H3>
setLoop</H3>
<PRE>
public void <B>setLoop</B>(int&nbsp;index,
                    int&nbsp;count)</PRE>
<DL>
<DD>Set number of times sample is looped.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html#setLoop(int, int)">setLoop</A></CODE> in interface <CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - device specific reference number to device driver sample<DD><CODE>count</CODE> - number of times sample is repeated<DT><B>See Also:</B><DD><A HREF="../../../../javax/media/j3d/Sound.html#setLoop(int)"><CODE>Sound.setLoop(int)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setPosition(int, javax.vecmath.Point3d)"><!-- --></A><H3>
setPosition</H3>
<PRE>
public void <B>setPosition</B>(int&nbsp;index,
                        <A HREF="../../../../javax/vecmath/Point3d.html" title="class in javax.vecmath">Point3d</A>&nbsp;position)</PRE>
<DL>
<DD>Set location of sample.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html#setPosition(int, javax.vecmath.Point3d)">setPosition</A></CODE> in interface <CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - device specific reference number to device driver sample<DD><CODE>position</CODE> - point location in virtual world coordinate of sample<DT><B>See Also:</B><DD><A HREF="../../../../javax/media/j3d/PointSound.html#setPosition(float, float, float)"><CODE>PointSound.setPosition(float x, float y, float z)</CODE></A>, 
<A HREF="../../../../javax/media/j3d/PointSound.html#setPosition(javax.vecmath.Point3f)"><CODE>PointSound.setPosition(Point3f position)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setDistanceGain(int, double[], float[], double[], float[])"><!-- --></A><H3>
setDistanceGain</H3>
<PRE>
public void <B>setDistanceGain</B>(int&nbsp;index,
                            double[]&nbsp;frontDistance,
                            float[]&nbsp;frontAttenuationScaleFactor,
                            double[]&nbsp;backDistance,
                            float[]&nbsp;backAttenuationScaleFactor)</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html#setDistanceGain(int, double[], float[], double[], float[])">AudioDevice3D</A></CODE></B></DD>
<DD>Sets this sound's distance gain elliptical attenuation (not
 including filter cutoff frequency) by defining corresponding 
 arrays containing distances from the sound's origin and gain
 scale factors applied to all active positional sounds.
 Gain scale factor is applied to sound based on the distance 
 the listener
 is from sound source.
 These attenuation parameters are ignored for BackgroundSound nodes.
 The back attenuation parameter is ignored for PointSound nodes.
 <P>
 The form of the attenuation parameters match that of the ConeSound method
 of the same name.
 A full description of this parameter and how it is used is in 
 the documentation for ConeSound class.
 <P> 
 This method should only be called by Java3D Core and  NOT by any application.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html#setDistanceGain(int, double[], float[], double[], float[])">setDistanceGain</A></CODE> in interface <CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - device specific reference number to device driver sample<DD><CODE>frontDistance</CODE> - defines an array of distance along positive axis
 through which ellipses pass<DD><CODE>frontAttenuationScaleFactor</CODE> - gain scale factors<DD><CODE>backDistance</CODE> - defines an array of distance along the negative axis
 through which ellipses pass<DD><CODE>backAttenuationScaleFactor</CODE> - gain scale factors<DT><B>See Also:</B><DD><A HREF="../../../../javax/media/j3d/ConeSound.html#setDistanceGain(float[], float[], float[], float[])"><CODE>ConeSound.setDistanceGain(float[] frontDistance, float[] frontGain,
 float[] backDistance, float[] backGain)</CODE></A>, 
<A HREF="../../../../javax/media/j3d/ConeSound.html#setDistanceGain(javax.vecmath.Point2f[], javax.vecmath.Point2f[])"><CODE>ConeSound.setDistanceGain(Point2f[] frontAttenuation,
 Point2f[] backAttenuation)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setDirection(int, javax.vecmath.Vector3d)"><!-- --></A><H3>
setDirection</H3>
<PRE>
public void <B>setDirection</B>(int&nbsp;index,
                         <A HREF="../../../../javax/vecmath/Vector3d.html" title="class in javax.vecmath">Vector3d</A>&nbsp;direction)</PRE>
<DL>
<DD>Set direction vector of sample.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html#setDirection(int, javax.vecmath.Vector3d)">setDirection</A></CODE> in interface <CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - device specific reference number to device driver sample<DD><CODE>direction</CODE> - vector in virtual world coordinate.<DT><B>See Also:</B><DD><A HREF="../../../../javax/media/j3d/ConeSound.html#setDirection(float, float, float)"><CODE>ConeSound.setDirection(float x, float y, float z)</CODE></A>, 
<A HREF="../../../../javax/media/j3d/ConeSound.html#setDirection(javax.vecmath.Vector3f)"><CODE>ConeSound.setDirection(Vector3f direction)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setAngularAttenuation(int, int, double[], float[], float[])"><!-- --></A><H3>
setAngularAttenuation</H3>
<PRE>
public void <B>setAngularAttenuation</B>(int&nbsp;index,
                                  int&nbsp;filterType,
                                  double[]&nbsp;angle,
                                  float[]&nbsp;attenuationScaleFactor,
                                  float[]&nbsp;filterCutoff)</PRE>
<DL>
<DD>Set angular attenuation arrays affecting angular amplitude attenuation
 and angular distance filtering.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html#setAngularAttenuation(int, int, double[], float[], float[])">setAngularAttenuation</A></CODE> in interface <CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - device specific reference number to device driver sample<DD><CODE>filterType</CODE> - denotes type of filtering (on no filtering) applied
 to sample.<DD><CODE>angle</CODE> - array containing angular distances from sound axis<DD><CODE>attenuationScaleFactor</CODE> - array containing gain scale factor<DD><CODE>filterCutoff</CODE> - array containing filter cutoff frequencies.
 The filter values for each tuples can be set to Sound.NO_FILTER.<DT><B>See Also:</B><DD><A HREF="../../../../javax/media/j3d/ConeSound.html#setAngularAttenuation(float[], float[], float[])"><CODE>ConeSound.setAngularAttenuation(float[] distance, float[] gain,
 float[] filter)</CODE></A>, 
<A HREF="../../../../javax/media/j3d/ConeSound.html#setAngularAttenuation(javax.vecmath.Point3f[])"><CODE>ConeSound.setAngularAttenuation(Point3f[] attenuation)</CODE></A>, 
<A HREF="../../../../javax/media/j3d/ConeSound.html#setAngularAttenuation(javax.vecmath.Point2f[])"><CODE>ConeSound.setAngularAttenuation(Point2f[] attenuation)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setRolloff(float)"><!-- --></A><H3>
setRolloff</H3>
<PRE>
public void <B>setRolloff</B>(float&nbsp;rolloff)</PRE>
<DL>
<DD>Set rolloff value for current aural attribute applied to all samples.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html#setRolloff(float)">setRolloff</A></CODE> in interface <CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>rolloff</CODE> - scale factor applied to standard speed of sound.<DT><B>See Also:</B><DD><A HREF="../../../../javax/media/j3d/AuralAttributes.html#setRolloff(float)"><CODE>AuralAttributes.setRolloff(float)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setReflectionCoefficient(float)"><!-- --></A><H3>
setReflectionCoefficient</H3>
<PRE>
public void <B>setReflectionCoefficient</B>(float&nbsp;coefficient)</PRE>
<DL>
<DD>Set reverberation surface reflection coefficient value for current aural
 attribute applied to all samples.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html#setReflectionCoefficient(float)">setReflectionCoefficient</A></CODE> in interface <CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>coefficient</CODE> - applied to amplitude of reverbation added at each
 iteration of reverb processing.<DT><B>See Also:</B><DD><A HREF="../../../../javax/media/j3d/AuralAttributes.html#setReflectionCoefficient(float)"><CODE>AuralAttributes.setReflectionCoefficient(float)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setReverbDelay(float)"><!-- --></A><H3>
setReverbDelay</H3>
<PRE>
public void <B>setReverbDelay</B>(float&nbsp;reverbDelay)</PRE>
<DL>
<DD>Set reverberation delay time for current aural attribute applied to 
 all samples.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html#setReverbDelay(float)">setReverbDelay</A></CODE> in interface <CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>reverbDelay</CODE> - amount of time in millisecond between each
 iteration of reverb processing.<DT><B>See Also:</B><DD><A HREF="../../../../javax/media/j3d/AuralAttributes.html#setReverbDelay(float)"><CODE>AuralAttributes.setReverbDelay(float reverbDelay)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setReverbOrder(int)"><!-- --></A><H3>
setReverbOrder</H3>
<PRE>
public void <B>setReverbOrder</B>(int&nbsp;reverbOrder)</PRE>
<DL>
<DD>Set reverberation order for current aural attribute applied to all 
 samples.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html#setReverbOrder(int)">setReverbOrder</A></CODE> in interface <CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>reverbOrder</CODE> - number of times reverb process loop is iterated.<DT><B>See Also:</B><DD><A HREF="../../../../javax/media/j3d/AuralAttributes.html#setReverbOrder(int)"><CODE>AuralAttributes.setReverbOrder(int)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setDistanceFilter(int, double[], float[])"><!-- --></A><H3>
setDistanceFilter</H3>
<PRE>
public void <B>setDistanceFilter</B>(int&nbsp;filterType,
                              double[]&nbsp;dist,
                              float[]&nbsp;filterCutoff)</PRE>
<DL>
<DD>Set distance filter for current aural attribute applied to all samples.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html#setDistanceFilter(int, double[], float[])">setDistanceFilter</A></CODE> in interface <CODE><A HREF="../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE></DL>