IlvChartRenderer (Rogue Wave JViews 9.2 API)

java.lang.Object
- ilog.views.chart.IlvChartRenderer

All Implemented Interfaces:

IlvChartAreaAccessible, IlvChart3DSupport, Serializable

Direct Known Subclasses:

IlvCompositeChartRenderer, IlvSimpleChartRenderer, IlvSingleChartRenderer
```
public abstract class IlvChartRenderer
extends Object
implements IlvChart3DSupport, IlvChartAreaAccessible, Serializable
```
Base class for objects that render data sets. An IlvChartRenderer object is responsible for displaying one or several data sets according to its rendering type. The IlvChartRenderer instances can be added to a chart with the following method: IlvChart.addRenderer(IlvChartRenderer).

Since:

JViews 5.0

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`AREA` Area chart renderer type.
`static int`	`BAR` Bar chart renderer type.
`static int`	`BUBBLE` Bubble chart renderer type.
`static int`	`CANDLE` Candle chart renderer type.
`static int`	`CENTERED_LABEL_LAYOUT` Enum constant for label layout: specifies that the data label is centered on the graphical representation of the data point.
`static int`	`COMBO` Combo chart renderer type.
`static int`	`DATA_LABEL` Enum constant for labeling mode: specifies that the label of the data point should be displayed.
`static int`	`DEFAULT_LABEL_LAYOUT` The default label layout.
`static int`	`DEFAULT_LABELING` The default labeling mode.
`static int`	`HILO` HiLo chart renderer type.
`static int`	`HILO_ARROW` Clustered HiLo Arrow chart renderer type.
`static int`	`HILO_STICK` Clustered HiLo Stick chart renderer type.
`static int`	`HLOC` HighLow-OpenClose chart renderer type.
`static int`	`OUTSIDE_LABEL_LAYOUT` Enum constant for label layout: specifies that the data label is drawn outside of the graphical representation of the data point.
`static int`	`PERCENT_LABEL` Enum constant for labeling mode: specifies that the percent contribution of the data point should be displayed.
`static int`	`PIE` Pie chart renderer type.
`static int`	`POLYLINE` Polyline chart renderer type.
`static int`	`SCATTER` Scatter chart renderer type.
`static int`	`STACKED_AREA` Stacked area chart renderer type.
`static int`	`STACKED_BAR` Stacked bar chart renderer type.
`static int`	`STACKED_DIVERGING_BAR` Stacked diverging bar chart renderer type.
`static int`	`STACKED_POLYLINE` Stacked polyline chart renderer type.
`static int`	`STACKED_STAIR` Stacked stair chart renderer type.
`static int`	`STACKED100_AREA` Stacked100 area chart renderer type.
`static int`	`STACKED100_BAR` Stacked100 bar chart renderer type.
`static int`	`STACKED100_POLYLINE` Stacked100 polyline chart renderer type.
`static int`	`STACKED100_STAIR` Stacked100 stair chart renderer type.
`static int`	`STAIR` Stair chart renderer type.
`static int`	`SUMMED_STAIR` Summed stair chart renderer type.
`static int`	`SUPERIMPOSED_BAR` Superimposed bar chart renderer type.
`static int`	`TREEMAP` Treemap chart renderer type.
`static int`	`X_VALUE_LABEL` Enum constant for labeling mode: specifies that the x-value of the data point should be displayed.
`static int`	`XY_VALUES_LABEL` Enum constant for labeling mode: specifies that the x- and y-values of the data point should be displayed.
`static int`	`Y_VALUE_LABEL` Enum constant for labeling mode: specifies that the y-value of the data point should be displayed.

Constructor Summary

Constructors
Modifier Constructor and Description

protected IlvChartRenderer()
Creates a new chart renderer and connects it to a default data source.

