Package org.opensourcephysics.cabrillo.tracker

Class PerspectiveTrack

java.lang.Object

org.opensourcephysics.display.OSPRuntime.Supported

org.opensourcephysics.cabrillo.tracker.TTrack

org.opensourcephysics.cabrillo.tracker.PerspectiveTrack

All Implemented Interfaces:

PropertyChangeListener, EventListener, Drawable, Interactive, Measurable, Trackable

public class PerspectiveTrack
extends TTrack

This is a track used for autotracking perspective filter corners.

Author:

Douglas Brown

Nested Class Summary

Nested classes/interfaces inherited from class org.opensourcephysics.cabrillo.tracker.TTrack

TTrack.NameDialog, TTrack.StepArray, TTrack.TextLineLabel, TTrack.TrackDecimalField, TTrack.TrackNumberField

Field Summary

Fields inherited from class org.opensourcephysics.cabrillo.tracker.TTrack

angleField, angleLabel, angleSeparator, attachmentNames, attachments, autoAdvance, autoAdvanceItem, autoTrackerMarking, circleFootprintListener, clearStepsItem, closeButton, colorItem, constantsLoadedFromXML, customNumberFormats, dataBuilderItem, dataDescriptions, dataFrames, dataProp, datasetManager, dataValid, defaultColors, defaultFootprint, deleteStepItem, deleteTrackItem, description, descriptionItem, enabled, fieldBorder, fixedItem, footprint, footprintListener, footprintMenu, footprints, formatAngleMouseListener, formatMouseListener, hint, HINT_STEP_ADDED_OR_REMOVED, HINT_STEPS_SELECTED, initialized, isMarking, keyFrames, labelFont, locked, lockedItem, magField, magLabel, magSeparator, markByDefault, markByDefaultItem, name, nameDialog, nameItem, nextID, NOMAP, NOMAPS, NOVARA, NOVARS, numberFields, partName, points, positionFields, preferredColumnOrder, properties, PROPERTY_TTRACK_COLOR, PROPERTY_TTRACK_DATA, PROPERTY_TTRACK_FOOTPRINT, PROPERTY_TTRACK_FORMAT, PROPERTY_TTRACK_LOCKED, PROPERTY_TTRACK_MASS, PROPERTY_TTRACK_MODELEND, PROPERTY_TTRACK_MODELSTART, PROPERTY_TTRACK_NAME, PROPERTY_TTRACK_STEP, PROPERTY_TTRACK_STEPS, PROPERTY_TTRACK_TEXTCOLUMN, PROPERTY_TTRACK_VISIBLE, refreshDataLater, skippedStepWarningCheckbox, skippedStepWarningDialog, skippedStepWarningOn, skippedStepWarningTextpane, stepLabel, steps, stepSeparator, stepSizeWhenFirstMarked, stepValueLabel, targetIndex, textColumnEntries, textColumnNames, tField, tframe, tLabel, toolbarPointComponents, toolbarTrackComponents, tp, trailLength, trailVisible, trailVisibleItem, tSeparator, ttype, tValueLabel, TYPE_CALIBRATION, TYPE_CIRCLEFITTER, TYPE_COORDAXES, TYPE_LINEPROFILE, TYPE_OFFSETORIGIN, TYPE_PERSPECTIVE, TYPE_POINTMASS, TYPE_PROTRACTOR, TYPE_RGBREGION, TYPE_TAPEMEASURE, TYPE_UNKNOWN, TYPE_VECTOR, viewable, visible, visibleItem, xField, xLabel, xSeparator, xSpinner, yField, yLabel, ySeparator, ySpinner

Fields inherited from interface org.opensourcephysics.media.core.Trackable

PROPERTY_ADJUSTING

Constructor Summary

Constructors

Constructor	Description
PerspectiveTrack(PerspectiveFilter filter)	Constructor requires a PerspectiveFilter to control.

Method Summary

