JViews 5.5 Maps Release Notes

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

General Changes
Library Changes

New Interfaces and Classes

• ilog.views.maps.IlvMapCSSRenderer
• ilog.views.maps.format.oracle.objectmodel.IlvDefaultObjectSDOKeyExtractor
• ilog.views.maps.format.oracle.objectmodel.IlvObjectSDODimElement
• ilog.views.maps.format.oracle.objectmodel.IlvObjectSDOLayerMetaData
• ilog.views.maps.srs.coordtrans.IlvFittedTransform

Modified Classes

• ilog.views.maps.IlvAttributeInfoProperty
• ilog.views.maps.IlvScaleController
• ilog.views.maps.IlvScaleVisibilityFilter
• ilog.views.maps.attribute.IlvBooleanAttribute
• ilog.views.maps.attribute.IlvDoubleAttribute
• ilog.views.maps.attribute.IlvIntegerAttribute
• ilog.views.maps.attribute.IlvStringAttribute
• ilog.views.maps.format.IlvMapDataPathResolver
• ilog.views.maps.format.image.IlvImageReader
• ilog.views.maps.format.image.IlvImageTileLoader
• ilog.views.maps.format.oracle.objectmodel.IlvDefaultObjectSDOTileLoader
• ilog.views.maps.format.oracle.objectmodel.IlvObjectSDOLayer
• ilog.views.maps.format.oracle.objectmodel.IlvObjectSDOUtil
• ilog.views.maps.format.shapefile.IlvDBFReader
• ilog.views.maps.graphic.IlvAnchoredLabel
• ilog.views.maps.labelling.IlvLabeledPointRenderer

General Changes

• The interface IlvStroke is no longer used in the Maps package. All the rendering attributes defined in this interface are now accessed in the Maps package directly through the java.awt.BasicStroke class. For instance, don�t use IlvStroke.CAP_BUTT any longer, use java.awt.BasicStroke.CAP_BUTT instead.
• The MapBuilder can now be launched as a stand-alone application or as an extension of Composer.

Library Changes

New Interfaces and Classes

ilog.views.maps.IlvMapCSSRenderer

The Cascading Style Sheet (CSS) renderer is a renderer able to customize another renderer or able to create a renderer using a CSS file.

ilog.views.maps.format.oracle.objectmodel.IlvDefaultObjectSDOKeyExtractor

This implementation of IlvObjectSDOKeyExtractor extracts unique IDs from a given layer column.

ilog.views.maps.format.oracle.objectmodel.IlvObjectSDODimElement

This object allows you to define dimensions for layers.

ilog.views.maps.format.oracle.objectmodel.IlvObjectSDOLayerMetaData

This class represents the metadata information for an Oracle Spatial layer.

ilog.views.maps.srs.coordtrans.IlvFittedTransform

A transformation that transforms coordinates using a polynomial transform between two sets of points. This transformation allows superimposition of maps of different coordinate systems even if their coordinate systems are unknown, provided that a set of tie-points can be found between the maps.

Modified Classes

ilog.views.maps.IlvAttributeInfoProperty

• Overview of new features:
  • Added a method to retrieve an index of attributes whose names are specified.
• New methods:
  • getAttributeIndex(String): Returns the index of the first attribute with the specified name.

ilog.views.maps.IlvScaleController

• Overview of new features:
  • Added two methods to center views around a given point.
• New methods:
  • FitTransformerToPoint(IlvManagerView, IlvLinearUnit, double, IlvPoint, boolean): Centers the specified view around the specified point and sets the scale of the view to the specified scale.
  • FitTransformerToPoint(IlvManagerView, double, IlvPoint, boolean): Centers the specified georeferenced view around the specified point and sets the scale of the view to the specified scale.

ilog.views.maps.IlvScaleVisibilityFilter

• Overview of new features:
  • This class now extends ilog.views.IlvZoomFactorVisibilityFilter.

ilog.views.maps.attribute.IlvBooleanAttribute

• Overview of new features:
  • Added a static method to directly retrieve the boolean value of an IlvBooleanAttribute contained in an IlvAttributeProperty.
• New methods:
  • BooleanValue(IlvAttributeProperty, String): Returns the boolean value of the IlvBooleanAttribute which name is specified.

ilog.views.maps.attribute.IlvDoubleAttribute

• Overview of new features:
  • Added a static method to directly retrieve the double value of an IlvDoubleAttribute contained in an IlvAttributeProperty.
• New methods:
  • DoubleValue(IlvAttributeProperty, String): Returns the double value of the IlvDoubleAttribute which name is specified.