Constructors
Modifier	Constructor and Description
`protected`	`IlvChartRenderer()` Creates a new chart renderer and connects it to a default data source.

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addImageMapAreas(IlvIMapDefinition mapDef, List<? super IlvIMapArea> areaList)` Generates image map areas.
`void`	`applyStyles(boolean newStyles)` Applies styling to the renderer.
`protected static void`	`applyStyles(IlvDataSet dataSet, IlvChartRenderer renderer, boolean doClear, int firstIdx, int lastIdx, ilog.views.chart.styling.IlvStylingSupport support)` Re-applies styles on the specific data points.
`static ilog.views.chart.styling.IlvDataSetStyle`	`applyStyles(IlvDataSet dataSet, IlvChartRenderer renderer, IlvChartRenderer rendererBean, ilog.views.chart.styling.IlvStylingSupport support, boolean differentNodes)` Applies styles on the specified data set.
`protected void`	`chartConnected(IlvChart oldChart, IlvChart newChart)` Called when the renderer is added to or removed from a chart.
`void`	`collectDisplayItems(IlvChartDataPicker picker, ArrayList<IlvDisplayPoint> accumulator)` Collects the display items containing the specified picking point.
`String`	`computeDataLabel(IlvDataSetPoint dp)` Computes the data label associated with the specified point.
`Point`	`computeDataLabelLocation(IlvDisplayPoint dp, Dimension size)` Computes the location of the data label associated with the specified point.
`static IlvChartRenderer`	`create(String rendererName)` Creates a chart renderer instance, using the specified renderer ID.
`abstract IlvLegendItem[]`	`createLegendItems()` Creates the legend items associated with the renderer.
`static IlvChartRenderer`	`createRenderer(int type)` Creates a chart renderer instance of the given type.
`protected void`	`dataSetsAdded(int firstIdx, int lastIdx, IlvDataSet[] oldDataSets)` Called when new data sets are connected to this renderer.
`protected void`	`dataSetsChangesBatchEnding()` Called when a series of data sets insertions or removals is terminating.
`protected void`	`dataSetsChangesBatchStarting()` Called when a series of data sets insertions or removals is starting.
`protected void`	`dataSetsRemoved(int firstIdx, int lastIdx, IlvDataSet[] oldDataSets)` Called when data sets are disconnected from this renderer.
`void`	`dispose()` Cleans up this renderer and its children renderers, and drops references to objects to help garbage collection.
`abstract void`	`draw(Graphics dst)` Draws the renderer.
`abstract void`	`draw(Graphics dst, IlvDataSet dataSet, int iMin, int iMax)` Deprecated. This method is not used by JViews.
`abstract 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.
`abstract void`	`drawLegendSymbol(IlvLegendItem item, Graphics g, int x, int y, int w, int h)` Draws the symbol of the given legend item.
`abstract 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.
`void`	`drawSelectionHandles(Graphics g, IlvHandlesSelectionStyle style, IlvDataSet dataSet, int index)` Draws a data point with selection handles.
`void`	`drawSelectionHandles(Graphics g, IlvHandlesSelectionStyle style, IlvObjectModelWithColumns model, Object object)` Draws a data object with selection handles.
`protected void`	`endRendererChanges()` Terminates a batch of renderer changes.
`protected Color`	`findAppropriateColor(Collection<Color> colorsToAvoid)` Tries to find an appropriate color for the style used by this renderer.
`protected void`	`fireTreemapFocusEvent(TreemapFocusEvent event)` Fires a treemap focus change event to the registered listeners.
`IlvDataAnnotation`	`getAnnotation()` Returns the global annotation defined for this renderer.
`abstract IlvDataAnnotation`	`getAnnotation(IlvDataSet dataSet, int idx)` Returns the annotation of the specified data point.
`Rectangle2D`	`getBounds(IlvDataSet dataSet, int iMin, int iMax, Rectangle2D bounds)` Returns the bounds of the graphical representation for the specified data.
`abstract Rectangle2D`	`getBounds(IlvDataSet dataSet, int iMin, int iMax, Rectangle2D bounds, boolean includeAnnotations)` Returns the bounds of the graphical representation for the specified data.
`abstract Rectangle2D`	`getBounds(Rectangle2D bounds, boolean includeAnnotations)` Returns the bounds of the graphical representation for the visible data.
`IlvChart`	`getChart()` Returns the chart with which this renderer is associated.
`IlvChartRenderer`	`getChild(int index)` Returns the child renderer at the specified index.
`int`	`getChildCount()` Returns the number of child renderers.
`Iterator<IlvChartRenderer>`	`getChildIterator()` Returns an iterator over the children of this renderer.
`List<IlvChartRenderer>`	`getChildren()` Returns the children of this renderer.
`Rectangle`	`getClipRect()` Returns the rectangle that will be used to clip this renderer drawing.
`IlvCoordinateSystem`	`getCoordinateSystem()` Returns the coordinate system to which this renderer is associated.
`int`	`getDataLabeling()` Returns the data labeling mode.
`int`	`getDataLabelLayout()` Returns the layout mode for the data labels.
`int`	`getDataLabelling()` Deprecated. Please use `getDataLabeling()` instead.
`int`	`getDataSetIndex(IlvDataSet dataSet)` Returns the index of the specified data set in the data source connected to this renderer.
`int`	`getDataSetMainIndex(IlvDataSet dataSet)` Returns the index of the specified data set in the data source connected to the main renderer in the parent chain of this renderer.
`IlvChartRenderer`	`getDataSetMainRenderer(IlvDataSet dataSet)` Returns the main renderer of the specified data set in the parent chain of this renderer.
`IlvDataSource`	`getDataSource()` Returns the data source to which this renderer is connected.
`Color[]`	`getDefaultColors()` Returns the default colors used by this renderer.
`String`	`getDefaultLegendTitle()` Returns the default legend title.
`double[]`	`getDepths()` Returns the front and back depths of the renderer.
`abstract IlvDisplayPoint`	`getDisplayItem(IlvChartDataPicker picker)` Returns the display item containing the specified picking point.
`static IlvDisplayPoint`	`getDisplayItem(Iterator<IlvChartRenderer> ite, IlvChartDataPicker picker)` Returns the display item containing the specified point.
`static List<IlvDisplayPoint>`	`getDisplayItems(Iterator<IlvChartRenderer> ite, IlvChartDataPicker picker)` Returns the display items containing the specified point.
`abstract IlvDisplayPoint`	`getDisplayPoint(IlvDataSet dataSet, int dataIdx)` Returns the display point corresponding to the specified data point.
`IlvStyle`	`getLegendStyle()` Returns the rendering style used to draw the legend item symbol.
`String`	`getLegendText(IlvLegendItem item)` Returns the label of the specified legend item.
`int`	`getMinDataSetCount()` Returns the minimum number of data sets to which this renderer must be connected.
`String`	`getName()` Returns the name of this renderer.
`abstract IlvDisplayPoint`	`getNearestItem(IlvChartDataPicker picker, double[] distanceResult)` Returns the display item closest to the picking point defined by the specified data picker.
`static IlvDisplayPoint`	`getNearestItem(Iterator<IlvChartRenderer> ite, IlvChartDataPicker picker, double[] distanceResult)` Returns the projected data item closest to the specified point.
`abstract IlvDisplayPoint`	`getNearestPoint(IlvChartDataPicker picker)` Returns the display point closest to the picking point defined by the specified data picker.
`static IlvDisplayPoint`	`getNearestPoint(Iterator<IlvChartRenderer> ite, IlvChartDataPicker picker)` Returns the projected data point closest to the specified point.
`IlvChartRenderer`	`getParent()` Returns the parent of this renderer.
`Rectangle`	`getPlotRect()` Returns the rectangle used to project data points.
`Insets`	`getPreferredMargins()` Returns the preferred margins of this renderer for the calculation of the plotting rectangle.
`IlvDataRenderingHint`	`getRenderingHint()` Returns the global rendering hint defined for this renderer.
`abstract IlvDataRenderingHint`	`getRenderingHint(IlvDataSet dataSet)` Returns the rendering hint that was specified globally for all the points of the given data set.
`abstract IlvDataRenderingHint`	`getRenderingHint(IlvDataSet dataSet, int idx)` Returns the rendering hint of the specified data point.
`abstract IlvStyle`	`getStyle(IlvDataSet dataSet, int index)` Returns the style used to display the specified data point.
`IlvStyle`	`getStyle(int idx)` Returns the style at the specified index.
`abstract IlvStyle[]`	`getStyles()` Returns the styles used by this renderer.
`IlvDataSet`	`getVirtualDataSet(IlvDataSet dataSet)` Returns the virtual data set that is actually used internally in the renderer for rendering the specified data set.
`abstract IlvDataInterval`	`getXRange(IlvDataInterval retRange)` Returns the range of the x-values displayed by this renderer.
`double`	`getXShift()` Returns the shift along the x-axis applied to data points before they are projected.
`int`	`getYAxisIdx()` Returns the index of the y axis to which this renderer is or will be connected.
`abstract IlvDataInterval`	`getYRange(IlvDataInterval retRange)` Returns the range of the y-values displayed by this renderer.
`abstract IlvDataInterval`	`getYRange(IlvDataInterval xRange, IlvDataInterval retRange)` Returns the range of the y-values displayed by this renderer within the specified x-interval.
`boolean`	`has3DSupport()` Indicates whether this renderer supports three-dimensional drawing.
`abstract boolean`	`holdsAnnotations()` Returns true if some annotations are defined for some data sets, data points, or data objects, in this renderer.
`boolean`	`isDisplayingDataSet(IlvDataSet dataSet)` Indicates whether the current renderer is used to display the specified data set.
`boolean`	`isViewable()` Indicates whether this renderer can be displayed.
`boolean`	`isVisible()` Indicates whether this renderer is visible.
`boolean`	`isVisibleInLegend()` Indicates whether the renderer creates a legend item.
`void`	`reDraw()` Repaints the chart
`protected static void`	`register(String rendererName, Class<?> rendererClass)` Registers the specified renderer class, using the specified ID.
`protected void`	`set3D(boolean is3D)` Invoked by the chart when 3-D rendering is toggled.
`void`	`setAnnotation(IlvDataAnnotation annotation)` Specifies a global annotation for all the data sets displayed by this renderer.
`abstract void`	`setAnnotation(IlvDataSet dataSet, IlvDataAnnotation annotation)` Specifies a global annotation for all the points of a data set.
`abstract void`	`setAnnotation(IlvDataSet dataSet, int idx, IlvDataAnnotation annotation)` Specifies an annotation for a data point.
`void`	`setDataLabeling(int mode)` Specifies the data labeling mode, which describes the labels that appear next to the graphical representation of data points.
`void`	`setDataLabelLayout(int layout)` Specifies the layout mode of data labels.
`void`	`setDataLabelling(int mode)` Deprecated. Please use `setDataLabeling(int)` instead.
`void`	`setDataPoint(IlvDataSet dataSet, int dataIndex, double xData, double yData)` Changes the value of a data point.
`void`	`setDataSource(IlvDataSource dataSource)` Connects the specified data source to this renderer.
`abstract void`	`setDisplayPoint(IlvDataSet dataSet, int dataIndex, double xCoord, double yCoord)` Changes the value of a data point according to the specified projected coordinates.
`void`	`setName(String name)` Sets the name of this renderer.
`void`	`setParent(IlvChartRenderer parent)` Connects this renderer to the specified parent.
`void`	`setRenderingHint(IlvDataRenderingHint hint)` Specifies a global rendering hint for all the data sets displayed by this renderer.
`abstract void`	`setRenderingHint(IlvDataSet dataSet, IlvDataRenderingHint hint)` Specifies a global rendering hint for all the points of a data set.
`abstract void`	`setRenderingHint(IlvDataSet dataSet, int idx, IlvDataRenderingHint hint)` Specifies a rendering hint for a data point.
`void`	`setRenderingHintWithNoDraw(IlvDataRenderingHint hint)` Specifies a global rendering hint for all the data sets displayed by this renderer.
`void`	`setStyle(int idx, IlvStyle style)` Sets the style at the specified index.
`abstract void`	`setStyles(IlvStyle[] styles)` Sets the styles used by this renderer.
`void`	`setVisible(boolean visible)` Toggles the visibility of this renderer.
`void`	`setVisibleInLegend(boolean visible)` Indicates whether the renderer appears in the legend.
`void`	`setXShift(double shift)` Sets the shift along the x-axis applied to data points before they are projected.
`void`	`setYAxisIdx(int yAxisIdx)` Connects the specified renderer to the specified ordinate axis.
`protected void`	`startRendererChanges()` Starts a batch of renderer changes.
`void`	`toData(IlvDoublePoints pts)` Inverses project points using this renderer coordinate system and projector area.
`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.
`void`	`triggerChange(int type)` Triggers an update of the chart displaying this renderer.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - BAR
```
public static final int BAR
```
    Bar chart renderer type.
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvBarChartRenderer, Constant Field Values
  - STACKED_BAR
