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

Methods

Modifier and Type	Method and Description
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

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

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