JViews Diagrammer Release Notes

This document describes the main changes that have been made to JViews Diagrammer since version 6.0.

Incompatibilities
General Changes
Library Changes
New Packages

• ilog.views.diagrammer.faces

New Interfaces and Classes

• ilog.views.graphlayout.labellayout.IlvLabelingModelWithRotation
• ilog.views.sdm.renderer.graphlayout.IlvSDMNodeComparator
• ilog.views.sdm.renderer.graphlayout.IlvSDMNodeComparator.ComparatorSortCriteria
• ilog.views.sdm.renderer.graphlayout.IlvSDMNodeComparator.DataModelAttributeSortCriteria
• ilog.views.sdm.renderer.graphlayout.IlvSDMNodeComparator.SortCriteria

Modified Classes

• ilog.views.diagrammer.IlvDiagrammer
• ilog.views.diagrammer.application.IlvDiagrammerPaletteAction
• ilog.views.diagrammer.application.IlvDiagrammerToolBar
• ilog.views.diagrammer.application.IlvDiagrammerViewBar
• ilog.views.graphlayout.bus.IlvBusLayout
• ilog.views.graphlayout.grid.IlvGridLayout
• ilog.views.graphlayout.labellayout.IlvDefaultLabelingModel
• ilog.views.graphlayout.labellayout.annealing.IlvAnnealingLabelDescriptor
• ilog.views.graphlayout.labellayout.annealing.IlvAnnealingLabelLayout
• ilog.views.graphlayout.tree.IlvTreeLayout
• ilog.views.graphlayout.hierarchical.IlvHierarchicalLayout
• ilog.views.interactor.IlvMoveRectangleInteractor
• ilog.views.interactor.IlvSelectInteractorMoveSelection
• ilog.views.sdm.IlvSDMEngine
• ilog.views.sdm.graphic.IlvGeneralLink
• ilog.views.sdm.graphic.IlvURLGraphic
• ilog.views.sdm.model.IlvTableSDMModel
• ilog.views.sdm.renderer.IlvCSSSDM
• ilog.views.sdm.renderer.IlvDecorationRenderer
• ilog.views.sdm.renderer.IlvFilterSDMRenderer
• ilog.views.sdm.renderer.IlvLegendRenderer
• ilog.views.sdm.renderer.IlvSDMRenderer
• ilog.views.sdm.renderer.IlvStyleSheetRenderer
• ilog.views.sdm.renderer.IlvSubGraphRenderer
• ilog.views.sdm.renderer.graphlayout.IlvGraphLayoutRenderer
• ilog.views.sdm.renderer.graphlayout.IlvLabelLayoutRenderer
• ilog.views.swing.IlvJScrollManagerView

Incompatibilities

• The way identifiers are automatically allocated by an ilog.views.sdm.model.IlvBasicSDMModel has been changed for better performances. Since the way identifiers were allocated was not specified, this should not normally break any application code, but if your application relied on the exact values of the automatic IDs in an SDM model, you may have to modify this code.

• The painting code of the ilog.views.sdm.graphic.IlvGeneralLink has been optimized: when the link is less than 2 pixels wide on the screen, it is painted as a solid line whatever the painting mode is. This may lead to a slightly different visual appearance. You can disable this optimization if you want the exact same look as in JViews 6.0 by calling the method see setOptimized(false).

• The default minimum and maximum zoom levels of an ilog.views.diagrammer.IlvDiagrammer have been changed to the minimum and maximum values of a float, respectively. See setMinimumZoom(double) and setMaximumZoom(double).

  This means that, by default, users are now allowed to zoom in/ou a Diagrammer view with much wider limits. You can reset the limits used in JViews 6.0 by calling the setMinimumZoom and setMaximumZoom methods.

• The Map renderer (ilog.views.sdm.renderer.maps.IlvMapRenderer) now uses a default projection when no projection is found in the supplied map file. This projection is an instance of ilog.views.maps.projection.IlvEquidistantCylindricalProjection, and is suitable for use with the sample maps available on the web support site.

  The Map renderer also accepts a null map file.

General Changes

• The new JViews Diagrammer Faces components allow you to easily build JavaServer Pages (JSP) that are compliant with the JavaServer Faces (JSF) user interface framework for Java Web application.

• New features available in the Designer:
  • The new Background option (available in the Rule tree and in the Edit > Options dialog) lets you customize the background color and pattern of the diagram, as well as load a background file containing vector graphics (in IVL or SVG format).

  • The new Label Layout option (available in the Rule tree and in the Edit > Options dialog) lets you use a Label Layout algorithm to place the labels of nodes and/or links automatically.

  • Many other usability improvements have also been made in the Designer.