```
public static final int STACKED_BAR
```
    Stacked bar chart renderer type.
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvBarChartRenderer, Constant Field Values
  - STACKED100_BAR
```
public static final int STACKED100_BAR
```
    Stacked100 bar chart renderer type.
    
    Since:
    
    JViews 6.0
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvBarChartRenderer, Constant Field Values
  - STACKED_DIVERGING_BAR
```
public static final int STACKED_DIVERGING_BAR
```
    Stacked diverging bar chart renderer type.
    
    Since:
    
    JViews 8.1
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvBarChartRenderer, IlvBarChartRenderer.setDiverging(boolean), Constant Field Values
  - SUPERIMPOSED_BAR
```
public static final int SUPERIMPOSED_BAR
```
    Superimposed bar chart renderer type.
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvBarChartRenderer, Constant Field Values
  - AREA
```
public static final int AREA
```
    Area chart renderer type.
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvAreaChartRenderer, Constant Field Values
  - STACKED_AREA
```
public static final int STACKED_AREA
```
    Stacked area chart renderer type.
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvAreaChartRenderer, Constant Field Values
  - STACKED100_AREA
```
public static final int STACKED100_AREA
```
    Stacked100 area chart renderer type.
    
    Since:
    
    JViews 6.0
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvBarChartRenderer, Constant Field Values
  - POLYLINE
```
public static final int POLYLINE
```
    Polyline chart renderer type.
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvPolylineChartRenderer, Constant Field Values
  - STACKED_POLYLINE
```
public static final int STACKED_POLYLINE
```
    Stacked polyline chart renderer type.
    
    Since:
    
    JViews 5.5
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvPolylineChartRenderer, Constant Field Values
  - STACKED100_POLYLINE
```
public static final int STACKED100_POLYLINE
```
    Stacked100 polyline chart renderer type.
    
    Since:
    
    JViews 6.0
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvBarChartRenderer, Constant Field Values
  - SCATTER
```
public static final int SCATTER
```
    Scatter chart renderer type.
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvScatterChartRenderer, Constant Field Values
  - STAIR
```
public static final int STAIR
```
    Stair chart renderer type.
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvStairChartRenderer, Constant Field Values
  - STACKED_STAIR
```
public static final int STACKED_STAIR
```
    Stacked stair chart renderer type.
    
    Since:
    
    JViews 6.0
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvStairChartRenderer, Constant Field Values
  - STACKED100_STAIR
```
public static final int STACKED100_STAIR
```
    Stacked100 stair chart renderer type.
    
    Since:
    
    JViews 6.0
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvBarChartRenderer, Constant Field Values
  - SUMMED_STAIR
```
public static final int SUMMED_STAIR
```
    Summed stair chart renderer type.
    
    Since:
    
    JViews 6.0
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvStairChartRenderer, Constant Field Values
  - BUBBLE
```
public static final int BUBBLE
```
    Bubble chart renderer type.
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvBubbleChartRenderer, Constant Field Values
  - HILO
```
public static final int HILO
```
    HiLo chart renderer type.
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvHiLoChartRenderer, Constant Field Values
  - HILO_ARROW
```
public static final int HILO_ARROW
```
    Clustered HiLo Arrow chart renderer type.
    
    Since:
    
    JViews 6.0
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvHiLoChartRenderer, Constant Field Values
  - HILO_STICK
```
public static final int HILO_STICK
```
    Clustered HiLo Stick chart renderer type.
    
    Since:
    
    JViews 6.0
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvHiLoChartRenderer, Constant Field Values
  - CANDLE
```
public static final int CANDLE
```
    Candle chart renderer type.
    
    Since:
    
    JViews 6.0
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvHiLoChartRenderer, Constant Field Values
  - HLOC
```
public static final int HLOC
```
    HighLow-OpenClose chart renderer type.
    
    Since:
    
    JViews 6.0
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvHiLoChartRenderer, Constant Field Values
  - PIE
```
public static final int PIE
```
    Pie chart renderer type.
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvPieChartRenderer, Constant Field Values
  - TREEMAP
```
public static final int TREEMAP
```
    Treemap chart renderer type.
    
    Since:
    
    JViews 7.5
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvTreemapChartRenderer, Constant Field Values
  - COMBO
```
public static final int COMBO
```
    Combo chart renderer type.
    
    Since:
    
    JViews 6.0
    
    See Also:
    
    IlvChart.setRenderingType(int), IlvComboChartRenderer, Constant Field Values
  - DATA_LABEL
```
public static final int DATA_LABEL
```
    Enum constant for labeling mode: specifies that the label of the data point should be displayed.
    
    See Also:
    
    setDataLabeling(int), IlvDataSet.getDataLabel(int), Constant Field Values
  - Y_VALUE_LABEL
