auralattributes.html

JAVA多媒体开发类库说明

  If this is not set, no distance filtering is performed (equivalent to
  using a distance filter of Sound.NO_FILTER for all distances). Currently,
  this filter is a low-pass cutoff frequency. This array of pairs defines
  a piece-wise linear slope for range of values. This attenuation array is
  similar to the PointSound node's distanceAttenuation pair array, except
  paired with distances in this list are frequency values.  Using these
  pairs, distance-based low-pass frequency filtering can be applied during
  sound rendering. Distances, specified in the local coordinate system in
  meters, must be > 0. Frequencies (in Hz) must be > 0.
<P>
  If the distance from the listener to the sound source is less than the
  first distance in the array, the first filter is applied to the sound
  source.  This creates a spherical region around the listener within
  which a sound is uniformly attenuated by the first filter in the array.
  If the distance from the listener to the sound source is greater than
  the last distance in the array, the last filter is applied to the sound
  source.
   <P>
  Distance elements in these array of pairs is a monotonically-increasing
  set of floating point numbers measured from the location of the sound
  source.  FrequencyCutoff elements in this list of pairs can be any
  positive float. While for most applications this list of values will
  usually be monotonically-decreasing, they do not have to be.
   <P>
  The getDistanceFilterLength method returns the length of the distance filter
  arrays. Arrays passed into getDistanceFilter methods should all be at
  least this size.</UL>
   </UL><P>
  Doppler Effect Model
   <P><UL>
  Doppler effect can be used to create a greater sense of movement of
  sound sources, and can help reduce front-back localization errors.
  The frequency of sound waves emanating from the source are raised or
  lowered based on the speed of the source in relation to the listener,
  and several AuralAttribute parameters.
   <P>
  The FrequencyScaleFactor can be used to increase or reduce the change
  of frequency associated with normal Doppler calculation, or to shift
  the pitch of the sound directly if Doppler effect is disabled.
  Values must be > zero for sounds to be heard.  If the value is zero,
  sounds affected by this AuralAttribute object are paused.
   <P>
  To simulate Doppler effect, the relative velocity (change in 
  distance in the local coordinate system between the sound source and 
  the listener over time, in meters per second) is calculated. This
  calculated velocity is multipled by the given VelocityScaleFactor.
  Values must be >= zero.  If is a scale factor value of zero is given,
  Doppler effect is not calculated or applied to sound.</UL></UL>
<P>

<P>
<HR>

<P>
<!-- =========== FIELD SUMMARY =========== -->

<A NAME="field_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Field Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_ATTRIBUTE_GAIN_READ">ALLOW_ATTRIBUTE_GAIN_READ</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the reading of it's attribute gain scale factor information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_ATTRIBUTE_GAIN_WRITE">ALLOW_ATTRIBUTE_GAIN_WRITE</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the writing of it's attribute gain scale factor information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_DECAY_FILTER_READ">ALLOW_DECAY_FILTER_READ</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the reading of it's reverb decay filter information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_DECAY_FILTER_WRITE">ALLOW_DECAY_FILTER_WRITE</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the writing of it's reverb decay filter information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_DECAY_TIME_READ">ALLOW_DECAY_TIME_READ</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the reading of it's reverb decay time information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_DECAY_TIME_WRITE">ALLOW_DECAY_TIME_WRITE</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the writing of it's reverb decay time information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_DENSITY_READ">ALLOW_DENSITY_READ</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the reading of it's reverb density information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_DENSITY_WRITE">ALLOW_DENSITY_WRITE</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the writing of it's reverb density information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_DIFFUSION_READ">ALLOW_DIFFUSION_READ</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the reading of it's reverb diffusion information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_DIFFUSION_WRITE">ALLOW_DIFFUSION_WRITE</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the writing of it's reverb diffusion information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_DISTANCE_FILTER_READ">ALLOW_DISTANCE_FILTER_READ</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the reading of it's frequency cutoff information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_DISTANCE_FILTER_WRITE">ALLOW_DISTANCE_FILTER_WRITE</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the writing of it's frequency cutoff information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_FREQUENCY_SCALE_FACTOR_READ">ALLOW_FREQUENCY_SCALE_FACTOR_READ</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the reading of it's frequency scale factor information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_FREQUENCY_SCALE_FACTOR_WRITE">ALLOW_FREQUENCY_SCALE_FACTOR_WRITE</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the writing of it's frequency scale factor information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_REFLECTION_COEFFICIENT_READ">ALLOW_REFLECTION_COEFFICIENT_READ</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the reading of it's reflection coefficient.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_REFLECTION_COEFFICIENT_WRITE">ALLOW_REFLECTION_COEFFICIENT_WRITE</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the writing of it's reflection coefficient.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_REFLECTION_DELAY_READ">ALLOW_REFLECTION_DELAY_READ</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the reading of it's reflection delay information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_REFLECTION_DELAY_WRITE">ALLOW_REFLECTION_DELAY_WRITE</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the writing of it's reflection delay information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_REVERB_COEFFICIENT_READ">ALLOW_REVERB_COEFFICIENT_READ</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the reading of it's reverb coefficient.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_REVERB_COEFFICIENT_WRITE">ALLOW_REVERB_COEFFICIENT_WRITE</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the writing of it's reverb coefficient.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_REVERB_DELAY_READ">ALLOW_REVERB_DELAY_READ</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the reading of it's reverberation delay information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_REVERB_DELAY_WRITE">ALLOW_REVERB_DELAY_WRITE</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the writing of it's reverberation delay information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_REVERB_ORDER_READ">ALLOW_REVERB_ORDER_READ</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the reading of it's reverb order (feedback loop) information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/AuralAttributes.html#ALLOW_REVERB_ORDER_WRITE">ALLOW_REVERB_ORDER_WRITE</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For AuralAttributes component objects, specifies that this object
 allows the writing of it's reverb order (feedback loop) information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">