org.das2.graph

Class RGBImageRenderer

java.lang.Object

org.das2.graph.Renderer

org.das2.graph.RGBImageRenderer

All Implemented Interfaces:

Displayable, Editable, DataSetConsumer

public class RGBImageRenderer
extends Renderer

Renders RBG images stored in a QDataSet[m,n,3], etc.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PROP_NEARESTNEIGHBORINTERPOLATION

Fields inherited from class org.das2.graph.Renderer

bottomDecorator, colorBar, control, CONTROL_KEY_COLOR, CONTROL_KEY_COLOR_TABLE, CONTROL_KEY_DRAW_ERROR, CONTROL_KEY_FILL_COLOR, CONTROL_KEY_FILL_DIRECTION, CONTROL_KEY_FILL_TEXTURE, CONTROL_KEY_FONT_SIZE, CONTROL_KEY_LINE_STYLE, CONTROL_KEY_LINE_THICK, CONTROL_KEY_MODULO_X, CONTROL_KEY_MODULO_Y, CONTROL_KEY_REFERENCE, CONTROL_KEY_SPECIAL_COLORS, CONTROL_KEY_SYMBOL, CONTROL_KEY_SYMBOL_SIZE, drawLegendLabel, ds, firstValidIndex, id, lastException, lastValidIndex, legendLabel, logger, MARKER_DATASET, MARKER_X_AXIS_RANGE, MARKER_Y_AXIS_RANGE, needWorkMarkers, PROP_ACTIVE, PROP_BOTTOMDECORATOR, PROP_COLORBAR, PROP_CONTROL, PROP_DRAWLEGENDLABEL, PROP_ID, PROP_LEGENDLABEL, PROP_RECORDFILE, PROP_TOPDECORATOR, propertyChangeSupport, renderException, topDecorator

Constructor Summary

Constructors

Constructor and Description
RGBImageRenderer()

Method Summary

Modifier and Type	Method and Description
boolean	acceptContext(int x, int y) Returns true if the render will accept the context for a point.
static boolean	acceptsData(QDataSet ds) accepts either rank2 data with grey scale 0-255, or rank3 (w,h,3 or 4)
static QDataSet	doAutorange(QDataSet ds) autorange on the data, returning a rank 2 bounds for the dataset.
java.lang.String	getControl() get the string which summarizes the state of the renderer.
javax.swing.Icon	getListIcon() An icon can be provided that will be shown in a list along with the textual description of the element.
protected void	installRenderer()
boolean	isNearestNeighborInterpolation()
void	render(java.awt.Graphics2D g, DasAxis xAxis, DasAxis yAxis) Render is called whenever the image needs to be refreshed or the content has changed.
java.awt.Shape	selectionArea()
void	setControl(java.lang.String s) set the control string which contains a number of properties.
void	setDataSet(QDataSet ds) Set the dataset to be plotted.
void	setNearestNeighborInterpolation(boolean nearestNeighborInterpolation)
protected void	uninstallRenderer()
void	updatePlotImage(DasAxis xAxis, DasAxis yAxis, ProgressMonitor monitor) this actually can take a little while, I discovered when playing with the wave-at-cassini image.

Methods inherited from class org.das2.graph.Renderer

acceptsDataSet, addPropertyChangeListener, addPropertyChangeListener, addToStats, decodeDatum, decodeFillStyle, decodePlotSymbolConnectorControl, decodePlotSymbolControl, drawListIcon, encodeBooleanControl, encodeColorControl, encodeDatum, encodeFillStyle, encodePlotSymbolConnectorControl, encodePlotSymbolControl, formatControl, getAffineTransform, getBooleanControl, getBottomDecorator, getColorBar, getColorControl, getConsumedDataSet, getControl, getDataLoader, getDataSet, getDataSetDescriptor, getDataSetID, getDatumControl, getDoubleArrayControl, getDoubleControl, getId, getIntegerControl, getInternalDataSet, getLastException, getLegendLabel, getListLabel, getParent, getRenderCount, getStatsFile, getTopDecorator, getUpdateCount, getXmemento, getYmemento, hasControl, incrementRenderCount, incrementUpdateCount, invalidateParentCacheImage, isActive, isDrawLegendLabel, isDumpDataSet, isTableDataSet, parseControl, parseLayoutString, postException, postMessage, postMessage, refresh, refreshImage, removePropertyChangeListener, removePropertyChangeListener, renderException, resetCounters, setActive, setBottomDecorator, setColorBar, setDataSetDescriptor, setDataSetID, setDataSetLoader, setDrawLegendLabel, setDumpDataSet, setException, setId, setLastException, setLegendLabel, setParent, setStatsFile, setTopDecorator, setUpFont, setUpFont, update, updateCacheImage, updateImmediately

