sndchannel.html

这个是java的quicktime for java 的详细使用文档

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the current setting of the quietNow flag.</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="../../quicktime/sound/SndChannel.html#play(quicktime.sound.SndHandle)">play</A></B>(<A HREF="../../quicktime/sound/SndHandle.html">SndHandle</A>&nbsp;sndHdl)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Plays a sound asynchronously from memory.</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="../../quicktime/sound/SndChannel.html#setEQSpectrumBands(quicktime.std.movies.media.MediaEQSpectrumBands)">setEQSpectrumBands</A></B>(<A HREF="../../quicktime/std/movies/media/MediaEQSpectrumBands.html">MediaEQSpectrumBands</A>&nbsp;spectrumInfo)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the array of fequencies that are used to calculate spectral information.</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="../../quicktime/sound/SndChannel.html#setEQToneControlGain(int, int)">setEQToneControlGain</A></B>(int&nbsp;bass,
                     int&nbsp;treble)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the values of the bass and treble tone control gain values.</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="../../quicktime/sound/SndChannel.html#setEQToneControlOnOff(boolean)">setEQToneControlOnOff</A></B>(boolean&nbsp;flag)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If true enables the tone control (bass and treble).</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="../../quicktime/sound/SndChannel.html#setLevelMeterOnOff(boolean)">setLevelMeterOnOff</A></B>(boolean&nbsp;enabled)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets Level Meter state.</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="../../quicktime/sound/SndChannel.html#setQuietNow(boolean)">setQuietNow</A></B>(boolean&nbsp;flag)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This flag controls whether a sound channel is silent when it is disposed of.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../quicktime/sound/SCStatus.html">SCStatus</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../quicktime/sound/SndChannel.html#status()">status</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The fields of the record returned by this call accurately 
 describe the sound channel specified.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_quicktime.QTObject"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class quicktime.<A HREF="../../quicktime/QTObject.html">QTObject</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../quicktime/QTObject.html#disposeQTObject()">disposeQTObject</A>, <A HREF="../../quicktime/QTObject.html#equals(java.lang.Object)">equals</A>, <A HREF="../../quicktime/QTObject.html#ID(quicktime.QTObject)">ID</A>, <A HREF="../../quicktime/QTObject.html#toString()">toString</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class java.lang.Object</B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>getClass, hashCode, notify, notifyAll, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

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


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

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="SndChannel()"><!-- --></A><H3>
SndChannel</H3>
<PRE>
public <B>SndChannel</B>()
           throws <A HREF="../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Opens a new SndChannel and allocates memory to store the commands that will control
 the operation of the sound channel.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/SOUND/imsoundmgr.54.htm#pgfId=2214">QuickTime::SndNewChannel</a> </b><BR><BR>
<HR>

<A NAME="SndChannel(int, int)"><!-- --></A><H3>
SndChannel</H3>
<PRE>
public <B>SndChannel</B>(int&nbsp;synth,
                  int&nbsp;init)
           throws <A HREF="../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Opens a new SndChannel and allocates memory to store the commands that will control
 the operation of the sound channel.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/SOUND/imsoundmgr.54.htm#pgfId=2214">QuickTime::SndNewChannel</a> </b><BR><BR>
<DT><B>Parameters:</B><DD><CODE>synth</CODE> - the sound data type you intend to play on this channel<DD><CODE>init</CODE> - the desired initialization parameters for the channel.</DL>
</DD>
</DL>
<HR>

<A NAME="SndChannel(quicktime.sound.SoundCallBack)"><!-- --></A><H3>
SndChannel</H3>
<PRE>
public <B>SndChannel</B>(<A HREF="../../quicktime/sound/SoundCallBack.html">SoundCallBack</A>&nbsp;callback)
           throws <A HREF="../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Opens a new SndChannel and allocates memory to store the commands that will control
 the operation of the sound channel.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/SOUND/imsoundmgr.54.htm#pgfId=2214">QuickTime::SndNewChannel</a> </b><BR><BR>
<DT><B>Parameters:</B><DD><CODE>synth</CODE> - the sound data type you intend to play on this channel<DD><CODE>init</CODE> - the desired initialization parameters for the channel.<DD><CODE>callback</CODE> - the (optional) callback that can be called when a sound has completed.</DL>
</DD>
</DL>
<HR>

