org.das2.graph

Class DasLabelAxis

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

org.das2.graph.DasCanvasComponent

org.das2.graph.DasAxis

org.das2.graph.DasLabelAxis

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.lang.Cloneable, java.util.EventListener, Editable, DataRangeSelectionListener, TimeRangeSelectionListener, DasUpdateListener

public class DasLabelAxis
extends DasAxis
implements DasUpdateListener

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.das2.graph.DasAxis

DasAxis.AxisLayoutManager, DasAxis.Lock, DasAxis.Memento

Nested classes/interfaces inherited from class org.das2.graph.DasCanvasComponent

DasCanvasComponent.CanvasComponentAction

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

javax.swing.JComponent.AccessibleJComponent

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

java.awt.Container.AccessibleAWTContainer

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

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields inherited from class org.das2.graph.DasAxis

axisLabel, BOTTOM, dataRange, datumFormatter, dividerDatumFormatter, enableHistory, flipLabel, formatString, HORIZONTAL, LEFT, majorTicksDomainDivider, MAX_TCA_LINES, minorTicksDomainDivider, primaryInputPanel, PROP_AXISOFFSET, PROP_BOUNDS, PROP_DIVIDERDATUMFORMATTER, PROP_ENABLEHISTORY, PROP_FLIPLABEL, PROP_FLIPPED, PROP_FONTSIZE, PROP_FORMAT, PROP_LABEL, PROP_LINETHICKNESS, PROP_LOCKDOMAINDIVIDER, PROP_LOG, PROP_MAJORTICKSDOMAINDIVIDER, PROP_MINORTICKSDOMAINDIVIDER, PROP_OPPOSITE_AXIS_VISIBLE, PROP_REFERENCE, PROP_SCAN_RANGE, PROP_TCALABELS, PROP_TCAROWS, PROP_TICKVALUES, PROP_UNITS, PROP_USEDOMAINDIVIDER, PROPERTY_DATUMRANGE, PROPERTY_TICKS, RIGHT, secondaryInputPanel, tickV, TOP, useDomainDivider, VERTICAL

Fields inherited from class org.das2.graph.DasCanvasComponent

mouseAdapter, PROP_OPAQUEBACKGROUND, PROPERTIES_ACTION

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

Modifier	Constructor and Description
protected	DasLabelAxis(DatumVector labels, DataRange dataRange, int orientation)
	DasLabelAxis(DatumVector labels, int orientation)
	DasLabelAxis(QDataSet labels, int orientation)

Method Summary

Modifier and Type	Method and Description
DasAxis	createAttachedAxis(DasRow row, DasColumn column)
DasAxis	createAttachedAxis(int orientation) create another axis that follows this axis.
Datum	findTick(Datum xDatum, double direction, boolean minor) Locates the next or previous tick starting at xDatum.
java.awt.geom.AffineTransform	getAffineTransform(DasAxis.Memento memento, java.awt.geom.AffineTransform at) return the AffineTransform, or null.
int	getInterItemSpace()
int	getItemMax(Datum d) get the maximum pixel location of the bin allocated to the Datum.
int	getItemMin(Datum d) get the minimum pixel location of the bin allocated to the Datum.
int[]	getLabelPositions()
int	getOutsidePadding() Getter for property outsidePadding.
TickVDescriptor	getTickV() return the current set of ticks.
Datum	invTransform(double d) return the data location for the given pixel position.
boolean	isFloppyItemSpacing() Getter for property floppyltemSpacing.
protected void	paintHorizontalAxis(java.awt.Graphics2D g) Paint the axis if it is horizontal
protected void	paintVerticalAxis(java.awt.Graphics2D g) Paint the vertical axis
protected boolean	rangeIsAcceptable(DatumRange dr) override this to allow a single Datum.
void	setFloppyItemSpacing(boolean floppyItemSpacing) Setter for property floppyltemSpacing.
void	setLabelFormatter(DatumFormatter df) vg1pws needed a way to explicitly set this.
void	setOutsidePadding(int outsidePadding) Setter for property outsidePadding.
protected java.lang.String	tickFormatter(Datum t) return a label for this datum and visible range.
protected java.lang.String[]	tickFormatter(DatumVector tickV, DatumRange datumRange) return the tick labels for these datums and visible range.
double	transform(double value, Units units) Transforms a double in the given units in data coordinates to a horizontal or vertical position on the parent canvas.
void	update(DasUpdateEvent e)
void	updateTickV() recalculate the tick positions.

