JViews Maps for Defense Release Notes

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

Incompatibilities
General Changes
Library Changes
New Packages

• ilog.views.maps.defense.terrain3d.component

• ilog.views.maps.defense.terrain3d.model

• ilog.views.maps.defense.terrain3d.symbol

• ilog.views.maps.defense.terrain3d.util

• ilog.views.maps.defense.terrain3d.view

New Interfaces and Classes

• ilog.views.maps.defense.symbology.swing.IlvAbstractGroupTreeViewActions
• ilog.views.maps.defense.symbology.swing.IlvSymbologyTreeView
• ilog.views.maps.defense.symbology.swing.IlvSymbologyTreeViewActions
• ilog.views.maps.defense.terrain.IlvGradientRasterStyleBeanInfo
• ilog.views.maps.defense.terrain.IlvLineOfSightRasterStyleBeanInfo
• ilog.views.maps.defense.terrain.IlvLineOfVisibilityStyleBeanInfo
• ilog.views.maps.defense.terrain.IlvMakeLineOfVisibilityInteractor.LineOfVisibilityDataSource
• ilog.views.maps.defense.terrain.IlvMakeTerrainCutInteractor
• ilog.views.maps.defense.terrain.IlvMakeTerrainCutInteractor.TerrainCutDataSource
• ilog.views.maps.defense.terrain.IlvMapControllingPolyline
• ilog.views.maps.defense.terrain.IlvMapControllingPolyline.ComputeListener
• ilog.views.maps.defense.terrain.IlvTerrainAccessoryContainerProperty
• ilog.views.maps.defense.terrain.IlvTerrainCut
• ilog.views.maps.defense.terrain.IlvValleyRasterStyleBeanInfo
• ilog.views.maps.defense.terrain3d.component.Ilv3DComponent
• ilog.views.maps.defense.terrain3d.component.Ilv3DCorridor
• ilog.views.maps.defense.terrain3d.component.Ilv3DHemisphere
• ilog.views.maps.defense.terrain3d.model.Ilv3DModel
• ilog.views.maps.defense.terrain3d.model.Ilv3DTile
• ilog.views.maps.defense.terrain3d.model.IlvRasterMappedBuffer3DTile
• ilog.views.maps.defense.terrain3d.model.IlvTileElevationProvider
• ilog.views.maps.defense.terrain3d.symbol.Ilv3DSymbol
• ilog.views.maps.defense.terrain3d.symbol.Ilv3DSymbolManager
• ilog.views.maps.defense.terrain3d.symbol.Ilv3DSymbolStyle
• ilog.views.maps.defense.terrain3d.symbol.Ilv3DSymbolStyleBeanInfo
• ilog.views.maps.defense.terrain3d.util.Ilv3DCoordinateConverter
• ilog.views.maps.defense.terrain3d.util.Ilv3DLinearCoordinateConverter
• ilog.views.maps.defense.terrain3d.util.Ilv3DVertex
• ilog.views.maps.defense.terrain3d.util.IlvGeographicPoint
• ilog.views.maps.defense.terrain3d.view.Ilv3DCamera
• ilog.views.maps.defense.terrain3d.view.Ilv3DTrajectory
• ilog.views.maps.defense.terrain3d.view.Ilv3DTrajectory.Point
• ilog.views.maps.defense.terrain3d.view.Ilv3DView
• ilog.views.maps.defense.terrain3d.view.Ilv3DViewBoundsDataSource
• ilog.views.maps.defense.terrain3d.view.Ilv3DViewBoundsStyle
• ilog.views.maps.defense.terrain3d.view.Ilv3DViewBoundsStyleBeanInfo
• ilog.views.maps.defense.terrain3d.view.Ilv3DViewControlUI
• ilog.views.maps.defense.terrain3d.view.IlvFlyThroughAction
• ilog.views.maps.defense.terrain3d.view.IlvFlyThroughStyle
• ilog.views.maps.defense.terrain3d.view.IlvFlyThroughStyleBeanInfo
• ilog.views.maps.defense.terrain3d.view.IlvJTimedButtonControl
• ilog.views.maps.defense.terrain3d.view.IlvJTimedSliderControl
• ilog.views.maps.defense.terrain3d.view.IlvMake3DFlyThroughInteractor
• ilog.views.maps.defense.terrain3d.view.IlvMake3DFlyThroughInteractor.RestartingDataSource
• ilog.views.maps.defense.terrain3d.view.IlvMake3DViewInteractor
• ilog.views.maps.defense.terrain3d.view.IlvMapTerrainFlyThrough

Modified Classes

