DasPlot

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - org.das2.graph.DasCanvasComponent
      - org.das2.graph.DasPlot

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, Editable

Direct Known Subclasses:

AngleSpectrogramSlicer
```
public class DasPlot
extends DasCanvasComponent
```
DasPlot is the 2D plot containing a horizontal X axis and vertical Y axis, and a stack of Renderers that paint data onto the plot. It coordinates calls to each Renderer's updatePlotImage and render methods, and manages the rendered stack image to provide previews of new axis settings.

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

protected class DasPlot.RebinListener
- 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

Nested Classes
Modifier and Type	Class and Description
`protected class`	`DasPlot.RebinListener`

Field Summary

Fields
Modifier and Type	Field and Description
`protected Painter`	`bottomDecorator`
`protected boolean`	`displayTitle` true if the plot title should be displayed.
`javax.swing.Action`	`DUMP_TO_FILE_ACTION` Action to dump the first (0th) renderer's data to a file.
`protected Renderer`	`focusRenderer` returns the Renderer with the current focus.
`static int`	`INFO` These levels are now taken from java.util.logging.Level.
`static java.lang.String`	`PROP_BOTTOMDECORATOR`
`static java.lang.String`	`PROP_CONTEXT` property where the plot context can be stored.
`static java.lang.String`	`PROP_DISPLAY_CONTEXT` necessary place to put the range of the data actually displayed.
`static java.lang.String`	`PROP_DISPLAYLEGEND` true if the legend should be displayed
`static java.lang.String`	`PROP_DISPLAYTITLE` turns the plot title off or on.
`static java.lang.String`	`PROP_DRAWBACKGROUND` the background should be drawn, if alpha is >0.
`java.lang.String`	`PROP_DRAWDEBUGMESSAGES` draw a purple box in the lower right corner indicating the number of times each renderer has updated, rendered, and the plot itself has painted.
`static java.lang.String`	`PROP_DRAWGRID` If true, faint grey lines continue the axis major ticks across the plot.
`static java.lang.String`	`PROP_DRAWGRIDCOLOR` if not transparent, draw the grid in this color.
`static java.lang.String`	`PROP_DRAWGRIDOVER` if true, then the grid is on top of the data.
`static java.lang.String`	`PROP_DRAWMINORGRID` If true, faint grey lines continue the axis minor ticks across the plot.
`static java.lang.String`	`PROP_FOCUSRENDERER` property name for the current renderer that the operator has selected.
`static java.lang.String`	`PROP_FONTSIZE`
`static java.lang.String`	`PROP_ISOTROPIC` true if the x and y scaling (pixel:data) ratio is locked together.
`static java.lang.String`	`PROP_LEGEND_WIDTH_LIMIT_PX`
`static java.lang.String`	`PROP_LEGENDFONTSIZE`
`static java.lang.String`	`PROP_LEGENDPOSITION` the location of the legend position, which can be one of the four corners, or outside and to the right of the plot.
`static java.lang.String`	`PROP_LEGENDRELATIVESIZESIZE` relative font size for the legend.
`static java.lang.String`	`PROP_LINETHICKNESS`
`static java.lang.String`	`PROP_LOG_LEVEL` the log level for the messages on the screen.
`static java.lang.String`	`PROP_LOG_TIMEOUT_SEC` number of seconds to show the log messages.
`static java.lang.String`	`PROP_LONGTITLES`
`static java.lang.String`	`PROP_MULTILINETEXTALIGNMENT` property name for multiline labels, the horizontal alignment, where 0 is left, 0.5 is center, and 1.0 is right.
`static java.lang.String`	`PROP_OVERSIZE` boolean property indicating that the data outside the axis bounds is rendered, to smooth animation when the axis is panned.
`static java.lang.String`	`PROP_PLOTVISIBLE`
`static java.lang.String`	`PROP_PRINTINGLOGLEVEL` the log level to indicate the log level when printing.
`static java.lang.String`	`PROP_RENDERERS`
`static java.lang.String`	`PROP_TITLE` title for the plot
`static java.lang.String`	`PROP_TOPDECORATOR`
`protected DasPlot.RebinListener`	`rebinListener` listens for property changes and triggers the process of updating the plot image.
`static int`	`SEVERE` mark the log message as severe, where an error condition has occurred.
`protected java.beans.PropertyChangeListener`	`ticksListener` listens for x and y axis tick changes, and repaints the plot when drawing grid lines at tick positions.
`protected Painter`	`topDecorator`
`static int`	`WARNING` mark the log message as a warning where the operator should be aware.

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
Constructor and Description

DasPlot(DasAxis xAxis, DasAxis yAxis)
create a new plot with the x and y axes.

