org.openimaj.video.processing.timefinder

Class ObjectTimeFinder

java.lang.Object

org.openimaj.video.processing.timefinder.ObjectTimeFinder

public class ObjectTimeFinder
extends Object

This class is a general class for finding the time range in which a specific object is found within a video. Given a seed frame in which the object appears, this class will track forwards and backwards in the video stream to find when the object disappears. It is then able to provide the timecodes at which the object can be found within the video.

Author:

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

Created:

14 Oct 2011

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ObjectTimeFinder.TimeFinderListener<O,I> An interface for objects that wish to be informed of object tracking events during the time finder's execution.

Constructor Summary

Constructors

Constructor and Description
ObjectTimeFinder()

Method Summary

Modifier and Type

Method and Description

<I extends Image<?,I>,O> IndependentPair<VideoTimecode,VideoTimecode>

trackObject(ObjectTracker<O,I> objectTracker, Video<I> video, VideoTimecode keyframeTime, Rectangle bounds, ObjectTimeFinder.TimeFinderListener<O,I> listener) Given a video, a keyframe (timecode) and a region of the image, this method will attempt to track the the contents of the rectangle from the given frame, back and forth to find the place at which the object appears and disappears from the video.

Methods inherited from class java.lang.Object

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

Constructor Detail

ObjectTimeFinder

public ObjectTimeFinder()

Method Detail

trackObject

public <I extends Image<?,I>,O> IndependentPair<VideoTimecode,VideoTimecode> trackObject(ObjectTracker<O,I> objectTracker,
                                                                                         Video<I> video,
                                                                                         VideoTimecode keyframeTime,
                                                                                         Rectangle bounds,
                                                                                         ObjectTimeFinder.TimeFinderListener<O,I> listener)

Given a video, a keyframe (timecode) and a region of the image, this method will attempt to track the the contents of the rectangle from the given frame, back and forth to find the place at which the object appears and disappears from the video.

Type Parameters:

I - The type of image returned from the video

O - The type of object being tracked

Parameters:

objectTracker - The object tracker that will track the object for us

video - The video

keyframeTime - The keyframe timecode to start at

bounds - The bounding box of the object you wish to track

listener - A listener for object tracking events

Returns:

An IndependentPair of timecodes delineating the start and end of the video which contains the object