org.jzy3d.plot3d.rendering.legends

Class AWTLegend

java.lang.Object

org.jzy3d.plot3d.rendering.view.AbstractViewportManager

org.jzy3d.plot3d.rendering.view.AWTImageViewport

org.jzy3d.plot3d.rendering.legends.AWTLegend

All Implemented Interfaces:

IDrawableListener, ILegend, IImageViewport

Direct Known Subclasses:

AWTColorbarLegend

public abstract class AWTLegend
extends AWTImageViewport
implements IDrawableListener, ILegend

A AWTLegend represent information concerning a AbstractDrawable that may be displayed as a metadata in the ChartView. The constructor of a AWTLegend registers itself as listener of its parent AbstractDrawable, and unregister itself when it is disposed. When defining a concrete AWTLegend, one should:

• override the toImage(int width, int height) method, that defines the picture representation.
• override the drawableChanged(DrawableChangedEvent e) method, that must select events that actually triggers an image update.

Last, a AWTLegend optimizes rendering by :

• storing current image dimension,
• computing a new image only if the required AWTLegend dimensions changed.

Author:

Martin Pernollet

Field Summary

Fields

Modifier and Type	Field and Description
protected Color	background
protected AbstractDrawable	drawable
protected Color	foreground
protected AWTImageGenerator	imageGenerator
protected Dimension	minimumDimension

Fields inherited from class org.jzy3d.plot3d.rendering.view.AWTImageViewport

imageHeight, imageObj, imageWidth

Fields inherited from class org.jzy3d.plot3d.rendering.view.AbstractViewportManager

lastViewPort, mode, ratioHeight, ratioWidth, screenBottom, screenGridDisplayed, screenHeight, screenLeft, screenSquaredDim, screenWidth, screenXOffset, screenYOffset

Constructor Summary

Constructors

Constructor and Description
AWTLegend(AbstractDrawable drawable)
AWTLegend(AbstractDrawable drawable, Color foreground, Color background)

Method Summary

Modifier and Type	Method and Description
void	dispose()
void	drawableChanged(DrawableChangedEvent e)
Color	getBackground()
Color	getForeground()
Dimension	getMinimumDimension()
Dimension	getMinimumSize() Return the minimum size for this graphic.
void	saveImage(String filename)
void	setBackground(Color background)
void	setForeground(Color foreground)
void	setGeneratorColors()
void	setMinimumDimension(Dimension minimumDimension)
void	setMinimumSize(Dimension dimension)
void	setViewPort(int width, int height, float left, float right) Defines viewport dimensions, and precompute an image if required (i.e. if the viewport dimension have changed
abstract BufferedImage	toImage(int width, int height)
void	updateImage() Recompute the picture, using last used dimensions.

Methods inherited from class org.jzy3d.plot3d.rendering.view.AWTImageViewport

getImage, getPreferedSize, render, setImage, setImage, setImage

Methods inherited from class org.jzy3d.plot3d.rendering.view.AbstractViewportManager

applyViewport, getLastViewPort, getMode, getRectangle, renderSubScreenGrid, setScreenGridDisplayed, setViewPort, setViewPort, setViewportMode

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jzy3d.plot3d.rendering.view.IImageViewport

getLastViewPort, getMode, getPreferedSize, render, setViewPort, setViewPort, setViewportMode

Field Detail

drawable

protected AbstractDrawable drawable

foreground

protected Color foreground

background

protected Color background

minimumDimension

protected Dimension minimumDimension

imageGenerator

protected AWTImageGenerator imageGenerator

Constructor Detail

AWTLegend

public AWTLegend(AbstractDrawable drawable)

AWTLegend

public AWTLegend(AbstractDrawable drawable,
                 Color foreground,
                 Color background)

Method Detail

dispose

public void dispose()

toImage

public abstract BufferedImage toImage(int width,
                                      int height)

setViewPort

public void setViewPort(int width,
                        int height,
                        float left,
                        float right)

Defines viewport dimensions, and precompute an image if required (i.e. if the viewport dimension have changed

Specified by:

setViewPort in interface IImageViewport

Overrides:

setViewPort in class AbstractViewportManager

Parameters:

width - the width of the target window.

height - the height of the target window.

left - the width's ratio where this subscreen starts in the target window.

right - the width's ratio where this subscreen stops in the target window.

drawableChanged

public void drawableChanged(DrawableChangedEvent e)

Specified by:

drawableChanged in interface IDrawableListener

Specified by:

drawableChanged in interface ILegend

updateImage

public void updateImage()

Description copied from interface: ILegend

Recompute the picture, using last used dimensions.

Specified by:

updateImage in interface ILegend

saveImage

public void saveImage(String filename)
               throws IOException

Throws:

IOException

getMinimumSize

public Dimension getMinimumSize()

Description copied from class: AWTImageViewport

Return the minimum size for this graphic.

Specified by:

getMinimumSize in interface IImageViewport

Overrides:

getMinimumSize in class AWTImageViewport

setMinimumSize

public void setMinimumSize(Dimension dimension)

setGeneratorColors

public void setGeneratorColors()

getForeground

public Color getForeground()

setForeground

public void setForeground(Color foreground)

getBackground

public Color getBackground()

setBackground

public void setBackground(Color background)

getMinimumDimension

public Dimension getMinimumDimension()

setMinimumDimension

public void setMinimumDimension(Dimension minimumDimension)