```
public static final int Y_VALUE_LABEL
```
    Enum constant for labeling mode: specifies that the y-value of the data point should be displayed.
    
    See Also:
    
    setDataLabeling(int), Constant Field Values
  - XY_VALUES_LABEL
```
public static final int XY_VALUES_LABEL
```
    Enum constant for labeling mode: specifies that the x- and y-values of the data point should be displayed.
    
    See Also:
    
    setDataLabeling(int), Constant Field Values
  - X_VALUE_LABEL
```
public static final int X_VALUE_LABEL
```
    Enum constant for labeling mode: specifies that the x-value of the data point should be displayed.
    
    See Also:
    
    setDataLabeling(int), Constant Field Values
  - PERCENT_LABEL
```
public static final int PERCENT_LABEL
```
    Enum constant for labeling mode: specifies that the percent contribution of the data point should be displayed. This mode is only available for renderers displaying percentages: IlvPieChartRenderer
    
    See Also:
    
    setDataLabeling(int), Constant Field Values
  - CENTERED_LABEL_LAYOUT
```
public static final int CENTERED_LABEL_LAYOUT
```
    Enum constant for label layout: specifies that the data label is centered on the graphical representation of the data point.
    
    See Also:
    
    setDataLabelLayout(int), Constant Field Values
  - OUTSIDE_LABEL_LAYOUT
```
public static final int OUTSIDE_LABEL_LAYOUT
```
    Enum constant for label layout: specifies that the data label is drawn outside of the graphical representation of the data point.
    
    See Also:
    
    setDataLabelLayout(int), Constant Field Values
  - DEFAULT_LABEL_LAYOUT
```
public static final int DEFAULT_LABEL_LAYOUT
```
    The default label layout.
    
    Since:
    
    JViews 5.5
    
    See Also:
    
    setDataLabelLayout(int), Constant Field Values
  - DEFAULT_LABELING
```
public static final int DEFAULT_LABELING
```
    The default labeling mode.
    
    Since:
    
    JViews 5.5
    
    See Also:
    
    setDataLabeling(int), Constant Field Values
- Constructor Detail
  - IlvChartRenderer
```
protected IlvChartRenderer()
```
    Creates a new chart renderer and connects it to a default data source.
- Method Detail
  - register
```
protected static void register(String rendererName,
                               Class<?> rendererClass)
```
    Registers the specified renderer class, using the specified ID.
  - create
```
public static IlvChartRenderer create(String rendererName)
                               throws IllegalAccessException,
                                      ClassNotFoundException,
                                      InstantiationException
```
    Creates a chart renderer instance, using the specified renderer ID. A chart renderer can be instantiated using either a string ID registered with the register(java.lang.String, java.lang.Class<?>) method, or directly through its class name.
    
    Throws:
    
    IllegalAccessException
    
    ClassNotFoundException
    
    InstantiationException
  - getChart
```
public final IlvChart getChart()
```
    Returns the chart with which this renderer is associated. This method returns null until the renderer is added to a chart.
    
    See Also:
    
    IlvChart.addRenderer(IlvChartRenderer), IlvChart.addRenderer(IlvChartRenderer, int)
  - chartConnected
```
protected void chartConnected(IlvChart oldChart,
                              IlvChart newChart)
```
    Called when the renderer is added to or removed from a chart.
    
    Parameters:
    
    oldChart - The chart with which this renderer was associated, or null if this renderer is added to a new chart.
    
    newChart - The chart to which this renderer is added, or null if this renderer is removed from its current chart.
  - getPlotRect
```
public final Rectangle getPlotRect()
```
    Returns the rectangle used to project data points.
  - getClipRect
```
public Rectangle getClipRect()
```
    Returns the rectangle that will be used to clip this renderer drawing. The default implementation returns the plotting rectangle. It can be overridden so that drawings can occur outside of this rectangle.
    
    See Also:
    
    getPlotRect()
  - isVisible
```
public boolean isVisible()
```
    Indicates whether this renderer is visible.
    
    See Also:
    
    isViewable(), setVisible(boolean)
  - setVisible
```
public void setVisible(boolean visible)
```
    Toggles the visibility of this renderer.
    
    See Also:
    
    isVisible()
  - getYAxisIdx
```
public final int getYAxisIdx()
```
    Returns the index of the y axis to which this renderer is or will be connected. This method returns -1 if no y axis has been specified using setYAxisIdx(int) and the renderer is currently not added to a chart.
    The y-axis as an IlvAxis instance can be retrieved through getCoordinateSystem().getYAxis() or, equivalently, through getChart().getYAxis(getYAxisIdx()).
    
    See Also:
    
    IlvChart.addRenderer(IlvChartRenderer), IlvChart.addRenderer(IlvChartRenderer, int), setYAxisIdx(int)
  - setYAxisIdx
```
public void setYAxisIdx(int yAxisIdx)
```
    Connects the specified renderer to the specified ordinate axis.
    
    Since:
    
    JViews 8.8
  - getCoordinateSystem
```
public final IlvCoordinateSystem getCoordinateSystem()
```
    Returns the coordinate system to which this renderer is associated. This method returns null until the renderer is added to a chart.
    
    See Also:
    
    IlvChart.addRenderer(IlvChartRenderer), IlvChart.addRenderer(IlvChartRenderer, int)
  - toData
```
public void toData(IlvDoublePoints pts)
```
    Inverses project points using this renderer coordinate system and projector area.
    
    See Also:
    
    IlvChart.toData(IlvDoublePoints, int)
  - toDisplay
```
public void toDisplay(IlvDoublePoints pts)
```
    Projects points using this renderer coordinate system and projector area.
    
    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).
    
    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
  - getName
```
public String getName()
```
    Returns the name of this renderer.
  - setName
```
public void setName(String name)
```
    Sets the name of this renderer.
  - setXShift
```
public void setXShift(double shift)
```
    Sets the shift along the x-axis applied to data points before they are projected.
  - getXShift
```
public double getXShift()
```
    Returns the shift along the x-axis applied to data points before they are projected.
  - isViewable
```
public boolean isViewable()
```
    Indicates whether this renderer can be displayed.
    By default, a renderer is suitable for rendering when the following conditions are true:
    - The renderer is visible (see isVisible()).
    - The renderer has been added to a chart.
    - The renderer is connected to a sufficient number of data sets.
    - If the chart is configured to be displayed in 3D, the has3DSupport() method must return true.
    Specified by:
    
    isViewable in interface IlvChartAreaAccessible
  - getXRange
```
public abstract IlvDataInterval getXRange(IlvDataInterval retRange)
```
    Returns the range of the x-values displayed by this renderer.
    
    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 abstract IlvDataInterval getYRange(IlvDataInterval retRange)
```
    Returns the range of the y-values displayed by this renderer.
    
    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 abstract IlvDataInterval getYRange(IlvDataInterval xRange,
                                          IlvDataInterval retRange)
```
    Returns the range of the y-values displayed by this renderer within the specified x-interval.
    
    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.
  - getMinDataSetCount
```
public int getMinDataSetCount()
```
    Returns the minimum number of data sets to which this renderer must be connected. The default implementation returns 1.
  - getDataSource
```
public final IlvDataSource getDataSource()
```
    Returns the data source to which this renderer is connected.
    
    See Also:
    
    setDataSource(ilog.views.chart.data.IlvDataSource)
  - getDataSetIndex