Constructors
Constructor and Description
`DasPlot(DasAxis xAxis, DasAxis yAxis)` create a new plot with the x and y axes.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`addCustomizer(CustomizerKey key, Customizer customizer)` Add a new customizer to the collection of customizers being used when creating new plots.
`void`	`addRenderer(int index, Renderer rend)` add the renderer to the stack of renderers at the given index.
`void`	`addRenderer(Renderer rend)` add the renderer to the stack of renderers.
`void`	`addToLegend(Renderer renderer, javax.swing.ImageIcon icon, int pos, java.lang.String message)` Add the message to the messages in the legend.
`protected java.awt.AWTEvent`	`coalesceEvents(java.awt.AWTEvent existingEvent, java.awt.AWTEvent newEvent)` Potentially coalesce an event being posted with an existing event.
`boolean`	`contains(int x, int y)` since the plotVisible property can be false and the plot having no renderers, we want the mouse events to pass on to elements below them.
`boolean`	`containsRenderer(Renderer rend)` return true if the plot contains the renderer.
`static DasPlot`	`createDummyPlot()` provide convenient method for creating a plot.
`static DasPlot`	`createPlot(DatumRange xrange, DatumRange yrange)` provide convenient method for creating a plot.
`protected void`	`drawContent(java.awt.Graphics2D g)` this is a stub (empty method) that can be overridden to draw content.
`int`	`findRendererAt(int x, int y)` return the index of the renderer at canvas location (x,y), or -1 if no renderer is found at the position.
`java.awt.Shape`	`getActiveRegion()` return a Shape containing the plot.
`protected java.awt.geom.AffineTransform`	`getAffineTransform(DasAxis xAxis, DasAxis yAxis)` returns the AffineTransform to transform data from the last updatePlotImage call axes (if super.updatePlotImage was called), or null if the transform is not possible.
`java.awt.Rectangle`	`getAxisClip()` return the Rectangle where data is drawn, useful for clipping.
`Painter`	`getBottomDecorator()`
`protected java.awt.Rectangle`	`getCacheImageBounds()` returns a copy of the position of the cacheImage in the canvas frame of reference.
`DatumRange`	`getContext()` convenient place to put the plot context.
`static Customizer`	`getCustomizer(CustomizerKey key)`
`static java.util.List<CustomizerKey>`	`getCustomizerKeys()` Return a list of keys of all current customizing objects in the order they would be invoked.
`DasColorBar`	`getDasColorBar()` return the colorbar associated with this DasPlot.
`DatumRange`	`getDisplayContext()`
`java.awt.Color`	`getDrawBackground()` return the background color, where alpha=0 (transparent) means don't draw the background.
`java.awt.Color`	`getDrawGridColor()`
`Renderer`	`getFocusRenderer()` get the current renderer that the operator has selected.
`java.lang.String`	`getFontSize()`
`java.lang.String`	`getLegendFontSize()`
`LegendPosition`	`getLegendPosition()`
`int`	`getLegendRelativeFontSize()`
`int`	`getLegendWidthLimitPx()` width of plot required to show the legend labels.
`java.lang.String`	`getLineThickness()`
`java.util.logging.Level`	`getLogLevel()`
`int`	`getLogTimeoutSec()`
`float`	`getMultiLineTextAlignment()` get the horizontal alignment for multiline labels, where 0 is left, 0.5 is center, and 1.0 is right.
`int`	`getPaintCount()` get the diagnostic for the number of times the component was asked to paint itself since the last reset.
`java.util.logging.Level`	`getPrintingLogLevel()`
`Renderer`	`getRenderer(int index)` return one of the renderers, which paint the data on to the plot.
`Renderer[]`	`getRenderers()` return a list of the renderers, which paint the data on to the plot.
`java.lang.String`	`getTitle()` Returns the title of this plot.
`Painter`	`getTopDecorator()`
`protected java.awt.Rectangle`	`getUpdateImageBounds()` returns the rectangle that renderers should paint so that when they are asked to render, they have everything pre-rendered.
`DasAxis`	`getXAxis()` return the x (horizontal) axis.
`DasAxis`	`getYAxis()` return the y (vertical) axis
`protected void`	`installComponent()` currently does nothing.
`void`	`invalidateCacheImage()` mark the dasPlot's cache image as invalid, forcing it to repaint.
`void`	`invalidateCacheImageNoUpdate()` mark the dasPlot's cache image as invalid, but from the update method, so we don't need to update.
`boolean`	`isCacheImageValid()` introduced to debug Autoplot test018.
`boolean`	`isDisplayLegend()` true if the legend should be displayed
`boolean`	`isDisplayTitle()` return the state of enable/disable display of the title.
`boolean`	`isDrawDebugMessages()`
`boolean`	`isDrawGrid()` Getter for property drawGrid.
`boolean`	`isDrawGridOver()`
`boolean`	`isDrawMinorGrid()` Get the value of drawMinorGrid
`boolean`	`isIsotropic()`
`boolean`	`isLongTitles()` long titles means it won't clip at the axis bounds, at the risk of affecting codes which expect the old boundaries.
`boolean`	`isOverSize()`
`boolean`	`isPlotVisible()`
`boolean`	`isPreviewEnabled()` true if the data rendering will be scaled immediately to indicate axis state changes.
`protected void`	`paintComponent(java.awt.Graphics graphics0)`
`void`	`postException(Renderer renderer, java.lang.Exception exception)` notify user of an exception, in the context of the plot.
`void`	`postMessage(Renderer renderer, java.lang.String message, int messageType, Datum x, Datum y)` Notify user of an exception, in the context of the plot.
`void`	`postMessage(Renderer renderer, java.lang.String message, java.util.logging.Level messageLevel, Datum x, Datum y)` Notify user of an exception, in the context of the plot.
`protected void`	`printComponent(java.awt.Graphics g)` we need to call each renderer's updatePlotImage method, otherwise we assume the session is interactive.
`protected void`	`processEvent(java.awt.AWTEvent e)` Processes events occurring on this component.
`void`	`releaseAll()` In Autoplot, we need a way to get help releasing all resources.
`static void`	`removeCustomizer(CustomizerKey key)` Remove the customizer that is associated with the given key.
`void`	`removeRenderer(Renderer rend)` remove the renderer from the stack of renderers.
`void`	`removeRenderers()` remove all the renderers from the dasPlot.
`void`	`repaint()` request that the plot be repainted.
`void`	`resetPaintCount()` reset the paint counter.
`void`	`resize()` recalculate the bounds of the component.
`void`	`setAxisPlotVisible(boolean visible)` set the visibility of both the plot and its x and y axes.
`void`	`setBottomDecorator(Painter bottomDecorator)` add additional painting code to the renderer, which is called after the renderer is called.
`protected void`	`setCacheImageBounds(java.awt.Rectangle cacheImageBounds)` there's a deadlock that shows with test140 on ci-pw if this is synchronized.
`void`	`setContext(DatumRange context)` convenient place to put the plot context.
`void`	`setDisplayContext(DatumRange displayContext)` set the property
`void`	`setDisplayLegend(boolean displayLegend)` true if the legend should be displayed
`void`	`setDisplayTitle(boolean v)` enable/disable display of the title.
`void`	`setDrawBackground(java.awt.Color drawBackground)` if not transparent, draw this background first.
`void`	`setDrawDebugMessages(boolean v)`
`void`	`setDrawGrid(boolean drawGrid)` Setter for property drawGrid.
`void`	`setDrawGridColor(java.awt.Color drawGridColor)` if not transparent, draw the grid in this color.
`void`	`setDrawGridOver(boolean gridOver)`
`void`	`setDrawMinorGrid(boolean newdrawMinorGrid)` Set the value of drawMinorGrid
`void`	`setEnableRenderPropertiesAction(boolean b)` add or remove the menu item to get at the renderer properties.
`void`	`setFocusRenderer(Renderer focusRenderer)` set the current renderer that the operator has selected.
`void`	`setFontSize(java.lang.String fontSize)` set the font size, with respect to the canvas font.
`void`	`setIsotropic(boolean isotropic)` set the property value
`void`	`setLegendFontSize(java.lang.String legendFontSize)` set the font size for the legend, using the conventions where 1em is the parent's font size: 1em same as plot font.
`void`	`setLegendPosition(LegendPosition newlegendPosition)`
`void`	`setLegendRelativeFontSize(int size)` set the relative size of the legend element text.
`void`	`setLegendWidthLimitPx(int legendWidthLimitPx)` width of plot required to show the legend labels.
`void`	`setLineThickness(java.lang.String lineThickness)` set the thickness of the lines drawn.
`void`	`setLogLevel(java.util.logging.Level level)`
`void`	`setLogTimeoutSec(int logTimeoutSec)`
`void`	`setLongTitles(boolean longTitles)` long titles means it won't clip at the axis bounds, at the risk of affecting codes which expect the old boundaries.
`void`	`setMultiLineTextAlignment(float multiLineTextAlignment)` set the horizontal alignment for multiline labels, where 0 is left, 0.5 is center, and 1.0 is right.
`void`	`setOverSize(boolean overSize)`
`void`	`setPlotVisible(boolean plotVisible)`
`void`	`setPreviewEnabled(boolean preview)` if true then the data rendering will be scaled immediately to indicate axis state changes.
`void`	`setPrintingLogLevel(java.util.logging.Level printingLogLevel)`
`void`	`setReduceOutsideLegendTopMargin(boolean reduceOutsideLegendTopMargin)` Used at APL for layout.
`void`	`setTitle(java.lang.String t)` Sets the title which will be displayed above this plot.
`void`	`setTopDecorator(Painter topDecorator)` add additional painting code to the renderer, which is called after the renderer is called.
`void`	`setXAxis(DasAxis xAxis)` set the x axis.
`void`	`setYAxis(DasAxis yAxis)` Attaches a new axis to the plot.
`protected void`	`uninstallComponent()` remove the component row and column update listener.
`protected void`	`updateImmediately()` This method is called when a DasUpdateEvent is processed.

