- All Known Implementing Classes:
High level interface for an object tracker where the object being tracked is specified using a quadrilateral. The input is assumed to be a sequence of consecutive video images. When initialize is called the tracker is put into its initial state ago and its past history is discarded. The vertices in the quadrilateral are specified in a clock-wise direction (a,b,c,d).
The motion/distortion model used by the trackers will vary. Typical models are (scale,translation), (scale,translation,rotation), and affine. For maximum abstraction, access to the underlying model is not provided through this interface. To access that model invoke the lower level algorithm directly.
Method SummaryModifier and TypeMethodDescriptionReturns information on the type of image that it can process.
<T> TProvides access to the inner low level tracker.
voidProvide a hint for where the tracked object is.
booleanInitializes tracking by specifying the object's location using a quadrilateral.
booleanUpdates the tracks location using the latest video frame.
initializeInitializes tracking by specifying the object's location using a quadrilateral. Some implementations can fail if there is insufficient visual information for it to track. All previous tracking information is discarded when this function is called.
image- Initial image in the sequence
location- Initial location of the object being tracked
- true if successful and false if not.
(Quadrilateral_F64 hint)Provide a hint for where the tracked object is. How and if this hint is used at all is implementation specific. This can be used add information from sensors such as gyros to the tracker. If this functionality isn't supported by the tracker then it will simply ignore the suggestion. It probably knows what's happening than you do.
hint- (Input) estimated location of the object.
processUpdates the tracks location using the latest video frame.
initialize(boofcv.struct.image.ImageBase, Quadrilateral_F64)must be called once before this function can be called.
image- (Input) The next image in the video sequence.
results- (Output) Storage for new location if tracking is successful.
- true if the target was found and 'location' updated.
getImageTypeReturns information on the type of image that it can process.
- Image type
getLowLevelTracker<T> T getLowLevelTracker()Provides access to the inner low level tracker. You need to be familiar with the tracker's source code to make sure of this function. Returns null if implementing it doesn't make sense.
- Tracking algorithm.