```
public int getDataSetIndex(IlvDataSet dataSet)
```
    Returns the index of the specified data set in the data source connected to this renderer.
    
    Returns:
    
    The index of the data set, or -1 if is not connected to this renderer.
  - setDataSource
```
public void setDataSource(IlvDataSource dataSource)
```
    Connects the specified data source to this renderer.
    
    See Also:
    
    getDataSource()
  - isDisplayingDataSet
```
public final boolean isDisplayingDataSet(IlvDataSet dataSet)
```
    Indicates whether the current renderer is used to display the specified data set.
  - getVirtualDataSet
```
public final IlvDataSet getVirtualDataSet(IlvDataSet dataSet)
```
    Returns the virtual data set that is actually used internally in the renderer for rendering the specified data set. This data set is shortly lived: it can be replaced by a different one when the content of the data source changes. If the renderer renders this data set directly, this method returns the specified data set unchanged.
    
    Returns:
    
    A data set used internally in the renderer, or the specified data set.
    
    Since:
    
    JViews 8.1
  - setDisplayPoint
```
public abstract void setDisplayPoint(IlvDataSet dataSet,
                                     int dataIndex,
                                     double xCoord,
                                     double yCoord)
```
    Changes the value of a data point according to the specified projected coordinates.
    
    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 displayed by this renderer.
    
    yCoord - The new y-coordinate of the projected point, as displayed 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.
    
    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.
  - dataSetsRemoved
```
protected void dataSetsRemoved(int firstIdx,
                               int lastIdx,
                               IlvDataSet[] oldDataSets)
```
    Called when data sets are disconnected from this renderer. This can happen in two cases:
    - A data source is disconnected from the renderer.
    - The contents of the data source connected to this renderer has changed.
    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 new data sets are connected to this renderer. This can happen in two cases:
    - A new data source is connected to the renderer.
    - The contents of the data source connected to this renderer has changed.
    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.
  - dataSetsChangesBatchStarting
```
protected void dataSetsChangesBatchStarting()
```
    Called when a series of data sets insertions or removals is starting.
    This method may start to delay the handling of dataSetsAdded(int, int, ilog.views.chart.data.IlvDataSet[]), dataSetsRemoved(int, int, ilog.views.chart.data.IlvDataSet[]) callbacks.
    
    Since:
    
    JViews 8.5
    
    See Also:
    
    dataSetsChangesBatchEnding()
  - dataSetsChangesBatchEnding
```
protected void dataSetsChangesBatchEnding()
```
    Called when a series of data sets insertions or removals is terminating.
    This method should handle the dataSetsAdded(int, int, ilog.views.chart.data.IlvDataSet[]), dataSetsRemoved(int, int, ilog.views.chart.data.IlvDataSet[]) callbacks that arrived since the last call to dataSetsChangesBatchStarting().
    
    Since:
    
    JViews 8.5
    
    See Also:
    
    dataSetsChangesBatchStarting()
  - getStyles
```
public abstract IlvStyle[] getStyles()
```
    Returns the styles used by this renderer.
  - setStyles
```
public abstract void setStyles(IlvStyle[] styles)
```
    Sets the styles used by this renderer.
  - getStyle
```
public IlvStyle getStyle(int idx)
```
    Returns the style at the specified index.
    
    See Also:
    
    setStyle(int, IlvStyle)
  - setStyle
```
public void setStyle(int idx,
                     IlvStyle style)
```
    Sets the style at the specified index.
  - getStyle
```
public abstract IlvStyle getStyle(IlvDataSet dataSet,
                                  int index)
```
    Returns the style used to display the specified data point.
    
    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
  - getDefaultColors
```
public Color[] getDefaultColors()
```
    Returns the default colors used by this renderer. When the styles of a renderer are not explicitly specified, styles are automatically calculated based on the default colors returned by this method.
    The default implementation uses the IlvChart.getDefaultColors() method. If the method returns null, the styles are created with the global colors defined by IlvColor.getDefaultColors().
  - findAppropriateColor
```
protected Color findAppropriateColor(Collection<Color> colorsToAvoid)
```
    Tries to find an appropriate color for the style used by this renderer. It looks for an appropriate default color, avoiding the colors given in the colorsToAvoid argument.
    
    Parameters:
    
    colorsToAvoid - A set of color objects that should be avoided. For optimal performance, this should be a HashSet.
    
    Returns:
    
    A suitable color, or null if none was found.
    
    Since:
    
    JViews 7.5
    
    See Also:
    
    getDefaultColors()
  - draw
```
public abstract void draw(Graphics dst)
```
    Draws the renderer.
    
    Parameters:
    
    dst - The destination Graphics. May be null if the renderer is drawn in a 3D scene.
  - drawAnnotations
```
public abstract void drawAnnotations(Graphics dst)
```
    Draws the annotations of the renderer using the specified Graphics.
  - draw
```
@Deprecated
public abstract void draw(Graphics dst,
                                      IlvDataSet dataSet,
                                      int iMin,
                                      int iMax)
```
    Deprecated. This method is not used by JViews.
    
    Draws the specified data.
    
    Deprecated Since:
    
    JViews 8.1
  - getBounds
```
public abstract 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.
    
    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)
```
    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.
    
    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.
  - getBounds
```
public abstract 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.
    
    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 abstract void drawSelectionHandles(Graphics g,
                                          IlvHandlesSelectionStyle style)
```
    Draws this renderer with selection handles.
    
    Specified by:
    
    drawSelectionHandles in interface IlvChartAreaAccessible
    
    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.
    
    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
  - drawSelectionHandles
```
public void drawSelectionHandles(Graphics g,
                                 IlvHandlesSelectionStyle style,
                                 IlvDataSet dataSet,
                                 int index)
```
    Draws a data point with selection handles.
    
    Parameters:
    
    g - A graphics context.
    
    style - The graphic style parameters.
    
    dataSet - One of the data sets of this renderer's data source.
    
    index - The index of a data point in the data set.
    
    Since:
    
    JViews 8.8
  - drawSelectionHandles
```
public void drawSelectionHandles(Graphics g,
                                 IlvHandlesSelectionStyle style,
                                 IlvObjectModelWithColumns model,
                                 Object object)
```
    Draws a data object with selection handles.
    
    Parameters:
    
    g - A graphics context.
    
    style - The graphic style parameters.
    
    model - A flat or tree-like object model.
    
    object - An object in the model.
    
    Since:
    
    JViews 8.8
  - has3DSupport
```
public boolean has3DSupport()
```
    Indicates whether this renderer supports three-dimensional drawing.
    
    Specified by:
    
    has3DSupport in interface IlvChart3DSupport
    
    Since:
    
    JViews 5.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.
    Note: This method is only called on renderers whose has3DSupport() method returns true.
    
    Parameters:
    
    is3D - Indicates whether 3-D rendering is turned on or off.
    
    Since:
    
    JViews 5.5
  - getDepths
