org.openimaj.video.processing.shotdetector

Class CombiShotDetector

java.lang.Object

org.openimaj.video.Video<T>

org.openimaj.video.processor.VideoProcessor<I>

org.openimaj.video.processing.shotdetector.VideoShotDetector<MBFImage>

org.openimaj.video.processing.shotdetector.CombiShotDetector

All Implemented Interfaces:

Closeable, AutoCloseable, Iterable<MBFImage>, VideoDisplayListener<MBFImage>

public class CombiShotDetector
extends VideoShotDetector<MBFImage>

A shot detector that uses evidence from a number of shot detectors to determine if a shot has been detected.

It runs the shot detection for each detector that is registered with the class and if it determines that a shot boundary occurred the score is increased by the weighting value for that detector. The final score is divided by the number of detectors to get a probability value for the frame being a shot boundary. By default the threshold is set to 0.75 - that is, there must be a 3/4 correlation of shot boundary for it to be considered a shot boundary.

Version:

$Author$, $Revision$, $Date$

Author:

David Dupplaw (dpd@ecs.soton.ac.uk)

Created:

28 Jan 2013

Field Summary

Fields inherited from class org.openimaj.video.processing.shotdetector.VideoShotDetector

lastFrameWasBoundary, threshold

Constructor Summary

Constructors

Constructor and Description
CombiShotDetector() If you use this constructor, your timecodes will be messed up unless you call VideoShotDetector.setFPS(double) before you process any frames.
CombiShotDetector(Video<MBFImage> video) Default constructor that takes the video to be processed

Method Summary

Modifier and Type	Method and Description
void	addVideoShotDetector(VideoShotDetector<MBFImage> detector, double weight) Add a shot detector that will be used in the evidence gathering.
protected double	getInterframeDistance(MBFImage thisFrame) Returns the inter-frame distance between this frame and the last.

Methods inherited from class org.openimaj.video.processing.shotdetector.VideoShotDetector

addShotDetectedListener, afterUpdate, beforeUpdate, fireDifferentialCalculated, fireShotDetected, getDifferentials, getLastKeyframe, getLastShotBoundary, getShotBoundaries, getThreshold, process, processFrame, removeShotDetectedListener, reset, setFindKeyframes, setFPS, setStoreAllDifferentials, setThreshold, wasLastFrameBoundary

Methods inherited from class org.openimaj.video.processor.VideoProcessor

countFrames, getCurrentFrame, getFPS, getHeight, getNextFrame, getTimeStamp, getWidth, hasNextFrame, process, processingComplete

Methods inherited from class org.openimaj.video.Video

close, getCurrentFrameIndex, iterator, seek, setCurrentFrameIndex

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

CombiShotDetector

public CombiShotDetector()

If you use this constructor, your timecodes will be messed up unless you call VideoShotDetector.setFPS(double) before you process any frames.

CombiShotDetector

public CombiShotDetector(Video<MBFImage> video)

Default constructor that takes the video to be processed

Parameters:

video - The video

Method Detail

addVideoShotDetector

public void addVideoShotDetector(VideoShotDetector<MBFImage> detector,
                                 double weight)

Add a shot detector that will be used in the evidence gathering.

Parameters:

detector - The detector

weight - The weight to use for this detector

getInterframeDistance

protected double getInterframeDistance(MBFImage thisFrame)

Returns the inter-frame distance between this frame and the last.

Specified by:

getInterframeDistance in class VideoShotDetector<MBFImage>

Returns:

The inter-frame distance

See Also:

VideoShotDetector.getInterframeDistance(org.openimaj.image.Image)