conesound.html

JAVA多媒体开发类库说明

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets this sound's back distance gain attenuation - where gain scale 
 factor is applied to sound based on distance listener along the negative
 sound direction axis from sound source.</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/ConeSound.html#setDirection(float, float, float)">setDirection</A></B>(float&nbsp;x,
             float&nbsp;y,
             float&nbsp;z)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets this sound's direction from the three values provided.</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/ConeSound.html#setDirection(javax.vecmath.Vector3f)">setDirection</A></B>(<A HREF="../../../javax/vecmath/Vector3f.html" title="class in javax.vecmath">Vector3f</A>&nbsp;direction)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets this sound's direction from the vector provided.</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/ConeSound.html#setDistanceGain(float[], float[], float[], float[])">setDistanceGain</A></B>(float[]&nbsp;frontDistance,
                float[]&nbsp;frontGain,
                float[]&nbsp;backDistance,
                float[]&nbsp;backGain)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets this sound's distance gain attenuation as an array of Point2fs.</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/ConeSound.html#setDistanceGain(javax.vecmath.Point2f[], javax.vecmath.Point2f[])">setDistanceGain</A></B>(<A HREF="../../../javax/vecmath/Point2f.html" title="class in javax.vecmath">Point2f</A>[]&nbsp;frontAttenuation,
                <A HREF="../../../javax/vecmath/Point2f.html" title="class in javax.vecmath">Point2f</A>[]&nbsp;backAttenuation)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets this sound's distance gain elliptical attenuation - 
 where gain scale factor is applied to sound based on distance listener
 is from sound source.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_javax.media.j3d.PointSound"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class javax.media.j3d.<A HREF="../../../javax/media/j3d/PointSound.html" title="class in javax.media.j3d">PointSound</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../javax/media/j3d/PointSound.html#getDistanceGain(float[], float[])">getDistanceGain</A>, <A HREF="../../../javax/media/j3d/PointSound.html#getDistanceGain(javax.vecmath.Point2f[])">getDistanceGain</A>, <A HREF="../../../javax/media/j3d/PointSound.html#getDistanceGainLength()">getDistanceGainLength</A>, <A HREF="../../../javax/media/j3d/PointSound.html#getPosition(javax.vecmath.Point3f)">getPosition</A>, <A HREF="../../../javax/media/j3d/PointSound.html#setDistanceGain(float[], float[])">setDistanceGain</A>, <A HREF="../../../javax/media/j3d/PointSound.html#setDistanceGain(javax.vecmath.Point2f[])">setDistanceGain</A>, <A HREF="../../../javax/media/j3d/PointSound.html#setPosition(float, float, float)">setPosition</A>, <A HREF="../../../javax/media/j3d/PointSound.html#setPosition(javax.vecmath.Point3f)">setPosition</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_javax.media.j3d.Sound"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class javax.media.j3d.<A HREF="../../../javax/media/j3d/Sound.html" title="class in javax.media.j3d">Sound</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../javax/media/j3d/Sound.html#getContinuousEnable()">getContinuousEnable</A>, <A HREF="../../../javax/media/j3d/Sound.html#getDuration()">getDuration</A>, <A HREF="../../../javax/media/j3d/Sound.html#getEnable()">getEnable</A>, <A HREF="../../../javax/media/j3d/Sound.html#getInitialGain()">getInitialGain</A>, <A HREF="../../../javax/media/j3d/Sound.html#getLoop()">getLoop</A>, <A HREF="../../../javax/media/j3d/Sound.html#getMute()">getMute</A>, <A HREF="../../../javax/media/j3d/Sound.html#getNumberOfChannelsUsed()">getNumberOfChannelsUsed</A>, <A HREF="../../../javax/media/j3d/Sound.html#getNumberOfChannelsUsed(javax.media.j3d.View)">getNumberOfChannelsUsed</A>, <A HREF="../../../javax/media/j3d/Sound.html#getPause()">getPause</A>, <A HREF="../../../javax/media/j3d/Sound.html#getPriority()">getPriority</A>, <A HREF="../../../javax/media/j3d/Sound.html#getRateScaleFactor()">getRateScaleFactor</A>, <A HREF="../../../javax/media/j3d/Sound.html#getReleaseEnable()">getReleaseEnable</A>, <A HREF="../../../javax/media/j3d/Sound.html#getSchedulingBoundingLeaf()">getSchedulingBoundingLeaf</A>, <A HREF="../../../javax/media/j3d/Sound.html#getSchedulingBounds()">getSchedulingBounds</A>, <A HREF="../../../javax/media/j3d/Sound.html#getSoundData()">getSoundData</A>, <A HREF="../../../javax/media/j3d/Sound.html#isPlaying()">isPlaying</A>, <A HREF="../../../javax/media/j3d/Sound.html#isPlaying(javax.media.j3d.View)">isPlaying</A>, <A HREF="../../../javax/media/j3d/Sound.html#isPlayingSilently()">isPlayingSilently</A>, <A HREF="../../../javax/media/j3d/Sound.html#isPlayingSilently(javax.media.j3d.View)">isPlayingSilently</A>, <A HREF="../../../javax/media/j3d/Sound.html#isReady()">isReady</A>, <A HREF="../../../javax/media/j3d/Sound.html#isReady(javax.media.j3d.View)">isReady</A>, <A HREF="../../../javax/media/j3d/Sound.html#setContinuousEnable(boolean)">setContinuousEnable</A>, <A HREF="../../../javax/media/j3d/Sound.html#setEnable(boolean)">setEnable</A>, <A HREF="../../../javax/media/j3d/Sound.html#setInitialGain(float)">setInitialGain</A>, <A HREF="../../../javax/media/j3d/Sound.html#setLoop(int)">setLoop</A>, <A HREF="../../../javax/media/j3d/Sound.html#setMute(boolean)">setMute</A>, <A HREF="../../../javax/media/j3d/Sound.html#setPause(boolean)">setPause</A>, <A HREF="../../../javax/media/j3d/Sound.html#setPriority(float)">setPriority</A>, <A HREF="../../../javax/media/j3d/Sound.html#setRateScaleFactor(float)">setRateScaleFactor</A>, <A HREF="../../../javax/media/j3d/Sound.html#setReleaseEnable(boolean)">setReleaseEnable</A>, <A HREF="../../../javax/media/j3d/Sound.html#setSchedulingBoundingLeaf(javax.media.j3d.BoundingLeaf)">setSchedulingBoundingLeaf</A>, <A HREF="../../../javax/media/j3d/Sound.html#setSchedulingBounds(javax.media.j3d.Bounds)">setSchedulingBounds</A>, <A HREF="../../../javax/media/j3d/Sound.html#setSoundData(javax.media.j3d.MediaContainer)">setSoundData</A>, <A HREF="../../../javax/media/j3d/Sound.html#updateNodeReferences(javax.media.j3d.NodeReferenceTable)">updateNodeReferences</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_javax.media.j3d.Node"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class javax.media.j3d.<A HREF="../../../javax/media/j3d/Node.html" title="class in javax.media.j3d">Node</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../javax/media/j3d/Node.html#cloneTree()">cloneTree</A>, <A HREF="../../../javax/media/j3d/Node.html#cloneTree(boolean)">cloneTree</A>, <A HREF="../../../javax/media/j3d/Node.html#cloneTree(boolean, boolean)">cloneTree</A>, <A HREF="../../../javax/media/j3d/Node.html#cloneTree(javax.media.j3d.NodeReferenceTable)">cloneTree</A>, <A HREF="../../../javax/media/j3d/Node.html#cloneTree(javax.media.j3d.NodeReferenceTable, boolean)">cloneTree</A>, <A HREF="../../../javax/media/j3d/Node.html#cloneTree(javax.media.j3d.NodeReferenceTable, boolean, boolean)">cloneTree</A>, <A HREF="../../../javax/media/j3d/Node.html#getBounds()">getBounds</A>, <A HREF="../../../javax/media/j3d/Node.html#getBoundsAutoCompute()">getBoundsAutoCompute</A>, <A HREF="../../../javax/media/j3d/Node.html#getCollidable()">getCollidable</A>, <A HREF="../../../javax/media/j3d/Node.html#getLocale()">getLocale</A>, <A HREF="../../../javax/media/j3d/Node.html#getLocalToVworld(javax.media.j3d.SceneGraphPath, javax.media.j3d.Transform3D)">getLocalToVworld</A>, <A HREF="../../../javax/media/j3d/Node.html#getLocalToVworld(javax.media.j3d.Transform3D)">getLocalToVworld</A>, <A HREF="../../../javax/media/j3d/Node.html#getParent()">getParent</A>, <A HREF="../../../javax/media/j3d/Node.html#getPickable()">getPickable</A>, <A HREF="../../../javax/media/j3d/Node.html#setBounds(javax.media.j3d.Bounds)">setBounds</A>, <A HREF="../../../javax/media/j3d/Node.html#setBoundsAutoCompute(boolean)">setBoundsAutoCompute</A>, <A HREF="../../../javax/media/j3d/Node.html#setCollidable(boolean)">setCollidable</A>, <A HREF="../../../javax/media/j3d/Node.html#setPickable(boolean)">setPickable</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_javax.media.j3d.SceneGraphObject"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class javax.media.j3d.<A HREF="../../../javax/media/j3d/SceneGraphObject.html" title="class in javax.media.j3d">SceneGraphObject</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../javax/media/j3d/SceneGraphObject.html#clearCapability(int)">clearCapability</A>, <A HREF="../../../javax/media/j3d/SceneGraphObject.html#clearCapabilityIsFrequent(int)">clearCapabilityIsFrequent</A>, <A HREF="../../../javax/media/j3d/SceneGraphObject.html#duplicateSceneGraphObject(javax.media.j3d.SceneGraphObject)">duplicateSceneGraphObject</A>, <A HREF="../../../javax/media/j3d/SceneGraphObject.html#getCapability(int)">getCapability</A>, <A HREF="../../../javax/media/j3d/SceneGraphObject.html#getCapabilityIsFrequent(int)">getCapabilityIsFrequent</A>, <A HREF="../../../javax/media/j3d/SceneGraphObject.html#getName()">getName</A>, <A HREF="../../../javax/media/j3d/SceneGraphObject.html#getUserData()">getUserData</A>, <A HREF="../../../javax/media/j3d/SceneGraphObject.html#isCompiled()">isCompiled</A>, <A HREF="../../../javax/media/j3d/SceneGraphObject.html#isLive()">isLive</A>, <A HREF="../../../javax/media/j3d/SceneGraphObject.html#setCapability(int)">setCapability</A>, <A HREF="../../../javax/media/j3d/SceneGraphObject.html#setCapabilityIsFrequent(int)">setCapabilityIsFrequent</A>, <A HREF="../../../javax/media/j3d/SceneGraphObject.html#setName(java.lang.String)">setName</A>, <A HREF="../../../javax/media/j3d/SceneGraphObject.html#setUserData(java.lang.Object)">setUserData</A>, <A HREF="../../../javax/media/j3d/SceneGraphObject.html#toString()">toString</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->

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

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

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

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