```
public double[] getDepths()
```
    Returns the front and back depths of the renderer.
    
    Returns:
    
    An array containing the front (maximum) depth and back (minimum) depth. The returned array is null if has3DSupport() returns false, or if the renderer is not added to a chart.
    
    Since:
    
    JViews 5.5
    
    See Also:
    
    IlvChart3DView.getFrontDepth(), IlvChart3DView.getBackDepth(), IlvChart3DView.setDepthGap(int)
  - getChildCount
```
public int getChildCount()
```
    Returns the number of child renderers. The default implementation returns 0.
  - getChildIterator
```
public Iterator<IlvChartRenderer> getChildIterator()
```
    Returns an iterator over the children of this renderer. The type of the elements traversed by this iterator is IlvChartRenderer. The returned iterator does not allow element removal (an UnsupportedOperationException is thrown when calling the remove method). The default implementation returns an iterator over an empty collection.
    
    Returns:
    
    an iterator over IlvChartRenderer elements
  - getChildren
```
public List<IlvChartRenderer> getChildren()
```
    Returns the children of this renderer. The default implementation returns an empty list.
    
    Returns:
    
    a list of IlvChartRenderer
  - getChild
```
public IlvChartRenderer getChild(int index)
```
    Returns the child renderer at the specified index. The default implementation returns null.
  - getParent
```
public IlvChartRenderer getParent()
```
    Returns the parent of this renderer.
  - setParent
```
public void setParent(IlvChartRenderer parent)
```
    Connects this renderer to the specified parent. This method should not be called directly.
  - getDataSetMainRenderer
```
public IlvChartRenderer getDataSetMainRenderer(IlvDataSet dataSet)
```
    Returns the main renderer of the specified data set in the parent chain of this renderer. If this renderer has inherited the specified data set from its parent renderer, then the main renderer is the parent renderer (or the renderer from which the parent renderer has inherited the data set). Otherwise it is this renderer.
    
    Parameters:
    
    dataSet - A data set that should be contained in the data source of this renderer.
    
    Returns:
    
    The renderer from which the data set is ultimately inherited, or null if is not connected to this renderer.
    
    Since:
    
    JViews 8.7
    
    See Also:
    
    getParent()
  - getDataSetMainIndex
```
public int getDataSetMainIndex(IlvDataSet dataSet)
```
    Returns the index of the specified data set in the data source connected to the main renderer in the parent chain of this renderer.
    
    Parameters:
    
    dataSet - A data set that should be contained in the data source of this renderer.
    
    Returns:
    
    The index of the data set, or -1 if is not connected to this renderer.
    
    Since:
    
    JViews 8.7
    
    See Also:
    
    getDataSetMainRenderer(IlvDataSet)
  - addImageMapAreas
```
public void addImageMapAreas(IlvIMapDefinition mapDef,
                             List<? super IlvIMapArea> areaList)
```
    Generates image map areas.
    
    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.
    
    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)
  - getNearestPoint
```
public abstract IlvDisplayPoint getNearestPoint(IlvChartDataPicker picker)
```
    Returns the display point closest to the picking point defined by the specified data picker. This method considers only the projected points, not the geometry of the renderer drawing.
    
    Parameters:
    
    picker - The object holding the picking information.
    
    Returns:
    
    The nearest display point, or null if none was found.
    
    See Also:
    
    getNearestItem(IlvChartDataPicker, double[])
  - getNearestItem
```
public abstract 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.
    
    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:
    
    getNearestPoint(IlvChartDataPicker), getDisplayItem(IlvChartDataPicker)
  - getDisplayItem
```
public abstract 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.
    
    Parameters:
    
    picker - The object holding the picking information.
    
    Returns:
    
    The display point, or null if none was found.
    
    See Also:
    
    getNearestItem(IlvChartDataPicker, double[])
  - collectDisplayItems
```
public void collectDisplayItems(IlvChartDataPicker picker,
                                ArrayList<IlvDisplayPoint> accumulator)
```
    Collects the display items containing the specified picking point. This is like getDisplayItem(IlvChartDataPicker), except that it returns all items, if several renderers happen to show an item at or near the same point. The first collected point is the same as the one returned by getDisplayItem(IlvChartDataPicker).
    
    Parameters:
    
    picker - The object holding the picking information.
    
    accumulator - A list to which the found display items will be added.
    
    Since:
    
    JViews 8.8
  - getDisplayPoint
```
public abstract IlvDisplayPoint getDisplayPoint(IlvDataSet dataSet,
                                                int dataIdx)
```
    Returns the display point corresponding to the specified data point.
  - getNearestPoint
```
public static IlvDisplayPoint getNearestPoint(Iterator<IlvChartRenderer> ite,
                                              IlvChartDataPicker picker)
```
    Returns the projected data point closest to the specified point. The search is carried out among the renderers traversed by the provided iterator. It is assumed that the iterator only returns IlvChartRenderer objects, otherwise a ClassCastException is thrown.
    
    See Also:
    
    getNearestPoint(IlvChartDataPicker)
  - getNearestItem
```
public static IlvDisplayPoint getNearestItem(Iterator<IlvChartRenderer> ite,
                                             IlvChartDataPicker picker,
                                             double[] distanceResult)
```
    Returns the projected data item closest to the specified point. Optionally returns the distance to the renderer drawing. The search is carried out among the renderers traversed by the provided iterator. It is assumed that the iterator only returns IlvChartRenderer objects, otherwise a ClassCastException is thrown.
    
    Parameters:
    
    ite - An iterator over chart renderers.
    
    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.
    
    Since:
    
    JViews 8.5
    
    See Also:
    
    getNearestItem(IlvChartDataPicker, double[])
  - getDisplayItems
```
public static List<IlvDisplayPoint> getDisplayItems(Iterator<IlvChartRenderer> ite,
                                                    IlvChartDataPicker picker)
```
    Returns the display items containing the specified point. The search is carried out among the renderers traversed by the provided iterator. It is assumed that the iterator only returns IlvChartRenderer objects, otherwise a ClassCastException is thrown. The first returned point is the same as the one returned by getDisplayItem(Iterator, IlvChartDataPicker).
    
    Returns:
    
    The display points, a list of IlvDisplayPoint objects, or an empty list if none was found.
    
    Since:
    
    JViews 8.1
    
    See Also:
    
    getDisplayItem(IlvChartDataPicker)
  - getDisplayItem
```
public static IlvDisplayPoint getDisplayItem(Iterator<IlvChartRenderer> ite,
                                             IlvChartDataPicker picker)
```
    Returns the display item containing the specified point. The search is carried out among the renderers traversed by the provided iterator. It is assumed that the iterator only returns IlvChartRenderer objects, otherwise a ClassCastException is thrown.
    
    See Also:
    
    getDisplayItem(IlvChartDataPicker)
  - drawLegendSymbol
```
public abstract 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 their symbol.
    
    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 abstract IlvLegendItem[] createLegendItems()
```
    Creates the legend items associated with the renderer. This method is automatically called by the legend to populate itself.
    
    Returns:
    
    An array containing all the legend items associated with the renderer, or null.
    
    See Also:
    
    IlvLegend, IlvLegendItem
  - getLegendText
```
public String getLegendText(IlvLegendItem item)
```
    Returns the label of the specified legend item. The default implementation returns the name of this renderer.
  - getDefaultLegendTitle