• The new Eclipse example shows how to integrate JViews Diagrammer in Eclipse.

• Significant performance enhancements have been made to the SDM engine. These enhancements can improve the loading time by 20 to 30% depending on the data and style used.

  In particular, you can improve the performances of your applications in many cases by disabling the mechanism that processes per-object layout parameters: see setUsePerObjectParameters.

  The new Benchmark example shows the loading time for many different graph configurations and styles, and compares the loading times using the SDM engine and using directly the Graphics Framework API.

• Usability improvements in the Graph Layout library.

Library Changes

New Packages

ilog.views.diagrammer.faces

This package (and its subpackages) contains the diagrammer specific JSF components, renderers and JSP tags.

New Interfaces and Classes

ilog.views.graphlayout.labellayout.IlvLabelingModelWithRotation

An IlvLabelingModelWithRotation is the extension of a labeling model that supports automatic positioning of rotated labels.
This new interface is intended to be implemented in user labeling models if rotated labels are needed.
The IlvDefaultLabelingModel class has been modified to support this new interface, allowing rotated labels for labeling models created from an IlvGrapher instance.

ilog.views.sdm.renderer.graphlayout.IlvSDMNodeComparator

An implementation of the Comparator interface that allows to define the one or several ordering criteria for the the nodes of the graph. It can use the values of data model attributes.

ilog.views.sdm.renderer.graphlayout.IlvSDMNodeComparator.ComparatorSortCriteria

An object that allows to specify the sort criteria using a java.util.Comparator implementation.

ilog.views.sdm.renderer.graphlayout.IlvSDMNodeComparator.DataModelAttributeSortCriteria

An object that allows to specify the sort criteria using data model attributes of the nodes.

ilog.views.sdm.renderer.graphlayout.IlvSDMNodeComparator.SortCriteria

The base class of the objects that can be used for specifying a sort criteria.

Modified Classes

ilog.views.diagrammer.IlvDiagrammer

• New methods:
  • getUndoManager(): Returns the Undo Manager of this diagrammer.
  • processServerAction(int, int): This method can be called when the diagram component is used on the server-side of a web application, to process an action sent by the client-side.
  • setAsRoot(Component): Defines the supplied component as the root component of a hierarchy with a diagrammer component.

ilog.views.diagrammer.application.IlvDiagrammerPaletteAction

• New methods:
  • getSmallIconSize(): Returns the size of the icons in the Diagrammer toolbar
  • setSmallIconSize(int): Sets the size of the icons in the Diagrammer toolbar Default is 20

ilog.views.diagrammer.application.IlvDiagrammerToolBar

• Overview of new features:
  • The actions contained in a toolbar can now be cloned, that it, the tollbar will contain copies of the actions. This is useful to use toolbars with the same actions but that will act on different Diagrammer instances.
• New constructors:
  • IlvDiagrammerToolBar(Action[], int, boolean): Creates a new Diagrammer toolbar attached to the specified diagram component, containing the specified actions, and with the specified orientation.

ilog.views.diagrammer.application.IlvDiagrammerViewBar

• Overview of new features:
  • The actions contained in a toolbar can now be cloned, that it, the tollbar will contain copies of the actions. This is useful to use toolbars with the same actions but that will act on different Diagrammer instances.
• New constructors:
  • IlvDiagrammerViewBar(int, boolean): Creates a new Diagrammer view bar.

ilog.views.graphlayout.bus.IlvBusLayout

• Overview of new features:
  • Improved customization of the node ordering.
• New methods:
  • getNodeComparator(): Returns the comparator used for sorting the nodes.
  • setNodeComparator(Comparator): Sets the comparator used for sorting the nodes.


• New fields:
  • ASCENDING_AREA: Ordering by ascending area.
  • ASCENDING_HEIGHT: Ordering by ascending height.
  • ASCENDING_INDEX: Ordering by ascending index.
  • ASCENDING_WIDTH: Ordering by ascending width.
  • DESCENDING_AREA: Ordering by descending area.
  • DESCENDING_HEIGHT: Ordering by descending height.
  • DESCENDING_INDEX: Ordering by descending index.
  • DESCENDING_WIDTH: Ordering by descending width.

ilog.views.graphlayout.grid.IlvGridLayout

• Overview of new features:
  • It is now possible to customize the ordering of the nodes.
• New methods:
  • getIndex(Object): Returns the index associated with a node.
  • setIndex(Object, int): Allows you to specify the index of a node.
  • getNodeComparator(): Returns the comparator used for sorting the nodes.
  • setNodeComparator(Comparator): Sets the comparator used for sorting the nodes.


