sequencegrabber.html

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

</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>c</CODE> - the channel you want to dispose</DL>
</DD>
</DL>
<HR>

<A NAME="newOutput(quicktime.std.movies.media.DataRef, int)"><!-- --></A><H3>
newOutput</H3>
<PRE>
public <A HREF="../../../quicktime/std/sg/SGOutput.html">SGOutput</A> <B>newOutput</B>(<A HREF="../../../quicktime/std/movies/media/DataRef.html">DataRef</A>&nbsp;dataRef,
                          int&nbsp;whereFlags)
                   throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>The SGNewOutput function creates a new sequence grabber output. You specify
	the output誷 destination container using a data reference. Once you have
	created the sequence grabber output, you can use the SGSetChannelOutput
	function to assign the output to a sequence grabber channel.

	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/REF/refSeqGrabComp.c.htm#refSeq386">QuickTime::SGNewOutput</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>owner</CODE> - Specifies the type of channel.<DD><CODE>dataRef</CODE> - Specifies the type of channel.<DD><CODE>dataRefType</CODE> - Specifies the type of channel.<DD><CODE>whereFlags</CODE> - Specifies the type of channel.</DL>
</DD>
</DL>
<HR>

<A NAME="disposeOutput(quicktime.std.sg.SGOutput)"><!-- --></A><H3>
disposeOutput</H3>
<PRE>
public void <B>disposeOutput</B>(<A HREF="../../../quicktime/std/sg/SGOutput.html">SGOutput</A>&nbsp;output)
                   throws <A HREF="../../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Disposes of an output associated with a sequence grabber.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/REF/refSeqGrabComp.c.htm#refSeq389">QuickTime::SGDisposeOutput</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>c</CODE> - the output you want to dispose</DL>
</DD>
</DL>
<HR>

<A NAME="writeExtendedMovieData(quicktime.std.sg.SGChannel, int, int, long, quicktime.std.sg.SGOutput)"><!-- --></A><H3>
writeExtendedMovieData</H3>
<PRE>
public void <B>writeExtendedMovieData</B>(<A HREF="../../../quicktime/std/sg/SGChannel.html">SGChannel</A>&nbsp;c,
                                   int&nbsp;p,
                                   int&nbsp;len,
                                   long&nbsp;offset,
                                   <A HREF="../../../quicktime/std/sg/SGOutput.html">SGOutput</A>&nbsp;sgOut)
                            throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>Allows your channel component to add data to a movie.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/REF/refSeqGrabChanComp.a.htm#refSeq245">QuickTime::SGWriteExtendedMovieData(</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>p</CODE> - &nbsp;<DD><CODE>len</CODE> - &nbsp;<DD><CODE>offset</CODE> - offset to the new data in the movie. If the movie is in memory, the
 returned offset reflects the location the data will have in the movie on a permanent storage device.<DD><CODE>sgOut</CODE> - output to which the data was written.  
 associated with the sequence grabber output.</DL>
</DD>
</DL>
<HR>

<A NAME="startPreview()"><!-- --></A><H3>
startPreview</H3>
<PRE>
public void <B>startPreview</B>()
                  throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>Instructs the sequence grabber to begin processing data from its channels.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabChanComp.f.htm#imSeqG186">QuickTime::SGStartPreview</a>  <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabComp.c.htm#imSeqG235">QuickTime::SGStartPreview</a> </b><BR><BR>
</DL>
</DD>
</DL>
<HR>

<A NAME="startRecord()"><!-- --></A><H3>
startRecord</H3>
<PRE>
public void <B>startRecord</B>()
                 throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>Instructs the sequence grabber component to begin collecting data from its channels.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabChanComp.f.htm#imSeqG190">QuickTime::SGStartRecord</a>  <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabComp.c.htm#imSeqG239">QuickTime::SGStartRecord</a> </b><BR><BR>
</DL>
</DD>
</DL>
<HR>