```
public String getDefaultLegendTitle()
```
    Returns the default legend title. It is used when no legend title has been explicitly set. The default implementation returns null, which stands for no title.
    
    Since:
    
    JViews 7.5
  - getLegendStyle
```
public IlvStyle getLegendStyle()
```
    Returns the rendering style used to draw the legend item symbol. The default implementation returns the first style of this renderer.
  - getPreferredMargins
```
public Insets getPreferredMargins()
```
    Returns the preferred margins of this renderer for the calculation of the plotting rectangle.
    
    Returns:
    
    The preferred margins.
    
    See Also:
    
    IlvChart.Area.getMargins()
  - triggerChange
```
public void triggerChange(int type)
```
    Triggers an update of the chart displaying this renderer. This method must be called for every change made on the renderer that has a visual impact on the chart. The update type request is specified by the parameter and should be one of the event type constants defined by ChartRendererEvent.
    
    See Also:
    
    ChartRendererEvent
  - startRendererChanges
```
protected void startRendererChanges()
```
    Starts a batch of renderer changes.
    
    Since:
    
    JViews 8.5
    
    See Also:
    
    triggerChange(int), ChartRendererListener2
  - endRendererChanges
```
protected void endRendererChanges()
```
    Terminates a batch of renderer changes.
    
    Since:
    
    JViews 8.5
    
    See Also:
    
    triggerChange(int), ChartRendererListener2
  - fireTreemapFocusEvent
```
protected void fireTreemapFocusEvent(TreemapFocusEvent event)
```
    Fires a treemap focus change event to the registered listeners.
    
    Since:
    
    JViews 7.5
    
    See Also:
    
    IlvChart.addTreemapFocusListener(ilog.views.chart.event.TreemapFocusListener)
  - isVisibleInLegend
```
public boolean isVisibleInLegend()
```
    Indicates whether the renderer creates a legend item.
    
    See Also:
    
    setVisibleInLegend(boolean)
  - setVisibleInLegend
```
public void setVisibleInLegend(boolean visible)
```
    Indicates whether the renderer appears in the legend.
    The default value of this property is true, which means that the renderer will automatically create and add items to the legend.
    
    See Also:
    
    isVisibleInLegend(), createLegendItems()
  - getDataLabeling
```
public int getDataLabeling()
```
    Returns the data labeling mode.
    
    Since:
    
    JViews 8.0
    
    See Also:
    
    setDataLabeling(int)
  - getDataLabelling
```
@Deprecated
public int getDataLabelling()
```
    Deprecated. Please use getDataLabeling() instead.
    
    Returns the data labeling mode.
    
    Deprecated Since:
    
    JViews 8.0
  - setDataLabeling
```
public void setDataLabeling(int mode)
```
    Specifies the data labeling mode, which describes the labels that appear next to the graphical representation of data points. Data labeling is performed by the IlvDataLabelAnnotation class. The specified mode is used by the computeDataLabel(ilog.views.chart.data.IlvDataSetPoint) method to determine the label that is drawn by the annotation. The following code shows how to label all the points of a data set with their x- and y-values:
```
     aRenderer.setDataLabeling(IlvChartRenderer.XY_VALUES_LABEL);
     aRenderer.setAnnotation(dataSet, new IlvDataLabelAnnotation());
 
```
    The default mode is Y_VALUE_LABEL.
    Since:
    
    JViews 8.0
    
    See Also:
    
    DATA_LABEL, X_VALUE_LABEL, Y_VALUE_LABEL, XY_VALUES_LABEL
  - setDataLabelling
```
@Deprecated
public void setDataLabelling(int mode)
```
    Deprecated. Please use setDataLabeling(int) instead.
    Specifies the data labeling mode, which describes the labels that appear next to the graphical representation of data points. Data labeling is performed by the IlvDataLabelAnnotation class. The specified mode is used by the computeDataLabel(ilog.views.chart.data.IlvDataSetPoint) method to determine the label that is drawn by the annotation. The following code shows how to label all the points of a data set with their x- and y-values:
```
     aRenderer.setDataLabeling(IlvChartRenderer.XY_VALUES_LABEL);
     aRenderer.setAnnotation(dataSet, new IlvDataLabelAnnotation());
 
```
    The default mode is Y_VALUE_LABEL.
    See Also:
    
    DATA_LABEL, X_VALUE_LABEL, Y_VALUE_LABEL, XY_VALUES_LABEL
    
    Deprecated Since:
    
    JViews 8.0
  - getDataLabelLayout
```
public int getDataLabelLayout()
```
    Returns the layout mode for the data labels.
    
    See Also:
    
    setDataLabelLayout(int)
  - setDataLabelLayout
```
public void setDataLabelLayout(int layout)
```
    Specifies the layout mode of data labels.
    
    Parameters:
    
    layout - One of CENTERED_LABEL_LAYOUT, OUTSIDE_LABEL_LAYOUT.
  - getAnnotation
```
public final IlvDataAnnotation getAnnotation()
```
    Returns the global annotation defined for this renderer.
    
    See Also:
    
    setAnnotation(IlvDataAnnotation)
  - setAnnotation
```
public void setAnnotation(IlvDataAnnotation annotation)
```
    Specifies a global annotation for all the data sets displayed by this renderer. The specified annotation will also be associated with all the data sets that are connected to this renderer.
    
    Parameters:
    
    annotation - The new annotation. If this parameter is null, all the global annotations previously defined are removed.
    
    See Also:
    
    setAnnotation(IlvDataSet, IlvDataAnnotation)
  - getAnnotation
```
public abstract IlvDataAnnotation getAnnotation(IlvDataSet dataSet,
                                                int idx)
```
    Returns the annotation of the specified data point.
    
    Parameters:
    
    dataSet - The considered data set.
    
    idx - The index of the point within the data set.
    
    Returns:
    
    The annotation associated with the data point.
  - setAnnotation
```
public abstract void setAnnotation(IlvDataSet dataSet,
                                   int idx,
                                   IlvDataAnnotation annotation)
```
    Specifies an annotation for a data point.
    
    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 setAnnotation(IlvDataSet, IlvDataAnnotation) method, it is overridden by this new annotation. In that case, a null value has no effect.
  - setAnnotation
```
public abstract void setAnnotation(IlvDataSet dataSet,
                                   IlvDataAnnotation annotation)
```
    Specifies a global annotation for all the points of a data set.
    
    Parameters:
    
    dataSet - The considered data set.
    
    annotation - The new annotation, or null if the global annotation must be removed.
    
    See Also:
    
    setAnnotation(IlvDataAnnotation)
  - holdsAnnotations
```
public abstract boolean holdsAnnotations()
```
    Returns true if some annotations are defined for some data sets, data points, or data objects, in this renderer.
    
    Since:
    
    JViews 8.7
  - getRenderingHint
```
public final IlvDataRenderingHint getRenderingHint()
```
    Returns the global rendering hint defined for this renderer.
    
    See Also:
    
    setRenderingHint(IlvDataRenderingHint)
  - setRenderingHint
```
public void setRenderingHint(IlvDataRenderingHint hint)
```
    Specifies a global rendering hint for all the data sets displayed by this renderer. The specified hint will also be associated with all the data sets that are connected to this renderer. The method repaints after each hint update.
    
    Parameters:
    
    hint - The new rendering hint. If this parameter is null, all the global hints previously defined are removed.
    
    See Also:
    
    setRenderingHint(IlvDataSet, IlvDataRenderingHint)
  - setRenderingHintWithNoDraw
