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
Example Changes
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
IlvReliefRectangle
and IlvShadowRectangle
now
inherit directly from IlvRectangle
and no longer
from IlvFilledRectangle
, which has been
deprecated.The main new features of the Graphics Framework are the following:
ilog.views.print
package.
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:
IlvFixedSizeGraphic
and
IlvLabel
behaves as nonzoomable on the SVG dynamic client.
IlvGraphics
tooltips are shown on the SVG dynamic client.IlvGraphic
hierarchy and allow easy modification of created instances by the developers.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
.
IlvGrapherPinInteractor
).This package, based on the JViews Printing Framework, provides the facilities to print the contents of an
IlvManager
instance.
This package provides the Servlet implementation to deploy an SVG Thin Client with the JViews Graphics Framework.
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 anIlvManagerView
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 typeIlvPinLinkConnector
.
ilog.views.svg.SVGDocumentReader
This class populates an
IlvGraphicBag
with the translation of the SVGElement
instances of an SVGDocument
.
ilog.views.svg.SVGDocumentReaderConfigurator
This class allows you to configure an
SVGDocumentReader
instance.
ilog.views.IlvCenterLinkConnector
IlvCenterLinkConnector(IlvLinkImage, boolean)
:
Creates an IlvCenterLinkConnector
attached to the origin or destination of link
.
ilog.views.IlvDefaultManagerFrame
setTitle(String)
:
Sets the title of the frame.
getTitle()
:
Returns the title of the frame.
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.
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.
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
FILLED_CIRCLE_SHAPE
:
The filled circle shape for handles.
CIRCLE_SHAPE
:
The circle shape for handles.
IlvLinkConnector(IlvLinkImage, boolean)
:
Creates an IlvLinkConnector
attached to the origin or destination of link
.
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
.
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.
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
getCursor()
:
Returns the cursor of the context.
ilog.views.IlvPinLinkConnector
IlvPinLinkConnector(IlvLinkImage, boolean)
:
Creates an IlvPinLinkConnector
attached to the origin or destination of link
, with no pins.
drawGhost(Graphics, IlvTransformer)
:
Draws all the pins.
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
getType()
:
Returns the type of the event.
OBJECT_SELECTED
:
The type of the event when an object is selected.
OBJECT_DESELECTED
:
The type of the event when an object is deselected.
IlvArc(IlvRect, float, float, boolean, boolean)
:
Creates a new IlvArc
.
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.
IlvEllipse(IlvRect, boolean, boolean)
:
Creates a new IlvEllipse
.
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.
IlvPolygon(IlvPoint[], boolean, boolean, boolean)
:
Creates a new IlvPolygon
.
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
IlvRectangle(IlvRect, boolean, boolean)
:
Creates a new IlvRectangle
.
IlvRectangle(IlvRect, boolean, boolean, int)
:
Creates a new IlvRectangle
with rounded corners.
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.
IlvSpline(IlvPoint[], boolean, boolean)
:
Creates a new IlvSpline
.
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
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
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
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
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
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
isPermanent()
:
Returns true
if the interactor operates in permanent mode; false
otherwise.
setPermanent(boolean)
:
Changes the mode of the interactor.
ilog.views.svg.SVGDocumentBuilder
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
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.
.
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
SVGStreamFactory(SVGDocumentReaderConfigurator, SVGDocumentBuilderConfigurator)
:
Builds an SVGStreamFactory
instance configured with an
SVGDocumentReaderConfigurator
and an
SVGDocumentBuilderConfigurator
.
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
createSVGDocument(SVGDocumentBuilderConfigurator.RealToStringConverter, short)
:
Returns an implementation instance of the SVGDocument
interface.
ilog.views.thinclient.IlvZoomTool
getZoomLevel(int)
:
Returns the zoom level used for the specified zoom button
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.
IlvGraphic
instances has been added
under <jviewsdir>/demos/graphics.
IlvGrapherPinInteractor
).