au.edu.jcu.v4l4j

Interface CaptureCallback

public interface CaptureCallback

Objects implementing this interface receive notifications from frame grabbers when new captured frames become available, or an exception occurs during a capture. In order to capture from a video device, you must instantiate an object which implements this interface and pass it to a frame grabber (via @link FrameGrabber.setCaptureCallback(CaptureCallback)). When you start the capture, v4l4j will call nextFrame(VideoFrame) to deliver new frames to your application as soon as they arrive. Check the FrameGrabber page for more information.

Author:

gilles

Method Summary

Modifier and Type	Method and Description
void	exceptionReceived(V4L4JException e) This method is called if an error occurs during capture.
void	nextFrame(VideoFrame frame) During a capture, this method is called by v4l4j to provide the latest video frame.

Method Detail

nextFrame

void nextFrame(VideoFrame frame)

During a capture, this method is called by v4l4j to provide the latest video frame. It is important that you minimise the amount of code and processing done in this method in order to maintain the appropriate frame rate.
Make sure the frame is recycled when no longer used. It does not have to be done in this method, but it must be done at some point in the near future.

Parameters:

frame - the latest captured frame

exceptionReceived

void exceptionReceived(V4L4JException e)

This method is called if an error occurs during capture. It is safe to assume that if this method is called, no more calls to nextFrame(VideoFrame) will follow.

Parameters:

e - the exception that was raised during the capture.