• New fields:
  • ASCENDING_AREA: Ordering by ascending area option.
  • ASCENDING_HEIGHT: Ordering by ascending height option.
  • ASCENDING_INDEX: Ordering by ascending index option.
  • ASCENDING_WIDTH: Ordering by ascending width option.
  • AUTOMATIC_ORDERING: No ordering option.
  • DESCENDING_AREA: Ordering by descending area option.
  • DESCENDING_HEIGHT: Ordering by height option.
  • DESCENDING_INDEX: Ordering by descending index option.
  • DESCENDING_WIDTH: Ordering by descending width option.
  • NO_INDEX: No index code.
  • NO_ORDERING: No ordering option.

ilog.views.graphlayout.labellayout.IlvDefaultLabelingModel

• Overview of new features:
  • This class now implements the IlvLabelingModelWithRotation interface, allowing rotated labels when using the Annealing label layout
• New methods:
  • getLabelOverlap(Object, IlvRect, double, Object, IlvRect, double, float): Returns the overlap between two labels, if the labels would be at the given positions specified by the passed rectangles and the rotation angle.
  • getRotation(Object, IlvRect): Returns the rotation angle of a label.
  • setRotation(Object, float): Rotates the label around the center of its bounding box.
  • getObstacleOverlap(Object, IlvRect, double, Object, IlvRect, float): Returns the overlap between the label and the obstacle, if the label would be at the given position specified by the passed rectangle and the rotation angle.
  • getPolylineObstacleOverlap(Object, IlvRect, double, Object, IlvPoint[], float, float): Returns the overlap between the label and the polyline obstacle, if the label would be at the given position specified by the passed rectangle and the rotation angle.

ilog.views.graphlayout.labellayout.annealing.IlvAnnealingLabelDescriptor

• Overview of new features:
  • This class has been modified to support the new label rotation feature in the annealing label layout.
• New methods:
  • getRotation(IlvLabelingModel, IlvRect): Returns the rotation of the label if it were placed at the position given by the input rectangle labelRect.

ilog.views.graphlayout.labellayout.annealing.IlvAnnealingLabelLayout

• Overview of new features:
  • The annealing label layout now supports rotated labels for labeling models that implement the new interface IlvLabelingModelWithRotation. The IlvLabelingModelWithRotation class has been modified to implement this interface.

ilog.views.graphlayout.tree.IlvTreeLayout

• Overview of new features:
  • It is now very easy to obtain straight shapes for the non-tree links.
• New methods:
  • isNonTreeLinksStraight(): Returns true if all non-tree links that don't have the no-reshape link style and that are not fixed and are not incident to fixed nodes are reshaped to be straight.
  • setNonTreeLinksStraight(boolean): Enables whether all non-tree links that don't have the no-reshape link style and that are not fixed and are not incident to fixed nodes are reshaped to be straight.

ilog.views.graphlayout.hierarchical.IlvHierarchicalLayout

• Overview of new features:
  • If the global link style is polyline mode, the spacing between node levels can be variable in order to control the slope of the link segments. The slope is controlled by the aperture angle.
• New methods:
  • getMaxInterLevelApertureAngle(): Returns the maximal aperture angle of the links incident to a node.
  • setMaxInterLevelApertureAngle(float): Sets the maximal aperture angle of the links incident to a node. Limiting the aperture angle of links results in a variable spacing of the node levels. In order to avoid that the slope of a link segment is too steep, the spacing between node levels is automatically increased as needed.

ilog.views.interactor.IlvMoveRectangleInteractor

• New methods:
  • snapRectangleToGrid(IlvRect): This method is called to snap the given rectangle to the IlvManagerView grid.

ilog.views.interactor.IlvSelectInteractorMoveSelection

• New methods:
  • snapRectangleToGrid(IlvRect): This method is called to snap the given rectangle to the IlvManagerView grid.

ilog.views.sdm.IlvSDMEngine

• New methods:
  • processServerAction(int, int, IlvManagerView): This method can be called when the SDM engine is used on the server-side of a web application, to process an action sent by the client-side.

ilog.views.sdm.graphic.IlvGeneralLink

• Overview of new features:
  • The general link has been optimized for better performances in bounding box computations and painting. See also Incompatibilities.
• New methods:
  • isOptimized(): Sets or clears the "optimized" mode of this link.
  • setOptimized(boolean): Sets or clears the "optimized" mode of this link.

ilog.views.sdm.graphic.IlvURLGraphic

