All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class edu.wpi.mqp.graphics.jviz.ParallelCoordinatesGraph

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.Container
                   |
                   +----com.sun.java.swing.JComponent
                           |
                           +----edu.wpi.mqp.graphics.jviz.ParallelCoordinatesGraph

public class ParallelCoordinatesGraph

extends JComponent

implements Cloneable, Serializable, JVizInterface

Version:

1.0

Author:

Matthew C. Jucius

activeDimensions

brush

colorManager

componentHeight

componentWidth

ctrlDown

data

dragBrushDimension

dragBrushEnd

dragBrushStart

graphImage

min

modified

popup

scale

screenSize

shiftDown

xMargin

xVals

yMargin

yVals

zoomFactor

ParallelCoordinatesGraph(Data, Brush, ColorManager)

Constructor

addNotify()

This method is called by the GUI before paint is first called.

getImage()

This method will return the image that is being drawn to.

getXMargin()

This method gets the amount of margin to place on the left and right side of the graph.

getYMargin()

This method returns the number of pixels of padding to place on the top and bottom of the graph.

getZoomFactor()

This method returns the zoom factor of this graph.

paint(Graphics)

This method overrides the paint() method in JComponent.

printScreen(JFrame)

This method, which is part of the JVizInterface interface, will print this graph to a printer.

processMouseEvent(MouseEvent)

This method handles all the mouse clicks and other mouse events.

processMouseMotionEvent(MouseEvent)

This method overrides the processMouseMotionEvent method in JComponent.

setGraphModified()

This method allows calling calling classes to make sure the graph is redrawn from scratch on the next call to paint()

setNewBrushValue(int, int)

This method will reshape the brush if the x coordinate is on a dimension.

setXMargin(int)

This method sets the amount of margin to place on the left and right sides of the graph to prevent crowding.

setYMargin(int)

This method sets the number of pixels of padding to place on the top and bottom of the graph.

setZoomFactor(double)

This method sets the zoom factor to the value specified and then changes the modified bit so that the graph will be redrawn the next time the paint() method is called.

updateCoordinates()

This method forms an array of the y coordinates to use to graph each data point.

 protected int xMargin

 protected int yMargin

 protected int componentHeight

 protected int componentWidth

 protected double zoomFactor

 protected int xVals[]

 protected int yVals[][]

 protected double scale[]

 protected double min[]

 protected int activeDimensions[]

 protected Dimension screenSize

 protected Data data

 protected Brush brush

 protected ColorManager colorManager

 protected Image graphImage

 protected boolean modified

 protected boolean shiftDown

 protected boolean ctrlDown

 protected int dragBrushDimension

 protected double dragBrushStart

 protected double dragBrushEnd

 protected JPopupMenu popup

 public ParallelCoordinatesGraph(Data newData,
                                 Brush newBrush,
                                 ColorManager newColorManager)

Constructor

Parameters:

newData - data to graph

newBrush - brush to use with the data

newColorManager - object to request colors from when graphing

 public void processMouseMotionEvent(MouseEvent e)

This method overrides the processMouseMotionEvent method in JComponent. It monitors where the mouse pointer is. If it moves over one of the parallel vertical lines denoting a dimension, it will determine whether the brush will be resized larger or smaller if clicked. It changes the pointer to point up if the upper bounds of the brush will be changed or changes the pointer to point down if the lower bounds of the brush will be changed. This is to add a little more feedback for the user. Also, it is not a detriment to performance.

Parameters:

e - MouseEvent object passed to this function by the GUI.

Overrides:

processMouseMotionEvent in class JComponent

 public void processMouseEvent(MouseEvent e)

This method handles all the mouse clicks and other mouse events. If the mouse popup trigger is pressed, then the popup menu is formed and displayed It was in this method that we found the only problem/difference between the Unix versions of JViz and the Windows based version. In Unix, when the right mouse button is clicked, the only event we get is the popup trigger. In windows, we get a button click and a popup trigger event. This means, if the right mouse button is clicked while it is on one of the dimensions, the brush will change, then the popup menu will chenge. We had a test to get around this problem, but that caused problem in the UNIX environment, so it was removed. There may be a way to get around this problem, but we could not figure it out. It would be quite valuable to do this. This method also handles direct maninipulation of the brush using mouse clicks, the shift key, and also the control key.

