org.mathIT.plot

Class ComplexPlotPane

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

org.mathIT.plot.ComplexPlotPane

All Implemented Interfaces:

ImageObserver, MenuContainer, Printable, Serializable, Accessible

public class ComplexPlotPane
extends JPanel
implements Printable

An object of this class is a canvas for plotting graphs of three-dimensional function. The variables used in this class are related to a given function f by:

z = f (x, y)

Version:

1.1

Author:

Andreas de Vries

See Also:

Serialized Form

Nested Class Summary

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

JPanel.AccessibleJPanel

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

Field Summary

Fields 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.print.Printable

NO_SUCH_PAGE, PAGE_EXISTS

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

Constructors

Constructor and Description
ComplexPlotPane(int width, int height, String[] functions, Color[] surfaceColor, byte[] lineStrength, double xmin, double xmax, double ymin, double ymax, double zmin, double zmax, boolean realPart, boolean imaginaryPart, boolean zAuto, boolean zRatio, boolean drawAxes, boolean drawGrid) Creates a new plot pane.

Method Summary

Modifier and Type	Method and Description
void	axes(Graphics g) Plots the axes of this graph.
void	computeValues() Computes all line values regarding the current parameter values.
void	drawAxes(Graphics2D g) Draws the axes of this plot.
void	line(Graphics g, double x1, double y1, double x2, double y2) Draws the line through the specified start and end coordinates projected onto the plot plane.
int	mapX(double x) Returns the projected value of the specified x value mapped onto this plot.
int	mapY(double y) Returns the projected value of the specified y value mapped onto this plot.
void	paint(Graphics g1)
double[]	pixelToV(int px, int py) Returns the projected coordinate values from the pixel values.
double	pixelToX(int px, int py) Returns the x-value corresponding to the pixels (px,py).
double	pixelToY(int px, int py) Returns the y-value corresponding to the pixels (px,py).
int	print(Graphics g, PageFormat pf, int pi)
void	rotate(double xAngle, double yAngle) Rotates the coordinate axes.
void	setAngles(double angleX, double angleY) Sets the rotation angles of this plot.
void	setBackground(Color color)
void	setDrawAxes(boolean drawAxes) Decides whether to draw the coordinate axes of this plot.
void	setImaginaryPart(boolean imaginaryPart) Decides whether the imaginary part of the function is plotted.
void	setLimits(double xmin, double xmax, double ymin, double ymax, double zmin, double zmax) Sets the limits for the values.
void	setRealPart(boolean realPart) Decides whether the real part of the function is plotted.
void	setVLimits(int vxmin, int vxmax, int vymin, int vymax) Sets the limit projected values.
void	startPrinterJob() Prints this plot.
double	vx(double x, double y, double z) Returns the projected value on the x axis given by the current rotation angles.
double	vy(double x, double y, double z) Returns the projected value on the y axis given by the current rotation angles.

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

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, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, 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, 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

Methods inherited from class java.awt.Container

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

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, 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, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

ComplexPlotPane

public ComplexPlotPane(int width,
                       int height,
                       String[] functions,
                       Color[] surfaceColor,
                       byte[] lineStrength,
                       double xmin,
                       double xmax,
                       double ymin,
                       double ymax,
                       double zmin,
                       double zmax,
                       boolean realPart,
                       boolean imaginaryPart,
                       boolean zAuto,
                       boolean zRatio,
                       boolean drawAxes,
                       boolean drawGrid)

Creates a new plot pane.

Parameters:

width - the width of this plot pane

height - the width of this plot pane

functions - an array of all functions to be plotted, given by strings parseable by FunctionParser.

surfaceColor - an array of colors for each function (i.e., surfaceColor.length = functions.length)

lineStrength - an array of line strengths in pixels for each function (i.e., lineStrength.length = functions.length); usually, the strength is a small positive integer

xmin - the minimum x-value to be plotted

xmax - the maximum x-value to be plotted

ymin - the minimum y-value to be plotted

ymax - the maximum y-value to be plotted

zmin - the minimum z-value to be plotted

zmax - the maximum z-value to be plotted

realPart - indicates whether the real part of f is to be plotted

imaginaryPart - indicates whether the imaginary part of f is to be plotted

zAuto - indicates whether the limits of z-values, given by z = f (x, y), are calculated automatically

zRatio - indicates whether the ratio z/x is one

drawAxes - indicates whether the axes are drawn

drawGrid - indicates whether the plot is marked with a grid

Method Detail

setBackground

public void setBackground(Color color)

Overrides:

setBackground in class JComponent