• Overview of new features:
  • This class can now be saved and restored to IVL files.
• New methods:
  • applyTransform(IlvTransformer): Applies a transformer to this graphic object.
  • getBackground(): Returns the background color of all the objects in the graphic set, or null if the background color has not been set.
  • getForeground(): Returns the foreground color of all the objects in the graphic set, or null if the foreground color has not been set.

ilog.views.sdm.model.IlvTableSDMModel

• Overview of new features:
  • A new option lets you choose whether all the columns of the table should be mapped automatically to SDM properties, or if all mapping should be explicitely defined.
• New constructors:
  • IlvTableSDMModel(IlvTableModelMapper, String, boolean, boolean): Creates a new Table-to-SDM-model adapter.


• New methods:
  • isMapAllColumns(): Returns the flag that specifies whether all the columns of the table model are automatically mapped to object properties in the SDM model.
  • setMapAllColumns(boolean): Specifies whether all the columns of the table model are automatically mapped to object properties in the SDM model, even if the table model mapper does not define a mapping explicitely.

ilog.views.sdm.renderer.IlvCSSSDM

• New methods:
  • customizeBeanWithDeclarations(Map, IlvSDMModel, Object, Object, String[], boolean): Same as customizeBean, but provides the declarations used to create and to customize the bean.

ilog.views.sdm.renderer.IlvDecorationRenderer

• Overview of new features:
  • The Decoration renderer now accepts SVG files as vector background images. A new option specifies whether a "fit-to-content" must be done or not after loading the background file.
• New methods:
  • isFitToContent(): Returns the value of the "fit-to-content" flag.
  • setFitToContent(boolean): Specifies whether a "fit-to-content" will be performed after the background file has been loaded.

ilog.views.sdm.renderer.IlvFilterSDMRenderer

• New methods:
  • processServerAction(int, int, IlvManagerView): Calls the filtered renderer's processServerAction method.

ilog.views.sdm.renderer.IlvLegendRenderer

• New methods:
  • processServerAction(int, int, IlvManagerView): Processes clicks in the legend's check boxes from the client-side of a web application.

ilog.views.sdm.renderer.IlvSDMRenderer

• New methods:
  • processServerAction(int, int, IlvManagerView): This method is called when the SDM is used on the server-side of a web application, to process an action sent by the client-side.

ilog.views.sdm.renderer.IlvStyleSheetRenderer

• New methods:
  • customizeBeanWithDeclarations(Map, IlvSDMModel, Object, Object, String[], boolean): Same as customizeBean, but provides the declarations to create and customize the bean

ilog.views.sdm.renderer.IlvSubGraphRenderer

• New methods:
  • processServerAction(int, int, IlvManagerView): Processes clicks in the expand/collapse icons from the client-side of a web application.

ilog.views.sdm.renderer.graphlayout.IlvGraphLayoutRenderer

• Overview of new features:
  • Processing of per-object layout parameters can be disabled for better performances.
• New methods:
  • isUsePerObjectParameters(): Returns true if per-object layout parameters are enabled (the default), or false otherwise.
  • setUsePerObjectParameters(boolean): Enables or disables per-object layout parameters.

ilog.views.sdm.renderer.graphlayout.IlvLabelLayoutRenderer

• New methods:
  • getAuxiliaryBeans(): Returns an array containing the IlvLabelLayout object returned by getReferenceLabelLayout.
  • getRecursiveMultipleLayout(): Returns the instance of IlvRecursiveMultipleLayout internally used by this renderer.
  • getReferenceLabelLayout(): Returns the reference label layout used by the internal IlvRecursiveMultipleLayout.

ilog.views.swing.IlvJScrollManagerView

• Overview of new features:
  • Mouse wheel support.
• New methods:
  • isWheelScrollingEnabled(): Indicates whether or not scrolling will take place in response to movement of the mouse wheel.
  • setWheelScrollingEnabled(boolean): Enables/disables scrolling in response to movement of the mouse wheel.

Example Changes

• JSF examples: These new examples show how to use the JViewsDiagrammer JSF components to display and interact on a diagrammer in a server environment.
• Eclipse example: This new example shows how to integrate the JViews Diagrammer in an Eclipse plug-in.
• Benchmark example: This new example shows the performances of JViews Diagrammer when loading graphs of different sizes, and using different styling options.
• Extension example: This new example shows how to use the Diagrammer SDK to add fonctionality to a project created with the Designer.
• Link Bundle example: This example now shows the new "single connection point" feature.
• Rotated Label Layout example: This new example shows the support of rotated labels for label layout.