<A NAME="SndChannel(int, int, quicktime.sound.SoundCallBack)"><!-- --></A><H3>
SndChannel</H3>
<PRE>
public <B>SndChannel</B>(int&nbsp;synth,
                  int&nbsp;init,
                  <A HREF="../../quicktime/sound/SoundCallBack.html">SoundCallBack</A>&nbsp;callback)
           throws <A HREF="../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Opens a new SndChannel and allocates memory to store the commands that will control
 the operation of the sound channel.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/SOUND/imsoundmgr.54.htm#pgfId=2214">QuickTime::SndNewChannel</a> </b><BR><BR>
<DT><B>Parameters:</B><DD><CODE>synth</CODE> - the sound data type you intend to play on this channel<DD><CODE>init</CODE> - the desired initialization parameters for the channel.<DD><CODE>callback</CODE> - the (optional) callback that can be called when a sound has completed.</DL>
</DD>
</DL>

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

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

<A NAME="isQuietNow()"><!-- --></A><H3>
isQuietNow</H3>
<PRE>
public boolean <B>isQuietNow</B>()</PRE>
<DL>
<DD>Returns the current setting of the quietNow flag.<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setQuietNow(boolean)"><!-- --></A><H3>
setQuietNow</H3>
<PRE>
public void <B>setQuietNow</B>(boolean&nbsp;flag)</PRE>
<DL>
<DD>This flag controls whether a sound channel is silent when it is disposed of.
 If this is false, then when the SndChannel is diposed, the disposal call becomes
 synchronous and waits until the the sound is actually finished. If this is true,
 the SndChannel's queue is flushed immediately, which may silent a sound if it is playing.
 <BR> The default setting is to allow the sound to finish playing (the flag is set to false). 
 If you wish to explicitly stop a sound when you dispose the channel then set this to true.<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="play(quicktime.sound.SndHandle)"><!-- --></A><H3>
play</H3>
<PRE>
public void <B>play</B>(<A HREF="../../quicktime/sound/SndHandle.html">SndHandle</A>&nbsp;sndHdl)
          throws <A HREF="../../quicktime/sound/SoundException.html">SoundException</A></PRE>
<DL>
<DD>Plays a sound asynchronously from memory.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/SOUND/imintrosound.15.htm#pgfId=825">QuickTime::SndPlay</a>  <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/SOUND/imsoundmgr.52.htm#pgfId=2209">QuickTime::SndPlay</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>chan</CODE> - if supplied the sound is played asynchronously using this channel<DD><CODE>sndHdl</CODE> - the handle that has the sound data in it</DL>
</DD>
</DL>
<HR>

<A NAME="isFinished()"><!-- --></A><H3>
isFinished</H3>
<PRE>
public boolean <B>isFinished</B>()
                   throws <A HREF="../../quicktime/sound/SoundException.html">SoundException</A></PRE>
<DL>
<DD>Returns true if the channel is both NOT busy and NOT paused - ie. there are
 no commands to waiting to be processed for the channel and it is not paused.
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>a boolean</DL>
</DD>
</DL>
<HR>

<A NAME="isPaused()"><!-- --></A><H3>
isPaused</H3>
<PRE>
public boolean <B>isPaused</B>()
                 throws <A HREF="../../quicktime/sound/SoundException.html">SoundException</A></PRE>
<DL>
<DD>Returns true if the channel is currently paused.
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>a boolean</DL>
</DD>
</DL>
<HR>

<A NAME="status()"><!-- --></A><H3>
status</H3>
<PRE>
public <A HREF="../../quicktime/sound/SCStatus.html">SCStatus</A> <B>status</B>()
                throws <A HREF="../../quicktime/sound/SoundException.html">SoundException</A></PRE>
<DL>
<DD>The fields of the record returned by this call accurately 
 describe the sound channel specified.		
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>SCStatus</DL>
</DD>
</DL>
<HR>

<A NAME="doCommand(quicktime.sound.SndCommand)"><!-- --></A><H3>
doCommand</H3>
<PRE>
public void <B>doCommand</B>(<A HREF="../../quicktime/sound/SndCommand.html">SndCommand</A>&nbsp;cmd)
               throws <A HREF="../../quicktime/sound/SoundException.html">SoundException</A></PRE>
<DL>
<DD>The SndDoCommand function sends the sound command specified in the cmd parameter to the end of the command queue of the channel specified in the chan parameter. The noWait is set to true
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>cmd</CODE> - A sound command to be sent to the channel</DL>
</DD>
</DL>
<HR>