pointsound.html

JAVA多媒体开发类库说明

</DL>
<HR>

<A NAME="ALLOW_POSITION_WRITE"><!-- --></A><H3>
ALLOW_POSITION_WRITE</H3>
<PRE>
public static final int <B>ALLOW_POSITION_WRITE</B></PRE>
<DL>
<DD>Specifies that this node allows writing to its object's position
 information.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.PointSound.ALLOW_POSITION_WRITE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_DISTANCE_GAIN_READ"><!-- --></A><H3>
ALLOW_DISTANCE_GAIN_READ</H3>
<PRE>
public static final int <B>ALLOW_DISTANCE_GAIN_READ</B></PRE>
<DL>
<DD>Specifies that this node allows access to its object's distance
 gain attenuation information.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.PointSound.ALLOW_DISTANCE_GAIN_READ">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_DISTANCE_GAIN_WRITE"><!-- --></A><H3>
ALLOW_DISTANCE_GAIN_WRITE</H3>
<PRE>
public static final int <B>ALLOW_DISTANCE_GAIN_WRITE</B></PRE>
<DL>
<DD>Specifies that this node allows writing to its object's distance
 gain attenuation information.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.PointSound.ALLOW_DISTANCE_GAIN_WRITE">Constant Field Values</A></DL>
</DL>

<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_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>Constructor Detail</B></FONT></TH>
</TR>
</TABLE>

<A NAME="PointSound()"><!-- --></A><H3>
PointSound</H3>
<PRE>
public <B>PointSound</B>()</PRE>
<DL>
<DD>Constructs and initializes a new PointSound node using default
 parameters.  The following default values are used:
 <ul>
 position vector: (0.0, 0.0, 0.0)<br>
 Back attenuation: null<br>
 distance gain attenuation: null (no attenuation performed)<br>
 </ul>
<P>
</DL>
<HR>

<A NAME="PointSound(javax.media.j3d.MediaContainer, float, javax.vecmath.Point3f)"><!-- --></A><H3>
PointSound</H3>
<PRE>
public <B>PointSound</B>(<A HREF="../../../javax/media/j3d/MediaContainer.html" title="class in javax.media.j3d">MediaContainer</A>&nbsp;soundData,
                  float&nbsp;initialGain,
                  <A HREF="../../../javax/vecmath/Point3f.html" title="class in javax.vecmath">Point3f</A>&nbsp;position)</PRE>
<DL>
<DD>Constructs a PointSound node object using only the provided parameter
 values for sound data, sample gain, and position. The remaining fields
 are set to the above default values. This form uses a point as input for
 its position.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>soundData</CODE> - sound data associated with this sound source node<DD><CODE>initialGain</CODE> - amplitude scale factor applied to sound source<DD><CODE>position</CODE> - 3D location of source</DL>
</DL>
<HR>

<A NAME="PointSound(javax.media.j3d.MediaContainer, float, float, float, float)"><!-- --></A><H3>
PointSound</H3>
<PRE>
public <B>PointSound</B>(<A HREF="../../../javax/media/j3d/MediaContainer.html" title="class in javax.media.j3d">MediaContainer</A>&nbsp;soundData,
                  float&nbsp;initialGain,
                  float&nbsp;posX,
                  float&nbsp;posY,
                  float&nbsp;posZ)</PRE>
<DL>
<DD>Constructs a PointSound node object using only the provided parameter
 values for sound data, sample gain, and position. The remaining fields
 are set to to the above default values. This form uses individual float
 parameters for the elements of the position point.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>soundData</CODE> - sound data associated with this sound source node<DD><CODE>initialGain</CODE> - amplitude scale factor applied to sound source data<DD><CODE>posX</CODE> - x coordinate of location of source<DD><CODE>posY</CODE> - y coordinate of location of source<DD><CODE>posZ</CODE> - z coordinate of location of source</DL>
</DL>
<HR>