setDrawAxes

public void setDrawAxes(boolean drawAxes)

Decides whether to draw the coordinate axes of this plot.

Parameters:

drawAxes - flag indicating whether to draw the coordinate axes

setVLimits

public void setVLimits(int vxmin,
                       int vxmax,
                       int vymin,
                       int vymax)

Sets the limit projected values.

Parameters:

vxmin - minimum projected x-value

vxmax - maximum projected x-value

vymin - minimum projected y-value

vymax - maximum projected y-value

setAngles

public void setAngles(double angleX,
                      double angleY)

Sets the rotation angles of this plot.

Parameters:

angleX - the rotation angle of the x axis

angleY - the rotation angle of the y axis

setLimits

public void setLimits(double xmin,
                      double xmax,
                      double ymin,
                      double ymax,
                      double zmin,
                      double zmax)

Sets the limits for the values.

Parameters:

xmin - minimum x value

xmax - maximum x value

ymin - minimum y value

ymax - maximum y value

zmin - minimum z value

zmax - maximum z value

computeValues

public void computeValues()

Computes all line values regarding the current parameter values.

rotate

public void rotate(double xAngle,
                   double yAngle)

Rotates the coordinate axes.

Parameters:

xAngle - angle to rotate the x axis

yAngle - angle to rotate the y axis

setRealPart

public void setRealPart(boolean realPart)

Decides whether the real part of the function is plotted.

Parameters:

realPart - flag indicating whether the real part of the function is plotted

setImaginaryPart

public void setImaginaryPart(boolean imaginaryPart)

Decides whether the imaginary part of the function is plotted.

Parameters:

imaginaryPart - flag indicating whether the imaginary part of the function is plotted

paint

public void paint(Graphics g1)

Overrides:

paint in class JComponent

print

public int print(Graphics g,
                 PageFormat pf,
                 int pi)
          throws PrinterException

Specified by:

print in interface Printable

Throws:

PrinterException

startPrinterJob

public void startPrinterJob()

Prints this plot.

axes

public void axes(Graphics g)

Plots the axes of this graph.

Parameters:

g - the graphics object of this plot

vx

public double vx(double x,
                 double y,
                 double z)

Returns the projected value on the x axis given by the current rotation angles.

Parameters:

x - the x value

y - the y value

z - the z value

Returns:

the projected value on the x axis given by the current rotation angles

See Also:

setAngles(double, double)

vy

public double vy(double x,
                 double y,
                 double z)

Returns the projected value on the y axis given by the current rotation angles.

Parameters:

x - the x value

y - the y value

z - the z value

Returns:

the projected value on the y axis given by the current rotation angles

See Also:

setAngles(double, double)

mapX

public int mapX(double x)

Returns the projected value of the specified x value mapped onto this plot.

Parameters:

x - the x value

Returns:

the projected value of x

mapY

public int mapY(double y)

Returns the projected value of the specified y value mapped onto this plot.

Parameters:

y - the y value

Returns:

the projected value of y

pixelToX

public double pixelToX(int px,
                       int py)

Returns the x-value corresponding to the pixels (p_x,p_y). It uses the transformation

(x,y)^T = A^-1 [(p_x,p_y)^T - a]

where A is the rotation composed of the rotation with angleX around the screen x-axis and angleY around the screen y-axis, and a the (pixel) translation.

Parameters:

px - pixels p_x in x coordinate

py - pixels p_y in y coordinate

Returns:

x-value corresponding to (p_x,p_y)

pixelToY

public double pixelToY(int px,
                       int py)

Returns the y-value corresponding to the pixels (p_x,p_y).

Parameters:

px - pixels p_x in x coordinate

py - pixels p_y in y coordinate

Returns:

y-value corresponding to (p_x,p_y)

See Also:

pixelToX(int,int)

pixelToV

public double[] pixelToV(int px,
                         int py)

Returns the projected coordinate values from the pixel values.

Parameters:

px - the pixel value of x

py - the pixel value of y

Returns:

an array where the first entry is the projected x coordinate and the second entry the projected y coordinate

line

public void line(Graphics g,
                 double x1,
                 double y1,
                 double x2,
                 double y2)

Draws the line through the specified start and end coordinates projected onto the plot plane.

Parameters:

g - the graphics object of this plot

x1 - the x coordinate of the starting point

y1 - the y coordinate of the starting point

x2 - the x coordinate of the end point

y2 - the y coordinate of the end point

drawAxes

public void drawAxes(Graphics2D g)

Draws the axes of this plot.

Parameters:

g - the graphics object of this plot