audiodevice3dl2.html

JAVA多媒体开发类库说明

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the obstruction gain control.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AudioDevice3DL2.html#setOcclusionFilter(int, float)">setOcclusionFilter</A></B>(int&nbsp;sampleId,
                   float&nbsp;frequencyCutoff)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the occlusion filter control.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AudioDevice3DL2.html#setOcclusionGain(int, float)">setOcclusionGain</A></B>(int&nbsp;sampleId,
                 float&nbsp;scaleFactor)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the occlusion gain control.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AudioDevice3DL2.html#setRateScaleFactor(int, float)">setRateScaleFactor</A></B>(int&nbsp;sampleId,
                   float&nbsp;scaleFactor)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set scale factor applied to sample playback rate for a particular sound
 associated with the audio device.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AudioDevice3DL2.html#setReflectionDelay(float)">setReflectionDelay</A></B>(float&nbsp;reflectionDelay)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the early reflection delay time.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AudioDevice3DL2.html#setReverbCoefficient(float)">setReverbCoefficient</A></B>(float&nbsp;coefficient)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set late reflection (referred to as 'reverb') attenuation.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_javax.media.j3d.AudioDevice3D"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from interface javax.media.j3d.<A HREF="../../../javax/media/j3d/AudioDevice3D.html" title="interface in javax.media.j3d">AudioDevice3D</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../javax/media/j3d/AudioDevice3D.html#clearSound(int)">clearSound</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#getNumberOfChannelsUsed(int)">getNumberOfChannelsUsed</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#getNumberOfChannelsUsed(int, boolean)">getNumberOfChannelsUsed</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#getSampleDuration(int)">getSampleDuration</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#getStartTime(int)">getStartTime</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#muteSample(int)">muteSample</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#pauseSample(int)">pauseSample</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#prepareSound(int, javax.media.j3d.MediaContainer)">prepareSound</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setAngularAttenuation(int, int, double[], float[], float[])">setAngularAttenuation</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setDirection(int, javax.vecmath.Vector3d)">setDirection</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setDistanceFilter(int, double[], float[])">setDistanceFilter</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setDistanceGain(int, double[], float[], double[], float[])">setDistanceGain</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setFrequencyScaleFactor(float)">setFrequencyScaleFactor</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setLoop(int, int)">setLoop</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setPosition(int, javax.vecmath.Point3d)">setPosition</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setReflectionCoefficient(float)">setReflectionCoefficient</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setReverbDelay(float)">setReverbDelay</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setReverbOrder(int)">setReverbOrder</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setRolloff(float)">setRolloff</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setSampleGain(int, float)">setSampleGain</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setVelocityScaleFactor(float)">setVelocityScaleFactor</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setView(javax.media.j3d.View)">setView</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#setVworldXfrm(int, javax.media.j3d.Transform3D)">setVworldXfrm</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#startSample(int)">startSample</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#stopSample(int)">stopSample</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#unmuteSample(int)">unmuteSample</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#unpauseSample(int)">unpauseSample</A>, <A HREF="../../../javax/media/j3d/AudioDevice3D.html#updateSample(int)">updateSample</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_javax.media.j3d.AudioDevice"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from interface javax.media.j3d.<A HREF="../../../javax/media/j3d/AudioDevice.html" title="interface in javax.media.j3d">AudioDevice</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../javax/media/j3d/AudioDevice.html#close()">close</A>, <A HREF="../../../javax/media/j3d/AudioDevice.html#getAngleOffsetToSpeaker()">getAngleOffsetToSpeaker</A>, <A HREF="../../../javax/media/j3d/AudioDevice.html#getAudioPlaybackType()">getAudioPlaybackType</A>, <A HREF="../../../javax/media/j3d/AudioDevice.html#getCenterEarToSpeaker()">getCenterEarToSpeaker</A>, <A HREF="../../../javax/media/j3d/AudioDevice.html#getChannelsAvailable()">getChannelsAvailable</A>, <A HREF="../../../javax/media/j3d/AudioDevice.html#getChannelsUsedForSound(javax.media.j3d.Sound)">getChannelsUsedForSound</A>, <A HREF="../../../javax/media/j3d/AudioDevice.html#getTotalChannels()">getTotalChannels</A>, <A HREF="../../../javax/media/j3d/AudioDevice.html#initialize()">initialize</A>, <A HREF="../../../javax/media/j3d/AudioDevice.html#setAngleOffsetToSpeaker(float)">setAngleOffsetToSpeaker</A>, <A HREF="../../../javax/media/j3d/AudioDevice.html#setAudioPlaybackType(int)">setAudioPlaybackType</A>, <A HREF="../../../javax/media/j3d/AudioDevice.html#setCenterEarToSpeaker(float)">setCenterEarToSpeaker</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>

