Package cnuphys.splot.plot

Class PlotCanvas

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

cnuphys.splot.plot.PlotCanvas

All Implemented Interfaces:

DataChangeListener, IRubberbanded, IToolBarListener, MouseListener, MouseMotionListener, ImageObserver, MenuContainer, Serializable, EventListener, TableModelListener

public class PlotCanvas
extends JComponent
implements MouseListener, MouseMotionListener, IRubberbanded, IToolBarListener, TableModelListener, DataChangeListener

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field	Description
protected DataSet	_dataSet
protected AffineTransform	_localToWorld
protected PlotParameters	_parameters
protected AffineTransform	_worldToLocal
static final String	DATACLEAREDPROP
static final String	DONEDRAWINGPROP
static final String	TITLECHANGEPROP
static final String	XLABELCHANGEPROP
static final String	YLABELCHANGEPROP

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
PlotCanvas(DataSet dataSet, String plotTitle, String xLabel, String yLabel)	Create a plot canvas for plotting a dataset

Method Summary

Modifier and Type	Method	Description
void	buttonPressed(CommonToolBar toolbar, ToolBarButton button)
void	dataSetChanged(DataSet dataSet)	A data set changed
void	doButtonAction(String command)
void	doneRubberbanding()	This just signals that we are done rubber banding.
Rectangle	getActiveBounds()	Get the active plot area
DataSet	getDataSet()	Get the underlying dataset
Gradient	getGradient()	Get the canvas's color gradient
String	getLocationString()	Get the last updated location string
PlotParameters	getParameters()	Get the plot parameters
PlotTicks	getPlotTicks()	Get the canavas's plot ticks
File	getSavePngFile()
String	getTitle()	Get the plot title
DataSetType	getType()	Get the DataSet type
Rectangle2D.Double	getWorld()	Get the world boundary
void	localToWorld(Point pp, Point2D.Double wp)	This converts a screen or pixel point to a world point.
void	localToWorld(Rectangle pr, Rectangle2D.Double wr)	This converts a screen or pixel rectangle to a world rectangle.
void	mouseClicked(MouseEvent e)	The mouse has been clicked on the plot canvas
void	mouseDragged(MouseEvent e)	The mouse has been dragged over the plot canvas
void	mouseEntered(MouseEvent e)	The mouse has entered the area of the plot canvas
void	mouseExited(MouseEvent e)	The mouse has exited the area of the plot canvas
void	mouseMoved(MouseEvent e)	The mouse has moved over the plot canvas
void	mousePressed(MouseEvent e)	The mouse has been pressed on plot canvas
void	mouseReleased(MouseEvent e)	The mouse has been released on plot canvas.
void	needsRedraw(boolean rescale)	Data is being added, possibly very quickly, so lets schedule a redraw
void	paintComponent(Graphics g)	Paint the canvas
void	print()	Print
void	recenterAtClick(Point pp)	Center the plot world at the click.
void	remoteFirePropertyChange(String propName, Object oldValue, Object newValue)	Used so another object can tell the plot canvas to fire a propert change event
void	scale(double amount)	Scale the canvas by a given amount
protected void	setAffineTransforms()
void	setDataSet(DataSet ds)	Set a new data set for the canvas
void	setParent(Component parent)	Set the parent component, probably a PlotPanel
void	setSelectedToggle(String s)	Set which toggle button is selected
void	setWorldSystem()	Set the world system based on the dataset This is where the plot limits are set.
void	showDataEditor()	Show the data editor
void	showPreferencesEditor()	Show the plot preferences dialog
void	tableChanged(TableModelEvent e)
void	takePicture()	Take a picture, sanve as png
void	toggleButtonActivated(CommonToolBar toolbar, ToolBarToggleButton button)
void	worldToLocal(Point pp, Point2D.Double wp)	This converts a world point to a screen or pixel point.
void	worldToLocal(Rectangle r, Rectangle2D.Double wr)

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUI, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Details

DONEDRAWINGPROP

public static final String DONEDRAWINGPROP

See Also:

• Constant Field Values

TITLECHANGEPROP

public static final String TITLECHANGEPROP

See Also:

• Constant Field Values

XLABELCHANGEPROP

public static final String XLABELCHANGEPROP

See Also:

• Constant Field Values

YLABELCHANGEPROP

public static final String YLABELCHANGEPROP

See Also:

• Constant Field Values

DATACLEAREDPROP

public static final String DATACLEAREDPROP

See Also:

• Constant Field Values

_localToWorld

protected AffineTransform _localToWorld

_worldToLocal

protected AffineTransform _worldToLocal

_dataSet

protected DataSet _dataSet

_parameters

protected PlotParameters _parameters

Constructor Details

PlotCanvas

public PlotCanvas(DataSet dataSet,
 String plotTitle,
 String xLabel,
 String yLabel)

Create a plot canvas for plotting a dataset

Parameters:

dataSet - the dataset to plot. It might contain many curves

plotTitle - the plot title

xLabel - the x axis label

yLabel - the y axis label

Method Details

getType

public DataSetType getType()

Get the DataSet type

Returns:

the data set type

getTitle

public String getTitle()

Get the plot title

Returns:

the plot title

getParameters

public PlotParameters getParameters()

Get the plot parameters

Returns:

the plot parameters

setParent

