JViews Charts 6.0 Release Notes

This document describes the main changes that have been made to the JViews charts module since version 5.5.

Incompatibilities
General Changes
Library Changes

New Interfaces and Classes

• ilog.views.chart.IlvChartConfiguration
• ilog.views.chart.IlvServerSideLayout
• ilog.views.chart.data.IlvSwingTableDataSource.Mapping
• ilog.views.chart.event.LegendDockingEvent
• ilog.views.chart.event.LegendDockingListener
• ilog.views.chart.graphic.IlvThresholdIndicator
• ilog.views.chart.interactor.IlvChartDataIndicatorInteractor
• ilog.views.chart.renderer.IlvSuperimposedRenderer
• ilog.views.chart.servlet.IlvOverviewAction
• ilog.views.chart.servlet.IlvPanAction
• ilog.views.chart.servlet.IlvPickPointAction
• ilog.views.chart.servlet.IlvZoomAction
• ilog.views.chart.swing.IlvDoubleSliderUI
• ilog.views.chart.util.IlvSelectionUtil

Modified Classes

• ilog.views.chart.IlvChart
• ilog.views.chart.IlvChart.Area
• ilog.views.chart.IlvChartInteractor
• ilog.views.chart.IlvChartProduct
• ilog.views.chart.IlvChartRenderer
• ilog.views.chart.IlvGrid
• ilog.views.chart.IlvLegend
• ilog.views.chart.IlvLegendLayout
• ilog.views.chart.IlvScale
• ilog.views.chart.IlvStyle
• ilog.views.chart.data.IlvJDBCDataSource
• ilog.views.chart.data.IlvSwingTableDataSource
• ilog.views.chart.data.xml.IlvXMLDataWriter
• ilog.views.chart.graphic.IlvDataIndicator
• ilog.views.chart.graphic.IlvImageDecoration
• ilog.views.chart.java2d.IlvValueGradientPaint
• ilog.views.chart.renderer.IlvBarChartRenderer
• ilog.views.chart.renderer.IlvPolylineChartRenderer
• ilog.views.chart.renderer.IlvSingleChartRenderer
• ilog.views.chart.renderer.IlvSinglePieRenderer
• ilog.views.chart.servlet.IlvChartServletSupport
• ilog.views.chart.swing.IlvDoubleSlider
• ilog.views.chart.util.IlvChartUtil

Incompatibilities

• There are no known incompatibilities.

General Changes

• A new License Manager has been introduced. For more information, please refer to the Licensing documentation.
• A graphical editor called Designer for JViews Charts has been added to easily edit and style a Chart.
• The Styling Capabilities have been extended to support the following features:
  • Chart decorations
  • Threshold lines
  • interactors customization
  • multiple graphical representation
  • CSS Functions
• The mapping capabilities of the IlvSwingTableDataSource have been extended to support multiple x-series and data labels columns.
• The IlvJDBCDataSource class now inherits from IlvSwingTableDataSource.
• The set of DHTML Charts Components that was provided as a contribution in JViews 5.5 Charts module has been integrated into the library. These components can be used with the Charts thin-client framework to build interactive client-side charts.

Library Changes

New Interfaces and Classes

ilog.views.chart.IlvChartConfiguration

A class that reads and write chart configuration file.

ilog.views.chart.IlvServerSideLayout

A layout interface used for the server side image generation.

ilog.views.chart.data.IlvSwingTableDataSource.Mapping

A class used to define a data mapping in a TableModel.

ilog.views.chart.event.LegendDockingEvent

Events that describe changes of the docking position of an IlvLegend.

ilog.views.chart.event.LegendDockingListener

Defines the interface for objects that listen to the changes of the docking position of an IlvLegend.

ilog.views.chart.graphic.IlvThresholdIndicator

An IlvDataIndicator subclass that defines threshold lines accessible from a stylesheet.

ilog.views.chart.interactor.IlvChartDataIndicatorInteractor

A class to interact on an IlvDataIndicator.

ilog.views.chart.renderer.IlvSuperimposedRenderer

Interface for renderers that support superimposed rendering (child renderers are drawn on top of each other).

ilog.views.chart.servlet.IlvOverviewAction

An IlvChartServerAction that handles overview interactions.

ilog.views.chart.servlet.IlvPanAction

A class to pan the chart area on the server side.

ilog.views.chart.servlet.IlvPickPointAction

A class to perform data point picking on the server side.

ilog.views.chart.servlet.IlvZoomAction

An IlvChartServerAction implementation to zoom in or out a chart.

ilog.views.chart.swing.IlvDoubleSliderUI

This class is the basic UI delegate implementation for IlvDoubleSlider components.

ilog.views.chart.util.IlvSelectionUtil

A utility class for selection-related operations.

Modified Classes

ilog.views.chart.IlvChart

• Overview of new features:
  • CSS Functions
  • Decorations support in CSS
