JViews 5.5 Graphics Framework Release Notes

This document describes the main changes that have been made to the JViews Graphics Framework since version 5.0.

Incompatibilities
General Changes
Library Changes
New Packages

• ilog.views.print
• ilog.views.svg.servlet

New Classes

• ilog.views.IlvApplyObjects
• ilog.views.IlvDefaultGrapherPin
• ilog.views.IlvManagerViewDecoration
• ilog.views.IlvZoomFactorVisibilityFilter
• ilog.views.graphic.IlvSVGGraphicSet
• ilog.views.interactor.IlvGrapherPinInteractor
• ilog.views.svg.SVGDocumentReader
• ilog.views.svg.SVGDocumentReaderConfigurator

Modified Classes

• ilog.views.IlvCenterLinkConnector
• ilog.views.IlvDefaultManagerFrame
• ilog.views.IlvGrapherPin
• ilog.views.IlvGraphic
• ilog.views.IlvGraphicUtil
• ilog.views.IlvHandlesSelection
• ilog.views.IlvLinkConnector
• ilog.views.IlvManager
• ilog.views.IlvManagerView
• ilog.views.IlvObjectInteractorContext
• ilog.views.IlvPinLinkConnector
• ilog.views.IlvTransformer
• ilog.views.event.ManagerSelectionChangedEvent
• ilog.views.graphic.IlvArc
• ilog.views.graphic.IlvEllipse
• ilog.views.graphic.IlvPolygon
• ilog.views.graphic.IlvRectangle
• ilog.views.graphic.IlvSpline
• ilog.views.interactor.IlvMakePolygonInteractor
• ilog.views.interactor.IlvMakeRectangleInteractor
• ilog.views.interactor.IlvMakeSplineInteractor
• ilog.views.interactor.IlvPanInteractor
• ilog.views.interactor.IlvSelectInteractor
• ilog.views.interactor.IlvUnZoomViewInteractor
• ilog.views.svg.SVGDocumentBuilder
• ilog.views.svg.SVGDocumentBuilderConfigurator
• ilog.views.svg.SVGStreamFactory
• ilog.views.svg.dom.SVGUtil
• ilog.views.thinclient.IlvZoomTool
• ilog.views.tiling.IlvTile

Incompatibilities

• Some deprecated methods and classes of JViews 5.5 have been removed; check the JViews 5.0 Reference Manual for alternatives in each case.
• IlvReliefRectangle and IlvShadowRectangle now inherit directly from IlvRectangle and no longer from IlvFilledRectangle, which has been deprecated.
• Views C++ files (ILV files) import facilities have been deprecated.

General Changes

The main new features of the Graphics Framework are the following:

• Printing Framework: In JViews 5.5, the Graphics Framework is using the new Generic Printing Framework of the JViews Component Suite to provide new printing features such as preview, printing area selection, and a printing page customization dialog to the Graphics Framework user. You will find the corresponding classes in the ilog.views.print package.
• SVG: In JViews 5.0, only static features of an IlvManager could be exported to SVG. In JViews 5.5, the IlvSVGManagerServlet allows you to enhance the generated SVG document with the following SVG Thin-Client dynamic features:

  • A dynamic SVG OverView of your generated SVG document for easy navigation on the SVG client.
  • A dynamic Layer View of your generated SVG document to easily switch on or off the visibility of the layers on the SVG client.
  • IlvFixedSizeGraphic and IlvLabel behaves as nonzoomable on the SVG dynamic client.

  • Layer Visibility management is exported to the SVG client with the ability to load on demand invisible layers.

  • IlvGraphics tooltips are shown on the SVG dynamic client.

• Composer: In JViews 5.5, Composer has been rewritten on top of Application Framework, providing to Composer users a very flexible way to customize it using the Application Framework settings API. In addition, the Printing Framework functionalities and a new color chooser bar have been added to Composer.
• Graphics Objects: Some JViews Graphics Objects have been deprecated and merged with some other Graphics Objects to simplify the IlvGraphic hierarchy and allow easy modification of created instances by the developers.
• Link Connectors: There is improved customization of the connection points of grapher links. Link Connectors (subclasses of IlvLinkConnector) can now be specified individually for each link, not only for each node.

  A default implementation of the abstract class IlvGrapherPin is now provided: IlvDefaultGrapherPin.