Methods inherited from class java.lang.Object

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

Field Detail

PROP_NEARESTNEIGHBORINTERPOLATION

public static final java.lang.String PROP_NEARESTNEIGHBORINTERPOLATION

See Also:

Constant Field Values

Constructor Detail

RGBImageRenderer

public RGBImageRenderer()

Method Detail

setControl

public void setControl(java.lang.String s)

Description copied from class: Renderer

set the control string which contains a number of properties. These are defined for each renderer, but they should try to be consistent. See http://autoplot.org/developer.guessRenderType#Proposed_extensions When overriding this, be sure to call super.

Overrides:

setControl in class Renderer

Parameters:

s - the control

See Also:

etc

getControl

public java.lang.String getControl()

Description copied from class: Renderer

get the string which summarizes the state of the renderer. These allow a compact string to contain the renderer settings. This should be an ampersand-delimited list of name=value pairs.

Overrides:

getControl in class Renderer

Returns:

render

public void render(java.awt.Graphics2D g,
                   DasAxis xAxis,
                   DasAxis yAxis)

Description copied from class: Renderer

Render is called whenever the image needs to be refreshed or the content has changed. This operation should occur with an animation-interactive time scale, and an image should be cached when this is not possible. The graphics object will have its origin at the upper-left corner of the screen.

Specified by:

render in class Renderer

Parameters:

g - the graphics context in the canvas reference frame.

xAxis - the axis relating x data coordinates to horizontal pixel coordinates

yAxis - the axis relating y data coordinates to horizontal pixel coordinates

isNearestNeighborInterpolation

public boolean isNearestNeighborInterpolation()

setNearestNeighborInterpolation

public void setNearestNeighborInterpolation(boolean nearestNeighborInterpolation)

setDataSet

public void setDataSet(QDataSet ds)

Description copied from class: Renderer

Set the dataset to be plotted. Different renderers accept QDataSets with different schemes. For example SeriesRenderer takes: ds[t] rank 1 dataset with rank 1 DEPEND_0 or ds[t,n] rank 2 bundle dataset with X in ds[t,0] and Y in ds[t,n-1] and SpectrogramRenderer takes: ds[t,y] rank 2 table dataset ds[n,t,y] rank 3 dataset with the first dimension join See each renderer's documentation for the schemes it takes. Note the lastException property is cleared, even when the dataset is null.

Overrides:

setDataSet in class Renderer

installRenderer

protected void installRenderer()

Overrides:

installRenderer in class Renderer

uninstallRenderer

protected void uninstallRenderer()

Overrides:

uninstallRenderer in class Renderer

updatePlotImage

public void updatePlotImage(DasAxis xAxis,
                            DasAxis yAxis,
                            ProgressMonitor monitor)
                     throws DasException

this actually can take a little while, I discovered when playing with the wave-at-cassini image.

Overrides:

updatePlotImage in class Renderer

Parameters:

xAxis - the axis relating x data coordinates to horizontal pixel coordinates

yAxis - the axis relating y data coordinates to horizontal pixel coordinates

monitor - a monitor for the operation. Note the updatePlotImage operation should be fast (<1000ms).

Throws:

DasException

acceptsData

public static boolean acceptsData(QDataSet ds)

accepts either rank2 data with grey scale 0-255, or rank3 (w,h,3 or 4)

Parameters:

ds - the dataset

Returns:

true if the dataset is useful.

acceptContext

public boolean acceptContext(int x,
                             int y)

Description copied from class: Renderer

Returns true if the render will accept the context for a point. That is, the renderer affected that point, or nearby points. This is used currently to provide a way for the operator to click on a plot and directly edit the renderer which drew the pixel.

Overrides:

acceptContext in class Renderer

Parameters:

x - the x coordinate in the canvas coordinate system.

y - the y coordinate in the canvas coordinate system.

Returns:

true if the renderer will accept the context.

selectionArea

public java.awt.Shape selectionArea()

getListIcon

public javax.swing.Icon getListIcon()

Description copied from interface: Displayable

An icon can be provided that will be shown in a list along with the textual description of the element. This method should return null if there is no icon available, or a roughly 16x16 pixel icon.

Specified by:

getListIcon in interface Displayable

Overrides:

getListIcon in class Renderer

Returns:

the icon.

doAutorange

public static QDataSet doAutorange(QDataSet ds)

autorange on the data, returning a rank 2 bounds for the dataset.

Parameters:

ds - the dataset

Returns:

a bounding box

See Also:

Schemes.boundingBox()