ilog.views.chart.renderer

Class IlvSingleChartRenderer

java.lang.Object

ilog.views.chart.IlvChartRenderer

ilog.views.chart.renderer.IlvSingleChartRenderer

All Implemented Interfaces:

IlvChartAreaAccessible, IlvChart3DSupport, Serializable

Direct Known Subclasses:

IlvSingleBarRenderer, IlvSingleHiLoRenderer, IlvSinglePieRenderer, IlvSinglePolylineRenderer, IlvSingleScatterRenderer

public abstract class IlvSingleChartRenderer
extends IlvChartRenderer

The IlvSingleChartRenderer class is the base class for elementary renderers. The subclasses of IlvSingleChartRenderer implement the drawing of a given rendering type. Single renderers usually have a composite counterpart (subclass of IlvCompositeChartRenderer), which is used to display several data sets. For example, IlvSingleBarRenderer renders a single data set with bars, while IlvBarChartRenderer uses instances of this elementary renderer to display the contents of a data source.

Since:

JViews 5.0

See Also:

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

Modifier	Constructor and Description
protected	IlvSingleChartRenderer() Creates a new IlvSingleChartRenderer with a default style.
protected	IlvSingleChartRenderer(IlvStyle style) Creates a new IlvSingleChartRenderer with the specified style.

Method Summary

Modifier and Type	Method and Description
void	addImageMapAreas(IlvIMapDefinition mapDef, List<? super IlvIMapArea> areaList) Generates image map areas.
void	applyDataSetStyle(ilog.views.chart.styling.IlvDataSetStyle dataSetStyle) Applies the styles for a data set.
void	applyStyles(boolean newStyles) Applies styling to the renderer.
protected void	chartConnected(IlvChart oldChart, IlvChart newChart) Called when the renderer is added to or removed from a chart.
IlvLegendItem[]	createLegendItems() Creates the legend item instances associated to this renderer.
void	dataSetContentsChanged(DataSetContentsEvent event) Called when the content of the associated data set is modified.
void	dataSetPropertyChanged(DataSetPropertyEvent event) Called when a property of the associated data set has been changed.
protected void	dataSetsAdded(int firstIdx, int lastIdx, IlvDataSet[] oldDataSets) Called when data sets are connected to this renderer.
protected void	dataSetsRemoved(int firstIdx, int lastIdx, IlvDataSet[] oldDataSets) Called when data sets are disconnected from this renderer.
void	draw(Graphics dst) Draws the renderer using the specified Graphics.
void	draw(Graphics dst, IlvDataSet dataSet, int iMin, int iMax) Deprecated. This method is not used by JViews.
void	drawAnnotations(Graphics dst) Draws the annotations of the renderer using the specified Graphics.
void	drawIntoHitmap(IlvChartHitmapDefinition definition, IlvChartHitmapAccumulator accumulator) Draws the rendering into a hitmap.
void	drawLegendSymbol(IlvLegendItem item, Graphics g, int x, int y, int w, int h) Draws the symbol of the given legend item.
void	drawSelectionHandles(Graphics g, IlvHandlesSelectionStyle style) Draws this renderer with selection handles.
void	drawSelectionHandles(Graphics g, IlvHandlesSelectionStyle style, IlvDataSet dataSet) Draws a data set with selection handles.
IlvDataAnnotation	getAnnotation(IlvDataSet dataSet, int idx) Returns the annotation of the specified data point.
Rectangle2D	getBounds(IlvDataSet dataSet, int iMin, int iMax, Rectangle2D bounds, boolean includeAnnotations) Returns the bounds of the graphical representation for the specified data.
Rectangle2D	getBounds(Rectangle2D bounds, boolean includeAnnotations) Returns the bounds of the graphical representation for the visible data.
String	getDefaultLegendText() Returns a default legend text for this renderer.
IlvDisplayPoint	getDisplayItem(IlvChartDataPicker picker) Returns the display item containing the specified picking point.
IlvDisplayPoint	getDisplayPoint(IlvDataSet dataSet, int dataIdx) Returns the display point corresponding to the specified data point.
IlvStyle	getDisplayStyle(int index) Returns the style used to display the specified data point.
String	getLegendText(IlvLegendItem item) Returns the label of the specified legend item.
IlvDisplayPoint	getNearestItem(IlvChartDataPicker picker, double[] distanceResult) Returns the display item closest to the picking point defined by the specified data picker.
IlvDisplayPoint	getNearestPoint(IlvChartDataPicker picker) Returns the data point closest to the specified projected coordinates.
Insets	getPreferredMargins() Returns the preferred margins of this renderer for the calculation of the plotting rectangle.
IlvDataRenderingHint	getRenderingHint(IlvDataSet dataSet) Returns the rendering hint that was specified globally for all the points of the given data set.
IlvDataRenderingHint	getRenderingHint(IlvDataSet dataSet, int idx) Returns the rendering hint of the specified data point.
IlvStyle	getStyle() Returns the main style used by this renderer.
IlvStyle	getStyle(IlvDataSet dataSet, int index) Returns the style used to display the specified data point.
IlvStyle[]	getStyles() Returns the styles used by this renderer.
IlvDataInterval	getXRange(IlvDataInterval retRange) Returns the range of the x-values displayed by this renderer.
IlvDataInterval	getYRange(IlvDataInterval retRange) Returns the range of the y-values displayed by this renderer.
IlvDataInterval	getYRange(IlvDataInterval xRange, IlvDataInterval retRange) Returns the range of the y-values displayed by this renderer within the specified X interval.
String	getZAnnotationText() Returns the text displayed along the depth axis of a 3-D chart.
boolean	holdsAnnotations() Returns true if some annotations are defined for some data sets, data points, or data objects, in this renderer.
boolean	isFilled() Indicates whether the renderer uses a fill color.
protected IlvStyle	makeDefaultStyle() Creates a default style for this renderer.
protected void	set3D(boolean is3D) Invoked by the chart when 3-D rendering is toggled.
void	setAnnotation(IlvDataSet dataSet, IlvDataAnnotation annotation) Sets an annotation on all the data points of the specified data set.
void	setAnnotation(IlvDataSet dataSet, int idx, IlvDataAnnotation annotation) Sets an annotation on the specified data point.
void	setDataPoint(IlvDataSet dataSet, int dataIndex, double xData, double yData) Changes the value of a data point.
void	setDisplayPoint(IlvDataSet dataSet, int dataIndex, double xCoord, double yCoord) Changes the value of a data point according to the specified projected coordinates.
void	setRenderingHint(IlvDataSet dataSet, IlvDataRenderingHint hint) Specifies a rendering hint for all the data points of a data set.
void	setRenderingHint(IlvDataSet dataSet, int idx, IlvDataRenderingHint hint) Specifies a rendering hint for a data point.
void	setStyle(IlvStyle style) Sets the style used by this renderer.
void	setStyles(IlvStyle[] styles) Sets the styles used by this renderer.
void	toDisplay(IlvDoublePoints pts) Projects points using this renderer coordinate system and projector area.
void	toDisplay(IlvDoublePoints pts, IlvChartProjector proj, Rectangle plotRect, IlvCoordinateSystem coordSys) Projects points using this renderer coordinate system and projector area.

Methods inherited from class ilog.views.chart.IlvChartRenderer

applyStyles, applyStyles, collectDisplayItems, computeDataLabel, computeDataLabelLocation, create, createRenderer, dataSetsChangesBatchEnding, dataSetsChangesBatchStarting, dispose, drawSelectionHandles, drawSelectionHandles, endRendererChanges, findAppropriateColor, fireTreemapFocusEvent, getAnnotation, getBounds, getChart, getChild, getChildCount, getChildIterator, getChildren, getClipRect, 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, reDraw, register, setAnnotation, setDataLabeling, setDataLabelLayout, setDataLabelling, setDataSource, setName, setParent, setRenderingHint, setRenderingHintWithNoDraw, 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

IlvSingleChartRenderer

protected IlvSingleChartRenderer()

Creates a new IlvSingleChartRenderer with a default style.

IlvSingleChartRenderer

protected IlvSingleChartRenderer(IlvStyle style)

Creates a new IlvSingleChartRenderer with the specified style.

Method Detail

isFilled

public boolean isFilled()

Indicates whether the renderer uses a fill color.

Returns:

true if the renderer uses a fill color, or false if it only uses a stroke color. The default implementation returns true.

Since:

JViews 5.5

setStyle

public void setStyle(IlvStyle style)

Sets the style used by this renderer. By default, the IlvSingleChartRenderer class makes use of a single style. If the parameter is null and the renderer has been attached to a chart, sets a default style.

Note: The Bean property style must not be specified together with the Bean property styles.

See Also:

getStyle()

getStyle

public IlvStyle getStyle()

Returns the main style used by this renderer.

See Also:

setStyle(ilog.views.chart.IlvStyle)

setStyles

public void setStyles(IlvStyle[] styles)

Sets the styles used by this renderer.

Specified by:

setStyles in class IlvChartRenderer

See Also:

Note: The Bean property styles must not be specified together with the Bean property style.

getStyles

public IlvStyle[] getStyles()

Returns the styles used by this renderer.

Specified by:

getStyles in class IlvChartRenderer

See Also:

getStyle()

chartConnected

protected void chartConnected(IlvChart oldChart,
                              IlvChart newChart)

Called when the renderer is added to or removed from a chart.

Overrides:

chartConnected in class IlvChartRenderer

Parameters:

oldChart - The chart which this renderer was associated to. This parameter is null if this renderer is added to a new chart.

newChart - The chart which this renderer is added to. This parameter is null if this renderer is removed from its current chart.

toDisplay

public void toDisplay(IlvDoublePoints pts)

Projects points using this renderer coordinate system and projector area.

Overrides:

toDisplay in class IlvChartRenderer

See Also:

IlvChart.toDisplay(IlvDoublePoints, int)

toDisplay

public void toDisplay(IlvDoublePoints pts,
                      IlvChartProjector proj,
                      Rectangle plotRect,
                      IlvCoordinateSystem coordSys)

Projects points using this renderer coordinate system and projector area. This is an optimized variant of toDisplay(IlvDoublePoints).

Overrides:

toDisplay in class IlvChartRenderer

Parameters:

pts - A sequence of points.

proj - A precomputed and cached value of chart.getProjector().

plotRect - The precomputed and cached value of getPlotRect().

coordSys - The precomputed and cached value of getCoordinateSystem().

Since:

JViews 8.5

set3D

protected void set3D(boolean is3D)

Invoked by the chart when 3-D rendering is toggled. This method can be overridden to add initialization or cleanup code.

Overrides:

set3D in class IlvChartRenderer

Parameters:

is3D - Indicates whether 3-D rendering is turned on or off.

Since:

JViews 5.5

getZAnnotationText

public String getZAnnotationText()

Returns the text displayed along the depth axis of a 3-D chart. The default implementation returns null.

Since:

JViews 5.5

See Also:

IlvChart3DView.setZAnnotationVisible(boolean)

draw

public void draw(Graphics dst)

Draws the renderer using the specified Graphics.

Specified by:

draw in class IlvChartRenderer

Parameters:

dst - The destination Graphics. May be null if the renderer is drawn in a 3D scene.

draw

@Deprecated
public void draw(Graphics dst,
                             IlvDataSet dataSet,
                             int iMin,
                             int iMax)

Deprecated. This method is not used by JViews.

Draws the specified data.

Specified by:

draw in class IlvChartRenderer

Deprecated Since:

JViews 8.1

getBounds

public Rectangle2D getBounds(Rectangle2D bounds,
                             boolean includeAnnotations)

Returns the bounds of the graphical representation for the visible data. If nothing is 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.

Specified by:

getBounds in class IlvChartRenderer

Parameters:

bounds - An optional rectangle used to store the result.

includeAnnotations - Indicates whether annotation bounds should be included.

Since:

JViews 8.7

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.

Specified by:

getBounds in class IlvChartRenderer

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.

drawSelectionHandles

public void drawSelectionHandles(Graphics g,
                                 IlvHandlesSelectionStyle style)

Draws this renderer with selection handles.

Specified by:

drawSelectionHandles in interface IlvChartAreaAccessible

Specified by:

drawSelectionHandles in class IlvChartRenderer

Parameters:

g - A graphics context.

style - The graphic style parameters.

Since:

JViews 8.8

drawSelectionHandles

public void drawSelectionHandles(Graphics g,
                                 IlvHandlesSelectionStyle style,
                                 IlvDataSet dataSet)

Draws a data set with selection handles.

Overrides:

drawSelectionHandles in class IlvChartRenderer

Parameters:

g - A graphics context.

style - The graphic style parameters.

dataSet - One of the data sets of this renderer's data source.

Since:

JViews 8.8

getNearestPoint

public IlvDisplayPoint getNearestPoint(IlvChartDataPicker picker)

Returns the data point closest to the specified projected coordinates. This method considers only the projected points, not the geometry of the renderer drawing.

Specified by:

getNearestPoint in class IlvChartRenderer

Parameters:

picker - The object holding the picking information.

Returns:

The nearest display point, or null if none was found.

See Also:

IlvChartRenderer.getNearestItem(IlvChartDataPicker, double[])

getNearestItem

public IlvDisplayPoint getNearestItem(IlvChartDataPicker picker,
                                      double[] distanceResult)

Returns the display item closest to the picking point defined by the specified data picker. Unlike the getNearestPoint(ilog.views.chart.IlvChartDataPicker) method, this method considers the geometry of the renderer drawing to compute the result. It also optionally returns the distance to the renderer drawing.

Specified by:

getNearestItem in class IlvChartRenderer

Parameters:

picker - The object holding the picking information.

distanceResult - If not null, this will be used to return the distance to the rendering of the item. You can pass null if you don't need this information.

Returns:

The nearest display point, or null if none was found.

Since:

JViews 8.5

See Also:

IlvChartRenderer.getNearestPoint(IlvChartDataPicker), IlvChartRenderer.getDisplayItem(IlvChartDataPicker)

getDisplayItem

public IlvDisplayPoint getDisplayItem(IlvChartDataPicker picker)

Returns the display item containing the specified picking point. Unlike the getNearestPoint(ilog.views.chart.IlvChartDataPicker) method, this method considers the geometry of the renderer drawing to compute the result. Unlike the getNearestItem(ilog.views.chart.IlvChartDataPicker, double[]) method, this method does not consider the picker's pick distance.

Specified by:

getDisplayItem in class IlvChartRenderer

Parameters:

picker - The object holding the picking information.

Returns:

The display point, or null if none was found.

See Also:

IlvChartRenderer.getNearestItem(IlvChartDataPicker, double[])

getDisplayPoint

public IlvDisplayPoint getDisplayPoint(IlvDataSet dataSet,
                                       int dataIdx)

Returns the display point corresponding to the specified data point.

Specified by:

getDisplayPoint in class IlvChartRenderer

setDisplayPoint

public void setDisplayPoint(IlvDataSet dataSet,
                            int dataIndex,
                            double xCoord,
                            double yCoord)

Changes the value of a data point according to the specified projected coordinates.

Specified by:

setDisplayPoint in class IlvChartRenderer

Parameters:

dataSet - The considered data set.

dataIndex - The index of the considered data point within the data set.

xCoord - The new x-coordinate of the projected point, as rendered by this renderer.

yCoord - The new y-coordinate of the projected point, as rendered by this renderer.

See Also:

IlvDisplayPoint.setCoords(int, int)

setDataPoint

public void setDataPoint(IlvDataSet dataSet,
                         int dataIndex,
                         double xData,
                         double yData)

Changes the value of a data point.

Overrides:

setDataPoint in class IlvChartRenderer

Parameters:

dataSet - The considered data set.

dataIndex - The index of the considered data point within the data set.

xData - The new x-value.

yData - The new y-value.

addImageMapAreas

public void addImageMapAreas(IlvIMapDefinition mapDef,
                             List<? super IlvIMapArea> areaList)

Generates image map areas.

Overrides:

addImageMapAreas in class IlvChartRenderer

Parameters:

mapDef - The map definition.

areaList - The list of map areas. The method must add instances of IlvIMapArea to this list.

drawIntoHitmap

public void drawIntoHitmap(IlvChartHitmapDefinition definition,
                           IlvChartHitmapAccumulator accumulator)

Draws the rendering into a hitmap.

Overrides:

drawIntoHitmap in class IlvChartRenderer

Parameters:

definition - The specification how to construct the hitmap.

accumulator - The object that accumulates objects in the hitmap.

Since:

JViews 8.7

See Also:

IlvChartHitmapDefinition.drawIntoHitmap(IlvChart, IlvChartRenderer, IlvChartHitmapAccumulator)

dataSetContentsChanged

public void dataSetContentsChanged(DataSetContentsEvent event)

Called when the content of the associated data set is modified.

See Also:

DataSetContentsEvent

dataSetPropertyChanged

public void dataSetPropertyChanged(DataSetPropertyEvent event)

Called when a property of the associated data set has been changed.

See Also:

DataSetPropertyEvent

dataSetsRemoved

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

Called when data sets are disconnected from this renderer.

Overrides:

dataSetsRemoved in class IlvChartRenderer

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.

dataSetsAdded

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

Called when data sets are connected to this renderer.

Overrides:

dataSetsAdded in class IlvChartRenderer

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.

getXRange

public IlvDataInterval getXRange(IlvDataInterval retRange)

Returns the range of the x-values displayed by this renderer. For a bar renderer or high-low renderer, the range takes into account the width of the bars.

Specified by:

getXRange in class IlvChartRenderer

Parameters:

retRange - An interval used to store the result. If this parameter is null, a new IlvDataInterval is allocated.

Returns:

The computed range.

getYRange

public IlvDataInterval getYRange(IlvDataInterval retRange)

Returns the range of the y-values displayed by this renderer.

Specified by:

getYRange in class IlvChartRenderer

Parameters:

retRange - An interval used to store the result. If this parameter is null, a new IlvDataInterval is allocated.

Returns:

The computed range.

getYRange

public IlvDataInterval getYRange(IlvDataInterval xRange,
                                 IlvDataInterval retRange)

Returns the range of the y-values displayed by this renderer within the specified X interval.

Specified by:

getYRange in class IlvChartRenderer

Parameters:

xRange - The X interval used to select the points.

retRange - An interval used to store the result. If this parameter is null, a new IlvDataInterval is allocated.

Returns:

The computed range.

getPreferredMargins

public Insets getPreferredMargins()

Returns the preferred margins of this renderer for the calculation of the plotting rectangle. The default implementation returns empty margins.

Overrides:

getPreferredMargins in class IlvChartRenderer

Returns:

The preferred margins.

See Also:

IlvChart.Area.getMargins()

makeDefaultStyle

protected IlvStyle makeDefaultStyle()

Creates a default style for this renderer.

drawLegendSymbol

public void drawLegendSymbol(IlvLegendItem item,
                             Graphics g,
                             int x,
                             int y,
                             int w,
                             int h)

Draws the symbol of the given legend item. This method is called by IlvRendererLegendItem instances to draw the item symbol. The default implementation draws a rectangle using the current renderer drawing style.

Specified by:

drawLegendSymbol in class IlvChartRenderer

Parameters:

item - The legend item to draw.

g - The graphics context.

x - The symbol x-coordinate.

y - The symbol y-coordinate.

w - The symbol width.

h - The symbol height.

See Also:

IlvRendererLegendItem

createLegendItems

public IlvLegendItem[] createLegendItems()

Creates the legend item instances associated to this renderer. This method is automatically called by the legend to populate itself. By default, creates an IlvRendererLegendItem instance initialized with the label returned by getLegendText(ilog.views.chart.IlvLegendItem).

Specified by:

createLegendItems in class IlvChartRenderer

Returns:

An array containing the legend item associated to this renderer, or null.

See Also:

IlvLegend, IlvLegendItem

getLegendText

public String getLegendText(IlvLegendItem item)

Returns the label of the specified legend item.

Overrides:

getLegendText in class IlvChartRenderer

Returns:

The string returned by the getDefaultLegendText() method.

getDefaultLegendText

public String getDefaultLegendText()

Returns a default legend text for this renderer.

Returns:

The name of this renderer if it is defined, or the name of the displayed data set.

Since:

JViews 5.5

drawAnnotations

public void drawAnnotations(Graphics dst)

Draws the annotations of the renderer using the specified Graphics.

Specified by:

drawAnnotations in class IlvChartRenderer

setAnnotation

public void setAnnotation(IlvDataSet dataSet,
                          int idx,
                          IlvDataAnnotation annotation)

Sets an annotation on the specified data point.

Specified by:

setAnnotation in class IlvChartRenderer

Parameters:

dataSet - The considered data set.

idx - The index of the considered point in the data set.

annotation - The new annotation, or null if the annotation associated with the specified point must be removed. If an annotation has already been specified globally with the IlvChartRenderer.setAnnotation(IlvDataSet, IlvDataAnnotation) method, it is overridden by this new annotation. In that case, a null value has no effect.

setAnnotation

public void setAnnotation(IlvDataSet dataSet,
                          IlvDataAnnotation annotation)

Sets an annotation on all the data points of the specified data set.

Specified by:

setAnnotation in class IlvChartRenderer

Parameters:

dataSet - The considered data set.

annotation - The new annotation, or null if the global annotation must be removed.

See Also:

IlvChartRenderer.setAnnotation(IlvDataAnnotation)

getAnnotation

public IlvDataAnnotation getAnnotation(IlvDataSet dataSet,
                                       int idx)

Returns the annotation of the specified data point.

Specified by:

getAnnotation in class IlvChartRenderer

Parameters:

dataSet - The considered data set.

idx - The index of the point within the data set.

Returns:

The annotation associated with the data point.

setRenderingHint

public void setRenderingHint(IlvDataSet dataSet,
                             int idx,
                             IlvDataRenderingHint hint)

Specifies a rendering hint for a data point.

Specified by:

setRenderingHint in class IlvChartRenderer

Parameters:

dataSet - The considered data set.

idx - The index of the considered point in the data set.

hint - The new rendering hint, or null if the hint associated with the specified point must be removed. If an hint has already been specified globally with the IlvChartRenderer.setRenderingHint(IlvDataSet, IlvDataRenderingHint)} method, it is overridden by this new hint. In that case, a null value has no effect.

setRenderingHint

public void setRenderingHint(IlvDataSet dataSet,
                             IlvDataRenderingHint hint)

Specifies a rendering hint for all the data points of a data set.

Specified by:

setRenderingHint in class IlvChartRenderer

Parameters:

dataSet - The considered data set.

hint - The new rendering hint, or null if the global hint must be removed.

getRenderingHint

public IlvDataRenderingHint getRenderingHint(IlvDataSet dataSet,
                                             int idx)

Returns the rendering hint of the specified data point.

Specified by:

getRenderingHint in class IlvChartRenderer

Parameters:

dataSet - The considered data set.

idx - The index of the point within the data set.

Returns:

The rendering hint associated with the data point, or null for none.

getRenderingHint

public IlvDataRenderingHint getRenderingHint(IlvDataSet dataSet)

Returns the rendering hint that was specified globally for all the points of the given data set.

Specified by:

getRenderingHint in class IlvChartRenderer

Parameters:

dataSet - The considered data set.

Returns:

The rendering hint associated with the data set, or null for none.

Since:

JViews 8.8

getStyle

public IlvStyle getStyle(IlvDataSet dataSet,
                         int index)

Returns the style used to display the specified data point.

Specified by:

getStyle in class IlvChartRenderer

Parameters:

dataSet - The considered data set.

index - The index of the considered data point.

Returns:

The style used to display the point, or null if this data point is not displayed by the renderer.

Since:

JViews 5.5

getDisplayStyle

public IlvStyle getDisplayStyle(int index)

Returns the style used to display the specified data point.

Parameters:

index - The index of the considered data point.

Returns:

The style used to display the point.

Since:

JViews 5.5

See Also:

getStyle(IlvDataSet, int)

holdsAnnotations

public boolean holdsAnnotations()

Returns true if some annotations are defined for some data sets, data points, or data objects, in this renderer.

Specified by:

holdsAnnotations in class IlvChartRenderer

applyStyles

public void applyStyles(boolean newStyles)
                 throws Exception

Applies styling to the renderer. Internal method.

Overrides:

applyStyles in class IlvChartRenderer

Throws:

Exception

Since:

JViews 5.5

Internal: do not use!

applyDataSetStyle

public void applyDataSetStyle(ilog.views.chart.styling.IlvDataSetStyle dataSetStyle)

Applies the styles for a data set. Internal method.

Since:

JViews 6.0

Internal: do not use!