• ilog.views.maps.defense.format.asrp.IlvRasterASRPReader
• ilog.views.maps.defense.format.asrp.projection.IlvNonPolarARCProjection
• ilog.views.maps.defense.format.asrp.projection.IlvNorthPolarARCProjection
• ilog.views.maps.defense.format.asrp.projection.IlvSouthPolarARCProjection
• ilog.views.maps.defense.format.cadrg.IlvCADRGCoverageList
• ilog.views.maps.defense.format.vmap.IlvVMAPReader
• ilog.views.maps.defense.terrain.IlvAltitudeChart
• ilog.views.maps.defense.terrain.IlvComputedRasterReader
• ilog.views.maps.defense.terrain.IlvLineOfSightRasterStyle

Incompatibilities

• ilog.views.maps.defense.format.asrp.projection.IlvARCProjectionFactory
• The default constructor of IlvARCProjectionFactory is of no use to a class providing only static methods and has been removed.


• The ilog.views.maps.symbology package introduced an uneccessary complexity, by redefining standard SDM capabilities. It has been removed and partially replaced by the ilog.views.maps.defense.symbology package.
  
  The following classes are no longer provided:
  
  • IlvSymbologyEngine (should be replaced by IlvSDMEngine)
  • IlvSymbolModel(should be replaced by IlvSDMModel)
  • IlvDefaultSymbolModelGroup (no longer used)
  • IlvDefaultSymbolModel(no longer used)
  • IlvDefaultSymbolModelNode(no longer used)
  • IlvDefaultSymbolLocationEditor(should be replaced by IlvSymbolLocationEditor)
  
  The following classes are available in a different package:
  
  • IlvMapStyleSheetRenderer is now in ilog.views.maps
  • IlvSymbologyTreeViewActions has been moved to ilog.views.maps.defense.symbology.swing
  • IlvSymbologyTreeView has been moved to ilog.views.maps.defense.symbology.swing
  
  This changes the signature of the following methods of ilog.views.maps.defense.symbology.app6a.IlvApp6aSymbologyTreeViewActions such that they use an IlvSDMModel instead:
  • boolean isEditGroupEnabled(IlvSymbolModel)
  • boolean isDuplicateSymbolEnabled(IlvSymbolModel)
  • void createSymbol(IlvSymbolModel, Object, IlvApplyObject)
  • void createGroup(IlvSymbolModel, Object, IlvApplyObject)
  • void editSymbology(IlvSymbolModel, IlvApplyObject)
  • boolean isEditSymbolEnabled(IlvSymbolModel)
  • boolean isCreateSymbolEnabled(IlvSymbolModel)
  • boolean isCreateGroupEnabled(IlvSymbolModel)
  • boolean isEditSymbologyEnabled(IlvSymbolModel)
  • void editSymbol(IlvSymbolModel, Object, IlvApplyObject)
  • void editGroup(IlvSymbolModel, Object, IlvApplyObject)
  • Object duplicateSymbol(IlvSymbolModel, Object)
  • void setLatLonPicker(ilog.views.maps.beans.editor.IlvSymbolLocationEditor)
  • void setView(ilog.views.maps.symbology.swing.IlvSymbologyTreeView)
  • IlvSymbolLocationEditor getLatLonPicker()

General Changes

• Introduction of 3D Views of terrain and 3D Fly Throughs based on a JOGL implementation.
• Introduction of a specific URL reading API for most of the map readers (except VMAP).
• A new Terrain Cut interaction.
• Various performance improvements when displaying vector data.
• Refactoring of symbol management to better integrate with the current and future Diagrammer technologies.

Library Changes

New Packages

ilog.views.maps.defense.terrain3d.component

ilog.views.maps.defense.terrain3d.model

ilog.views.maps.defense.terrain3d.symbol

ilog.views.maps.defense.terrain3d.util

ilog.views.maps.defense.terrain3d.view

