javasoundmixer.html

JAVA多媒体开发类库说明

close</H3>
<PRE>
public boolean <B>close</B>()</PRE>
<DL>
<DD>Code to close the device.
 New interface to mixer/engine specific methods
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../javax/media/j3d/AudioDevice.html#close()">close</A></CODE> in interface <CODE><A HREF="../../../../../javax/media/j3d/AudioDevice.html" title="interface in javax.media.j3d">AudioDevice</A></CODE><DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine.html#close()">close</A></CODE> in class <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine.html" title="class in com.sun.j3d.audioengines">AudioEngine</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>flag: true is closed sucessfully, false if error</DL>
</DD>
</DL>
<HR>

<A NAME="prepareSound(int, javax.media.j3d.MediaContainer)"><!-- --></A><H3>
prepareSound</H3>
<PRE>
public int <B>prepareSound</B>(int&nbsp;soundType,
                        <A HREF="../../../../../javax/media/j3d/MediaContainer.html" title="class in javax.media.j3d">MediaContainer</A>&nbsp;soundData)</PRE>
<DL>
<DD>Code to load sound data into a channel of device mixer.
 Load sound as one or mores sample into the Java Sound Mixer:
   a) as either a STREAM or CLIP based on whether cached is enabled
   b) positional and directional sounds use three samples per
      sound
 Overriden method from AudioEngine3D.

 Sound type determines if this is a Background, Point or Cone
 sound source and thus the JSXxxxSample object type
 Call JSXxxxxSample.loadSample()
 If no error
     Get the next free index in the samples list.
     Store a reference to JSXxxxSample object in samples list.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../javax/media/j3d/AudioDevice3D.html#prepareSound(int, javax.media.j3d.MediaContainer)">prepareSound</A></CODE> in interface <CODE><A HREF="../../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE><DT><B>Overrides:</B><DD><CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#prepareSound(int, javax.media.j3d.MediaContainer)">prepareSound</A></CODE> in class <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html" title="class in com.sun.j3d.audioengines">AudioEngine3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>soundType</CODE> - denotes type of sound: Background, Point or Cone<DD><CODE>soundData</CODE> - descrition of sound source data
<DT><B>Returns:</B><DD>index to the sample in samples list.</DL>
</DD>
</DL>
<HR>

<A NAME="clearSound(int)"><!-- --></A><H3>
clearSound</H3>
<PRE>
public void <B>clearSound</B>(int&nbsp;index)</PRE>
<DL>
<DD>Clears the fields associated with sample data for this sound.
 Overriden method from AudioEngine3D.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../javax/media/j3d/AudioDevice3D.html#clearSound(int)">clearSound</A></CODE> in interface <CODE><A HREF="../../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE><DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#clearSound(int)">clearSound</A></CODE> in class <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html" title="class in com.sun.j3d.audioengines">AudioEngine3D</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="setVworldXfrm(int, javax.media.j3d.Transform3D)"><!-- --></A><H3>
setVworldXfrm</H3>
<PRE>
public void <B>setVworldXfrm</B>(int&nbsp;index,
                          <A HREF="../../../../../javax/media/j3d/Transform3D.html" title="class in javax.media.j3d">Transform3D</A>&nbsp;trans)</PRE>
<DL>
<DD>Save a reference to the local to virtual world coordinate space
 Overriden method from AudioEngine3D.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../javax/media/j3d/AudioDevice3D.html#setVworldXfrm(int, javax.media.j3d.Transform3D)">setVworldXfrm</A></CODE> in interface <CODE><A HREF="../../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE><DT><B>Overrides:</B><DD><CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#setVworldXfrm(int, javax.media.j3d.Transform3D)">setVworldXfrm</A></CODE> in class <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html" title="class in com.sun.j3d.audioengines">AudioEngine3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - device specific reference number to device driver sample<DD><CODE>trans</CODE> - is a reference to virtual world composite transform</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><B>Description copied from class: <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#setPosition(int, javax.vecmath.Point3d)">AudioEngine3D</A></CODE></B></DD>
<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><DT><B>Overrides:</B><DD><CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#setPosition(int, javax.vecmath.Point3d)">setPosition</A></CODE> in class <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html" title="class in com.sun.j3d.audioengines">AudioEngine3D</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="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><B>Description copied from class: <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#setDirection(int, javax.vecmath.Vector3d)">AudioEngine3D</A></CODE></B></DD>
<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><DT><B>Overrides:</B><DD><CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#setDirection(int, javax.vecmath.Vector3d)">setDirection</A></CODE> in class <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html" title="class in com.sun.j3d.audioengines">AudioEngine3D</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="setReflectionCoefficient(float)"><!-- --></A><H3>
setReflectionCoefficient</H3>
<PRE>
public void <B>setReflectionCoefficient</B>(float&nbsp;coefficient)</PRE>
<DL>
<DD><B>Description copied from class: <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#setReflectionCoefficient(float)">AudioEngine3D</A></CODE></B></DD>
<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><DT><B>Overrides:</B><DD><CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#setReflectionCoefficient(float)">setReflectionCoefficient</A></CODE> in class <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html" title="class in com.sun.j3d.audioengines">AudioEngine3D</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><B>Description copied from class: <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#setReverbDelay(float)">AudioEngine3D</A></CODE></B></DD>
<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><DT><B>Overrides:</B><DD><CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#setReverbDelay(float)">setReverbDelay</A></CODE> in class <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html" title="class in com.sun.j3d.audioengines">AudioEngine3D</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><B>Description copied from class: <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#setReverbOrder(int)">AudioEngine3D</A></CODE></B></DD>
<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><DT><B>Overrides:</B><DD><CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#setReverbOrder(int)">setReverbOrder</A></CODE> in class <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html" title="class in com.sun.j3d.audioengines">AudioEngine3D</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="startSample(int)"><!-- --></A><H3>
startSample</H3>
<PRE>
public int <B>startSample</B>(int&nbsp;index)</PRE>
<DL>
<DD><B>Description copied from class: <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#startSample(int)">AudioEngine3D</A></CODE></B></DD>
<DD>Start sample playing on audio device
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../javax/media/j3d/AudioDevice3D.html#startSample(int)">startSample</A></CODE> in interface <CODE><A HREF="../../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE><DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#startSample(int)">startSample</A></CODE> in class <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html" title="class in com.sun.j3d.audioengines">AudioEngine3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - device specific reference number to device driver sample
<DT><B>Returns:</B><DD>status: < 0 denotes an error</DL>
</DD>
</DL>
<HR>

<A NAME="stopSample(int)"><!-- --></A><H3>
stopSample</H3>
<PRE>
public int <B>stopSample</B>(int&nbsp;index)</PRE>
<DL>
<DD><B>Description copied from class: <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#stopSample(int)">AudioEngine3D</A></CODE></B></DD>
<DD>Stop sample playing on audio device
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../javax/media/j3d/AudioDevice3D.html#stopSample(int)">stopSample</A></CODE> in interface <CODE><A HREF="../../../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></CODE><DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html#stopSample(int)">stopSample</A></CODE> in class <CODE><A HREF="../../../../../com/sun/j3d/audioengines/AudioEngine3D.html" title="class in com.sun.j3d.audioengines">AudioEngine3D</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - device specific reference number to device driver sample
<DT><B>Returns:</B><DD>status: < 0 denotes an error</DL>
</DD>
</DL>
<HR>

<A NAME="pauseSample(int)"><!-- --></A><H3>
pauseSample</H3>
<PRE>