Methods inherited from class org.das2.graph.DasAxis

addMouseListener, addMouseMotionListener, addMouseWheelListener, addTickV, addTimeRangeSelectionListener, addToFavorites, attachTo, clearHistory, clone, createAttachedAxis, dataRangeSelected, detach, deviceRangeChanged, drawLabel, getActiveRegion, getAxisBounds, getAxisOffset, getAxisOffsetPixels, getDataMaximum, getDataMaximum, getDataMinimum, getDataMinimum, getDataPath, getDataRange, getDatumFormatter, getDatumRange, getDevicePosition, getDividerDatumFormatter, getDLength, getDrawTca, getFontSize, getFormat, getLabel, getLabelBounds, getLabelFont, getLabelOffset, getLineSpacing, getLineThickness, getMajorTicksDomainDivider, getMasterAxis, getMaxLabelWidth, getMemento, getMinorTicksDomainDivider, getOrientation, getRange, getReference, getScanRange, getTcaLabels, getTcaRows, getTickDirection, getTickLabelFont, getTickLength, getTickLines, getTickValues, getTitlePositionOffset, getUnits, getUserDatumFormatter, installComponent, invTransform, isAnimated, isAttached, isDrawTca, isEnableHistory, isFlipLabel, isFlipped, isHorizontal, isLockDomainDivider, isLog, isOppositeAxisVisible, isTcaLoaded, isTickLabelsVisible, isUseDomainDivider, mutatorLock, paintComponent, processEvent, removeFromFavorites, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeTimeRangeSelectionListener, repaint, resetRange, resetTickV, resize, resolveAxisLabel, scanNext, scanPrevious, setAnimated, setAxisOffset, setDataMaximum, setDataMinimum, setDataPath, setDataRange, setDataRangeForward, setDataRangePrev, setDataRangeZoomOut, setDatumRange, setDividerDatumFormatter, setDrawTca, setEnableHistory, setFlipLabel, setFlipped, setFontSize, setFormat, setLabel, setLabelOffset, setLeftXLabelOverride, setLineThickness, setLockDomainDivider, setLog, setMajorTicksDomainDivider, setMinorTicksDomainDivider, setNextAction, setNextActionLabel, setOppositeAxisVisible, setOrientation, setPlot, setPreviousAction, setPreviousActionLabel, setReference, setScanRange, setTcaFunction, setTcaLabels, setTcaRows, setTickLabelsVisible, setTickLength, setTickV, setTickV, setTickValues, setUnits, setUseDomainDivider, setUserDatumFormatter, setVisible, timeRangeSelected, toString, transform, transform, transform, transform, transformFast, uninstallComponent, updateImmediately, updateTickVManualTicks, valueIsAdjusting

Methods inherited from class org.das2.graph.DasCanvasComponent

acceptContext, addMouseModule, coalesceEvents, getActions, getCanvas, getColumn, getDasMouseInputAdapter, getDasName, getEmSize, getFont, getLineThicknessDouble, getRow, isOpaqueBackground, processDasUpdateEvent, removeMouseModule, setColumn, setDasName, setOpaqueBackground, setRow, showProperties, update

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, 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, 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, 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, bounds, checkImage, checkImage, 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, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, 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, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

DasLabelAxis

protected DasLabelAxis(DatumVector labels,
                       DataRange dataRange,
                       int orientation)

DasLabelAxis

public DasLabelAxis(DatumVector labels,
                    int orientation)

DasLabelAxis

public DasLabelAxis(QDataSet labels,
                    int orientation)

Method Detail

setLabelFormatter

public void setLabelFormatter(DatumFormatter df)

vg1pws needed a way to explicitly set this.

getLabelPositions

public int[] getLabelPositions()

findTick

public Datum findTick(Datum xDatum,
                      double direction,
                      boolean minor)

Description copied from class: DasAxis

Locates the next or previous tick starting at xDatum.

Overrides:

findTick in class DasAxis

Parameters:

xDatum - find the tick closest to this.

direction - -1 previous, 1 next, 0 closest

minor - find closest minor tick, major if false.

Returns:

the closest tick. If there is no tick in the given direction, then the behavior is undefined.

updateTickV

public void updateTickV()

Description copied from class: DasAxis

recalculate the tick positions.

Overrides:

updateTickV in class DasAxis

getTickV

public TickVDescriptor getTickV()

Description copied from class: DasAxis