```
public void setRenderingHintWithNoDraw(IlvDataRenderingHint hint)
```
    Specifies a global rendering hint for all the data sets displayed by this renderer. The specified hint will also be associated with all the data sets that are connected to this renderer. The method does not repaint after the hint update. Note: To repaint after the function call, use reDraw() method
    
    Parameters:
    
    hint - The new rendering hint. If this parameter is null, all the global hints previously defined are removed.
    
    See Also:
    
    setRenderingHint(IlvDataSet, IlvDataRenderingHint)
  - reDraw
```
public void reDraw()
```
    Repaints the chart
  - getRenderingHint
```
public abstract IlvDataRenderingHint getRenderingHint(IlvDataSet dataSet,
                                                      int idx)
```
    Returns the rendering hint of the specified data point.
    
    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.
  - setRenderingHint
```
public abstract void setRenderingHint(IlvDataSet dataSet,
                                      int idx,
                                      IlvDataRenderingHint hint)
```
    Specifies a rendering hint for a data point.
    
    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 setRenderingHint(IlvDataSet, IlvDataRenderingHint)} method, it is overridden by this new hint. In that case, a null value has no effect.
  - getRenderingHint
```
public abstract IlvDataRenderingHint getRenderingHint(IlvDataSet dataSet)
```
    Returns the rendering hint that was specified globally for all the points of the given data set.
    
    Parameters:
    
    dataSet - The considered data set.
    
    Returns:
    
    The rendering hint associated with the data set, or null for none.
    
    Since:
    
    JViews 8.8
  - setRenderingHint
```
public abstract void setRenderingHint(IlvDataSet dataSet,
                                      IlvDataRenderingHint hint)
```
    Specifies a global rendering hint for all the points of a data set.
    
    Parameters:
    
    dataSet - The considered data set.
    
    hint - The new rendering hint, or null if the global hint must be removed.
  - computeDataLabel
```
public String computeDataLabel(IlvDataSetPoint dp)
```
    Computes the data label associated with the specified point.
    This method is used for data labeling. The returned string depends on the mode specified by the setDataLabeling(int) method. The values are formatted using the IlvChart.formatXValue(double) and IlvChart.formatYValue(int, double) methods.
    
    Parameters:
    
    dp - The considered data point.
    
    Returns:
    
    The string corresponding to the specified data point, or null if none is available.
  - computeDataLabelLocation
```
public Point computeDataLabelLocation(IlvDisplayPoint dp,
                                      Dimension size)
```
    Computes the location of the data label associated with the specified point. This method is used by the IlvDataLabelAnnotation class.
    
    Parameters:
    
    dp - The considered display point.
    
    size - The size of the label.
    
    Returns:
    
    The location of the center of the label.
    
    See Also:
    
    setDataLabeling(int)
  - applyStyles
```
public void applyStyles(boolean newStyles)
                 throws Exception
```
    Applies styling to the renderer. Internal method.
    
    Throws:
    
    Exception
    
    Since:
    
    JViews 5.5
    
    Internal: do not use!
  - applyStyles
```
public static ilog.views.chart.styling.IlvDataSetStyle applyStyles(IlvDataSet dataSet,
                                                                   IlvChartRenderer renderer,
                                                                   IlvChartRenderer rendererBean,
                                                                   ilog.views.chart.styling.IlvStylingSupport support,
                                                                   boolean differentNodes)
```
    Applies styles on the specified data set. Internal method.
    
    Parameters:
    
    dataSet - The data set.
    
    renderer - The renderer that displays the data set.
    
    rendererBean - The renderer that should be styled, or null.
    
    support - CSS manager.
    
    differentNodes - If true, all CSS model nodes that are used must be different. If false, CSS model node creation can be optimized.
    
    Returns:
    
    An IlvDataSetStyle that holds the styling information on the data set.
    
    Since:
    
    JViews 7.5
    
    Internal: do not use!
  - applyStyles
```
protected static void applyStyles(IlvDataSet dataSet,
                                  IlvChartRenderer renderer,
                                  boolean doClear,
                                  int firstIdx,
                                  int lastIdx,
                                  ilog.views.chart.styling.IlvStylingSupport support)
```
    Re-applies styles on the specific data points. Internal method.
    
    Parameters:
    
    dataSet - The considered data set.
    
    renderer - Renderer which is rendering the data set.
    
    doClear - Whether to clear all data point styles first.
    
    firstIdx - The index of the first data point.
    
    lastIdx - The index of the last data point.
    
    support - Holds styling information.
    
    Since:
    
    JViews 7.5
    
    Internal: do not use!
  - createRenderer
```
public static IlvChartRenderer createRenderer(int type)
```
    Creates a chart renderer instance of the given type.
    
    Since:
    
    JViews 6.0
    
    See Also:
    
    BAR, STACKED_BAR, STACKED100_BAR, STACKED_DIVERGING_BAR, SUPERIMPOSED_BAR, AREA, STACKED_AREA, STACKED100_AREA, POLYLINE, STACKED_POLYLINE, STACKED100_POLYLINE, SCATTER, STAIR, STACKED_STAIR, STACKED100_STAIR, SUMMED_STAIR, BUBBLE, HILO, HILO_ARROW, HILO_STICK, CANDLE, HLOC, PIE, TREEMAP
  - dispose
```
public void dispose()
```
    Cleans up this renderer and its children renderers, and drops references to objects to help garbage collection.
    Note: After calling this function, this renderer and its children renderers are no longer functional.
    
    Since:
    
    JViews 7.5

Class IlvChartRenderer

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

BAR

STACKED_BAR

STACKED100_BAR

STACKED_DIVERGING_BAR

SUPERIMPOSED_BAR

AREA

STACKED_AREA

STACKED100_AREA

POLYLINE

STACKED_POLYLINE

STACKED100_POLYLINE

SCATTER

STAIR

STACKED_STAIR

STACKED100_STAIR

SUMMED_STAIR

BUBBLE

HILO

HILO_ARROW

HILO_STICK

CANDLE

HLOC

PIE

TREEMAP

COMBO

DATA_LABEL

Y_VALUE_LABEL

XY_VALUES_LABEL

X_VALUE_LABEL

PERCENT_LABEL

CENTERED_LABEL_LAYOUT

OUTSIDE_LABEL_LAYOUT

DEFAULT_LABEL_LAYOUT

DEFAULT_LABELING

Constructor Detail

IlvChartRenderer

Method Detail

register

create

getChart

chartConnected

getPlotRect

getClipRect

isVisible

setVisible

getYAxisIdx

setYAxisIdx

getCoordinateSystem

toData

toDisplay

toDisplay

getName

setName

setXShift

getXShift

isViewable

getXRange

getYRange

getYRange

getMinDataSetCount

getDataSource

getDataSetIndex

setDataSource

isDisplayingDataSet

getVirtualDataSet

setDisplayPoint

setDataPoint

dataSetsRemoved

dataSetsAdded

dataSetsChangesBatchStarting

dataSetsChangesBatchEnding

getStyles

setStyles

getStyle