Modifier and Type	Method	Description
TPoint	autoMarkAt(int n, double x, double y)	Used by autoTracker to mark a step at a match target position.
Step	createStep(int n, double x, double y)	Creates a new step.
Step	deleteStep(int n)	Deletes a step.
void	dispose()	Disposes of resources when this track is deleted or cleared.
void	draw(DrawingPanel panel, Graphics _g)	Draws the steps on the tracker panel.
Interactive	findInteractive(DrawingPanel panel, int xpix, int ypix)	Finds the interactive drawable object located at the specified pixel position.
String	getBaseType()
int	getFootprintLength()	Gets the length of the footprints required by this track.
Map<String,String>	getFormatDescMap()
Map<String,String[]>	getFormatMap()
String[]	getFormatVariables()
TPoint	getMarkedPoint(int n, int index)	Used by autoTracker to get the marked point for a given frame and index.
JMenu	getMenu(TrackerPanel trackerPanel, JMenu menu)	Prepares menu items and returns a new menu.
String	getMessage()	Gets a message about this track to display in a message box.
Step	getStep(TPoint p, TrackerPanel trackerPanel)	Gets the step associated with a TPoint.
int	getStepLength()	Gets the length of the steps created by this track.
protected String	getTargetDescription(int pointIndex)	Returns a description of a target point with a given index.
String	getVarDimsImpl(String variable)
protected boolean	isAutoTrackable()	Determines if at least one point in this track is autotrackable.
protected boolean	isAutoTrackable(int pointIndex)	Determines if the given point index is autotrackable.
void	propertyChange(PropertyChangeEvent e)	Responds to property change events.
void	remark(Integer panelID)	Remarks all steps on the specified panel.
protected void	setTargetIndex(TPoint p)	Sets the target index for the autotracker.
void	setTrackerPanel(TrackerPanel panel)	Adds events for TrackerPanel.

Methods inherited from class org.opensourcephysics.cabrillo.tracker.TTrack

addFixedItem, addFootprint, addListener, addListenerNCF, addPanelEvents, addStepListener, addTextColumn, assembleMenu, clearColumns, convertTextToDataColumn, createAllVariables, createWarningDialog, delete, delete, erase, erase, finalize, fireStepsChanged, getAllVariables, getAttachmentDescription, getAttachmentLength, getAttachments, getBaseTrackName, getBaseTypeInt, getColor, getCustomFormatPatterns, getData, getData, getDataDescription, getDataName, getDefaultFormatPatterns, getDefaultFormatPatterns, getDescription, getFootprint, getFootprint, getFootprintName, getFootprints, getFootprints, getFormatPatterns, getFrameForData, getIcon, getID, getLoader, getMarkingCursor, getMenuItems, getName, getName, getNameDialog, getNextVisibleStep, getNumberFields, getNumberFieldsForStep, getPlotViews, getPreferredDataOrder, getPreviousVisibleStep, getProperty, getPropertyNames, getSkippedStepWarningDialog, getStep, getSteps, getStepSizeWarningDialog, getTableViews, getTargetIndex, getTextColumnEntry, getTextColumnNames, getToolbarPointComponents, getToolbarTrackComponents, getTrack, getTrailLength, getValues, getVarFormatPattern, getVariableDimensions, getVariablesFromFormatterDisplayName, getX, getXMax, getXMin, getY, getYMax, getYMin, initialize, invalidateData, isAttached, isAutoAdvance, isDataValid, isDependent, isEmpty, isEnabled, isFullyAttached, isLocked, isMarkByDefault, isMarking, isMeasured, isStepComplete, isStepVisible, isTrailVisible, isViewable, isVisible, loadAttachmentsFromNames, refreshAttachments, refreshAttachmentsLater, refreshData, refreshData, refreshDecimalSeparators, remark, removeActiveTrack, removeDeleteTrackItem, removeListener, removeListenerNCF, removePanelEvents, removeStepListener, removeTextColumn, renameTextColumn, repaint, repaint, repaintAll, repaintStep, restorePatterns, savePatterns, setActive, setAnglesInRadians, setAutoAdvance, setColor, setColorToDefault, setDefaultNameAndColor, setDescription, setEnabled, setFixedPosition, setFontLevel, setFootprint, setFootprint, setFootprints, setFootprints, setFormatPattern, setInitialFormatPatterns, setLocked, setMarkByDefault, setMarking, setName, setProperty, setTargetIndex, setTargetIndex, setTextColumnEntry, setTrailLength, setTrailVisible, setViewable, setVisible, setX, setXY, setY, showAnglePopup, showFormatPopup, toString, updateListenerVisible

Methods inherited from class org.opensourcephysics.display.OSPRuntime.Supported

addListeners, addPropertyChangeListener, addPropertyChangeListener, addPropertyChangeListenerSafely, dispose, firePropertyChange, firePropertyChange, removeListeners, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opensourcephysics.display.Interactive

isInteractive

Constructor Details

PerspectiveTrack

public PerspectiveTrack(PerspectiveFilter filter)

Constructor requires a PerspectiveFilter to control.

Parameters:

filter - the filter

Method Details

dispose

public void dispose()

Description copied from class: TTrack

Disposes of resources when this track is deleted or cleared.

Overrides:

dispose in class TTrack

setTrackerPanel

public void setTrackerPanel(TrackerPanel panel)

Adds events for TrackerPanel.

Overrides:

setTrackerPanel in class TTrack

Parameters:

panel - the new TrackerPanel

propertyChange

public void propertyChange(PropertyChangeEvent e)