This new package contains the 3D View API, based on the current JSR 231 implementation, JOGL (https://jogl.dev.java.net).

Note: This technology requires the use of specific OS-Dependent libraries (DLL in windows) to map the Open-GL capabilities of the platform.

It contains the following subpackages:

ilog.views.maps.defense.terrain3d.component	3D Objects (hemispheres, corridors) on top of the 3D View.
ilog.views.maps.defense.terrain3d.model	3D terrain model
ilog.views.maps.defense.terrain3d.symbol	3D symbols
ilog.views.maps.defense.terrain3d.util	Mathematical and geographical utilities

New Interfaces and Classes

ilog.views.maps.defense.symbology.swing.IlvAbstractGroupTreeViewActions

Base class that defines default group management actions available in the symbology tree panel.

ilog.views.maps.defense.symbology.swing.IlvSymbologyTreeView

IlvSymbologyTreeView is a panel that provides a GUI to display the symbology of your application.

ilog.views.maps.defense.symbology.swing.IlvSymbologyTreeViewActions

IlvSymbologyTreeViewActions provides the actions to create symbols, edit symbols, or edit the entire symbology tree.

ilog.views.maps.defense.terrain.IlvGradientRasterStyleBeanInfo

Determines the list and editors for IlvGradientRasterStyle

ilog.views.maps.defense.terrain.IlvLineOfSightRasterStyleBeanInfo

Determines the list and editors for IlvLineOfSightRasterStyle

ilog.views.maps.defense.terrain.IlvLineOfVisibilityStyleBeanInfo

Determines the list and editors for IlvLineOfVisibilityStyle

ilog.views.maps.defense.terrain.IlvMakeLineOfVisibilityInteractor.LineOfVisibilityDataSource

Internal data source used to create the Line of Visibility graphical object on the map view.

ilog.views.maps.defense.terrain.IlvMakeTerrainCutInteractor

Interactor to create a Terrain Cut.

ilog.views.maps.defense.terrain.IlvMakeTerrainCutInteractor.TerrainCutDataSource

Internal data source used to create the Line of Visibility graphical object on the map view.

ilog.views.maps.defense.terrain.IlvMapControllingPolyline

Creates a polyline that keeps a reference to its associated lat/lon points in order to update some other component.

ilog.views.maps.defense.terrain.IlvMapControllingPolyline.ComputeListener

Listener interface that can be attached to the Line of View to track its changes.

ilog.views.maps.defense.terrain.IlvTerrainAccessoryContainerProperty

By default, when reading an existing map file, this class contains a reference to the tabbed pane where the terrain interactors should create accessories (for example, Terrain Cut charts).

ilog.views.maps.defense.terrain.IlvTerrainCut

An IlvMapControllingPolyline specialized for a Terrain Cut.

ilog.views.maps.defense.terrain.IlvValleyRasterStyleBeanInfo

Determines the list and editors for IlvValleyRasterStyle.

ilog.views.maps.defense.terrain3d.component.Ilv3DComponent

This interface implemented by any object that can draw itself in an Ilv3DView.

ilog.views.maps.defense.terrain3d.component.Ilv3DCorridor

This class is a 3D tube that can be used to represent, for example, an air traffic lane.

ilog.views.maps.defense.terrain3d.component.Ilv3DHemisphere

This class is a half sphere that can be used to represent, for example, radar coverage.

ilog.views.maps.defense.terrain3d.model.Ilv3DModel

This class is a lightweight model for a 3D scene holding a terrain structure, a list of Ilv3DComponent objects, and an Ilv3DSymbolManager.

ilog.views.maps.defense.terrain3d.model.Ilv3DTile

This class is a 3D mesh object capable of displaying elevation data at different sampling levels, according to its position relative to the viewing point.

ilog.views.maps.defense.terrain3d.model.IlvRasterMappedBuffer3DTile

This class is an Ilv3DTile based on an IlvRasterTileLoader.

ilog.views.maps.defense.terrain3d.model.IlvTileElevationProvider

This interface describes a two dimensional array that can return elevation values for points within its limits.

ilog.views.maps.defense.terrain3d.symbol.Ilv3DSymbol

A 3D element that displays an SDM node.

ilog.views.maps.defense.terrain3d.symbol.Ilv3DSymbolManager

This class displays the symbols defined in an SDM engine on a 3D View.

ilog.views.maps.defense.terrain3d.symbol.Ilv3DSymbolStyle

Style class used to regroup all style display preferences.

ilog.views.maps.defense.terrain3d.symbol.Ilv3DSymbolStyleBeanInfo

Bean info class for editing IlvGeneralPathStyle.

ilog.views.maps.defense.terrain3d.util.Ilv3DCoordinateConverter

Interface defining an object capable of converting geographic coordinates (longitude, latitude, altitude) into 3D space coordinates used by Ilv3DModel.

ilog.views.maps.defense.terrain3d.util.Ilv3DLinearCoordinateConverter

An simple implementation of Ilv3DCoordinateConverter that basically scales values along the elevation axis (see the Height Exaggeration setting of the Ilv3DView).

ilog.views.maps.defense.terrain3d.util.Ilv3DVertex

Class that represents a point of the Ilv3DModel in 3D space.

ilog.views.maps.defense.terrain3d.util.IlvGeographicPoint

Class that represents a geographic point determined by 3 coordinates: longitude and latitude in radians, and altitude in meters.

ilog.views.maps.defense.terrain3d.view.Ilv3DCamera

The camera class maintains a viewpoint and an orientation in 3D model space.

ilog.views.maps.defense.terrain3d.view.Ilv3DTrajectory

Definition of a Fly Through trajectory.

ilog.views.maps.defense.terrain3d.view.Ilv3DTrajectory.Point

Single trajectory point.

ilog.views.maps.defense.terrain3d.view.Ilv3DView

This class is a swing component capable of rendering an Ilv3DModel.

ilog.views.maps.defense.terrain3d.view.Ilv3DViewBoundsDataSource

A data source that manages a lat/lon rectangle in order to represent the 3D View bounds on the 2D View.

ilog.views.maps.defense.terrain3d.view.Ilv3DViewBoundsStyle

Style of the rectangle representing the 3D View bounds.

ilog.views.maps.defense.terrain3d.view.Ilv3DViewBoundsStyleBeanInfo

Determines the list and editors for Ilv3DViewBoundsStyle.

ilog.views.maps.defense.terrain3d.view.Ilv3DViewControlUI

This class provides a swing GUI to control the appearance and performance parameters of the view.

ilog.views.maps.defense.terrain3d.view.IlvFlyThroughAction

Defines a swing action to start and stop a Fly Through.

ilog.views.maps.defense.terrain3d.view.IlvFlyThroughStyle

Style of a polyline representing a Fly Through in a 2D View.

ilog.views.maps.defense.terrain3d.view.IlvFlyThroughStyleBeanInfo

Determines the list and editors for IlvFlyThroughStyle

ilog.views.maps.defense.terrain3d.view.IlvJTimedButtonControl

This class is a JButton that performs an action repeatedly when it is kept pressed down.

ilog.views.maps.defense.terrain3d.view.IlvJTimedSliderControl

Slider that performs a timed action.

ilog.views.maps.defense.terrain3d.view.IlvMake3DFlyThroughInteractor

Interactor that allows you to create a Fly Through object defined by several points.

ilog.views.maps.defense.terrain3d.view.IlvMake3DFlyThroughInteractor.RestartingDataSource

Data source that updates the Fly Through action at load time.

ilog.views.maps.defense.terrain3d.view.IlvMake3DViewInteractor

Interactor that creates an Ilv3DView of the terrain.

ilog.views.maps.defense.terrain3d.view.IlvMapTerrainFlyThrough

This class is a polyline that represents a Fly Through trajectory on the 2D View of a map.

Modified Classes

ilog.views.maps.defense.format.asrp.IlvRasterASRPReader

• Overview of new features:
  • This reader can now access data over a URL connection.
• New methods:
  • addMap(URL): Starts the reading of files and adds a new ASRP image.
  • openStream(URL): Opens a file input stream trying for extension in upper and lowercase.
  • readGEN(URL, IlvRasterProperties): Reads the GEN file of an ASRP image.
  • readIMG(URL, IlvRasterProperties, byte[]): Reads the IMG file of an ASRP image.
  • readQAL(URL, IlvRasterProperties, HashMap): Reads the QAL file of an ASRP image.

ilog.views.maps.defense.format.asrp.projection.IlvNonPolarARCProjection

• New methods:
  • toString(): Converts the projection to a string with Evenden's format.

ilog.views.maps.defense.format.asrp.projection.IlvNorthPolarARCProjection

• New methods:
  • toString(): Converts the projection to a string with Evenden's format.

ilog.views.maps.defense.format.asrp.projection.IlvSouthPolarARCProjection

• New methods:
  • toString(): Converts the projection to a string with Evenden's format.

ilog.views.maps.defense.format.cadrg.IlvCADRGCoverageList

• New methods:
  • addCoverages(URL, IlvCADRGCoverage[]): Adds a coverage table constructed by reading from an URL.

ilog.views.maps.defense.format.vmap.IlvVMAPReader

• New constructors:
  • IlvVMAPReader(IlvInputStream): Constructs an IlvVMAPReader from the input stream.


• New methods:
  • getLatLonBounds(): Returns the latitude/longitude bounds for the list of all geometries or null if the bounds are not available.
  • write(IlvOutputStream):

ilog.views.maps.defense.terrain.IlvAltitudeChart

• New methods:
  • getChart(): Returns the chart.

ilog.views.maps.defense.terrain.IlvComputedRasterReader

• Overview of new features:
  • It is now possible to prevent the computation from creating raster images that are too big, for example, if the user enters the wrong parameters.
• New methods:
  • getMaxImageSize(): Returns the maximum image width or height.
  • setMaxImageSize(int): Indicates that images with a bigger width or height than the parameter passed will not be created.

ilog.views.maps.defense.terrain.IlvLineOfSightRasterStyle

• Overview of new features:
  • Horizon is better computed and taken into account in the computations when using an Area of Sight.
• New methods:
  • computePreferredBounds(): Returns the preferred bounds, taking into account center, altitude, and curvature of the earth to compute the horizon.

Example Changes

• A new example shows the use of 3D View API.