Methods inherited from class org.das2.graph.DasCanvasComponent
acceptContext, addMouseModule, getActions, getCanvas, getColumn, getDasMouseInputAdapter, getDasName, getEmSize, getFont, getLineThicknessDouble, getRow, isOpaqueBackground, processDasUpdateEvent, removeMouseModule, setColumn, setDasName, setOpaqueBackground, setRow, showProperties, toString, update

Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, 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, 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, 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, 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, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, 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
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - PROP_LEGEND_WIDTH_LIMIT_PX
```
public static final java.lang.String PROP_LEGEND_WIDTH_LIMIT_PX
```
    See Also:
    
    Constant Field Values
  - PROP_TITLE
```
public static final java.lang.String PROP_TITLE
```
    title for the plot
    
    See Also:
    
    Constant Field Values
  - displayTitle
```
protected boolean displayTitle
```
    true if the plot title should be displayed.
  - rebinListener
```
protected DasPlot.RebinListener rebinListener
```
    listens for property changes and triggers the process of updating the plot image.
  - ticksListener
```
protected transient java.beans.PropertyChangeListener ticksListener
```
    listens for x and y axis tick changes, and repaints the plot when drawing grid lines at tick positions.
  - focusRenderer
```
protected Renderer focusRenderer
```
    returns the Renderer with the current focus. Clicking on a trace sets the focus.
  - PROP_FOCUSRENDERER
```
public static final java.lang.String PROP_FOCUSRENDERER
```
    property name for the current renderer that the operator has selected.
    
    See Also:
    
    Constant Field Values
  - PROP_MULTILINETEXTALIGNMENT
```
public static final java.lang.String PROP_MULTILINETEXTALIGNMENT
```
    property name for multiline labels, the horizontal alignment, where 0 is left, 0.5 is center, and 1.0 is right.
    
    See Also:
    
    Constant Field Values
  - DUMP_TO_FILE_ACTION
```
public javax.swing.Action DUMP_TO_FILE_ACTION
```
    Action to dump the first (0th) renderer's data to a file.
  - INFO
```
public static final int INFO
```
    These levels are now taken from java.util.logging.Level. Generally INFO messages are displayed.
  - WARNING
```
public static final int WARNING
```
    mark the log message as a warning where the operator should be aware.
  - SEVERE
```
public static final int SEVERE
```
    mark the log message as severe, where an error condition has occurred.
  - PROP_DISPLAYTITLE
```
public static final java.lang.String PROP_DISPLAYTITLE
```
    turns the plot title off or on.
    
    See Also:
    
    Constant Field Values
  - bottomDecorator
```
protected Painter bottomDecorator
```
  - PROP_BOTTOMDECORATOR
```
public static final java.lang.String PROP_BOTTOMDECORATOR
```
    See Also:
    
    Constant Field Values
  - topDecorator
```
protected Painter topDecorator
```
  - PROP_TOPDECORATOR
```
public static final java.lang.String PROP_TOPDECORATOR
```
    See Also:
    
    Constant Field Values
  - PROP_CONTEXT
```
public static final java.lang.String PROP_CONTEXT
```
    property where the plot context can be stored.
    
    See Also:
    
    setContext(org.das2.datum.DatumRange), Constant Field Values
  - PROP_DISPLAY_CONTEXT
```
public static final java.lang.String PROP_DISPLAY_CONTEXT
```
    necessary place to put the range of the data actually displayed. The context is the controller, and the displayContext closes the loop. This is mostly here to provide legacy support to Autoplot which abused the context property as both a write and read, and note there's a small problem that displayed items may have different display contexts. So this property should be used carefully, and generally when just one thing is visible.
    
    See Also:
    
    Constant Field Values
  - PROP_RENDERERS
```
public static final java.lang.String PROP_RENDERERS
```
    See Also:
    
    Constant Field Values
  - PROP_LEGENDPOSITION
```
public static final java.lang.String PROP_LEGENDPOSITION
```
    the location of the legend position, which can be one of the four corners, or outside and to the right of the plot.
    
    See Also:
    
    Constant Field Values
  - PROP_LEGENDRELATIVESIZESIZE
```
public static final java.lang.String PROP_LEGENDRELATIVESIZESIZE
```
    relative font size for the legend. For example, -2 will use sans-8 when the plot font is sans-10.
    
    See Also:
    
    Constant Field Values
  - PROP_LEGENDFONTSIZE
```
public static final java.lang.String PROP_LEGENDFONTSIZE
```
    See Also:
    
    Constant Field Values
  - PROP_FONTSIZE
```
public static final java.lang.String PROP_FONTSIZE
```
    See Also:
    
    Constant Field Values
  - PROP_DISPLAYLEGEND
```
public static final java.lang.String PROP_DISPLAYLEGEND
```
    true if the legend should be displayed
    
    See Also:
    
    Constant Field Values
  - PROP_DRAWBACKGROUND
```
public static final java.lang.String PROP_DRAWBACKGROUND
```
    the background should be drawn, if alpha is >0.
    
    See Also:
    
    Constant Field Values
  - PROP_DRAWGRIDCOLOR
```
public static final java.lang.String PROP_DRAWGRIDCOLOR
```
    if not transparent, draw the grid in this color. Otherwise the grid is drawn with the tick color.
    
    See Also:
    
    Constant Field Values
  - PROP_DRAWGRID
