boofcv.abst.feature.tracker

Class PointTrackerToTwoPass<T extends ImageBase>

java.lang.Object

boofcv.abst.feature.tracker.PointTrackerToTwoPass<T>

All Implemented Interfaces:

PointTracker<T>, PointTrackerTwoPass<T>

public class PointTrackerToTwoPass<T extends ImageBase>
extends Object
implements PointTrackerTwoPass<T>

Wrapper class that allows PointTracker to be used as a PointTrackerTwoPass. Since PointTrack does not have all the same capabilities of PointTrackerTwoPass not all operations are supported or behave in exactly the same way. Use of this interface is only appropriate when a two pass tracker is being used as a regular point tracker.

Author:

Peter Abeles

Constructor Summary

Constructors

Constructor and Description
PointTrackerToTwoPass(PointTracker<T> tracker)

Method Summary

Methods

Modifier and Type	Method and Description
void	dropAllTracks() Drops all feature to be dropped and will no longer be tracked.
boolean	dropTrack(PointTrack track) Manually forces a track to be dropped.
void	finishTracking() Finishes tracking and updates the track's description, updates inactive and drop track lists.
List<PointTrack>	getActiveTracks(List<PointTrack> list) Returns a list of active tracks.
List<PointTrack>	getAllTracks(List<PointTrack> list) Returns a list of all features that are currently being tracked
List<PointTrack>	getDroppedTracks(List<PointTrack> list) Returns a list of tracks dropped by the tracker during the most recent update.
List<PointTrack>	getInactiveTracks(List<PointTrack> list) Returns a list of inactive tracks.
List<PointTrack>	getNewTracks(List<PointTrack> list) Returns a list of tracks that have been added since process was called.
void	performSecondPass() Updates spacial information for each track and active list.
void	process(T image) Changes behavior of PointTracker.process(boofcv.struct.image.ImageBase) in that it will only update each track's location, but not its description, and the active list.
void	reset() Discard memory of all current and past tracks.
void	setHint(double pixelX, double pixelY, PointTrack track) Provides a hint for where the
void	spawnTracks() Automatically selects new features in the image to track.

Methods inherited from class java.lang.Object

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

Constructor Detail

PointTrackerToTwoPass

public PointTrackerToTwoPass(PointTracker<T> tracker)

Method Detail

process

public void process(T image)

Description copied from interface: PointTrackerTwoPass

Changes behavior of PointTracker.process(boofcv.struct.image.ImageBase) in that it will only update each track's location, but not its description, and the active list. Call PointTrackerTwoPass.finishTracking() to update the track's description, the inactive list, and the dropped list. An exception is thrown if multiple calls to this function are made without calling PointTrackerTwoPass.finishTracking().

Specified by:

process in interface PointTracker<T extends ImageBase>

Specified by:

process in interface PointTrackerTwoPass<T extends ImageBase>

Parameters:

image - Next image in the sequence

reset

public void reset()

Description copied from interface: PointTracker

Discard memory of all current and past tracks. Growing buffered might not be reset to their initial size by this method.

Specified by:

reset in interface PointTracker<T extends ImageBase>

dropAllTracks

public void dropAllTracks()

Description copied from interface: PointTracker

Drops all feature to be dropped and will no longer be tracked. Tracks dropped using this function will not appear in the dropped list.

Specified by:

dropAllTracks in interface PointTracker<T extends ImageBase>

dropTrack

public boolean dropTrack(PointTrack track)

Description copied from interface: PointTracker

Manually forces a track to be dropped. Tracks dropped using this function will not appear in the dropped list and their data is subject to being immediately recycled. New requests to all and active lists will not include the track after it has been dropped using this function. If request is made to drop a track that is not being tracked (in the internal all list), then the request is ignored.

Specified by:

dropTrack in interface PointTracker<T extends ImageBase>

Parameters:

track - The track which is to be dropped

Returns:

true if the request to drop the track was done or if it was ignored because the track wasn't being tracked

getAllTracks

public List<PointTrack> getAllTracks(List<PointTrack> list)

Description copied from interface: PointTracker

Returns a list of all features that are currently being tracked

Specified by:

getAllTracks in interface PointTracker<T extends ImageBase>

Parameters:

list - Optional storage for the list of tracks. If null a new list will be declared internally.

Returns:

List of tracks.

getActiveTracks

public List<PointTrack> getActiveTracks(List<PointTrack> list)

Description copied from interface: PointTracker

Returns a list of active tracks. An active track is defined as a track which was found in the most recently processed image.

Specified by:

getActiveTracks in interface PointTracker<T extends ImageBase>

Parameters:

list - Optional storage for the list of tracks. If null a new list will be declared internally.

Returns:

List of tracks.

getInactiveTracks

public List<PointTrack> getInactiveTracks(List<PointTrack> list)

Description copied from interface: PointTracker

Returns a list of inactive tracks. A track is inactive if it is not associated with any features in the current image.

Specified by:

getInactiveTracks in interface PointTracker<T extends ImageBase>

Parameters:

list - Optional storage for the list of tracks. If null a new list will be declared internally.

Returns:

List of tracks.

getDroppedTracks

public List<PointTrack> getDroppedTracks(List<PointTrack> list)

Description copied from interface: PointTracker

Returns a list of tracks dropped by the tracker during the most recent update. Tracks dropped by user request are not included in this list.

Specified by:

getDroppedTracks in interface PointTracker<T extends ImageBase>

Parameters:

list - Optional storage for the list of tracks. If null a new list will be declared internally.

Returns:

List of tracks.

getNewTracks

public List<PointTrack> getNewTracks(List<PointTrack> list)

Description copied from interface: PointTracker

Returns a list of tracks that have been added since process was called.

Specified by:

getNewTracks in interface PointTracker<T extends ImageBase>

Parameters:

list - Optional storage for the list of tracks. If null a new list will be declared internally.

Returns:

List of tracks.

spawnTracks

public void spawnTracks()

Description copied from interface: PointTracker

Automatically selects new features in the image to track. Returned tracks must be unique and not duplicates of any existing tracks. This includes both active and inactive tracks. NOTE: This function may or may not also modify the active and inactive lists.

Specified by:

spawnTracks in interface PointTracker<T extends ImageBase>

performSecondPass

public void performSecondPass()

Description copied from interface: PointTrackerTwoPass

Updates spacial information for each track and active list. Does not change the track description or any other lists. Can be called multiple times.

Specified by:

performSecondPass in interface PointTrackerTwoPass<T extends ImageBase>

finishTracking

public void finishTracking()

Description copied from interface: PointTrackerTwoPass

Finishes tracking and updates the track's description, updates inactive and drop track lists.

Specified by:

finishTracking in interface PointTrackerTwoPass<T extends ImageBase>

setHint

public void setHint(double pixelX,
           double pixelY,
           PointTrack track)

Description copied from interface: PointTrackerTwoPass

Provides a hint for where the

Specified by:

setHint in interface PointTrackerTwoPass<T extends ImageBase>

Parameters:

pixelX - x-coordinate hint for where the track is in the image

pixelY - y-coordinate hint for where the track is in the image

track - The track for which the hint is being provided for