sndhandle.html

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

<DL>
<DD>You can use the SetupSndHeader function to construct a sound resource containing sampled sound that can be passed to the SndPlay function.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/SOUND/imsoundinput.1b.htm#pgfId=908">QuickTime::SetupSndHeader</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>numChannels</CODE> - the number of channels for the sound<DD><CODE>sampleRate</CODE> - the rate at which the sound was recorded<DD><CODE>sampleSize</CODE> - The sample size for the original sound (that is, bits per sample).<DD><CODE>compressionType</CODE> - The compression type for the sound ('NONE', 'MAC3', 'MAC6', or other third-party types).<DD><CODE>numBytes</CODE> - The number of bytes of audio data that are to be stored in the handle. (This value is not necessarily the same as the number of samples in the sound.)<DT><B>Returns:</B><DD>the size (in bytes) of the 'snd ' resource header that is created</DL>
</DD>
</DL>
<HR>

<A NAME="setupHeader(int, float, int, int, int, int)"><!-- --></A><H3>
setupHeader</H3>
<PRE>
public int <B>setupHeader</B>(int&nbsp;numChannels,
                       float&nbsp;sampleRate,
                       int&nbsp;sampleSize,
                       int&nbsp;compressionType,
                       int&nbsp;baseNote,
                       int&nbsp;numBytes)
                throws <A HREF="../../quicktime/sound/SoundException.html">SoundException</A></PRE>
<DL>
<DD>You can use the SetupSndHeader function to construct a sound resource containing sampled sound that can be passed to the SndPlay function.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/SOUND/imsoundinput.1b.htm#pgfId=908">QuickTime::SetupSndHeader</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>numChannels</CODE> - the number of channels for the sound<DD><CODE>sampleRate</CODE> - the rate at which the sound was recorded<DD><CODE>sampleSize</CODE> - The sample size for the original sound (that is, bits per sample).<DD><CODE>compressionType</CODE> - The compression type for the sound ('NONE', 'MAC3', 'MAC6', or other third-party types).<DD><CODE>baseNote</CODE> - The base note for the sound, expressed as a MIDI note value.<DD><CODE>numBytes</CODE> - The number of bytes of audio data that are to be stored in the handle. (This value is not necessarily the same as the number of samples in the sound.)<DT><B>Returns:</B><DD>the size (in bytes) of the 'snd ' resource header that is created</DL>
</DD>
</DL>
<HR>

<A NAME="getSoundHeaderOffset()"><!-- --></A><H3>
getSoundHeaderOffset</H3>
<PRE>
public final int <B>getSoundHeaderOffset</B>()
                               throws <A HREF="../../quicktime/sound/SoundException.html">SoundException</A></PRE>
<DL>
<DD>The number of bytes from the beginning of the sound resource specified by the sndHdl parameter to the sound header that is contained within.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/SOUND/imsoundmgr.56.htm#pgfId=2126">QuickTime::GetSoundHeaderOffset</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>the offset to the sound header</DL>
</DD>
</DL>
<HR>

<A NAME="getSoundData()"><!-- --></A><H3>
getSoundData</H3>
<PRE>
public <A HREF="../../quicktime/util/QTPointerRef.html">QTPointerRef</A> <B>getSoundData</B>()
                          throws <A HREF="../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Return a Pointer to the sound data that is contained within the SndHandle.
 The SndHandle will be locked by this call and should remain locked for the
 life of the returned data object.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>a QTPointer to the Sound data</DL>
</DD>
</DL>
<HR>

<A NAME="appendSoundData(quicktime.util.QTPointerRef)"><!-- --></A><H3>
appendSoundData</H3>
<PRE>
public void <B>appendSoundData</B>(<A HREF="../../quicktime/util/QTPointerRef.html">QTPointerRef</A>&nbsp;buffer)
                     throws <A HREF="../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Appends the sound buffer to the end of this handle. This is required
 before the SndHandle can be used for recording or playing sound.
 If a pre-existing buffer has been appended this will be removed and
 replace with the incoming buffer. This will copy the incoming buffer.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>buffer</CODE> - the buffer that contains the actual sound data.</DL>
</DD>
</DL>
<HR>

<A NAME="appendSoundBuffer(int)"><!-- --></A><H3>
appendSoundBuffer</H3>
<PRE>
public void <B>appendSoundBuffer</B>(int&nbsp;bufferSize)
                       throws <A HREF="../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Appends the specified number of bytes to the SoundHandle after
 the header. The call resizes the SndHandle to the sound header offset + buffer size.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bufferSize</CODE> - the number of bytes to append for the sound buffer</DL>
</DD>
</DL>
<HR>

<A NAME="setSoundData(quicktime.util.QTPointerRef)"><!-- --></A><H3>
setSoundData</H3>
<PRE>
public void <B>setSoundData</B>(<A HREF="../../quicktime/util/QTPointerRef.html">QTPointerRef</A>&nbsp;buffer)
                  throws <A HREF="../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Sets the internal buffer Pointer of this sound header to the incomding buffer.
 This does NOT copy memory and is therefore the most efficient means of storing the data.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>buffer</CODE> - the buffer that contains the actual sound data.</DL>
</DD>
</DL>
<HR>

<A NAME="parseSndHeader()"><!-- --></A><H3>
parseSndHeader</H3>
<PRE>
public final <A HREF="../../quicktime/sound/SndInfo.html">SndInfo</A> <B>parseSndHeader</B>()
                             throws <A HREF="../../quicktime/sound/SoundException.html">SoundException</A></PRE>
<DL>
<DD>You use this function to retrieve information about a SndHandle.
 <BR><BR><b>QuickTime::ParseSndHeader</b><BR><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>a SndInfo object</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/SndHandle.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../quicktime/sound/SndCommand.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../quicktime/sound/SndInfo.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="SndHandle.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: &nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>

</BODY>
</HTML>