Package 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, AWTSerieLegend, AWTSeriesLegend

public abstract class AWTLegend
extends AWTImageViewport
implements IDrawableListener, ILegend

A AWTLegend represent information concerning a Drawable that may be displayed as a metadata in the ChartView. ChartView renders legend on the right side of the chart, hence avoiding superposition of legend and chart. The constructor of a AWTLegend registers itself as listener of its parent Drawable, and unregister itself when it is disposed. When defining a concrete AWTLegend, one should:

• override the toImage(int,int) method, that defines the picture representation.
• override the drawableChanged(org.jzy3d.events.DrawableChangedEvent) 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

Nested Class Summary

Nested classes/interfaces inherited from class org.jzy3d.plot3d.rendering.view.AWTImageViewport

AWTImageViewport.ImageLayout

Field Summary

Fields

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

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

image, imageData, imageHeight, imageWidth, margin, pixelScale

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

applyWindowsHiDPIWorkaround, lastViewPort, mode, screenBottom, screenGridDisplayed, screenHeight, screenLeft, screenSquaredDim, screenWidth, screenXOffset, screenYOffset

Constructor Summary

Constructors

Constructor	Description
AWTLegend(Drawable drawable)
AWTLegend(Drawable drawable, Color foreground, Color background)

Method Summary

Modifier and Type	Method	Description
void	dispose()
void	drawableChanged(DrawableChangedEvent e)
Color	getBackground()
Color	getForeground()
Dimension	getMinimumDimension()	Return the minimum size for this graphic.
void	saveImage(String filename)
void	setBackground(Color background)
void	setForeground(Color foreground)
void	setGeneratorColors()
void	setMinimumDimension(Dimension dimension)	Deprecated.
void	setMinimumWidth(int minimumWidth)	Deprecated.
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

computeLayout, getImage, getMargin, getPixelScale, render, renderImage, setImage, setImage, setImage, setMargin, updatePixelScale

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

apply_WindowsHiDPI_Workaround, apply_WindowsHiDPI_Workaround, applyViewport, applyViewportRectangle, applyViewportSquared, getLastViewPort, getRectangle, getScreenBottom, getScreenHeight, getScreenLeft, getScreenWidth, getScreenXOffset, getScreenYOffset, getSliceWidth, getViewPort, getViewportMode, getWindowsHiDPIScale_Workaround, isApplyWindowsHiDPIWorkaround, isScreenGridDisplayed, renderSubScreenGrid, setApplyWindowsHiDPIWorkaround, setScreenGridDisplayed, setScreenXOffset, setScreenYOffset, 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, getPixelScale, getSliceWidth, getViewportMode, render, setViewPort, setViewPort, setViewportMode, updatePixelScale

Methods inherited from interface org.jzy3d.plot3d.rendering.legends.ILegend

getFont, getHeight, getMargin, getWidth, setFont, updateMinimumDimension

Field Details

drawable

protected Drawable drawable

foreground

protected Color foreground

background

protected Color background

minimumDimension

protected Dimension minimumDimension

imageGenerator

protected AWTImageGenerator imageGenerator

Constructor Details

AWTLegend

public AWTLegend(Drawable drawable)

AWTLegend

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

Method Details

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

getMinimumDimension

public Dimension getMinimumDimension()

Description copied from class: AWTImageViewport

Return the minimum size for this graphic.

Specified by:

getMinimumDimension in interface IImageViewport

Overrides:

getMinimumDimension in class AWTImageViewport

setMinimumDimension

@Deprecated
public void setMinimumDimension(Dimension dimension)

Deprecated.

Now overriden by automatic processing of minimum dimension

Parameters:

dimension -

setMinimumWidth

@Deprecated
public void setMinimumWidth(int minimumWidth)

Deprecated.

setGeneratorColors

public void setGeneratorColors()

getForeground

public Color getForeground()

setForeground

public void setForeground(Color foreground)

getBackground

public Color getBackground()

setBackground

public void setBackground(Color background)