📄 pointsound.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><!--NewPage--><HTML><HEAD><!-- Generated by javadoc (build 1.5.0_06) on Wed Dec 13 16:20:06 PST 2006 --><TITLE>PointSound (Java 3D 1.5.0)</TITLE><META NAME="keywords" CONTENT="javax.media.j3d.PointSound class"><LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style"><SCRIPT type="text/javascript">function windowTitle(){ parent.document.title="PointSound (Java 3D 1.5.0)";}</SCRIPT><NOSCRIPT></NOSCRIPT></HEAD><BODY BGCOLOR="white" onload="windowTitle();"><!-- ========= START OF TOP NAVBAR ======= --><A NAME="navbar_top"><!-- --></A><A HREF="#skip-navbar_top" title="Skip navigation links"></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""><TR><TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A NAME="navbar_top_firstrow"><!-- --></A><TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR></TABLE></TD><TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM></EM></TD></TR><TR><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../javax/media/j3d/PointLight.html" title="class in javax.media.j3d"><B>PREV CLASS</B></A> <A HREF="../../../javax/media/j3d/PolygonAttributes.html" title="class in javax.media.j3d"><B>NEXT CLASS</B></A></FONT></TD><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html?javax/media/j3d/PointSound.html" target="_top"><B>FRAMES</B></A> <A HREF="PointSound.html" target="_top"><B>NO FRAMES</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>'); } //--></SCRIPT><NOSCRIPT> <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A></NOSCRIPT></FONT></TD></TR><TR><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD></TR></TABLE><A NAME="skip-navbar_top"></A><!-- ========= END OF TOP NAVBAR ========= --><HR><!-- ======== START OF CLASS DATA ======== --><H2><FONT SIZE="-1">javax.media.j3d</FONT><BR>Class PointSound</H2><PRE>java.lang.Object <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../javax/media/j3d/SceneGraphObject.html" title="class in javax.media.j3d">javax.media.j3d.SceneGraphObject</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../javax/media/j3d/Node.html" title="class in javax.media.j3d">javax.media.j3d.Node</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../javax/media/j3d/Leaf.html" title="class in javax.media.j3d">javax.media.j3d.Leaf</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../javax/media/j3d/Sound.html" title="class in javax.media.j3d">javax.media.j3d.Sound</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>javax.media.j3d.PointSound</B></PRE><DL><DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../javax/media/j3d/ConeSound.html" title="class in javax.media.j3d">ConeSound</A></DD></DL><HR><DL><DT><PRE>public class <B>PointSound</B><DT>extends <A HREF="../../../javax/media/j3d/Sound.html" title="class in javax.media.j3d">Sound</A></DL></PRE><P>The PointSound node (a sub-class of the Sound node) defines a spatially located sound source whose waves radiate uniformly in all directions from a given location in space. It has the same attributes as a Sound object with the addition of a location and the specification of distance-based gain attenuation for listener positions between an array of distances.<P> A sound's amplitude is attenuated based on the distance between the listener and the sound source position. A piecewise linear curve (defined in terms of pairs of distance and gain scale factor) specifies the gain scale factor slope. The PointSound's location and attenuation distances are defined in the local coordinate system of the node.<P> Distance Gain Attenuation <UL> Associated with distances from the listener to the sound source via an array of (distance, gain-scale-factor) pairs. The gain scale factor applied to the sound source is the linear interpolated gain value between the distance value range that includes the current distance from the listener to the sound source. If the distance from the listener to the sound source is less than the first distance in the array, the first gain scale factor is applied to the sound source. This creates a spherical region around the listener within which all sound gain is uniformly scaled by the first gain in the array. If the distance from the listener to the sound source is greater than the last distance in the array, the last gain scale factor is applied to the sound source.<P> Distance elements in this array of Point2f is a monotonically-increasing set of floating point numbers measured from the location of the sound source. Gain scale factors elements in this list of pairs can be any positive floating point numbers. While for most applications this list of gain scale factors will usually be monotonically-decreasing, they do not have to be. If this is not set, no distance gain attenuation is performed (equivalent to using a distance gain of 1.0 for all distances). <P> getDistanceGainLength method returns the length of the distance gain attenuation arrays. Arrays passed into getDistanceGain methods should all be at least this size.<P> There are two methods for getDistanceGain, one returning an array of points, the other returning separate arrays for each attenuation component.</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 int</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/PointSound.html#ALLOW_DISTANCE_GAIN_READ">ALLOW_DISTANCE_GAIN_READ</A></B></CODE><BR> Specifies that this node allows access to its object's distance gain attenuation information.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static int</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/PointSound.html#ALLOW_DISTANCE_GAIN_WRITE">ALLOW_DISTANCE_GAIN_WRITE</A></B></CODE><BR> Specifies that this node allows writing to its object's distance gain attenuation information.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static int</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/PointSound.html#ALLOW_POSITION_READ">ALLOW_POSITION_READ</A></B></CODE><BR> Specifies that this node allows access to its object's position information.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static int</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/PointSound.html#ALLOW_POSITION_WRITE">ALLOW_POSITION_WRITE</A></B></CODE><BR> Specifies that this node allows writing to its object's position information.</TD></TR></TABLE> <A NAME="fields_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>Fields 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#ALLOW_CHANNELS_USED_READ">ALLOW_CHANNELS_USED_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_CONT_PLAY_READ">ALLOW_CONT_PLAY_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_CONT_PLAY_WRITE">ALLOW_CONT_PLAY_WRITE</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_DURATION_READ">ALLOW_DURATION_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_ENABLE_READ">ALLOW_ENABLE_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_ENABLE_WRITE">ALLOW_ENABLE_WRITE</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_INITIAL_GAIN_READ">ALLOW_INITIAL_GAIN_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_INITIAL_GAIN_WRITE">ALLOW_INITIAL_GAIN_WRITE</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_IS_PLAYING_READ">ALLOW_IS_PLAYING_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_IS_READY_READ">ALLOW_IS_READY_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_LOOP_READ">ALLOW_LOOP_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_LOOP_WRITE">ALLOW_LOOP_WRITE</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_MUTE_READ">ALLOW_MUTE_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_MUTE_WRITE">ALLOW_MUTE_WRITE</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_PAUSE_READ">ALLOW_PAUSE_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_PAUSE_WRITE">ALLOW_PAUSE_WRITE</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_PRIORITY_READ">ALLOW_PRIORITY_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_PRIORITY_WRITE">ALLOW_PRIORITY_WRITE</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_RATE_SCALE_FACTOR_READ">ALLOW_RATE_SCALE_FACTOR_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_RATE_SCALE_FACTOR_WRITE">ALLOW_RATE_SCALE_FACTOR_WRITE</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_RELEASE_READ">ALLOW_RELEASE_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_RELEASE_WRITE">ALLOW_RELEASE_WRITE</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_SCHEDULING_BOUNDS_READ">ALLOW_SCHEDULING_BOUNDS_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_SCHEDULING_BOUNDS_WRITE">ALLOW_SCHEDULING_BOUNDS_WRITE</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_SOUND_DATA_READ">ALLOW_SOUND_DATA_READ</A>, <A HREF="../../../javax/media/j3d/Sound.html#ALLOW_SOUND_DATA_WRITE">ALLOW_SOUND_DATA_WRITE</A>, <A HREF="../../../javax/media/j3d/Sound.html#DURATION_UNKNOWN">DURATION_UNKNOWN</A>, <A HREF="../../../javax/media/j3d/Sound.html#INFINITE_LOOPS">INFINITE_LOOPS</A>, <A HREF="../../../javax/media/j3d/Sound.html#NO_FILTER">NO_FILTER</A></CODE></TD></TR></TABLE> <A NAME="fields_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>Fields 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#ALLOW_AUTO_COMPUTE_BOUNDS_READ">ALLOW_AUTO_COMPUTE_BOUNDS_READ</A>, <A HREF="../../../javax/media/j3d/Node.html#ALLOW_AUTO_COMPUTE_BOUNDS_WRITE">ALLOW_AUTO_COMPUTE_BOUNDS_WRITE</A>, <A HREF="../../../javax/media/j3d/Node.html#ALLOW_BOUNDS_READ">ALLOW_BOUNDS_READ</A>, <A HREF="../../../javax/media/j3d/Node.html#ALLOW_BOUNDS_WRITE">ALLOW_BOUNDS_WRITE</A>, <A HREF="../../../javax/media/j3d/Node.html#ALLOW_COLLIDABLE_READ">ALLOW_COLLIDABLE_READ</A>, <A HREF="../../../javax/media/j3d/Node.html#ALLOW_COLLIDABLE_WRITE">ALLOW_COLLIDABLE_WRITE</A>, <A HREF="../../../javax/media/j3d/Node.html#ALLOW_LOCAL_TO_VWORLD_READ">ALLOW_LOCAL_TO_VWORLD_READ</A>, <A HREF="../../../javax/media/j3d/Node.html#ALLOW_LOCALE_READ">ALLOW_LOCALE_READ</A>, <A HREF="../../../javax/media/j3d/Node.html#ALLOW_PARENT_READ">ALLOW_PARENT_READ</A>, <A HREF="../../../javax/media/j3d/Node.html#ALLOW_PICKABLE_READ">ALLOW_PICKABLE_READ</A>, <A HREF="../../../javax/media/j3d/Node.html#ALLOW_PICKABLE_WRITE">ALLOW_PICKABLE_WRITE</A>, <A HREF="../../../javax/media/j3d/Node.html#ENABLE_COLLISION_REPORTING">ENABLE_COLLISION_REPORTING</A>, <A HREF="../../../javax/media/j3d/Node.html#ENABLE_PICK_REPORTING">ENABLE_PICK_REPORTING</A></CODE></TD></TR></TABLE> <!-- ======== CONSTRUCTOR SUMMARY ======== --><A NAME="constructor_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>Constructor Summary</B></FONT></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><B><A HREF="../../../javax/media/j3d/PointSound.html#PointSound()">PointSound</A></B>()</CODE><BR> Constructs and initializes a new PointSound node using default parameters.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><B><A HREF="../../../javax/media/j3d/PointSound.html#PointSound(javax.media.j3d.MediaContainer, float, float, float, float)">PointSound</A></B>(<A HREF="../../../javax/media/j3d/MediaContainer.html" title="class in javax.media.j3d">MediaContainer</A> soundData, float initialGain, float posX, float posY, float posZ)</CODE><BR>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -