Java DTV API 1.3
18-Nov-2009

com.sun.dtv.media
Interface FreezeResumeControl

All Superinterfaces:
Control

public interface FreezeResumeControl
extends Control

This interface must be implemented to enable the application to freeze the player. During a freeze of the player the last frame displayed on the screen must still be present until a resume action is performed.


Method Summary
 void addFreezeResumeListener(FreezeResumeListener freezeResumeListener)
          Add a freeze,resume listener interface.
 void freeze()
          Invocation of this method freezes the decoding of the media stream as soon as possible and leaves the last decoded frame visible to the end-user.
 void removeFreezeResumeListener(FreezeResumeListener freezeResumeListener)
          Removes a freeze,resume listener interface.
 void resume()
          Invocation of this method resumes the decoding of the media stream following a freeze operation.
 
Methods inherited from interface javax.media.Control
getControlComponent
 

Method Detail

freeze

void freeze()
            throws FreezeResumeException
Invocation of this method freezes the decoding of the media stream as soon as possible and leaves the last decoded frame visible to the end-user. The decoding of the audio is stopped. The actual timebase of the underlying media is however not altered.

Throws:
FreezeResumeException - if the freeze is unsuccessful

resume

void resume()
            throws FreezeResumeException
Invocation of this method resumes the decoding of the media stream following a freeze operation. If the player is started and if decoding of the media stream was not previously frozen then calls to this method must have no effect. If the media of the Player is a broadcast stream the presentation will start at the respective mediaTime when the resume method was invoked. That means some part of the stream will not be displayed.

Throws:
FreezeResumeException - if the resume is unsuccessful

addFreezeResumeListener

void addFreezeResumeListener(FreezeResumeListener freezeResumeListener)
Add a freeze,resume listener interface.

Parameters:
freezeResumeListener - the interface that will receive all the freeze, resume events.
See Also:
removeFreezeResumeListener(com.sun.dtv.media.FreezeResumeListener)

removeFreezeResumeListener

void removeFreezeResumeListener(FreezeResumeListener freezeResumeListener)
Removes a freeze,resume listener interface.

Parameters:
freezeResumeListener - the listener to remove.
See Also:
addFreezeResumeListener(com.sun.dtv.media.FreezeResumeListener)

Java DTV API 1.3
18-Nov-2009

Copyright © 2008-2009 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved.

U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements. Sun, Sun Microsystems, the Sun logo and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.Products covered by and information contained in this service manual are controlled by U.S. Export Control laws and may be subject to the export or import laws in other countries. Nuclear, missile, chemical biological weapons or nuclear maritime end uses or end users, whether direct or indirect, are strictly prohibited. Export or reexport to countries subject to U.S. embargo or to entities identified on U.S. export exclusion lists, including, but not limited to, the denied persons and specially designated nationals lists is strictly prohibited.

DOCUMENTATION IS PROVIDED AS IS AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.

Use of this document is subject to license terms.