ilog.views.maps.attribute.IlvIntegerAttribute

• Overview of new features:
  • Added a static method to directly retrieve the int value of an IlvIntegerAttribute contained in an IlvAttributeProperty.
• New methods:
  • IntValue(IlvAttributeProperty, String): Returns the int value of the IlvIntegerAttribute which name is specified.

ilog.views.maps.attribute.IlvStringAttribute

• Overview of new features:
  • Added a static method to directly retrieve the String value of an IlvStringAttribute contained in an IlvAttributeProperty.
• New methods:
  • StringValue(IlvAttributeProperty, String): Returns the String value of the IlvStringAttribute which name is specified.

ilog.views.maps.format.IlvMapDataPathResolver

• Overview of new features:
  • The resolver now also resolve URLs.
• New methods:
  • resolveURL(String): Resolves the specified relative filename.

ilog.views.maps.format.image.IlvImageReader

• Overview of new features:
  • Added the constructor to read image from an URL.
• New constructors:
  • IlvImageReader(URL, IlvCoordinate, IlvCoordinate): Constructs an IlvImageReader by specifying the URL of the image file to read and the coordinates of the image.

 

ilog.views.maps.format.image.IlvImageTileLoader

• Overview of new features:
  • The IlvImageTileLoader now interprets the result from its method  getFileName(IlvTile) as an URL first. If the string returned by this method could not be interpreted as an URL, the string will be interpreted as a plain file name.

   

ilog.views.maps.format.oracle.objectmodel.IlvDefaultObjectSDOTileLoader

• Overview of new features:
  • The main constructor of previous version has been deprecated and is now replaced by the new constructor described below.
• New constructors:
  • IlvDefaultObjectSDOTileLoader(IlvSDOConnection, IlvObjectSDOLayerMetaData, double, double, String, String, IlvObjectSDOKeyExtractor, IlvRect): The main constructor of IlvDefaultObjectSDOTileLoader.
• New methods:
  • getLayerMetaData(): Returns the metadata associated with the tile loader.

ilog.views.maps.format.oracle.objectmodel.IlvObjectSDOLayer

• Overview of new features:
  • The former constructor has been deprecated and is now replaced by a new one using user specified layer metadata.
• New constructors:
  • IlvObjectSDOLayer(IlvSDOConnection, IlvObjectSDOLayerMetaData, double, double, String, String, IlvObjectSDOKeyExtractor, IlvRect): The main constructor of IlvObjectSDOLayer to load data from an Object SDO layer.

ilog.views.maps.format.oracle.objectmodel.IlvObjectSDOUtil

• Overview of new features:
  • Added the capability to retrieve metadata associated with a given table.
• New methods:
  • GetLayerMetaData(Connection, String, String, String, String): Returns metadata built from the database.

ilog.views.maps.format.shapefile.IlvDBFReader

• Overview of new features:
  • Added the capability to return interned strings. When reading DBF files containing string attributes that always have the same value, this can help use less memory.
  • Added the capability to selectively read and decode attributes. When reading DBF files containing a great number of attributes, and when some of the attributes are not useful for the application, this can cut down the memory used and the CPU overhead to decode attributes.
• New methods:
  • isInterningStringAttributes(): Returns true if the String attributes that are read are interned.
  • setInterningStringAttributes(boolean): Specifies whether the String attributes that are read are interned.
  • isReadingAttribute(int): Returns true if the specified attribute is read.
  • setReadingAttribute(int, boolean): Tells the reader whether to read the attribute whose index is specified.

ilog.views.maps.graphic.IlvAnchoredLabel

• New methods:
  • setReference(IlvGraphic): Sets the reference IlvGraphic.

ilog.views.maps.labelling.IlvLabeledPointRenderer

• Overview of new features:
  • This renderer has been updated so that it can be customized by the CSS renderer.
• New constructors:
  • IlvLabeledPointRenderer(): Constructs an empty IlvLabeledPointRenderer.
• New methods:
  • getAttributeNames(): Retrieves the array of attribute names.
  • setAttributeNames(String[]): Sets the attributes whose names are candidate to be displayed by the label.
  • getRejectedValues(): Retrieves the arrays of values to be rejected from attribute values.
  • setRejectedValues(String[]): Sets the arrays of values to be rejected from attribute values.

New Examples

CSS Rendering example

• This example is located in directory <installdir>/demos/maps/css. It demonstrates the usage of the new class IlvCSSRendering that performs the rendering of map features using a CSS file.