org.jscience.awt
Class Graph2D

java.lang.Object
  java.awt.Component
      java.awt.Canvas
          org.jscience.awt.DoubleBufferedCanvas
              org.jscience.awt.Graph2D

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, GraphDataListener

Direct Known Subclasses:

LineGraph, ScatterGraph

public abstract class Graph2D
extends DoubleBufferedCanvas
implements GraphDataListener

The Graph2D superclass provides an abstract encapsulation of 2D graphs.

See Also:

Serialized Form

Nested Class Summary

static interface

Graph2D.DataMarker DOCUMENT ME!

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

java.awt.Canvas.AccessibleAWTCanvas

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

protected int	axisPad DOCUMENT ME!
protected Graph2D.DataMarker	dataMarker DOCUMENT ME!
protected boolean	gridLines DOCUMENT ME!
protected int	leftAxisPad DOCUMENT ME!
static int	LINEAR_SCALE DOCUMENT ME!
static int	LOG_SCALE DOCUMENT ME!
protected Graph2DModel	model Data model.
protected boolean	numbering Axis numbering.
protected java.awt.Point	origin Origin.
protected int	scalePad Padding.
protected java.awt.Color[]	seriesColor Series colors.
protected java.text.NumberFormat	xNumberFormat DOCUMENT ME!
protected java.text.NumberFormat	yNumberFormat DOCUMENT ME!

Fields inherited from class java.awt.Component

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

Graph2D(Graph2DModel gm)
Constructs a 2D graph.

Method Summary

void	dataChanged(GraphDataEvent e) Implementation of GraphDataListener.
protected java.awt.Point	dataToScreen(float x, float y) Converts a data point to screen coordinates.
protected void	drawAxes(java.awt.Graphics g) Draws the graph axes.
java.awt.Color	getColor(int n) Gets the color of the nth y-series.
java.awt.Dimension	getMinimumSize() Returns the minimum size of this component.
Graph2DModel	getModel() Returns the model used by this graph.
java.awt.Dimension	getPreferredSize() Returns the preferred size of this component.
protected void	offscreenPaint(java.awt.Graphics g) Paints the graph.
protected void	rescale() Rescales this graph.
protected java.awt.Point	scaledDataToScreen(float x, float y) Converts a scaled data point to screen coordinates.
protected java.awt.geom.Point2D.Float	screenToData(java.awt.Point p) Converts a screen point to data coordinates.
void	setBounds(int x, int y, int width, int height) Reshapes this graph to the specified bounding box.
void	setColor(int n, java.awt.Color c) Sets the color of the nth y-series.
void	setGridLines(boolean flag) Turns grid lines on/off.
void	setMarker(Graph2D.DataMarker marker) Sets the data marker used to draw data points.
void	setModel(Graph2DModel gm) Sets the data plotted by this graph to the specified data.
void	setNumberFormat(java.text.NumberFormat format) Sets the display format used for axis numbering.
void	setNumbering(boolean flag) Turns axis numbering on/off.
void	setXExtrema(float min, float max) Sets the minimum/maximum values on the x-axis.
void	setXExtrema(float min, float max, float growth) DOCUMENT ME!
void	setXIncrement(float dx) Sets the x-axis numbering increment.
void	setXNumberFormat(java.text.NumberFormat format) Sets the display format used for x-axis numbering.
void	setXScale(int t) Sets the x-axis scale type.
void	setYExtrema(float min, float max) Sets the minimum/maximum values on the y-axis.
void	setYExtrema(float min, float max, float growth) DOCUMENT ME!
void	setYIncrement(float dy) Sets the y-axis numbering increment.
void	setYNumberFormat(java.text.NumberFormat format) Sets the display format used for y-axis numbering.
void	setYScale(int t) Sets the y-axis scale type.

Methods inherited from class org.jscience.awt.DoubleBufferedCanvas

getOffscreenGraphics, paint, print, redraw, update

Methods inherited from class java.awt.Canvas

addNotify, createBufferStrategy, createBufferStrategy, getAccessibleContext, getBufferStrategy

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, validate

Methods inherited from class java.lang.Object

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

Field Detail

LINEAR_SCALE

public static final int LINEAR_SCALE

DOCUMENT ME!

See Also:

Constant Field Values

LOG_SCALE

public static final int LOG_SCALE

DOCUMENT ME!

See Also:

Constant Field Values

model

protected Graph2DModel model

Data model.

origin

protected java.awt.Point origin

Origin.

dataMarker

protected Graph2D.DataMarker dataMarker

DOCUMENT ME!

seriesColor

protected java.awt.Color[] seriesColor

Series colors.

numbering

protected boolean numbering

Axis numbering.

xNumberFormat

protected java.text.NumberFormat xNumberFormat

DOCUMENT ME!

yNumberFormat

protected java.text.NumberFormat yNumberFormat

DOCUMENT ME!

gridLines

protected boolean gridLines

DOCUMENT ME!

scalePad

protected final int scalePad

Padding.

See Also:

Constant Field Values

axisPad

protected final int axisPad

DOCUMENT ME!

See Also:

Constant Field Values

leftAxisPad

protected int leftAxisPad

DOCUMENT ME!

Constructor Detail

Graph2D

public Graph2D(Graph2DModel gm)

Constructs a 2D graph.

Parameters:

gm - DOCUMENT ME!

Method Detail

setModel

public final void setModel(Graph2DModel gm)

Sets the data plotted by this graph to the specified data.

Parameters:

gm - DOCUMENT ME!