<A NAME="idle()"><!-- --></A><H3>
idle</H3>
<PRE>
public void <B>idle</B>()
          throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>Provides processing time to the sequence grabber component and its channel components. 
 After starting a preview or record operation, you should call this function as often 
 as possible, until you stop the operation by calling stop.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabChanComp.f.htm#imSeqG194">QuickTime::SGIdle</a>  <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabComp.c.htm#imSeqG243">QuickTime::SGIdle</a> </b><BR><BR>
</DL>
</DD>
</DL>
<HR>

<A NAME="idleMore()"><!-- --></A><H3>
idleMore</H3>
<PRE>
public boolean <B>idleMore</B>()
                 throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>Provides processing time to the sequence grabber component and its channel components. 
 After starting a preview or record operation, you should call this function as often 
 as possible, until you stop the operation by calling stop. If the sequence grabber
 has a stop time set, then this method will return false when the sequence grabber
 has captured media for the specified time. At that point the application should
 stop the sequence grabber and not call idle until restarted. 
 It will return true when further idling is required.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabChanComp.f.htm#imSeqG194">QuickTime::SGIdle</a>  <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabComp.c.htm#imSeqG243">QuickTime::SGIdle</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>true if requires more idling, false if comleted.</DL>
</DD>
</DL>
<HR>

<A NAME="update(quicktime.qd.Region)"><!-- --></A><H3>
update</H3>
<PRE>
public void <B>update</B>(<A HREF="../../../quicktime/qd/Region.html">Region</A>&nbsp;updateRgn)
            throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>The SGUpdate function allows you to tell the sequence grabber that it must refresh its display.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabChanComp.f.htm#imSeqG197">QuickTime::SGUpdate</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>updateRgn</CODE> - Indicates the part of the QDGraphics that has been changed. 
 If you set this parameter to null, the sequence grabber uses the window誷 current visible region</DL>
</DD>
</DL>
<HR>

<A NAME="stop()"><!-- --></A><H3>
stop</H3>
<PRE>
public void <B>stop</B>()
          throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>Stops a preview or record operation.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabChanComp.f.htm#imSeqG200">QuickTime::SGStop</a>  <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabComp.c.htm#imSeqG250">QuickTime::SGStop</a> </b><BR><BR>
</DL>
</DD>
</DL>
<HR>

<A NAME="pause(int)"><!-- --></A><H3>
pause</H3>
<PRE>
public void <B>pause</B>(int&nbsp;pause)
           throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>You can suspend or restart a record or preview operation by calling the pause function.
 You supply a byte value that instructs the sequence grabber whether to pause or restart 
 the current operation.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabChanComp.f.htm#imSeqG207">QuickTime::SGPause</a>  <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabComp.c.htm#imSeqG253">QuickTime::SGPause</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pause</CODE> - Instructs whether to suspend or restart the current operation.</DL>
</DD>
</DL>
<HR>

<A NAME="getPause()"><!-- --></A><H3>
getPause</H3>
<PRE>
public int <B>getPause</B>()
             throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>Specifies control information about the current operation to the sequence grabber component. 
 <BR><BR><b>QuickTime::SGGetPause</b><BR><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>sgFlags</CODE> - The control flags for the current operation.</DL>
</DD>
</DL>
<HR>

<A NAME="prepare(boolean, boolean)"><!-- --></A><H3>
prepare</H3>
<PRE>
public void <B>prepare</B>(boolean&nbsp;prepareForPreview,
                    boolean&nbsp;prepareForRecord)
             throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>Instructs the sequence grabber to get ready to begin a preview or record operation.
 May commence both operations. You specify the operations.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabChanComp.f.htm#imSeqG211">QuickTime::SGPrepare</a>  <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabComp.c.htm#imSeqG261">QuickTime::SGPrepare</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>prepareForPreview</CODE> - The preview operation.<DD><CODE>prepareForRecord</CODE> - The record operation.</DL>
</DD>
</DL>
<HR>

<A NAME="release()"><!-- --></A><H3>
release</H3>
<PRE>
public void <B>release</B>()
             throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>Instructs the sequence grabber to release any system resources it allocated previously.
 You should call release whenever you call SGPrepare without subsequently starting a 
 record or preview operation.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabChanComp.f.htm#imSeqG215">QuickTime::SGRelease</a>  <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabComp.c.htm#imSeqG265">QuickTime::SGRelease</a> </b><BR><BR>