Parameters:

e - MouseEvent passed by the GUI

Overrides:

processMouseEvent in class Component

 public boolean setNewBrushValue(int x,
                                 int y)

This method will reshape the brush if the x coordinate is on a dimension. It will change the brush to what the y coordinate represents in the scale. If the y coordinate is above the center of the brush, then the max boundary will be change. If it is below the center, then the minimum value will be changed. If the X coordinate is not on a dimension, none of the values are changed.

Parameters:

x - X-coordinate where mouse pointer clicked

y - Y-coordinate where mouse pointer clicked

Returns:

true if successfully changed

 public boolean printScreen(JFrame frame)

This method, which is part of the JVizInterface interface, will print this graph to a printer. Printing in Java redirects what is called in the paint() method to a printer. It will even print in color. NOTE - Currently this will print out a different sized graph depending on what the screen resolution of the monitor is since we use that to determine how big to make the on-screen image. It currently resizes the image to 50% and prints that out. It should be small enough to fit on paper, even if you are working at a higher resolution. There is a way to determine what the printer resolution is. Future versions could use this information to be more flexible with the printing options.

Parameters:

frame - parent frame

 public void setGraphModified()

This method allows calling calling classes to make sure the graph is redrawn from scratch on the next call to paint()

 public void updateCoordinates()

This method forms an array of the y coordinates to use to graph each data point. All of the x coordinates are the same for each dimension, but the y coordinates the only thing that change. This method gets called whenever the image needs to be redrawn. The method also determines the x coordinates for all the dimenions. These functions make calls to draw the lines quite neat.

 public void paint(Graphics g)

This method overrides the paint() method in JComponent. It draws the graph on the screen.

Parameters:

g - Graphics object passed by the GUI

Overrides:

paint in class JComponent

 public int getXMargin()

This method gets the amount of margin to place on the left and right side of the graph. This is so lines aren't drawn the extreme edges of the graphs. By default, it is set to 15 pixels

Returns:

number of pixels for the x margin

 public boolean setXMargin(int newXMargin)

This method sets the amount of margin to place on the left and right sides of the graph to prevent crowding. By default this value is 15 pixels

Parameters:

newXMargin - number of pixels to assign to xMargin

Returns:

true if successful in changing value

 public int getYMargin()

This method returns the number of pixels of padding to place on the top and bottom of the graph. The default value is 15 pixels.

Returns:

number of pixels of padding to place on the top and bottom of the graph.

 public boolean setYMargin(int newYMargin)

This method sets the number of pixels of padding to place on the top and bottom of the graph. The default vaule is 15 pixels.

Parameters:

newYMargin - number of pixels to assign to yMargin

Returns:

true if successfully set y Margin.

 public double getZoomFactor()

This method returns the zoom factor of this graph. The zoom factor is the decimal representation of the percentage of zoom. To display the graph at half size, the zoom factor would be .5. 1 is 100%, or full size.

Returns:

zoom factor as a double

 public boolean setZoomFactor(double newZoomFactor)

This method sets the zoom factor to the value specified and then changes the modified bit so that the graph will be redrawn the next time the paint() method is called. If the zoom factor is too high, the image needed for drawing the graph may need more memory than is available, so we catch that exception. We may want to pop up a dialog box in the future or handle this more gracefully/efficiently.

Parameters:

newZoomFactor - new zoom factor for the graph

Returns:

true if new zoomfactor is greater than 0

 public void addNotify()

This method is called by the GUI before paint is first called. We override it and add functionality to the default action. This is where we initially create the image to paint on. We could not create the image in the constructor.

Overrides:

addNotify in class JComponent

 public Image getImage()

This method will return the image that is being drawn to.

All Packages  Class Hierarchy  This Package  Previous  Next  Index