ilog.views.chart.renderer

Class IlvSingleBubbleRenderer

java.lang.Object

ilog.views.chart.IlvChartRenderer

ilog.views.chart.renderer.IlvSingleChartRenderer

ilog.views.chart.renderer.IlvSingleScatterRenderer

ilog.views.chart.renderer.IlvSingleBubbleRenderer

All Implemented Interfaces:

IlvChartAreaAccessible, IlvChart3DSupport, Serializable

public class IlvSingleBubbleRenderer
extends IlvSingleScatterRenderer

Renders two data sets with a bubble chart. A bubble chart helps you visualize two data sets:

• The first data set determines the location of the bubbles.
• The second data set determines the size of the bubbles.

Let min and max be the limits of the y-values stored in the size data set, and let yValue be the y-value of a point in this data set, the actual size of the bubble displaying this point will be:

 (maxSize-minSize) * (yValue-min)/(max-min) + minSize 

Where maxSize and minSize are specified by the setMaxSize(int) and setMinSize(int) methods respectively.

Since:

JViews 5.0

See Also:

IlvBubbleChartRenderer, Serialized Form

Field Summary

Fields inherited from class ilog.views.chart.IlvChartRenderer

AREA, BAR, BUBBLE, CANDLE, CENTERED_LABEL_LAYOUT, COMBO, DATA_LABEL, DEFAULT_LABEL_LAYOUT, DEFAULT_LABELING, HILO, HILO_ARROW, HILO_STICK, HLOC, OUTSIDE_LABEL_LAYOUT, PERCENT_LABEL, PIE, POLYLINE, SCATTER, STACKED_AREA, STACKED_BAR, STACKED_DIVERGING_BAR, STACKED_POLYLINE, STACKED_STAIR, STACKED100_AREA, STACKED100_BAR, STACKED100_POLYLINE, STACKED100_STAIR, STAIR, SUMMED_STAIR, SUPERIMPOSED_BAR, TREEMAP, X_VALUE_LABEL, XY_VALUES_LABEL, Y_VALUE_LABEL

Constructor Summary

Constructors

Constructor and Description
IlvSingleBubbleRenderer() Creates a new IlvSingleBubbleRenderer with a default bubble width and style.
IlvSingleBubbleRenderer(IlvMarker marker, int minSize, int maxSize, IlvStyle style) Creates a new IlvSingleBubbleRenderer with the specified bubble shape, size, and style.
IlvSingleBubbleRenderer(IlvStyle style) Creates a new IlvSingleBubbleRenderer with the specified style.

Method Summary

Modifier and Type	Method and Description
void	dataSetContentsChanged(DataSetContentsEvent event) Called when the contents of the associated data sets is modified.
protected void	dataSetsAdded(int firstIdx, int lastIdx, IlvDataSet[] oldDataSets) Called when data sets are connected to this renderer.
Rectangle2D	getBounds(IlvDataSet dataSet, int iMin, int iMax, Rectangle2D bounds, boolean includeAnnotations) Returns the bounds of the graphical representation for the specified data.
int	getMaxSize() Returns the maximum size of a bubble.
int	getMinSize() Returns the minimum size of a bubble.
protected boolean	isClipped() Indicates whether the drawing of this renderer is clipped by the plotting rectangle.
void	setMaxSize(int size) Sets the maximum size of a bubble.
void	setMinSize(int size) Sets the minimum size of a bubble.

Methods inherited from class ilog.views.chart.renderer.IlvSingleScatterRenderer

computeDataLabelLocation, drawLegendSymbol, getClipRect, getMarker, getMarkerSize, getPreferredMargins, setMarker, setMarkerSize

Methods inherited from class ilog.views.chart.renderer.IlvSingleChartRenderer

addImageMapAreas, applyDataSetStyle, applyStyles, chartConnected, createLegendItems, dataSetPropertyChanged, dataSetsRemoved, draw, draw, drawAnnotations, drawIntoHitmap, drawSelectionHandles, drawSelectionHandles, getAnnotation, getBounds, getDefaultLegendText, getDisplayItem, getDisplayPoint, getDisplayStyle, getLegendText, getNearestItem, getNearestPoint, getRenderingHint, getRenderingHint, getStyle, getStyle, getStyles, getXRange, getYRange, getYRange, getZAnnotationText, holdsAnnotations, isFilled, makeDefaultStyle, set3D, setAnnotation, setAnnotation, setDataPoint, setDisplayPoint, setRenderingHint, setRenderingHint, setStyle, setStyles, toDisplay, toDisplay

Methods inherited from class ilog.views.chart.IlvChartRenderer

applyStyles, applyStyles, collectDisplayItems, computeDataLabel, create, createRenderer, dataSetsChangesBatchEnding, dataSetsChangesBatchStarting, dispose, drawSelectionHandles, drawSelectionHandles, endRendererChanges, findAppropriateColor, fireTreemapFocusEvent, getAnnotation, getBounds, getChart, getChild, getChildCount, getChildIterator, getChildren, getCoordinateSystem, getDataLabeling, getDataLabelLayout, getDataLabelling, getDataSetIndex, getDataSetMainIndex, getDataSetMainRenderer, getDataSource, getDefaultColors, getDefaultLegendTitle, getDepths, getDisplayItem, getDisplayItems, getLegendStyle, getMinDataSetCount, getName, getNearestItem, getNearestPoint, getParent, getPlotRect, getRenderingHint, getStyle, getVirtualDataSet, getXShift, getYAxisIdx, has3DSupport, isDisplayingDataSet, isViewable, isVisible, isVisibleInLegend, register, setAnnotation, setDataLabeling, setDataLabelLayout, setDataLabelling, setDataSource, setName, setParent, setRenderingHint, setStyle, setVisible, setVisibleInLegend, setXShift, setYAxisIdx, startRendererChanges, toData, triggerChange

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvSingleBubbleRenderer

public IlvSingleBubbleRenderer()

Creates a new IlvSingleBubbleRenderer with a default bubble width and style.

IlvSingleBubbleRenderer

public IlvSingleBubbleRenderer(IlvStyle style)

Creates a new IlvSingleBubbleRenderer with the specified style.

IlvSingleBubbleRenderer

public IlvSingleBubbleRenderer(IlvMarker marker,
                               int minSize,
                               int maxSize,
                               IlvStyle style)

Creates a new IlvSingleBubbleRenderer with the specified bubble shape, size, and style.

Parameters:

marker - Specifies the shape of the bubbles.

minSize - The minimum size of a bubble.

maxSize - The maximum size of a bubble.

style - The rendering style.

Method Detail

getMinSize

public final int getMinSize()

Returns the minimum size of a bubble.

See Also:

setMinSize(int)

setMinSize

public void setMinSize(int size)

Sets the minimum size of a bubble.

See Also:

getMinSize(), setMaxSize(int)

getMaxSize

public final int getMaxSize()

Returns the maximum size of a bubble.

Overrides:

getMaxSize in class IlvSingleScatterRenderer

See Also:

setMaxSize(int)

setMaxSize

public void setMaxSize(int size)

Sets the maximum size of a bubble.

See Also:

getMaxSize(), setMinSize(int)

isClipped

protected boolean isClipped()

Indicates whether the drawing of this renderer is clipped by the plotting rectangle.

This method returns true.

Overrides:

isClipped in class IlvSingleScatterRenderer

dataSetsAdded

protected void dataSetsAdded(int firstIdx,
                             int lastIdx,
                             IlvDataSet[] oldDataSets)

Called when data sets are connected to this renderer.

Overrides:

dataSetsAdded in class IlvSingleChartRenderer

Parameters:

firstIdx - The index of the first data set.

lastIdx - The index of the last data set.

oldDataSets - The data sets previously connected to this renderer.

dataSetContentsChanged

public void dataSetContentsChanged(DataSetContentsEvent event)

Called when the contents of the associated data sets is modified.

Overrides:

dataSetContentsChanged in class IlvSingleChartRenderer

See Also:

DataSetContentsEvent

getBounds

public Rectangle2D getBounds(IlvDataSet dataSet,
                             int iMin,
                             int iMax,
                             Rectangle2D bounds,
                             boolean includeAnnotations)

Returns the bounds of the graphical representation for the specified data. If dataSet is not rendered by this renderer, an empty rectangle is returned. This method stores the result into bounds and returns bounds. If bounds is null, a new Rectangle2D is allocated.

Note that the bounds may be larger than necessary. There is no guarantee that the bounds returned are tight.

Note about multi-threading: This method must not take the Swing tree lock, and must not access IlvChart API that is not multithread-safe.

Overrides:

getBounds in class IlvSingleChartRenderer

Parameters:

dataSet - The data set containing the data points.

iMin - The minimum data point index.

iMax - The maximum data point index.

bounds - An optional rectangle used to store the result.

includeAnnotations - Indicates whether annotation bounds should be included.