boofcv.abst.feature.tracker

Class PointTrackerCombined<I extends boofcv.struct.image.ImageSingleBand,D extends boofcv.struct.image.ImageSingleBand,Desc extends boofcv.struct.feature.TupleDesc>

java.lang.Object

boofcv.abst.feature.tracker.PointTrackerCombined<I,D,Desc>

All Implemented Interfaces:

PointTracker<I>

Direct Known Subclasses:

PointTrackerTwoPassCombined

public class PointTrackerCombined<I extends boofcv.struct.image.ImageSingleBand,D extends boofcv.struct.image.ImageSingleBand,Desc extends boofcv.struct.feature.TupleDesc>
extends java.lang.Object
implements PointTracker<I>

Wrapper around CombinedTrackerScalePoint for PointTracker. Features are respawned when the number of active tracks drops below a threshold automatically. This threshold is realtive to the number of tracks spawned previously and is adjusted when the user requests that tracks are dropped.

Constructor Summary

Constructors

Constructor and Description
PointTrackerCombined(boofcv.alg.tracker.combined.CombinedTrackerScalePoint<I,D,Desc> tracker, int reactivateThreshold, java.lang.Class<I> imageType, java.lang.Class<D> derivType)

Method Summary

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.
java.util.List<PointTrack>	getActiveTracks(java.util.List<PointTrack> list) Returns a list of active tracks.
java.util.List<PointTrack>	getAllTracks(java.util.List<PointTrack> list) Returns a list of all features that are currently being tracked
java.util.List<PointTrack>	getDroppedTracks(java.util.List<PointTrack> list) Returns a list of tracks dropped by the tracker during the most recent update.
java.util.List<PointTrack>	getInactiveTracks(java.util.List<PointTrack> list) Returns a list of inactive tracks.
java.util.List<PointTrack>	getNewTracks(java.util.List<PointTrack> list) Returns a list of tracks that have been added since process was called.
void	process(I image) Process input image and perform tracking.
void	reset() Discard memory of all current and past tracks.
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

PointTrackerCombined

public PointTrackerCombined(boofcv.alg.tracker.combined.CombinedTrackerScalePoint<I,D,Desc> tracker,
                            int reactivateThreshold,
                            java.lang.Class<I> imageType,
                            java.lang.Class<D> derivType)

Method Detail

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<I extends boofcv.struct.image.ImageSingleBand>

process

public void process(I image)

Description copied from interface: PointTracker

Process input image and perform tracking.

Specified by:

process in interface PointTracker<I extends boofcv.struct.image.ImageSingleBand>

Parameters:

image - Next image in the sequence

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<I extends boofcv.struct.image.ImageSingleBand>

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<I extends boofcv.struct.image.ImageSingleBand>

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<I extends boofcv.struct.image.ImageSingleBand>

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 java.util.List<PointTrack> getAllTracks(java.util.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<I extends boofcv.struct.image.ImageSingleBand>

Parameters:

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

Returns:

List of tracks.

getActiveTracks

public java.util.List<PointTrack> getActiveTracks(java.util.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<I extends boofcv.struct.image.ImageSingleBand>

Parameters:

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

Returns:

List of tracks.

getInactiveTracks

public java.util.List<PointTrack> getInactiveTracks(java.util.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<I extends boofcv.struct.image.ImageSingleBand>

Parameters:

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

Returns:

List of tracks.

getDroppedTracks

public java.util.List<PointTrack> getDroppedTracks(java.util.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<I extends boofcv.struct.image.ImageSingleBand>

Parameters:

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

Returns:

List of tracks.

getNewTracks

public java.util.List<PointTrack> getNewTracks(java.util.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<I extends boofcv.struct.image.ImageSingleBand>

Parameters:

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

Returns:

List of tracks.