org.davic.media
Interface FreezeControl

All Superinterfaces:
Control

public interface FreezeControl
extends Control

This interface should be implemented to enable the application to freeze the player. The method getControl and getControls return an object implementing this interface if it is supported.


Method Summary
 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 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

public void freeze()
            throws MediaFreezeException
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:
MediaFreezeException - if the freeze is unsuccessful

resume

public void resume()
            throws MediaFreezeException
Invocation of this method resumes the decoding of the media stream following a freeze operation. This should be a very low latency operation. If the player is started and if decoding of the media stream is not frozen then calls to this method shall have no effect. If the player is not started then the exception shall be thrown.

Throws:
MediaFreezeException - if the resume is unsuccessful