</DL>
</DD>
</DL>
<HR>

<A NAME="getMovie()"><!-- --></A><H3>
getMovie</H3>
<PRE>
public <A HREF="../../../quicktime/std/movies/Movie.html">Movie</A> <B>getMovie</B>()</PRE>
<DL>
<DD>Determines a reference to the movie that contains the data collected during a record operation. 
 You can use this movie identifier with Movie Toolbox functions.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabComp.c.htm#imSeqG267">QuickTime::SGGetMovie</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>The Movie or null if there is no movie.</DL>
</DD>
</DL>
<HR>

<A NAME="setSettings(quicktime.std.movies.media.UserData)"><!-- --></A><H3>
setSettings</H3>
<PRE>
public void <B>setSettings</B>(<A HREF="../../../quicktime/std/movies/media/UserData.html">UserData</A>&nbsp;ud)
                 throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>Configures a sequence grabber. 
 You provide this configuration information in a Movie Toolbox user data list. 
 Typically, you obtain this configuration data from the getSettings method.
 Note that the sequence grabber disposes of any of its current channels before applying 
 this configuration information. It then opens connections to new channels as appropriate.
 You can restore saved settings by using the Movie Toolbox's NewUserDataFromHandle function.

	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabComp.d.htm#imSeqG286">QuickTime::SGSetSettings</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>ud</CODE> - Specifies a user data list with configuration information for the sequence grabber.</DL>
</DD>
</DL>
<HR>

<A NAME="getSettings()"><!-- --></A><H3>
getSettings</H3>
<PRE>
public <A HREF="../../../quicktime/std/movies/media/UserData.html">UserData</A> <B>getSettings</B>()
                     throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>Retrieves the current settings of all channels used by the sequence grabber.
 The sequence grabber places all of this configuration information into a 
 Movie Toolbox user data list.
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabComp.d.htm#imSeqG282">QuickTime::SGGetSettings</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>A Movie Toolbox user data list that contains the configuration information.</DL>
</DD>
</DL>
<HR>

<A NAME="grabPict(quicktime.qd.QDRect, int, int)"><!-- --></A><H3>
grabPict</H3>
<PRE>
public <A HREF="../../../quicktime/qd/Pict.html">Pict</A> <B>grabPict</B>(<A HREF="../../../quicktime/qd/QDRect.html">QDRect</A>&nbsp;bounds,
                     int&nbsp;offscreenDepth,
                     int&nbsp;grabPictFlags)
              throws <A HREF="../../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Provides a simple interface to obtain a QuickDraw picture from a sequence grabber component. 
 The sequence grabber can display the picture directly, or it can write the picture to an 
 offscreen buffer. This function is limited in scope, however, and does not allow you to 
 control all of the parameters that govern the operation. When you call this function, 
 the sequence grabber component obtains and configures appropriate sequence grabber 
 channel components (if necessary), grabs the data, and then releases any components 
 it obtained. 
	 <BR><BR><b> <a href="http://developer.apple.com/techpubs/quicktime/qtdevdocs/INMAC/QTC/imSeqGrabComp.c.htm#imSeqG273">QuickTime::SGGrabPict</a> </b><BR><BR>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bounds</CODE> - The bounding rectangle.<DD><CODE>offscreenDepth</CODE> - The bit depth of the Pict.<DD><CODE>grabPictFlags</CODE> - The flags for the operation.<DT><B>Returns:</B><DD>The Pict.</DL>
</DD>
</DL>
<HR>

<A NAME="setDataOutput(quicktime.io.QTFile, int)"><!-- --></A><H3>
setDataOutput</H3>
<PRE>
public void <B>setDataOutput</B>(<A HREF="../../../quicktime/io/QTFile.html">QTFile</A>&nbsp;movieFile,
                          int&nbsp;whereFlags)
                   throws <A HREF="../../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Specifies the movie file for a record operation and other options that govern the operation.