<A NAME="pause()"><!-- --></A><H3>
pause</H3>
<PRE>
void <B>pause</B>()</PRE>
<DL>
<DD>Pause audio device engine (thread/server) without closing the device.
 Causes all cached sounds to be paused and all streaming sounds to be
 stopped.
 <P>
 This method should NOT be called by any application if the audio device
 is associated with a Physical Environment used by Java3D Core.
 This method will be implicitly called when View (associated with this
 device) is deactivated.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="resume()"><!-- --></A><H3>
resume</H3>
<PRE>
void <B>resume</B>()</PRE>
<DL>
<DD>Resumes audio device engine (if previously paused) without reinitializing
 the device.
 Causes all paused cached sounds to be resumed and all streaming sounds
 restarted. 
 <P>
 This method should NOT be called by any application if the audio device
 is associated with a Physical Environment used by Java3D Core.
 This method will be implicitly called when View (associated with this  
 device) is actived.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setGain(float)"><!-- --></A><H3>
setGain</H3>
<PRE>
void <B>setGain</B>(float&nbsp;scaleFactor)</PRE>
<DL>
<DD>Set overall gain control of all sounds playing on the audio device.
 Default: 1.0f = no attenuation.
 <P>
 This method should NOT be called by any application if the audio device
 is associated with a Physical Environment used by Java3D Core.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>scaleFactor</CODE> - scale factor applied to calculated amplitudes for
 all sounds playing on this device</DL>
</DD>
</DL>
<HR>

<A NAME="setRateScaleFactor(int, float)"><!-- --></A><H3>
setRateScaleFactor</H3>
<PRE>
void <B>setRateScaleFactor</B>(int&nbsp;sampleId,
                        float&nbsp;scaleFactor)</PRE>
<DL>
<DD>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.
 Default: 1.0f = original sample rate is unchanged
 <P>
 This method should NOT be called by any application if the audio device
 is associated with a Physical Environment used by Java3D Core.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>sampleId</CODE> - device specific reference number to device driver sample<DD><CODE>scaleFactor</CODE> - non-negative factor applied to calculated 
 amplitudes for all sounds playing on this device</DL>
</DD>
</DL>
<HR>

<A NAME="setReverbCoefficient(float)"><!-- --></A><H3>
setReverbCoefficient</H3>
<PRE>
void <B>setReverbCoefficient</B>(float&nbsp;coefficient)</PRE>
<DL>
<DD>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.
 A coefficient value of 0 disables reverberation.
 Valid values of parameters range from 0.0 to 1.0.
 Default: 0.0f.
 <P>
 A full description of this parameter and how it is used is in
 the documentation for the AuralAttributes class.
 <P>
 This method should NOT be called by any application if the audio device
 is associated with a Physical Environment used by Java3D Core.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>coefficient</CODE> - late reflection attenuation factor<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/AuralAttributes.html#setReverbCoefficient(float)"><CODE>AuralAttributes.setReverbCoefficient(float)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setReflectionDelay(float)"><!-- --></A><H3>
setReflectionDelay</H3>
<PRE>
void <B>setReflectionDelay</B>(float&nbsp;reflectionDelay)</PRE>
<DL>
<DD>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. 
 Valid values are non-negative floats.
 There may be limitations imposed by the device on how small or large this
 value can be made.
 A value of 0.0 would result in early reflections being added as soon as
 possible after the sound begins.
 Default = 20.0 milliseconds.
 <P>
 A full description of this parameter and how it is used is in
 the documentation for the AuralAttributes class.
 <P>
 This method should NOT be called by any application if the audio device
 is associated with a Physical Environment used by Java3D Core.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>reflectionDelay</CODE> - time between each order of early reflection<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/AuralAttributes.html#setReflectionDelay(float)"><CODE>AuralAttributes.setReflectionDelay(float)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setDecayTime(float)"><!-- --></A><H3>
setDecayTime</H3>
<PRE>
void <B>setDecayTime</B>(float&nbsp;time)</PRE>
<DL>
<DD>Set reverb decay time.
 Defines the reverberation decay curve.
 Default: 1000.0 milliseconds.
 <P>
 A full description of this parameter and how it is used is in
 the documentation for the AuralAttributes class.
 <P>
 This method should NOT be called by any application if the audio device
 is associated with a Physical Environment used by Java3D Core.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>time</CODE> - decay time in milliseconds<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/AuralAttributes.html#setDecayTime(float)"><CODE>AuralAttributes.setDecayTime(float)</CODE></A></DL>
</DD>
</DL>
<HR>