• New methods:
  • getReversedDrawableIterator(): Returns an iterator over the IlvChartDrawable objects managed by this chart.
  • registerFunction(IlvCSSFunction): Registers another function into the Cascading Style Sheets engine.
  • setDecorations(List): Sets the decorations displayed by this chart.

ilog.views.chart.IlvChart.Area

• New methods:
  • isFilledPlottingArea(): Returns whether the plotting area is filled.
  • setFilledPlottingArea(boolean): Sets whether the plotting area is filled.

ilog.views.chart.IlvChartInteractor

• New methods:
  • getPriority(): Returns the priority of this interactor.


• New fields:
  • INTERNAL_HIGH: The priority value for high-priority internal interactors.
  • INTERNAL_LOW: The priority value for low-priority internal interactors.
  • NORMAL: The priority value for public interactors.

ilog.views.chart.IlvChartProduct

• Overview of new features:
  • New License Manager
• New methods:
  • getBuildNumber(): Returns the JViews Charts build number.
  • getMinorVersion(): Returns the JViews Charts minor version number, that is, 0.
  • getPatchLevel(): Returns the JViews Charts patch level number.
  • getReleaseDate(): Returns the date of the JViews Charts release.
  • getSubMinorVersion(): Returns the JViews Charts subminor version number.
  • getVersion(): Returns the JViews Charts version number, that is, 6.

ilog.views.chart.IlvChartRenderer

• New methods:
  • createRenderer(int): Creates a chart renderer instance of the given type.


• New fields:
  • CANDLE: Candle chart renderer type.
  • HLOC: HighLow-OpenClose chart renderer type.
  • STACKED_STAIR: Stacked stair chart renderer type.
  • SUMMED_STAIR: Summed stair chart renderer type.

ilog.views.chart.IlvGrid

• New methods:
  • drawGridLine(Graphics, Shape, boolean): Draws the gridline.
  • getAxisIndex(IlvGrid): Returns the axis index of the specified grid.
  • getGridShapes(IlvDoubleArray): Returns the gridlines for the specified values as an array of Shape.

ilog.views.chart.IlvLegend

• Overview of new features:
  • Docking event notification
  • Flow direction of the floating layout
• New methods:
  • addLegendDockingListener(LegendDockingListener): Adds a new LegendDockingListener.
  • createLegendLayout(): Creates the layout used by the legend.
  • fireLegendDockingEvent(LegendDockingEvent): Fires the given event to all the registered listeners.
  • getFloatingLayoutDirection(): Returns the flow direction of the floating layout.
  • setFloatingLayoutDirection(int): Sets the flow direction of the floating layout.
  • removeLegendDockingListener(LegendDockingListener): Removes a new LegendDockingListener.

ilog.views.chart.IlvLegendLayout

• New methods:
  • getFloatingLayoutDirection(): Returns the flow direction of the floating layout.
  • setFloatingLayoutDirection(int): Sets the flow direction of the floating layout.

ilog.views.chart.IlvScale

• New methods:
  • drawHighlight(Graphics): Draws this scale as highlighted.
  • getAxisIndex(IlvScale): Returns the axis index of the specified scale.
  • getTitleOffset(): Returns the offset between the scale title and the step labels.
  • setTitleOffset(int): Specifies the offset between the scale title and the step labels.
  • hit(Point2D): Returns the result of a hit testing on the specified point.
  • setAnnotations(IlvScaleAnnotation[]): Sets the annotations attached to this scale.

ilog.views.chart.IlvStyle

• New methods:
  • brighter(): Creates a brighter version of this rendering style.

ilog.views.chart.data.IlvJDBCDataSource

• Overview of new features:
  • Inherits from IlvSwingTableDataSource
• New methods:
  • isTimeSeries(int): Returns whether the specified column or row (depending on the type of this data source) represents a time series.
  • setTableModel(TableModel): Sets the table model associated with this data source.

ilog.views.chart.data.IlvSwingTableDataSource

• Overview of new features:
  • Data mapping has been improved to support multiple x-series and data labels columns.
• New constructors:
  • IlvSwingTableDataSource(TableModel, int, IlvSwingTableDataSource.Mapping[]): Creates a new IlvSwingTableDataSource associated with the given TableModel with the series ordered according to the specified type and initialized with the specified mapping.


• New methods:
  • getMapping(): Returns the contents of this data source according to the specified mapping.
  • setMapping(IlvSwingTableDataSource.Mapping[]): Initializes the contents of this data source according to the specified mapping.
  • isTimeSeries(int): Returns whether the specified column or row (depending on the type of this data source) represents a time series.

ilog.views.chart.data.xml.IlvXMLDataWriter

• New methods:
  • getDocument(): Returns the document being populated by this writer.

ilog.views.chart.graphic.IlvDataIndicator

• New methods:
  • getShape(): Returns the Shape corresponding to this data indicator.
  • setLabelRenderer(IlvLabelRenderer): Sets the renderer of the text displayed by this indicator.

ilog.views.chart.graphic.IlvImageDecoration