```
public static final java.lang.String PROP_DRAWGRID
```
    If true, faint grey lines continue the axis major ticks across the plot.
    
    See Also:
    
    Constant Field Values
  - PROP_DRAWMINORGRID
```
public static final java.lang.String PROP_DRAWMINORGRID
```
    If true, faint grey lines continue the axis minor ticks across the plot.
    
    See Also:
    
    Constant Field Values
  - PROP_DRAWGRIDOVER
```
public static final java.lang.String PROP_DRAWGRIDOVER
```
    if true, then the grid is on top of the data.
    
    See Also:
    
    Constant Field Values
  - PROP_LINETHICKNESS
```
public static final java.lang.String PROP_LINETHICKNESS
```
    See Also:
    
    Constant Field Values
  - PROP_PLOTVISIBLE
```
public static final java.lang.String PROP_PLOTVISIBLE
```
    See Also:
    
    Constant Field Values
  - PROP_OVERSIZE
```
public static final java.lang.String PROP_OVERSIZE
```
    boolean property indicating that the data outside the axis bounds is rendered, to smooth animation when the axis is panned.
    
    See Also:
    
    Constant Field Values
  - PROP_LONGTITLES
```
public static final java.lang.String PROP_LONGTITLES
```
    See Also:
    
    Constant Field Values
  - PROP_LOG_LEVEL
```
public static final java.lang.String PROP_LOG_LEVEL
```
    the log level for the messages on the screen.
    
    See Also:
    
    Constant Field Values
  - PROP_PRINTINGLOGLEVEL
```
public static final java.lang.String PROP_PRINTINGLOGLEVEL
```
    the log level to indicate the log level when printing.
    
    See Also:
    
    Constant Field Values
  - PROP_LOG_TIMEOUT_SEC
```
public static final java.lang.String PROP_LOG_TIMEOUT_SEC
```
    number of seconds to show the log messages. If Integer.MAX_VALUE/100 or greater then there is no timeout.
    
    See Also:
    
    Constant Field Values
  - PROP_ISOTROPIC
```
public static final java.lang.String PROP_ISOTROPIC
```
    true if the x and y scaling (pixel:data) ratio is locked together.
    
    See Also:
    
    Constant Field Values
  - PROP_DRAWDEBUGMESSAGES
```
public java.lang.String PROP_DRAWDEBUGMESSAGES
```
    draw a purple box in the lower right corner indicating the number of times each renderer has updated, rendered, and the plot itself has painted.
- Constructor Detail
  - DasPlot
```
public DasPlot(DasAxis xAxis,
               DasAxis yAxis)
```
    create a new plot with the x and y axes.
    
    Parameters:
    
    xAxis - the horizontal axis
    
    yAxis - the vertical axis
- Method Detail
  - getCustomizerKeys
```
public static java.util.List<CustomizerKey> getCustomizerKeys()
```
    Return a list of keys of all current customizing objects in the order they would be invoked.
    
    Returns:
    
    the keys
  - addCustomizer
```
public static void addCustomizer(CustomizerKey key,
                                 Customizer customizer)
```
    Add a new customizer to the collection of customizers being used when creating new plots. The new customizer will be invoked last.
    
    Parameters:
    
    key - the new customizer's lookup key
    
    customizer - the new customizer
  - getCustomizer
```
public static Customizer getCustomizer(CustomizerKey key)
```
  - removeCustomizer
```
public static void removeCustomizer(CustomizerKey key)
```
    Remove the customizer that is associated with the given key.
    
    Parameters:
    
    key - the key to the customizer to be removed.
  - getLegendWidthLimitPx
```
public int getLegendWidthLimitPx()
```
    width of plot required to show the legend labels.
  - setLegendWidthLimitPx
```
public void setLegendWidthLimitPx(int legendWidthLimitPx)
```
    width of plot required to show the legend labels.
    
    Parameters:
    
    legendWidthLimitPx -
  - getFocusRenderer
```
public Renderer getFocusRenderer()
```
    get the current renderer that the operator has selected.
    
    Returns:
    
    the current renderer that the operator has selected.
  - setFocusRenderer
```
public void setFocusRenderer(Renderer focusRenderer)
```
    set the current renderer that the operator has selected.
    
    Parameters:
    
    focusRenderer - the current renderer that the operator has selected.
  - getMultiLineTextAlignment
```
public float getMultiLineTextAlignment()
```
    get the horizontal alignment for multiline labels, where 0 is left, 0.5 is center, and 1.0 is right.
    
    Returns:
    
    the alignment
  - setMultiLineTextAlignment
```
public void setMultiLineTextAlignment(float multiLineTextAlignment)
```
    set the horizontal alignment for multiline labels, where 0 is left, 0.5 is center, and 1.0 is right.
    
    Parameters:
    
    multiLineTextAlignment - the alignment
  - findRendererAt
```
public int findRendererAt(int x,
                          int y)
```
    return the index of the renderer at canvas location (x,y), or -1 if no renderer is found at the position.
    
    Parameters:
    
    x - the x position on the canvas.
    
    y - the y position on the canvas. Note 0,0 is the upper left corner.
    
    Returns:
    
    the index of the renderer at the position, or -1 if no renderer is at the position.
  - setXAxis
```
public void setXAxis(DasAxis xAxis)
```
    set the x axis. This removes property change listeners to the old axis and adds PCLs to the new axis.
    
    Parameters:
    
    xAxis - a horizontal axis.
  - setYAxis