<A NAME="PointSound(javax.media.j3d.MediaContainer, float, int, boolean, boolean, boolean, javax.media.j3d.Bounds, float, javax.vecmath.Point3f, javax.vecmath.Point2f[])"><!-- --></A><H3>
PointSound</H3>
<PRE>
public <B>PointSound</B>(<A HREF="../../../javax/media/j3d/MediaContainer.html" title="class in javax.media.j3d">MediaContainer</A>&nbsp;soundData,
                  float&nbsp;initialGain,
                  int&nbsp;loopCount,
                  boolean&nbsp;release,
                  boolean&nbsp;continuous,
                  boolean&nbsp;enable,
                  <A HREF="../../../javax/media/j3d/Bounds.html" title="class in javax.media.j3d">Bounds</A>&nbsp;region,
                  float&nbsp;priority,
                  <A HREF="../../../javax/vecmath/Point3f.html" title="class in javax.vecmath">Point3f</A>&nbsp;position,
                  <A HREF="../../../javax/vecmath/Point2f.html" title="class in javax.vecmath">Point2f</A>[]&nbsp;distanceGain)</PRE>
<DL>
<DD>Construct a PointSound object accepting Point3f as input for the position
 and accepting an array of Point2f for the distance attenuation values 
 where each pair in the array contains a distance and a gain scale factor.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>soundData</CODE> - sound data associated with this sound source node<DD><CODE>initialGain</CODE> - amplitude scale factor applied to sound source<DD><CODE>loopCount</CODE> - number of times loop is looped<DD><CODE>release</CODE> - flag denoting playing sound data to end<DD><CODE>continuous</CODE> - denotes that sound silently plays when disabled<DD><CODE>enable</CODE> - sound switched on/off<DD><CODE>region</CODE> - scheduling bounds<DD><CODE>priority</CODE> - playback ranking value<DD><CODE>position</CODE> - 3D location of source<DD><CODE>distanceGain</CODE> - array of (distance,gain) pairs controling attenuation</DL>
</DL>
<HR>

<A NAME="PointSound(javax.media.j3d.MediaContainer, float, int, boolean, boolean, boolean, javax.media.j3d.Bounds, float, float, float, float, javax.vecmath.Point2f[])"><!-- --></A><H3>
PointSound</H3>
<PRE>
public <B>PointSound</B>(<A HREF="../../../javax/media/j3d/MediaContainer.html" title="class in javax.media.j3d">MediaContainer</A>&nbsp;soundData,
                  float&nbsp;initialGain,
                  int&nbsp;loopCount,
                  boolean&nbsp;release,
                  boolean&nbsp;continuous,
                  boolean&nbsp;enable,
                  <A HREF="../../../javax/media/j3d/Bounds.html" title="class in javax.media.j3d">Bounds</A>&nbsp;region,
                  float&nbsp;priority,
                  float&nbsp;posX,
                  float&nbsp;posY,
                  float&nbsp;posZ,
                  <A HREF="../../../javax/vecmath/Point2f.html" title="class in javax.vecmath">Point2f</A>[]&nbsp;distanceGain)</PRE>
<DL>
<DD>Construct a PointSound object accepting individual float parameters for 
 the elements of the position point, and accepting an array of Point2f for
 the distance attenuation values where each pair in the array contains a 
 distance and a gain scale factor.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>soundData</CODE> - sound data associated with this sound source node<DD><CODE>initialGain</CODE> - amplitude scale factor applied to sound source<DD><CODE>loopCount</CODE> - number of times loop is looped<DD><CODE>release</CODE> - flag denoting playing sound to end<DD><CODE>continuous</CODE> - denotes that sound silently plays when disabled<DD><CODE>enable</CODE> - sound switched on/off<DD><CODE>region</CODE> - scheduling bounds<DD><CODE>priority</CODE> - playback ranking value<DD><CODE>posX</CODE> - x coordinate of location of source<DD><CODE>posY</CODE> - y coordinate of location of source<DD><CODE>posZ</CODE> - z coordinate of location of source<DD><CODE>distanceGain</CODE> - array of (distance,gain) pairs controling attenuation</DL>
</DL>
<HR>

<A NAME="PointSound(javax.media.j3d.MediaContainer, float, int, boolean, boolean, boolean, javax.media.j3d.Bounds, float, javax.vecmath.Point3f, float[], float[])"><!-- --></A><H3>
PointSound</H3>
<PRE>
public <B>PointSound</B>(<A HREF="../../../javax/media/j3d/MediaContainer.html" title="class in javax.media.j3d">MediaContainer</A>&nbsp;soundData,
                  float&nbsp;initialGain,
                  int&nbsp;loopCount,
                  boolean&nbsp;release,
                  boolean&nbsp;continuous,
                  boolean&nbsp;enable,
                  <A HREF="../../../javax/media/j3d/Bounds.html" title="class in javax.media.j3d">Bounds</A>&nbsp;region,
                  float&nbsp;priority,
                  <A HREF="../../../javax/vecmath/Point3f.html" title="class in javax.vecmath">Point3f</A>&nbsp;position,
                  float[]&nbsp;attenuationDistance,
                  float[]&nbsp;attenuationGain)</PRE>