getModel

public final Graph2DModel getModel()

Returns the model used by this graph.

Returns:

DOCUMENT ME!

dataChanged

public void dataChanged(GraphDataEvent e)

Implementation of GraphDataListener. Application code will not use this method explicitly, it is used internally.

Specified by:

dataChanged in interface GraphDataListener

Parameters:

e - DOCUMENT ME!

setNumbering

public final void setNumbering(boolean flag)

Turns axis numbering on/off. Default is on.

Parameters:

flag - DOCUMENT ME!

setNumberFormat

public final void setNumberFormat(java.text.NumberFormat format)

Sets the display format used for axis numbering. Convenience method.

Parameters:

format - DOCUMENT ME!

See Also:

setXNumberFormat(NumberFormat), setYNumberFormat(NumberFormat)

setXNumberFormat

public final void setXNumberFormat(java.text.NumberFormat format)

Sets the display format used for x-axis numbering.

Parameters:

format - DOCUMENT ME!

setYNumberFormat

public final void setYNumberFormat(java.text.NumberFormat format)

Sets the display format used for y-axis numbering.

Parameters:

format - DOCUMENT ME!

setGridLines

public final void setGridLines(boolean flag)

Turns grid lines on/off. Default is off.

Parameters:

flag - DOCUMENT ME!

setXScale

public final void setXScale(int t)

Sets the x-axis scale type.

Parameters:

t - a _SCALE constant.

setYScale

public final void setYScale(int t)

Sets the y-axis scale type.

Parameters:

t - a _SCALE constant.

setXIncrement

public final void setXIncrement(float dx)

Sets the x-axis numbering increment.

Parameters:

dx - use 0.0f for auto-adjusting (default).

Throws:

java.lang.IllegalArgumentException - DOCUMENT ME!

setYIncrement

public final void setYIncrement(float dy)

Sets the y-axis numbering increment.

Parameters:

dy - use 0.0f for auto-adjusting (default).

Throws:

java.lang.IllegalArgumentException - DOCUMENT ME!

setXExtrema

public final void setXExtrema(float min,
                              float max)

Sets the minimum/maximum values on the x-axis. Set both min and max to 0.0f for auto-adjusting (default).

Parameters:

min - DOCUMENT ME!

max - DOCUMENT ME!

Throws:

java.lang.IllegalArgumentException - DOCUMENT ME!

setXExtrema

public final void setXExtrema(float min,
                              float max,
                              float growth)

DOCUMENT ME!

Parameters:

min - DOCUMENT ME!

max - DOCUMENT ME!

growth - DOCUMENT ME!

setYExtrema

public final void setYExtrema(float min,
                              float max)

Sets the minimum/maximum values on the y-axis. Set both min and max to 0.0f for auto-adjusting (default).

Parameters:

min - DOCUMENT ME!

max - DOCUMENT ME!

Throws:

java.lang.IllegalArgumentException - DOCUMENT ME!

setYExtrema

public final void setYExtrema(float min,
                              float max,
                              float growth)

DOCUMENT ME!

Parameters:

min - DOCUMENT ME!

max - DOCUMENT ME!

growth - DOCUMENT ME!

setMarker

public final void setMarker(Graph2D.DataMarker marker)

Sets the data marker used to draw data points.

Parameters:

marker - DOCUMENT ME!

setColor

public final void setColor(int n,
                           java.awt.Color c)

Sets the color of the nth y-series.

Parameters:

n - the index of the y-series.

c - the line color.

getColor

public final java.awt.Color getColor(int n)

Gets the color of the nth y-series.

Parameters:

n - the index of the y-series.

Returns:

DOCUMENT ME!

setBounds

public final void setBounds(int x,
                            int y,
                            int width,
                            int height)

Reshapes this graph to the specified bounding box.

Overrides:

setBounds in class java.awt.Component

Parameters:

x - DOCUMENT ME!

y - DOCUMENT ME!

width - DOCUMENT ME!

height - DOCUMENT ME!

getPreferredSize

public java.awt.Dimension getPreferredSize()

Returns the preferred size of this component.

Overrides:

getPreferredSize in class java.awt.Component

Returns:

DOCUMENT ME!

getMinimumSize

public java.awt.Dimension getMinimumSize()

Returns the minimum size of this component.

Overrides:

getMinimumSize in class java.awt.Component

Returns:

DOCUMENT ME!

rescale

protected final void rescale()

Rescales this graph.

dataToScreen

protected final java.awt.Point dataToScreen(float x,
                                            float y)

Converts a data point to screen coordinates.

Parameters:

x - DOCUMENT ME!

y - DOCUMENT ME!

Returns:

DOCUMENT ME!

scaledDataToScreen

protected final java.awt.Point scaledDataToScreen(float x,
                                                  float y)

Converts a scaled data point to screen coordinates.

Parameters:

x - DOCUMENT ME!

y - DOCUMENT ME!

Returns:

DOCUMENT ME!

screenToData

protected final java.awt.geom.Point2D.Float screenToData(java.awt.Point p)

Converts a screen point to data coordinates.

Parameters:

p - DOCUMENT ME!

Returns:

DOCUMENT ME!

drawAxes

protected final void drawAxes(java.awt.Graphics g)

Draws the graph axes.

Parameters:

g - DOCUMENT ME!

offscreenPaint

protected void offscreenPaint(java.awt.Graphics g)

Paints the graph.

Specified by:

offscreenPaint in class DoubleBufferedCanvas

Parameters:

g - DOCUMENT ME!