```
public void setYAxis(DasAxis yAxis)
```
    Attaches a new axis to the plot. The old axis is disconnected, and the plot will listen to the new axis. Also, the row and column for the axis is set, but this might change in the future. null appears to be a valid input as well. TODO: plot does not seem to be responding to changes in the axis. (goes grey because updatePlotImage is never done.
    
    Parameters:
    
    yAxis - a vertical axis.
  - updateImmediately
```
protected void updateImmediately()
```
    Description copied from class: DasCanvasComponent
    
    This method is called when a DasUpdateEvent is processed. The default implementation does nothing. If a subclass needs to do any expensive operations involved in updating, they should be done by overriding this method so that the AWT Event Queue can coalesce update events.
    
    Overrides:
    
    updateImmediately in class DasCanvasComponent
  - getAffineTransform
```
protected java.awt.geom.AffineTransform getAffineTransform(DasAxis xAxis,
                                                           DasAxis yAxis)
```
    returns the AffineTransform to transform data from the last updatePlotImage call axes (if super.updatePlotImage was called), or null if the transform is not possible. This is used for the purpose of showing previews.
    
    Parameters:
    
    xAxis - the xaxis of the target coordinate frame
    
    yAxis - the yaxis of the target coordinate frame
    
    Returns:
    
    the AffineTransform from the list updatePlotImage call to these axes, if null if this is not possible.
  - printComponent
```
protected void printComponent(java.awt.Graphics g)
```
    we need to call each renderer's updatePlotImage method, otherwise we assume the session is interactive. We call the getCanvas().isPrintingThread because this is very expensive to run when we are actually printing, where we redo updatePlotImage etc, but we might just be looking to create a thumbnail and existing images may work fine. All this was introduced because Autoplot was calling canvas.getImage to get thumbnails and for its layout tab, and a quick way to get the canvas image was needed.
    
    Overrides:
    
    printComponent in class javax.swing.JComponent
    
    Parameters:
    
    g - Java2D graphics context.
  - getAxisClip
```
public java.awt.Rectangle getAxisClip()
```
    return the Rectangle where data is drawn, useful for clipping.
    
    Returns:
    
    Rectangle in canvas coordinates.
    
    See Also:
    
    DasDevicePosition.toRectangle(org.das2.graph.DasRow, org.das2.graph.DasColumn)
  - paintComponent
```
protected void paintComponent(java.awt.Graphics graphics0)
```
    Overrides:
    
    paintComponent in class javax.swing.JComponent
  - setEnableRenderPropertiesAction
```
public void setEnableRenderPropertiesAction(boolean b)
```
    add or remove the menu item to get at the renderer properties. Das2 applications generally allow this so that applications don't have to bother handling this. Others like Autoplot have their own systems and uses for the click.
    
    Parameters:
    
    b - false to remove the menu item if it has been added.
  - releaseAll
```
public void releaseAll()
```
    In Autoplot, we need a way to get help releasing all resources. This clears out all the mouse modules, axis references, etc. Basically anything that could have a reference to other parts of the system that we know we don't need here, explicitly remove the reference.
  - postMessage
```
public void postMessage(Renderer renderer,
                        java.lang.String message,
                        int messageType,
                        Datum x,
                        Datum y)
```
    Notify user of an exception, in the context of the plot. A position in the data space may be specified to locate the text within the data context. Note either or both x or y may be null. Messages must only be posted while the Renderer's render method is called, not during updatePlotImage. All messages are cleared before the render step. (TODO:check on this)
    
    Parameters:
    
    renderer - identifies the renderer posting the exception
    
    message - the text to be displayed, may contain granny text.
    
    messageType - DasPlot.INFO, DasPlot.WARNING, or DasPlot.SEVERE. (SEVERE was ERROR before)
    
    x - if non-null, the location on the x axis giving context for the text.
    
    y - if non-null, the location on the y axis giving context for the text.
  - postMessage
```
public void postMessage(Renderer renderer,
                        java.lang.String message,
                        java.util.logging.Level messageLevel,
                        Datum x,
                        Datum y)
```
    Notify user of an exception, in the context of the plot. A position in the data space may be specified to locate the text within the data context. Note either or both x or y may be null. Messages must only be posted while the Renderer's render method is called, not during updatePlotImage. All messages are cleared before the render step. (TODO:check on this)
    
    Parameters:
    
    renderer - identifies the renderer posting the exception
    
    message - the text to be displayed, may contain granny text.
    
    messageLevel - allows java.util.logging.Level to be used, for example Level.INFO, Level.WARNING, and Level.SEVERE
    
    x - if non-null, the location on the x axis giving context for the text.
    
    y - if non-null, the location on the y axis giving context for the text.
  - postException
```
public void postException(Renderer renderer,
                          java.lang.Exception exception)
```
    notify user of an exception, in the context of the plot. This is similar to postMessage(renderer, exception.getMessage(), DasPlot.SEVERE, null, null ) except that it does catch CancelledOperationExceptions and reduced the severity since the user probably initiated the condition.
    
    Parameters:
    
    renderer - the renderer posting the exception.
    
    exception - the exception to post.
  - addToLegend
```
public void addToLegend(Renderer renderer,
                        javax.swing.ImageIcon icon,
                        int pos,
                        java.lang.String message)
```
    Add the message to the messages in the legend.
    
    Parameters:
    
    renderer - identifies the renderer adding to the legend
    
    icon - if non-null, an icon to use. If null, the renderer's icon is used.
    
    pos - integer order parameter, and also identifies item.
    
    message - String message to display.
  - setReduceOutsideLegendTopMargin
```
public void setReduceOutsideLegendTopMargin(boolean reduceOutsideLegendTopMargin)
```
    Used at APL for layout. This is off by default. This appears to shift the Y position.
    
    Parameters:
    
    reduceOutsideLegendTopMargin - shift the Y position.
  - drawContent
```
protected void drawContent(java.awt.Graphics2D g)
```
    this is a stub (empty method) that can be overridden to draw content. This can be used to add annotations to plots, but see DasCanvas addTopDecorator as well. This is drawn above the grid when it is the bottom, and below the data.
    
    Parameters:
    
    g - the graphics context.
    
    See Also:
    
    DasCanvas.addTopDecorator(org.das2.graph.Painter)
  - resize
```
public void resize()
```
    recalculate the bounds of the component. TODO: this is used a lot and needs to be explained in more detail.
    
    Overrides:
    
    resize in class DasCanvasComponent
  - setTitle
```
public void setTitle(java.lang.String t)
```
    Sets the title which will be displayed above this plot. null or empty string may be used to turn off the title.
    
    Parameters:
    
    t - The new title for this plot.
    
    See Also:
    
    setDisplayTitle(boolean)
  - getTitle
```
public java.lang.String getTitle()
```
    Returns the title of this plot.
    
    Returns:
    
    The plot title
    
    See Also:
    
    setTitle(String)
  - isDisplayTitle
```
public boolean isDisplayTitle()
```
    return the state of enable/disable display of the title.
    
    Returns:
    
    the current state.
    
    See Also:
    
    setDisplayTitle(boolean)
  - setDisplayTitle
```
public void setDisplayTitle(boolean v)
```
    enable/disable display of the title. Often the title contains useful information describing the plot content that we want to know during interactive use but not when the plot is printed.
    
    Parameters:
    
    v - true if the title should be displayed.
    
    See Also:
    
    isDisplayTitle()
  - getBottomDecorator
```
public Painter getBottomDecorator()
```
  - setBottomDecorator
```
public void setBottomDecorator(Painter bottomDecorator)
```
    add additional painting code to the renderer, which is called after the renderer is called.
    
    Parameters:
    
    bottomDecorator - the Painter to call, or null to clear.
  - getTopDecorator
```
public Painter getTopDecorator()
```
  - setTopDecorator
```
public void setTopDecorator(Painter topDecorator)
```
    add additional painting code to the renderer, which is called after the renderer is called.
    
    Parameters:
    
    topDecorator - the Painter to call, or null to clear.
  - getContext
```
public DatumRange getContext()
```
    convenient place to put the plot context. The context is used to store the timerange when there is no axis for it, for example, to show the state of data during a range. This may change to a QDataSet to provide several context dimensions.
    
    Returns:
    
    the context
    
    See Also:
    
    setContext(org.das2.datum.DatumRange)
  - setContext
```
public void setContext(DatumRange context)
```
    convenient place to put the plot context. The context is used to store the timerange when there is no axis for it, for example, to show the state of data during a range. This may change to a QDataSet to provide several context dimensions. Note this may be null to support no context.
    
    Parameters:
    
    context - the context
    
    See Also:
    
    getContext()
  - getDisplayContext
```
public DatumRange getDisplayContext()
```
    Returns:
    
    the property value
    
    See Also:
    
    PROP_DISPLAY_CONTEXT
  - setDisplayContext
```
public void setDisplayContext(DatumRange displayContext)
```
    set the property
    
    Parameters:
    
    displayContext - null or the display context.
    
    See Also:
    
    PROP_DISPLAY_CONTEXT
  - getXAxis
```
public DasAxis getXAxis()
```
    return the x (horizontal) axis.
    
    Returns:
    
    the x axis
  - getYAxis
```
public DasAxis getYAxis()
```
    return the y (vertical) axis
    
    Returns:
    
    the y axis
  - getDasColorBar
```
public DasColorBar getDasColorBar()
```
    return the colorbar associated with this DasPlot. This loops through the renderers, from the top most to the bottom most, looking for the first with a non-null colorBar property.
    
    Returns:
    
    null if not found or the dasColorBar most visible.
  - installComponent
```
protected void installComponent()
```
    Description copied from class: DasCanvasComponent
    
    currently does nothing.
    
    Overrides:
    
    installComponent in class DasCanvasComponent
  - uninstallComponent
```
protected void uninstallComponent()
```
    Description copied from class: DasCanvasComponent
    
    remove the component row and column update listener.
    
    Overrides:
    
    uninstallComponent in class DasCanvasComponent
  - addRenderer
```
public void addRenderer(Renderer rend)
```
    add the renderer to the stack of renderers. It will be the last element drawn. This fires off an PropertyChangeEvent with the old and new arrays of renderers.
    
    Parameters:
    
    rend - the renderer
  - addRenderer
```
public void addRenderer(int index,
                        Renderer rend)
```
    add the renderer to the stack of renderers at the given index. Index 0 is drawn first. This will insert the renderer at the position. This fires off an PropertyChangeEvent with the old and new arrays of renderers.
    
    Parameters:
    
    index - the index, 0 is drawn first.
    
    rend - the renderer
  - removeRenderer
```
public void removeRenderer(Renderer rend)
```
    remove the renderer from the stack of renderers. A warning is logged if the renderer is not present. This fires off an PropertyChangeEvent with the old and new arrays of renderers.
    
    Parameters:
    
    rend - the renderer
  - contains
```
public boolean contains(int x,
                        int y)
```
    since the plotVisible property can be false and the plot having no renderers, we want the mouse events to pass on to elements below them.
    
    Overrides:
    
    contains in class javax.swing.JComponent
    
    Parameters:
    
    x - the mouse x
    
    y - the mouse y
    
    Returns:
    
    true if the plot "contains" this point.
  - containsRenderer
```
public boolean containsRenderer(Renderer rend)
```
    return true if the plot contains the renderer.
    
    Parameters:
    
    rend - the renderer
    
    Returns:
    
    true if the plot contains the renderer.
  - removeRenderers
```
public void removeRenderers()
```
    remove all the renderers from the dasPlot.
  - createDummyPlot
```
public static DasPlot createDummyPlot()
```
    provide convenient method for creating a plot. For example:
    DasCanvas c= new DasCanvas(400,400); DasPlot p= DasPlot.createDummyPlot( ); c.add(p,DasRow.create(c,0,1),DasColumn.create(c,0,1)); JOptionPane.showConfirmDialog(None,c)
    Returns:
    
    a DasPlot, reader to be added to a canvas.
  - createPlot
```
public static DasPlot createPlot(DatumRange xrange,
                                 DatumRange yrange)
```
    provide convenient method for creating a plot. For example:
    DasCanvas c= new DasCanvas(400,400); DasPlot p= DasPlot.createPlot( DatumRangeUtil.parseTimeRange('2001'),DatumRange.newDatumRange(0,10,Units.dimensionless) ); c.add(p,DasRow.create(c,0,1),DasColumn.create(c,0,1)); JOptionPane.showConfirmDialog(None,c)
    Parameters:
    
    xrange - the range for the x axis.
    
    yrange - the range for the y axis
    
    Returns:
    
    a DasPlot, reader to be added to a canvas.
  - getRenderer
```
public Renderer getRenderer(int index)
```
    return one of the renderers, which paint the data on to the plot.
    
    Parameters:
    
    index - the index of the renderer
    
    Returns:
    
    the renderer
  - getRenderers
```
public Renderer[] getRenderers()
```
    return a list of the renderers, which paint the data on to the plot. This makes a copy of the renderer array.
    
    Returns:
    
    the Renderer
  - getActiveRegion
```
public java.awt.Shape getActiveRegion()
```
    return a Shape containing the plot.
    
    Overrides:
    
    getActiveRegion in class DasCanvasComponent
    
    Returns:
    
    a shape containing the active plot.
  - coalesceEvents
```
protected java.awt.AWTEvent coalesceEvents(java.awt.AWTEvent existingEvent,
                                           java.awt.AWTEvent newEvent)
```
    Potentially coalesce an event being posted with an existing event. This method is called by EventQueue.postEvent if an event with the same ID as the event to be posted is found in the queue (both events must have this component as their source). This method either returns a coalesced event which replaces the existing event (and the new event is then discarded), or null to indicate that no combining should be done (add the second event to the end of the queue). Either event parameter may be modified and returned, as the other one is discarded unless null is returned.
    This implementation of coalesceEvents coalesces DasUpdateEvents, returning the existingEvent parameter
    
    Overrides:
    
    coalesceEvents in class DasCanvasComponent
    
    Parameters:
    
    existingEvent - the event already on the EventQueue
    
    newEvent - the event being posted to the EventQueue
    
    Returns:
    
    a coalesced event, or null indicating that no coalescing was done
  - processEvent
```
protected void processEvent(java.awt.AWTEvent e)
```
    Processes events occurring on this component. By default this method calls the appropriate process<event type>Event method for the given class of event.
    Note that if the event parameter is null the behavior is unspecified and may result in an exception.
    
    Overrides:
    
    processEvent in class DasCanvasComponent
    
    Parameters:
    
    e - the event
    
    See Also:
    
    Component.processComponentEvent(java.awt.event.ComponentEvent), Component.processFocusEvent(java.awt.event.FocusEvent), Component.processKeyEvent(java.awt.event.KeyEvent), Component.processMouseEvent(java.awt.event.MouseEvent), Component.processMouseMotionEvent(java.awt.event.MouseEvent), Component.processInputMethodEvent(java.awt.event.InputMethodEvent), Component.processHierarchyEvent(java.awt.event.HierarchyEvent), Component.processMouseWheelEvent(java.awt.event.MouseWheelEvent), DasCanvasComponent.processDasUpdateEvent(org.das2.event.DasUpdateEvent)
  - repaint
```
public void repaint()
```
    request that the plot be repainted. This contains commented code that counts the number of repaints.
    
    Overrides:
    
    repaint in class java.awt.Component
  - invalidateCacheImage
```
public void invalidateCacheImage()
```
    mark the dasPlot's cache image as invalid, forcing it to repaint.
  - invalidateCacheImageNoUpdate
```
public void invalidateCacheImageNoUpdate()
```
    mark the dasPlot's cache image as invalid, but from the update method, so we don't need to update. (Updating results in a loop.)
  - isCacheImageValid
```
public boolean isCacheImageValid()
```
    introduced to debug Autoplot test018. This should not be used otherwise.
    
    Returns:
    
    true if the cache image is marked as valid.
  - getLegendPosition
```
public LegendPosition getLegendPosition()
```
    Returns:
    
    the current legend position
    
    See Also:
    
    PROP_LEGENDPOSITION, LegendPosition
  - setLegendPosition
```
public void setLegendPosition(LegendPosition newlegendPosition)
```
    Parameters:
    
    newlegendPosition - the legend position
    
    See Also:
    
    PROP_LEGENDPOSITION
  - getLegendRelativeFontSize
```
public int getLegendRelativeFontSize()
```
    Returns:
    
    the current relative size of the legend in points.
    
    See Also:
    
    PROP_LEGENDRELATIVESIZESIZE
  - setLegendRelativeFontSize
```
public void setLegendRelativeFontSize(int size)
```
    set the relative size of the legend element text.
    
    Parameters:
    
    size - relative size in points.
    
    See Also:
    
    PROP_LEGENDRELATIVESIZESIZE
  - getLegendFontSize
```
public java.lang.String getLegendFontSize()
```
  - setLegendFontSize
```
public void setLegendFontSize(java.lang.String legendFontSize)
```
    set the font size for the legend, using the conventions where 1em is the parent's font size:
    - 1em same as plot font.
    - 2em twice plot font.
    - 1em+2pt two points bigger than plot font.
    Parameters:
    
    legendFontSize -
    
    See Also:
    
    setFontSize(java.lang.String)
  - getFontSize
```
public java.lang.String getFontSize()
```
  - setFontSize
```
public void setFontSize(java.lang.String fontSize)
```
    set the font size, with respect to the canvas font.
    
    Parameters:
    
    fontSize -
  - isDisplayLegend
```
public boolean isDisplayLegend()
```
    true if the legend should be displayed
    
    Returns:
    
    true if the legend should be displayed
  - setDisplayLegend
```
public void setDisplayLegend(boolean displayLegend)
```
    true if the legend should be displayed
    
    Parameters:
    
    displayLegend - true if the legend should be displayed
    
    See Also:
    
    drawLegend(java.awt.Graphics2D, java.util.List)
  - getDrawBackground
```
public java.awt.Color getDrawBackground()
```
    return the background color, where alpha=0 (transparent) means don't draw the background.
    
    Returns:
    
    the background color.
  - setDrawBackground
```
public void setDrawBackground(java.awt.Color drawBackground)
```
    if not transparent, draw this background first.
    
    Parameters:
    
    drawBackground - the background, or a color with no opacity (new Color(0,0,0,0)) to turn off.
  - getDrawGridColor
```
public java.awt.Color getDrawGridColor()
```
    Returns:
    
    the grid color
    
    See Also:
    
    PROP_DRAWGRIDCOLOR
  - setDrawGridColor
```
public void setDrawGridColor(java.awt.Color drawGridColor)
```
    if not transparent, draw the grid in this color. Otherwise the grid is drawn with the tick color.
    
    Parameters:
    
    drawGridColor - the color
  - isDrawGrid
```
public boolean isDrawGrid()
```
    Getter for property drawGrid. If true, faint grey lines continue the axis major ticks across the plot.
    
    Returns:
    
    Value of property drawGrid.
  - setDrawGrid
```
public void setDrawGrid(boolean drawGrid)
```
    Setter for property drawGrid. If true, faint grey lines continue the axis major ticks across the plot.
    
    Parameters:
    
    drawGrid - New value of property drawGrid.
  - isDrawMinorGrid
```
public boolean isDrawMinorGrid()
```
    Get the value of drawMinorGrid
    
    Returns:
    
    the value of drawMinorGrid
    
    See Also:
    
    PROP_DRAWMINORGRID
  - setDrawMinorGrid
```
public void setDrawMinorGrid(boolean newdrawMinorGrid)
```
    Set the value of drawMinorGrid
    
    Parameters:
    
    newdrawMinorGrid - new value of drawMinorGrid
  - isDrawGridOver
```
public boolean isDrawGridOver()
```
    Returns:
    
    true if the grid is on top of the data.
    
    See Also:
    
    PROP_DRAWGRIDOVER
  - setDrawGridOver
```
public void setDrawGridOver(boolean gridOver)
```
    Parameters:
    
    gridOver - if the grid is on top of the data.
    
    See Also:
    
    PROP_DRAWGRIDOVER
  - getLineThickness
```
public java.lang.String getLineThickness()
```
  - setLineThickness
```
public void setLineThickness(java.lang.String lineThickness)
```
    set the thickness of the lines drawn.
    
    Parameters:
    
    lineThickness -
  - setPreviewEnabled
```
public void setPreviewEnabled(boolean preview)
```
    if true then the data rendering will be scaled immediately to indicate axis state changes.
    
    Parameters:
    
    preview - true if preview should be enabled.
  - isPreviewEnabled
```
public boolean isPreviewEnabled()
```
    true if the data rendering will be scaled immediately to indicate axis state changes.
    
    Returns:
    
    true if preview is enabled.
  - setAxisPlotVisible
```
public void setAxisPlotVisible(boolean visible)
```
    set the visibility of both the plot and its x and y axes. Recently, setVisible(v) would do this, but it incorrectly couples the visible properties of the separate components.
    
    Parameters:
    
    visible - false if the x and y axes, and the plot is visisble.
  - isPlotVisible
```
public boolean isPlotVisible()
```
  - setPlotVisible
```
public void setPlotVisible(boolean plotVisible)
```
  - isOverSize
```
public boolean isOverSize()
```
    Returns:
    
    oversize property
    
    See Also:
    
    PROP_OVERSIZE
  - setOverSize
```
public void setOverSize(boolean overSize)
```
    Parameters:
    
    overSize - true means draw outside the axis bounds.
    
    See Also:
    
    PROP_OVERSIZE
  - isLongTitles
```
public boolean isLongTitles()
```
    long titles means it won't clip at the axis bounds, at the risk of affecting codes which expect the old boundaries.
    
    Returns:
    
    the longTitles property
  - setLongTitles
```
public void setLongTitles(boolean longTitles)
```
    long titles means it won't clip at the axis bounds, at the risk of affecting codes which expect the old boundaries.
    
    Parameters:
    
    longTitles -
  - setLogLevel
```
public void setLogLevel(java.util.logging.Level level)
```
    Parameters:
    
    level - where Level.INFO is the default.
    
    See Also:
    
    PROP_LOG_LEVEL
  - getLogLevel
```
public java.util.logging.Level getLogLevel()
```
    Returns:
    
    level
    
    See Also:
    
    PROP_LOG_LEVEL
  - getPrintingLogLevel
```
public java.util.logging.Level getPrintingLogLevel()
```
    Returns:
    
    the level
    
    See Also:
    
    PROP_PRINTINGLOGLEVEL
  - setPrintingLogLevel
```
public void setPrintingLogLevel(java.util.logging.Level printingLogLevel)
```
    Parameters:
    
    printingLogLevel - where Level.ALL is the default.
    
    See Also:
    
    PROP_PRINTINGLOGLEVEL
  - getLogTimeoutSec
```
public int getLogTimeoutSec()
```
    Returns:
    
    property value
    
    See Also:
    
    PROP_LOG_TIMEOUT_SEC
  - setLogTimeoutSec
```
public void setLogTimeoutSec(int logTimeoutSec)
```
    Parameters:
    
    logTimeoutSec - the property value
    
    See Also:
    
    PROP_LOG_TIMEOUT_SEC
  - isIsotropic
```
public boolean isIsotropic()
```
    Returns:
    
    property value
    
    See Also:
    
    PROP_ISOTROPIC
  - setIsotropic
```
public void setIsotropic(boolean isotropic)
```
    set the property value
    
    Parameters:
    
    isotropic - property value
    
    See Also:
    
    PROP_ISOTROPIC
  - getUpdateImageBounds
```
protected java.awt.Rectangle getUpdateImageBounds()
```
    returns the rectangle that renderers should paint so that when they are asked to render, they have everything pre-rendered. This is the same as the axis bounds them oversize is turned off. This returns a copy of the current bounds and may be modified by the client. However, this does have the side-effect of recalculating the internal bounds.
    
    Returns:
    
    the cache image bounds.
    
    See Also:
    
    which does not recalculate.
  - getCacheImageBounds
```
protected java.awt.Rectangle getCacheImageBounds()
```
    returns a copy of the position of the cacheImage in the canvas frame of reference.
    
    Returns:
    
    Rectangle
  - setCacheImageBounds
```
protected void setCacheImageBounds(java.awt.Rectangle cacheImageBounds)
```
    there's a deadlock that shows with test140 on ci-pw if this is synchronized.
    
    Parameters:
    
    cacheImageBounds -
    
    See Also:
    
    https://ci-pw.physics.uiowa.edu/job/autoplot-test140
  - getPaintCount
```
public int getPaintCount()
```
    get the diagnostic for the number of times the component was asked to paint itself since the last reset.
    
    Returns:
    
    the number of times the component has painted itself.
  - resetPaintCount
```
public void resetPaintCount()
```
    reset the paint counter.
  - setDrawDebugMessages
```
public void setDrawDebugMessages(boolean v)
```
    Parameters:
    
    v - true if the messages should be shown.
    
    See Also:
    
    PROP_DRAWDEBUGMESSAGES
  - isDrawDebugMessages
```
public boolean isDrawDebugMessages()
```
    Returns:
    
    true if the messages should be shown.
    
    See Also:
    
    PROP_DRAWDEBUGMESSAGES

Class DasPlot

Nested Class Summary

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

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

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

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

Field Summary

Fields inherited from class org.das2.graph.DasCanvasComponent

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

Constructor Summary

Method Summary

Methods inherited from class org.das2.graph.DasCanvasComponent

Methods inherited from class javax.swing.JComponent

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Field Detail

PROP_LEGEND_WIDTH_LIMIT_PX

PROP_TITLE

displayTitle

rebinListener

ticksListener

focusRenderer

PROP_FOCUSRENDERER

PROP_MULTILINETEXTALIGNMENT

DUMP_TO_FILE_ACTION

INFO

WARNING

SEVERE

PROP_DISPLAYTITLE

bottomDecorator

PROP_BOTTOMDECORATOR

topDecorator

PROP_TOPDECORATOR

PROP_CONTEXT

PROP_DISPLAY_CONTEXT

PROP_RENDERERS

PROP_LEGENDPOSITION

PROP_LEGENDRELATIVESIZESIZE

PROP_LEGENDFONTSIZE

PROP_FONTSIZE

PROP_DISPLAYLEGEND

PROP_DRAWBACKGROUND

PROP_DRAWGRIDCOLOR

PROP_DRAWGRID

PROP_DRAWMINORGRID

PROP_DRAWGRIDOVER

PROP_LINETHICKNESS

PROP_PLOTVISIBLE

PROP_OVERSIZE

PROP_LONGTITLES

PROP_LOG_LEVEL

PROP_PRINTINGLOGLEVEL

PROP_LOG_TIMEOUT_SEC

PROP_ISOTROPIC

PROP_DRAWDEBUGMESSAGES

Constructor Detail

DasPlot

Method Detail

getCustomizerKeys

addCustomizer

getCustomizer

removeCustomizer

getLegendWidthLimitPx

setLegendWidthLimitPx

getFocusRenderer

setFocusRenderer

getMultiLineTextAlignment

setMultiLineTextAlignment

findRendererAt

setXAxis

setYAxis

updateImmediately

getAffineTransform

printComponent

getAxisClip

paintComponent

setEnableRenderPropertiesAction