public void setParent(Component parent)

Set the parent component, probably a PlotPanel

Parameters:

parent - the optional parent component

setDataSet

public void setDataSet(DataSet ds)

Set a new data set for the canvas

Parameters:

ds - the new dataset

getDataSet

public DataSet getDataSet()

Get the underlying dataset

Returns:

the underlying dataset

getWorld

public Rectangle2D.Double getWorld()

Get the world boundary

Returns:

the world boundary

setWorldSystem

public void setWorldSystem()

Set the world system based on the dataset This is where the plot limits are set.

paintComponent

public void paintComponent(Graphics g)

Paint the canvas

Overrides:

paintComponent in class JComponent

Parameters:

g - the graphics context

needsRedraw

public void needsRedraw(boolean rescale)

Data is being added, possibly very quickly, so lets schedule a redraw

Parameters:

rescale - if true the world system will also be rescaled

getActiveBounds

public Rectangle getActiveBounds()

Get the active plot area

Returns:

the active plot area

setAffineTransforms

protected void setAffineTransforms()

mouseDragged

public void mouseDragged(MouseEvent e)

The mouse has been dragged over the plot canvas

Specified by:

mouseDragged in interface MouseMotionListener

Parameters:

e - the mouseEvent

mouseMoved

public void mouseMoved(MouseEvent e)

The mouse has moved over the plot canvas

Specified by:

mouseMoved in interface MouseMotionListener

Parameters:

e - the mouseEvent

getLocationString

public String getLocationString()

Get the last updated location string

Returns:

mouseClicked

public void mouseClicked(MouseEvent e)

The mouse has been clicked on the plot canvas

Specified by:

mouseClicked in interface MouseListener

Parameters:

e - the mouseEvent

mousePressed

public void mousePressed(MouseEvent e)

The mouse has been pressed on plot canvas

Specified by:

mousePressed in interface MouseListener

Parameters:

e - the mouseEvent

mouseReleased

public void mouseReleased(MouseEvent e)

The mouse has been released on plot canvas. A release comes before the click

Specified by:

mouseReleased in interface MouseListener

Parameters:

e - the mouseEvent

mouseEntered

public void mouseEntered(MouseEvent e)

The mouse has entered the area of the plot canvas

Specified by:

mouseEntered in interface MouseListener

Parameters:

e - the mouseEvent

mouseExited

public void mouseExited(MouseEvent e)

The mouse has exited the area of the plot canvas

Specified by:

mouseExited in interface MouseListener

Parameters:

e - the mouseEvent

localToWorld

public void localToWorld(Point pp,
 Point2D.Double wp)

This converts a screen or pixel point to a world point.

Parameters:

pp - contains the local (screen-pixel) point.

wp - will hold the resultant world point.

localToWorld

public void localToWorld(Rectangle pr,
 Rectangle2D.Double wr)

This converts a screen or pixel rectangle to a world rectangle.

Parameters:

pr - contains the local (screen-pixel) rectangle.

wr - will hold the resultant world rectangle.

worldToLocal

public void worldToLocal(Point pp,
 Point2D.Double wp)

This converts a world point to a screen or pixel point.

Parameters:

pp - will hold the resultant local (screen-pixel) point.

wp - contains world point.

worldToLocal

public void worldToLocal(Rectangle r,
 Rectangle2D.Double wr)

doneRubberbanding

public void doneRubberbanding()

Description copied from interface: IRubberbanded

This just signals that we are done rubber banding.

Specified by:

doneRubberbanding in interface IRubberbanded

recenterAtClick

public void recenterAtClick(Point pp)

Center the plot world at the click.

Parameters:

pp -

scale

public void scale(double amount)

Scale the canvas by a given amount

Parameters:

amount - the factor to scale by

buttonPressed

public void buttonPressed(CommonToolBar toolbar,
 ToolBarButton button)

Specified by:

buttonPressed in interface IToolBarListener

doButtonAction

public void doButtonAction(String command)

print

public void print()

Print

getSavePngFile

public File getSavePngFile()

takePicture

public void takePicture()

Take a picture, sanve as png

toggleButtonActivated

public void toggleButtonActivated(CommonToolBar toolbar,
 ToolBarToggleButton button)

Specified by:

toggleButtonActivated in interface IToolBarListener

showPreferencesEditor

public void showPreferencesEditor()

Show the plot preferences dialog

showDataEditor

public void showDataEditor()

Show the data editor

remoteFirePropertyChange

public void remoteFirePropertyChange(String propName,
 Object oldValue,
 Object newValue)

Used so another object can tell the plot canvas to fire a propert change event

Parameters:

propName -

oldValue -

newValue -

tableChanged

public void tableChanged(TableModelEvent e)

Specified by:

tableChanged in interface TableModelListener

getPlotTicks

public PlotTicks getPlotTicks()

Get the canavas's plot ticks

Returns:

the plot ticks

getGradient

public Gradient getGradient()

Get the canvas's color gradient

Returns:

the color gradient

setSelectedToggle

public void setSelectedToggle(String s)

Set which toggle button is selected

dataSetChanged

public void dataSetChanged(DataSet dataSet)

Description copied from interface: DataChangeListener

A data set changed

Specified by:

dataSetChanged in interface DataChangeListener

Parameters:

dataSet - the dataSet that changed