javax.media.control
Interface FrameGrabbingControl

All Superinterfaces:

Control

public interface FrameGrabbingControl

extends Control

The FrameGrabbingControl is the interface to grab a still video frame from the video stream. This control can be exported by a Renderer or a Player via the getControl method.

The frame returned is in raw decoded format. The ImageConverter class can be used to convert it into Java image format.

Since:

JMF 2.0

Method Summary

Buffer

grabFrame() Grab the current frame from the video stream.

Methods inherited from interface javax.media.Control

getControlComponent

Method Detail

grabFrame

public Buffer grabFrame()

Grab the current frame from the video stream.

If the Player or Renderer is in the Started state, the exact frame returned is not well-defined.

The frame returned is in raw decoded format. The ImageConverter class can be used to convert it into Java image format.

Returns:

a copy of the current frame; null if the operation fails for any reason.