• New methods:
  • getImageURL(): Returns the URL of the image or null if not specified.

ilog.views.chart.java2d.IlvValueGradientPaint

• New constructors:
  • IlvValueGradientPaint(IlvChart, int, double[], Color[], boolean): Creates a gradient based on the specified y-values.
  • IlvValueGradientPaint(IlvChart, double[], Color[], boolean): Creates a gradient based on the specified x-values.

ilog.views.chart.renderer.IlvBarChartRenderer

• Overview of new features:
  • Automatic transparent colors mode (in superimposed configuration).
• New methods:
  • isAutoTransparency(): Returns whether this renderer should use transparent default colors.
  • setAutoTransparency(boolean): Sets whether this renderer should use transparent default colors.
  • isSuperimposed(): Returns whether this renderer is in a superimposed configuration.

ilog.views.chart.renderer.IlvPolylineChartRenderer

• Overview of new features:
  • Automatic transparent colors mode (in superimposed configuration).
• New methods:
  • isAutoTransparency(): Returns whether this renderer should use transparent default colors.
  • setAutoTransparency(boolean): Sets whether this renderer should use transparent default colors.
  • isSuperimposed(): Returns whether this renderer is in a superimposed configuration.

ilog.views.chart.renderer.IlvSingleChartRenderer

• New methods:
  • applyDataSetStyle(IlvDataSetStyle): Applies the styles for a data set.

ilog.views.chart.renderer.IlvSinglePieRenderer

• New methods:
  • applyDataSetStyle(IlvDataSetStyle): Applies the styles for a data set.

ilog.views.chart.servlet.IlvChartServletSupport

• Overview of new features:
  • DHTML components support
• New methods:
  • additionalBinaryCapabilities(IlvChart, IlvServletRequestParameters, DataOutputStream): Allows you to add additional capabilities to a capability request when the mime format is "application/octet-stream".
  • additionalOverviewBinaryCapabilities(IlvChart, IlvServletRequestParameters, DataOutputStream): Allows you to add additional capabilities to an overview capability request when the mime format is "application/octet-stream".
  • additionalOverviewTextCapabilities(IlvChart, IlvServletRequestParameters, PrintWriter): Allows you to add additional capabilities to an overview capability request when the mime format is "text/HTML".
  • additionalTextCapabilities(IlvChart, IlvServletRequestParameters, PrintWriter): Allows you to add additional capabilities to a capability request when the mime format is "text/html".
  • getLegend(IlvServletRequestParameters): Returns the legend component.
  • getOverviewChart(IlvServletRequestParameters): Returns the overview chart used for the specified request.
  • getRequestedVisibleWindow(IlvServletRequestParameters, IlvChart): Returns the requested visible window.
  • prepareOverviewChart(IlvServletRequestParameters, IlvChart): Allows you to prepare the overview chart content before the presentation is generated.
  • prepareVisibleWindow(IlvServletRequestParameters, IlvChart): Configure the axis visible range of the specified chart according to the request parameters.
  • toChartArea(Rectangle, IlvServletRequestParameters, IlvChart): Converts the specified rectangle from the reference component coordinate system to the chart area coordinate system.
  • toChartArea(Point, IlvServletRequestParameters, IlvChart): Converts the specified point from the reference component coordinate system to the chart area coordinate system.
  • toRefComp(Rectangle, IlvServletRequestParameters, IlvChart): Converts the specified rectangle from the chart area coordinate system to the reference component coordinate system.
  • toRefComp(Point, IlvServletRequestParameters, IlvChart): Converts the specified point from the chart area coordinate system to the reference component coordinate system.


• New fields:
  • CAPABILITIES_REQUEST: The capabilities request value for REQUEST_PARAM.
  • CAP_FORMAT_PARAM: The capabilities format parameter for capabilities requests.
  • HTML_CAP_FORMAT: The HTML capabilities format value for CAP_FORMAT_PARAM.
  • OCTET_CAP_FORMAT: The octet capabilities format value for CAP_FORMAT_PARAM.
  • OVERVIEW_COMPONENT: The overview chart component value for COMPONENT_PARAM.
  • VALID_CAP_FORMATS: The array of valid values for CAP_FORMAT_PARAM.
  • X_MAX_PARAM: The maximum visible x-value parameter for image requests.
  • X_MIN_PARAM: The minimum visible x-value parameter for image requests.
  • Y_MAX_PARAM: The maximum visible x-value parameter for image requests.
  • Y_MIN_PARAM: The minimum visible x-value parameter for image requests.

ilog.views.chart.swing.IlvDoubleSlider

• New methods:
  • getUIClassID(): Returns the name of the look and feel class that renders this component.
  • updateUI(): Resets the UI property to a value from the current look and feel.

ilog.views.chart.util.IlvChartUtil

• Overview of new features:
  • A new feature....
• New methods:
  • relativeURL(URL, URL): Returns a relative URL based on a specified base URL.