return the current set of ticks.

Overrides:

getTickV in class DasAxis

Returns:

the current set of ticks.

transform

public double transform(double value,
                        Units units)

Description copied from class: DasAxis

Transforms a double in the given units in data coordinates to a horizontal or vertical position on the parent canvas.

Overrides:

transform in class DasAxis

Parameters:

value - a data value

units - the units of the given data value.

Returns:

Horizontal or vertical position on the canvas.

invTransform

public Datum invTransform(double d)

Description copied from class: DasAxis

return the data location for the given pixel position. Plot coordinates have 0,0 at the upper-left hand corner of the screen.

Overrides:

invTransform in class DasAxis

Parameters:

d - the pixel location on the axis, in the canvas frame.

Returns:

the data location.

rangeIsAcceptable

protected boolean rangeIsAcceptable(DatumRange dr)

override this to allow a single Datum.

Overrides:

rangeIsAcceptable in class DasAxis

Parameters:

dr -

Returns:

tickFormatter

protected java.lang.String tickFormatter(Datum t)

Description copied from class: DasAxis

return a label for this datum and visible range. This is intended to be overridden to change behavior. Note that both tickFormatter methods should be overridden.

Overrides:

tickFormatter in class DasAxis

Parameters:

t - the location

Returns:

string, possibly with Granny control characters.

tickFormatter

protected java.lang.String[] tickFormatter(DatumVector tickV,
                                           DatumRange datumRange)

Description copied from class: DasAxis

return the tick labels for these datums and visible range. This is intended to be overridden to change behavior. Note that both tickFormatter methods should be overridden.

Overrides:

tickFormatter in class DasAxis

Parameters:

tickV - the ticks

datumRange - the range

Returns:

Strings, possibly with Granny control characters.

getInterItemSpace

public int getInterItemSpace()

getItemMin

public int getItemMin(Datum d)

get the minimum pixel location of the bin allocated to the Datum.

Parameters:

d -

Returns:

pixel location of the min.

getItemMax

public int getItemMax(Datum d)

get the maximum pixel location of the bin allocated to the Datum.

Parameters:

d -

Returns:

pixel location of the max.

createAttachedAxis

public DasAxis createAttachedAxis(DasRow row,
                                  DasColumn column)

createAttachedAxis

public DasAxis createAttachedAxis(int orientation)

Description copied from class: DasAxis

create another axis that follows this axis. It will have the same range.

Overrides:

createAttachedAxis in class DasAxis

Parameters:

orientation - the position relative to a plot, one of DasAxis.TOP, DasAxis.BOTTOM, DasAxis.LEFT, DasAxis.RIGHT

Returns:

attached axis.

update

public void update(DasUpdateEvent e)

Specified by:

update in interface DasUpdateListener

paintHorizontalAxis

protected void paintHorizontalAxis(java.awt.Graphics2D g)

Description copied from class: DasAxis

Paint the axis if it is horizontal

Overrides:

paintHorizontalAxis in class DasAxis

Parameters:

g - the graphics context

paintVerticalAxis

protected void paintVerticalAxis(java.awt.Graphics2D g)

Description copied from class: DasAxis

Paint the vertical axis

Overrides:

paintVerticalAxis in class DasAxis

Parameters:

g - the graphics context

getOutsidePadding

public int getOutsidePadding()

Getter for property outsidePadding.

Returns:

Value of property outsidePadding.

setOutsidePadding

public void setOutsidePadding(int outsidePadding)

Setter for property outsidePadding.

Parameters:

outsidePadding - New value of property outsidePadding.

isFloppyItemSpacing

public boolean isFloppyItemSpacing()

Getter for property floppyltemSpacing.

Returns:

Value of property floppyltemSpacing.

setFloppyItemSpacing

public void setFloppyItemSpacing(boolean floppyItemSpacing)

Setter for property floppyltemSpacing.

Parameters:

floppyItemSpacing - New value of property floppyltemSpacing.

getAffineTransform

public java.awt.geom.AffineTransform getAffineTransform(DasAxis.Memento memento,
                                                        java.awt.geom.AffineTransform at)

Description copied from class: DasAxis

return the AffineTransform, or null. The transform will be applied after the input transform is applied. So to just get the transform, pass in identity.

Overrides:

getAffineTransform in class DasAxis

Parameters:

memento - memento from another axis state.

at - initial transform

Returns:

the transform from that state to this state, or null if no transform can be created.