/// <summary>
/// Track the point in the current image, or use the existing data if already known.
/// </summary>
/// <param name="context"></param>
public void Track(TrackingContext context)
{
this.context = context;
if (!isTracking)
{
return;
}
TrackFrame closestFrame = trackTimeline.ClosestFrom(context.Time);
if (closestFrame == null)
{
currentValue = nonTrackingValue;
trackTimeline.Insert(context.Time, CreateTrackFrame(currentValue, PositionningSource.Manual));
return;
}
if (closestFrame.Template == null)
{
// We may not have the template if the timeline was imported from KVA.
trackTimeline.Insert(context.Time, CreateTrackFrame(closestFrame.Location, closestFrame.PositionningSource));
currentValue = closestFrame.Location;
return;
}
if (closestFrame.Time == context.Time)
{
currentValue = closestFrame.Location;
return;
}
TrackResult result = Tracker.Track(trackerParameters.SearchWindow, closestFrame, context.Image);
if (result.Similarity >= trackerParameters.SimilarityThreshold)
{
currentValue = result.Location;
if (result.Similarity > trackerParameters.TemplateUpdateThreshold)
{
Bitmap template = closestFrame.Template.CloneDeep();
TrackFrame newFrame = new TrackFrame(context.Time, result.Location, template, PositionningSource.TemplateMatching);
trackTimeline.Insert(context.Time, newFrame);
}
else
{
trackTimeline.Insert(context.Time, CreateTrackFrame(result.Location, PositionningSource.TemplateMatching));
}
}
else
{
currentValue = closestFrame.Location;
}
}
/// <summary>
/// Track the point in the current image, or use the existing data if already known.
/// We do this even if the drawing is currently not tracking, to push the existing tracked data in the object.
/// Important: for drawings containing multiple trackable points, either all or none of them should have a new value.
/// If some of them successfully track and some other don't, the one that didn't must insert the closest frame value.
/// This way we ensure the timelines are always of the same length.
/// </summary>
/// <param name="context"></param>
public bool Track(TrackingContext context)
{
bool inserted = false;
this.context = context;
if (!trackTimeline.HasData())
{
// Not a single entry in the timeline.
// This drawing has never been activated for tracking so far.
currentValue = nonTrackingValue;
timeDifference = -1;
if (isTracking)
{
// Use the current user-set position as a first tracked point.
trackTimeline.Insert(context.Time, CreateTrackFrame(currentValue, PositionningSource.Manual));
timeDifference = 0;
}
return(isTracking);
}
TrackFrame closestFrame = trackTimeline.ClosestFrom(context.Time);
if (closestFrame.Template == null)
{
// This point has entries in the timeline but doesn't have the corresponding image pattern.
// This happen when the timeline is imported from a KVA.
currentValue = closestFrame.Location;
timeDifference = Math.Abs(context.Time - closestFrame.Time);
if (isTracking)
{
// Make sure we extract the pattern and update the entry at this time.
// Note: the position we are using could come from a different time.
// But since we are actively tracking we need to end up adding an entry at this time.
// But since we don't have any specific template to look for, we will just create an entry at the same location.
// If we are on the right time, perfect. If not, it will use the location from the closest and comit it to this time.
// When the user switched tracking ON for this drawing, they saw where the point was.
// If they moved it manually before changing frame, it will be handled in SetUserValue.
// If not, it means they are content with the position it has and thus this insertion is correct.
PositionningSource source = timeDifference == 0 ? closestFrame.PositionningSource : PositionningSource.ForcedClosest;
trackTimeline.Insert(context.Time, CreateTrackFrame(closestFrame.Location, source));
timeDifference = 0;
}
return(isTracking);
}
if (closestFrame.Time == context.Time)
{
// We found an entry at the exact time requested.
currentValue = closestFrame.Location;
timeDifference = 0;
return(false);
}
if (!isTracking)
{
// We did not find the exact requested time in the timeline, and we are not currently tracking.
currentValue = closestFrame.Location;
timeDifference = Math.Abs(context.Time - closestFrame.Time);
return(false);
}
// We did not find the exact requested time in the timeline, but tracking is active so let's look for the pattern.
TrackResult result = Tracker.Track(trackerParameters.SearchWindow, closestFrame, context.Image);
if (result.Similarity >= trackerParameters.SimilarityThreshold)
{
currentValue = result.Location;
timeDifference = 0;
if (result.Similarity > trackerParameters.TemplateUpdateThreshold)
{
Bitmap template = BitmapHelper.Copy(closestFrame.Template);
TrackFrame newFrame = new TrackFrame(context.Time, result.Location, template, PositionningSource.TemplateMatching);
trackTimeline.Insert(context.Time, newFrame);
}
else
{
trackTimeline.Insert(context.Time, CreateTrackFrame(result.Location, PositionningSource.TemplateMatching));
}
inserted = true;
}
else
{
// Tracking failure.
currentValue = closestFrame.Location;
timeDifference = Math.Abs(context.Time - closestFrame.Time);
inserted = false;
}
return(inserted);
}