<A NAME="ALLOW_ANGULAR_ATTENUATION_WRITE"><!-- --></A><H3>
ALLOW_ANGULAR_ATTENUATION_WRITE</H3>
<PRE>
public static final int <B>ALLOW_ANGULAR_ATTENUATION_WRITE</B></PRE>
<DL>
<DD>Specifies that this ConeSound allows writing to its object's cone params
 information.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.ConeSound.ALLOW_ANGULAR_ATTENUATION_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="ConeSound()"><!-- --></A><H3>
ConeSound</H3>
<PRE>
public <B>ConeSound</B>()</PRE>
<DL>
<DD>Constructs and initializes a new ConeSound node using default
 parameters.  The following default values are used:
 <ul>
 Direction vector: (0.0, 0.0, 1.0) <br>
 Angular attenuation:
     ((0.0, 1.0, Sound.NO_FILTER),(p/2, 0.0, Sound.NO_FILTER)) <br>
 </ul>
<P>
</DL>
<HR>

<A NAME="ConeSound(javax.media.j3d.MediaContainer, float, javax.vecmath.Point3f, javax.vecmath.Vector3f)"><!-- --></A><H3>
ConeSound</H3>
<PRE>
public <B>ConeSound</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,
                 <A HREF="../../../javax/vecmath/Vector3f.html" title="class in javax.vecmath">Vector3f</A>&nbsp;direction)</PRE>
<DL>
<DD>Constructs a ConeSound node object using only the provided parameter