• Interactors: There is a new interactor: Grapher Pin Interactor ( IlvGrapherPinInteractor).
• Support for JDK 1.4 Headless Mode: To activate this feature, you must run your JVM with the following property: -Djava.awt.headless=true. You can find more information on how to run the server side examples here.

  ---

  Library Changes

  New Packages

  ilog.views.print

  This package, based on the JViews Printing Framework, provides the facilities to print the contents of an IlvManager instance.

  ilog.views.svg.servlet

  This package provides the Servlet implementation to deploy an SVG Thin Client with the JViews Graphics Framework.

  New Classes

  ilog.views.IlvApplyObjects

  IlvApplyObjects is an interface which is used to apply a method that affects many graphic objects.

  ilog.views.IlvDefaultGrapherPin

  This class is a convenient concrete implementation of the abstract class IlvGrapherPin.

  ilog.views.IlvManagerViewDecoration

  An IlvManagerViewDecoration is an interface that must be implemented by objects that need to draw something on top of an IlvManagerView

  ilog.views.IlvZoomFactorVisibilityFilter

  Controls the visibility of a layer according to the zoom factor on the view.

  ilog.views.graphic.IlvSVGGraphicSet

  A subclass of IlvGraphicSet that allows you to load the contents of an SVG file into it.

  ilog.views.interactor.IlvGrapherPinInteractor

  An interactor to edit IlvGrapherPin, managed by link connectors of type IlvPinLinkConnector.

  ilog.views.svg.SVGDocumentReader

  This class populates an IlvGraphicBag with the translation of the SVG Element instances of an SVG Document.

  ilog.views.svg.SVGDocumentReaderConfigurator

  This class allows you to configure an SVGDocumentReader instance.

  Modified Classes

  ilog.views.IlvCenterLinkConnector

  • New constructors:
    • IlvCenterLinkConnector(IlvLinkImage, boolean): Creates an IlvCenterLinkConnector attached to the origin or destination of link.

  ilog.views.IlvDefaultManagerFrame

  • New methods:
    • setTitle(String): Sets the title of the frame.
    • getTitle(): Returns the title of the frame.

  ilog.views.IlvGrapherPin

  • New methods:
    • getPinLinkConnector(): Returns the IlvPinLinkConnector which manages this pin, or null if the pin has been removed.
    • getColor(): Returns the color of the pin ghost.
    • setPosition(IlvPoint, IlvTransformer): Sets the position of the pin.
    • allowsMove(): Returns true if the location of the pin can be changed using the method #setPosition, and returns false otherwise.

  ilog.views.IlvGraphic

  • New methods:
    • setFillOn(boolean): Changes the fill status of the object. The default implementation does nothing.
    • setStrokeOn(boolean): Changes the stroke status of the object. The default implementation does nothing.

  ilog.views.IlvGraphicUtil

  • New methods:
    • isPrinting(Graphics): Returns true if we are currently printing. 
    • PointInPolygon(IlvPoint, IlvPoint[], int, IlvTransformer, boolean): Performs a hit test on a polygon.

  ilog.views.IlvHandlesSelection

  • New fields:
    • FILLED_CIRCLE_SHAPE: The filled circle shape for handles.
    • CIRCLE_SHAPE: The circle shape for handles.

  ilog.views.IlvLinkConnector

  • New constructors:
    • IlvLinkConnector(IlvLinkImage, boolean): Creates an IlvLinkConnector attached to the origin or destination of link. 
  • New methods:
    • attach(IlvLinkImage, boolean, boolean): Installs the link connector for the origin or destination of link. 
    • detach(IlvLinkImage, boolean, boolean): Detaches the link connector from the origin or destination of link. 
    • GetAttached(IlvGraphic): Returns the link connector attached to node using #attach(IlvGraphic, boolean), or null if none. 
    • GetAttached(IlvLinkImage, boolean): Returns the link connector attached to the origin or destination of link using #attach(IlvLinkImage, boolean, boolean), or null if none. 
    • Get(IlvLinkImage, boolean): Returns the link connector that actually controls the connection point on the origin or destination node of link.

  ilog.views.IlvManager

  • New methods:
    • applyToObjects(IlvGraphicVector, IlvApplyObject, Object, boolean): Applies a method to many graphic objects. 
    • applyToObjects(IlvGraphicEnumeration, IlvApplyObject, Object, boolean): Applies a method to many graphic objects. 
    • applyToObjects(IlvGraphicVector, IlvApplyObjects, Object, boolean): Applies a method that affects many graphic objects. 
    • applyToObjects(IlvGraphicEnumeration, IlvApplyObjects, Object, boolean): Applies a method that affects many graphic objects. 
    • setContentsAdjusting(boolean, boolean): Tells the manager and optionally all its parent managers that it is the beginning or the end of a major modification of its contents. 
    • translateObjects(IlvGraphicEnumeration, float, float, IlvTransformer): Translates the input objects that must belong to this manager. 
    • setTransformer(IlvTransformer): Changes the local transformer of this manager. 
    • isKeepingAspectRatio(): Returns true if the local transformer of this manager keeps the aspect ratio; otherwise it returns false. 
    • setKeepingAspectRatio(boolean): Allows or inhibits the ability of the local transformer of this manager to have different zoom factors along the x and y axes. 
    • getTreeLock(): Returns the object used to synchronize the contents of the manager for a multithreaded environment.

  ilog.views.IlvManagerView

  • New methods:
    • setZoomFactorRange(double, double): Sets the minimal and maximal zoom factor allowed for the view. 
    • setMinZoomXFactor(double): Sets the minimal zoom factor allowed for the view in the x direction.
    • getMinZoomXFactor(): Returns the minimal zoom factor allowed for the view in the x direction.
    • setMaxZoomXFactor(double): Sets the maximal zoom factor allowed for the view in the x direction. 
    • getMaxZoomXFactor(): Returns the maximal zoom factor allowed for the view in the x direction.
    • setMinZoomYFactor(double): Sets the minimal zoom factor allowed for the view in the y direction.
    • getMinZoomYFactor(): Returns the minimal zoom factor allowed for the view in the y direction.
    • setMaxZoomYFactor(double): Sets the maximal zoom factor allowed for the view in the y direction. 
    • getMaxZoomYFactor(): Returns the maximal zoom factor allowed for the view in the y direction.
    • isAtZoomXFactorLimit(): Returns true if the zoom factor of the view reached the minimal or the maximal zoom factor limit in the x direction when the transformer was changed.
    • isAtZoomYFactorLimit(): Returns true if the zoom factor of the view reached the minimal or the maximal zoom factor limit in the y direction when the transformer was changed.
    • addViewDecoration(IlvManagerViewDecoration): Adds a decoration to the view. 
    • removeViewDecoration(IlvManagerViewDecoration): Removes a decoration from the view.
    • getViewDecorationCount(): Returns the number of decorations added to the view.
    • getViewDecoration(int): Returns the decoration installed on the view at the specified index.

  ilog.views.IlvObjectInteractorContext

  • New methods:
    • getCursor(): Returns the cursor of the context.

  ilog.views.IlvPinLinkConnector

  • New constructors:
    • IlvPinLinkConnector(IlvLinkImage, boolean): Creates an IlvPinLinkConnector attached to the origin or destination of link, with no pins. 
  • New methods:
    • drawGhost(Graphics, IlvTransformer): Draws all the pins. 

  ilog.views.IlvTransformer

  • New methods:
    • zoomXFactor(): Returns the zoom factor of the transformer in the x direction.
    • zoomYFactor(): Returns the zoom factor of the transformer in the y direction.

  ilog.views.event.ManagerSelectionChangedEvent

  • New methods:
    • getType(): Returns the type of the event. 
  • New fields:
    • OBJECT_SELECTED: The type of the event when an object is selected.
    • OBJECT_DESELECTED: The type of the event when an object is deselected.

  ilog.views.graphic.IlvArc

  • New constructors:
    • IlvArc(IlvRect, float, float, boolean, boolean): Creates a new IlvArc.
  • New methods:
    • setBackground(Color): Changes the background color of the IlvArc. It is the color used to fill the arc.
    • getBackground(): Returns the background color of the IlvArc. It is the color used to fill the arc.
    • isFillOn(): Returns true if the inside of the arc will be filled.
    • setFillOn(boolean): If true, specifies that the inside of the arc will be filled.
    • isStrokeOn(): Returns true if the shape of the arc is stroked.
    • setStrokeOn(boolean): When set to true, specifies that the shape of the arc is stroked.

  ilog.views.graphic.IlvEllipse

  • New constructors:
    • IlvEllipse(IlvRect, boolean, boolean): Creates a new IlvEllipse.
  • New methods:
    • setBackground(Color): Changes the background color of the IlvEllipse. It is the color used to fill the ellipse.
    • getBackground(): Returns the background color of the IlvEllipse. It is the color used to fill the ellipse.
    • isFillOn(): Returns true if the inside of the ellipse will be filled.
    • setFillOn(boolean): If true, specifies that the inside of the ellipse will be filled.
    • isStrokeOn(): Returns true if the shape of the ellipse is stroked.
    • setStrokeOn(boolean): When set to true, specifies that the shape of the ellipse is stroked.

  ilog.views.graphic.IlvPolygon

  • New constructors:
    • IlvPolygon(IlvPoint[], boolean, boolean, boolean): Creates a new IlvPolygon.
  • New methods:
    • setBackground(Color): Changes the background color of the IlvPolygon. It is the color used to outline the polygon.
    • getBackground(): Returns the background color of the IlvPolygon. It is the color used to outline the polygon.
    • isFillOn(): Returns true if the inside of the polygon will be filled.
    • setFillOn(boolean): If true, specifies that the inside of the polygon will be filled.
    • isStrokeOn(): Returns true if the shape of the polygon is stroked.
    • setStrokeOn(boolean): When set to true, specifies that the shape of the polygon is stroked.

  ilog.views.graphic.IlvRectangle

  • New constructors:
    • IlvRectangle(IlvRect, boolean, boolean): Creates a new IlvRectangle.
    • IlvRectangle(IlvRect, boolean, boolean, int): Creates a new IlvRectangle with rounded corners.
  • New methods:
    • setBackground(Color): Changes the background color of the IlvRectangle. It is the color used to fill the rectangle.
    • getBackground(): Returns the background color of the IlvRectangle. It is the color used to fill the rectangle.
    • setRadius(int): Changes the radius.
    • getRadius(): Returns the radius.
    • isFillOn(): Returns true if the inside of the rectangle will be filled.
    • setFillOn(boolean): If true, specifies that the inside of the rectangle will be filled.
    • isStrokeOn(): Returns true if the rectangle is stroked.
    • setStrokeOn(boolean): When set to true, specifies that the rectangle is stroked.

  ilog.views.graphic.IlvSpline

  • New constructors:
    • IlvSpline(IlvPoint[], boolean, boolean): Creates a new IlvSpline.
  • New methods:
    • setBackground(Color): Changes the background color of the IlvSpline. It is the color used to fill the spline.
    • getBackground(): Returns the color of the IlvSpline. It is the color used to fill the spline.
    • isFillOn(): Returns true if the inside of the spline will be filled.
    • setFillOn(boolean): If true, specifies that the inside of the spline will be filled.
    • isStrokeOn(): Returns true if the spline is stroked.
    • setStrokeOn(boolean): When set to true, specifies that the spline is stroked.
    • setClosed(boolean): When set to true, specifies that the spline is closed.
    • isClosed(): Returns true if the spline is closed.

  ilog.views.interactor.IlvMakePolygonInteractor

  • New methods:
    • isFillOn(): Returns true if the inside of the created object should be filled.
    • setFillOn(boolean): If true, specifies that the inside of the created object should be filled.
    • isStrokeOn(): Returns true if the created object should be stroked.
    • setStrokeOn(boolean): When set to true, specifies that the created object should be stroked.

  ilog.views.interactor.IlvMakeRectangleInteractor

  • New methods:
    • isFillOn(): Returns true if the inside of the created object should be filled.
    • setFillOn(boolean): If true, specifies that the inside of the created object should be filled.
    • isStrokeOn(): Returns true if the created object should be stroked.
    • setStrokeOn(boolean): When set to true, specifies that the created object should be stroked.

  ilog.views.interactor.IlvMakeSplineInteractor

  • New methods:
    • isFillOn(): Returns true if the inside of the created object should be filled.
    • setFillOn(boolean): If true, specifies that the inside of the created object should be filled.
    • isStrokeOn(): Returns true if the created object should be stroked.
    • setStrokeOn(boolean): When set to true, specifies that the spline is stroked.
    • setClosed(boolean): When set to true, specifies that the created spline should be closed.
    • isClosed(): Returns true if the created spline should be closed.

  ilog.views.interactor.IlvPanInteractor

  • New methods:
    • isPermanent(): Returns false if the interactor will be removed from the view once the object is created. 
    • setPermanent(boolean): Allows you to specify if the interactor will or will not be removed from the view once the object is created.

  ilog.views.interactor.IlvSelectInteractor

  • New methods:
    • setLinksFollowEndNodes(boolean): Sets whether the bends of unselected links will move when both end nodes are selected and move.
    • isLinksFollowEndNodes(): Returns true if the bends of unselected links will move when both end nodes are selected and move.
    • getSelectedMovingObjects(IlvManager): Returns the selected moving objects of the input manager. 

  ilog.views.interactor.IlvUnZoomViewInteractor

  • New methods:
    • isPermanent(): Returns true if the interactor operates in permanent mode; false otherwise.
    • setPermanent(boolean): Changes the mode of the interactor.

  ilog.views.svg.SVGDocumentBuilder

  • New methods:
    • translate(IlvManagerLayer): Returns an Element for the given IlvManagerLayer. If it returns null the layer will not be added to the generated SVG Document.
    • getMetadata(): Returns the metadata node of the SVG document.

  ilog.views.svg.SVGDocumentBuilderConfigurator

  • New methods:
    • getSVGProfile(): Returns the SVG profile used to generate SVG documents.
    • setSVGProfile(short): Sets the SVG profile used to generate SVG documents. 
    • isEmbeddedImagesOn(): Returns true if the translation of IlvIcon should embed the images in the SVG file instead of referencing them..
    • setEmbeddedImagesOn(boolean): Specifies whether images are embedded or referenced. Setting this value to true will allow IlvIcon translations to embed the images in the SVG file instead of referencing them. 
    • isMetadataOn(String): Returns true if the SVGDocumentBuilder will generate special metadata from the given XML namespace if available. 
    • getPrefix(String): Returns the prefix used to generate metadata from the given XML namespace.
    • setMetadataOn(String, String, boolean): Allows you to tell the SVGDocumentBuilder to generate special metadata from the given XML namespace if available. .
  • New fields:
    • COMPACT_LOD: Performs compaction by not generating SVG for an IlvManagerLayer that can be loaded only on demand for an SVG client (layers that are not visible). 
    • FULL_SVG: Generates SVG documents using the full profile of SVG.
    • BASIC_SVG: Generates SVG documents using the basic profile of SVG. 
    • JVIEWS_GF_NAMESPACE_URI: JViews Graphics Framework XML Namespace URI. I
    • JVIEWS_GF_NAMESPACE_PREFIX: JViews Graphics Framework XML Namespace default Prefix.

  ilog.views.svg.SVGStreamFactory

  • New constructors:
    • SVGStreamFactory(SVGDocumentReaderConfigurator, SVGDocumentBuilderConfigurator): Builds an SVGStreamFactory instance configured with an SVGDocumentReaderConfigurator and an SVGDocumentBuilderConfigurator.
  • New methods:
    • getReaderConfigurator(): Returns the SVGDocumentReaderConfigurator
    • getBuilderConfigurator(): Returns the SVGDocumentBuilderConfigurator
    • createSVGDocumentReader(): Creates an SVGDocumentReader that will be used by the SVGInputStream to fill an IlvManager from the contents of an SVGDocument

  ilog.views.svg.dom.SVGUtil

  • New methods:
    • createSVGDocument(SVGDocumentBuilderConfigurator.RealToStringConverter, short): Returns an implementation instance of the SVGDocument interface.

  ilog.views.thinclient.IlvZoomTool

  • New methods:
    • getZoomLevel(int): Returns the zoom level used for the specified zoom button

  ilog.views.tiling.IlvTile

  • New constructors:
    • IlvTile(int, int, IlvTileController): Constructs a tile which column and row are specified. The tile is created to be used with the specified tile controller.

  ---

  Example Changes

  • A new example demonstrating the SVG Thin-Client capabilities has been added under <jviewsdir>/demos/servlet/svg-dynamic.
  • A new example explaining how to build IlvGraphic instances has been added under <jviewsdir>/demos/graphics.
  • The Grapher Pin demo located in <jviewsdir>/demos/grapher now includes the new Grapher Pin Interactor (IlvGrapherPinInteractor).

  ---