Responds to property change events.

Specified by:

propertyChange in interface PropertyChangeListener

Overrides:

propertyChange in class TTrack

Parameters:

e - the property change event

findInteractive

public Interactive findInteractive(DrawingPanel panel,
 int xpix,
 int ypix)

Finds the interactive drawable object located at the specified pixel position.

Specified by:

findInteractive in interface Interactive

Overrides:

findInteractive in class TTrack

Parameters:

panel - the drawing panel

xpix - the x pixel position on the panel

ypix - the y pixel position on the panel

Returns:

the first step TPoint that is hit

getMenu

public JMenu getMenu(TrackerPanel trackerPanel,
 JMenu menu)

Prepares menu items and returns a new menu. Subclasses should override this method and add track-specific menu items.

Overrides:

getMenu in class TTrack

Parameters:

trackerPanel - the tracker panel

menu - the menu. If null, a dynamic menu is returned that adds items only when selected

Returns:

a menu

getMessage

public String getMessage()

Gets a message about this track to display in a message box.

Overrides:

getMessage in class TTrack

Returns:

the message

getStep

public Step getStep(TPoint p,
 TrackerPanel trackerPanel)

Gets the step associated with a TPoint.

Overrides:

getStep in class TTrack

Parameters:

p - a TPoint

trackerPanel - the tracker panel holding the TPoint

Returns:

the step associated with the TPoint

deleteStep

public Step deleteStep(int n)

Deletes a step. This removes the perspective filter key frame data.

Overrides:

deleteStep in class TTrack

Parameters:

n - the frame number

Returns:

the deleted step

autoMarkAt

public TPoint autoMarkAt(int n,
 double x,
 double y)

Used by autoTracker to mark a step at a match target position.

Overrides:

autoMarkAt in class TTrack

Parameters:

n - the frame number

x - the x target coordinate in image space

y - the y target coordinate in image space

Returns:

the TPoint that was automarked

getMarkedPoint

public TPoint getMarkedPoint(int n,
 int index)

Used by autoTracker to get the marked point for a given frame and index.

Overrides:

getMarkedPoint in class TTrack

Parameters:

n - the frame number

index - the index

Returns:

the step TPoint at the index

setTargetIndex

protected void setTargetIndex(TPoint p)

Sets the target index for the autotracker.

Overrides:

setTargetIndex in class TTrack

Parameters:

p - a TPoint associated with this track

getTargetDescription

protected String getTargetDescription(int pointIndex)

Returns a description of a target point with a given index.

Overrides:

getTargetDescription in class TTrack

Parameters:

pointIndex - the index

Returns:

the description

isAutoTrackable

protected boolean isAutoTrackable(int pointIndex)

Determines if the given point index is autotrackable.

Overrides:

isAutoTrackable in class TTrack

Parameters:

pointIndex - the points[] index

Returns:

true if autotrackable

isAutoTrackable

protected boolean isAutoTrackable()

Determines if at least one point in this track is autotrackable.

Overrides:

isAutoTrackable in class TTrack

Returns:

true if autotrackable

draw

public void draw(DrawingPanel panel,
 Graphics _g)

Description copied from class: TTrack

Draws the steps on the tracker panel.

Specified by:

draw in interface Drawable

Overrides:

draw in class TTrack

Parameters:

panel - the drawing panel requesting the drawing

_g - the graphics context on which to draw

getStepLength

public int getStepLength()

Description copied from class: TTrack

Gets the length of the steps created by this track.

Specified by:

getStepLength in class TTrack

Returns:

the footprint length

getFootprintLength

public int getFootprintLength()

Description copied from class: TTrack

Gets the length of the footprints required by this track.

Specified by:

getFootprintLength in class TTrack

Returns:

the footprint length

createStep

public Step createStep(int n,
 double x,
 double y)

Description copied from class: TTrack

Creates a new step.

Specified by:

createStep in class TTrack

Parameters:

n - the frame number

x - the x coordinate in image space

y - the y coordinate in image space

Returns:

the new step

remark

public void remark(Integer panelID)

Description copied from class: TTrack

Remarks all steps on the specified panel.

Overrides:

remark in class TTrack

getFormatMap

public Map<String,String[]> getFormatMap()

Specified by:

getFormatMap in class TTrack

getFormatDescMap

public Map<String,String> getFormatDescMap()

Specified by:

getFormatDescMap in class TTrack

getFormatVariables

public String[] getFormatVariables()

Specified by:

getFormatVariables in class TTrack

getVarDimsImpl

public String getVarDimsImpl(String variable)

Specified by:

getVarDimsImpl in class TTrack

getBaseType

public String getBaseType()

Specified by:

getBaseType in class TTrack