<DL>
<DD>Construct a PointSound object accepting points as input for the position.
 and accepting separate arrays for the distance and gain scale factors 
 components of distance attenuation.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>soundData</CODE> - sound data associated with this sound source node<DD><CODE>initialGain</CODE> - amplitude scale factor applied to sound source<DD><CODE>loopCount</CODE> - number of times loop is looped<DD><CODE>release</CODE> - flag denoting playing sound data to end<DD><CODE>continuous</CODE> - denotes that sound silently plays when disabled<DD><CODE>enable</CODE> - sound switched on/off<DD><CODE>region</CODE> - scheduling bounds<DD><CODE>priority</CODE> - playback ranking value<DD><CODE>position</CODE> - 3D location of source<DD><CODE>attenuationDistance</CODE> - array of distance values used for attenuation<DD><CODE>attenuationGain</CODE> - array of gain scale factors used for attenuation</DL>
</DL>
<HR>

<A NAME="PointSound(javax.media.j3d.MediaContainer, float, int, boolean, boolean, boolean, javax.media.j3d.Bounds, float, float, float, float, float[], float[])"><!-- --></A><H3>
PointSound</H3>
<PRE>
public <B>PointSound</B>(<A HREF="../../../javax/media/j3d/MediaContainer.html" title="class in javax.media.j3d">MediaContainer</A>&nbsp;soundData,
                  float&nbsp;initialGain,
                  int&nbsp;loopCount,
                  boolean&nbsp;release,
                  boolean&nbsp;continuous,
                  boolean&nbsp;enable,
                  <A HREF="../../../javax/media/j3d/Bounds.html" title="class in javax.media.j3d">Bounds</A>&nbsp;region,
                  float&nbsp;priority,
                  float&nbsp;posX,
                  float&nbsp;posY,
                  float&nbsp;posZ,
                  float[]&nbsp;attenuationDistance,
                  float[]&nbsp;attenuationGain)</PRE>
<DL>
<DD>Construct a PointSound object accepting individual float parameters for 
 the elements of the position points, and accepting separate arrays for 
 the distance and gain scale factors components of distance attenuation.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>soundData</CODE> - sound data associated with this sound source node<DD><CODE>initialGain</CODE> - amplitude scale factor applied to sound source<DD><CODE>loopCount</CODE> - number of times loop is looped<DD><CODE>release</CODE> - flag denoting playing sound to end<DD><CODE>continuous</CODE> - denotes that sound silently plays when disabled<DD><CODE>enable</CODE> - sound switched on/off<DD><CODE>region</CODE> - scheduling bounds<DD><CODE>priority</CODE> - playback ranking value<DD><CODE>posX</CODE> - x coordinate of location of source<DD><CODE>posY</CODE> - y coordinate of location of source<DD><CODE>posZ</CODE> - z coordinate of location of source<DD><CODE>attenuationDistance</CODE> - array of distance values used for attenuation<DD><CODE>attenuationGain</CODE> - array of gain scale factors used for attenuation</DL>
</DL>

<!-- ============ 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="setPosition(javax.vecmath.Point3f)"><!-- --></A><H3>
setPosition</H3>
<PRE>
public void <B>setPosition</B>(<A HREF="../../../javax/vecmath/Point3f.html" title="class in javax.vecmath">Point3f</A>&nbsp;position)</PRE>
<DL>
<DD>Sets this sound's location from the vector provided.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>position</CODE> - the new location
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">CapabilityNotSetException</A></CODE> - if appropriate capability is
 not set and this object is part of live or compiled scene graph</DL>
</DD>
</DL>
<HR>

<A NAME="setPosition(float, float, float)"><!-- --></A><H3>
setPosition</H3>
<PRE>
public void <B>setPosition</B>(float&nbsp;x,
                        float&nbsp;y,
                        float&nbsp;z)</PRE>
<DL>
<DD>Sets this sound's position from the three values provided.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>x</CODE> - the new x position<DD><CODE>y</CODE> - the new y position<DD><CODE>z</CODE> - the new z position
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">CapabilityNotSetException</A></CODE> - if appropriate capability is
 not set and this object is part of live or compiled scene graph</DL>
</DD>
</DL>