JViews Maps for Defense Release Notes

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

Incompatibilities
General Changes
Library Changes

New Interfaces and Classes

• ilog.views.maps.defense.format.s57.IlvS57FeatureFilter
• ilog.views.maps.defense.format.vmap.IlvVMAPDataInput
• ilog.views.maps.defense.format.vmap.IlvVMAPGeometryFactory
• ilog.views.maps.defense.terrain3d.util.Ilv3DDoubleVector
• ilog.views.maps.defense.terrain3d.util.Ilv3DFloatVector
• ilog.views.maps.defense.terrain3d.util.Ilv3DRotation
• ilog.views.maps.defense.terrain3d.util.Ilv3DFloatMatrix
• ilog.views.maps.defense.terrain3d.util.IlvBufferSliceManager

Modified Classes

• ilog.views.maps.defense.format.s57.IlvS57DataSource
• ilog.views.maps.defense.format.s57.IlvS57Reader
• ilog.views.maps.defense.symbology.app6a.IlvApp6aGraphic
• ilog.views.maps.defense.terrain.IlvComputedRasterReader
• ilog.views.maps.defense.format.vmap.IlvVMAPReader
• ilog.views.maps.defense.format.vmap.IlvVMAPTable
• 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.view.Ilv3DCamera
• ilog.views.maps.defense.terrain3d.view.Ilv3DView

Incompatibilities

• The interface IlvVMAPDataInput was made public to ensure consistency with methods that were exposing it. This has lead to a change of signature in the methods of class IlvVMAPTable. Please refer to the section about new methods for further details.
• The interface IlvVMAPGeometryFactory was made public to ensure consistency with methods that were exposing it. This has lead to a change of signature in the methods of class IlvVMAPReader. Please refer to the section about new methods for further details.
• Several internal utility classes in package ilog.views.maps.defense.terrain3d.util were made public to ensure consistency with methods that were exposing them. This has lead to a change in signature for the methods in the following classes : Ilv3DCamera, Ilv3DModel, Ilv3DTile, and IlvRasterMappedBuffer3DTile. Please refer to the section about new methods for further details.

General Changes

• S57 rendering is based on the IHO ECDIS Presentation library (S52).
• Terrain analysis now provides parameters to limit the size of the generated images.

Library Changes

New Interfaces and Classes

ilog.views.maps.defense.format.s57.IlvS57FeatureFilter

A specialized criterion filter that returns the value of a feature attribute according to the property name.

This is useful, for example, when S52 rendering indicates that different depths must be rendered with different styles.

ilog.views.maps.defense.format.vmap.IlvVMAPDataInput

The interface that a stream must implement to provide VMAP data.

ilog.views.maps.defense.format.vmap.IlvVMAPGeometryFactory

Interface that creates GIS components for VMAP primitive features.

ilog.views.maps.defense.terrain3d.util.Ilv3DDoubleVector

A 3 element vector in double precision.

ilog.views.maps.defense.terrain3d.util.Ilv3DFloatVector

A 3 element vector in float precision.

ilog.views.maps.defense.terrain3d.util.Ilv3DRotation

This class represents a rotation with float precision components.

ilog.views.maps.defense.terrain3d.util.Ilv3DFloatMatrix

A 4 by 4 matrix utility class for 3D operations.

ilog.views.maps.defense.terrain3d.util.IlvBufferSliceManager

This class manages several slices of the same buffer to perform independent operation on each of them without interfering with the others.

Modified Classes

ilog.views.maps.defense.format.s57.IlvS57DataSource

• Overview of new features:
  • S57 rendering can be based on IHO ECDIS presentation library. Various parameters are available to select rendering options.
• New methods:
  • createFeatureRenderer(): This method has been overridden to render points using an IlvS52PointRenderer.
  • getColorSet(): Returns the S52 color set to use.
  • setColorSet(String): Sets the color set to use when rendering S52.
  • getDeepContour(): Returns the deep contour depth in meters.
  • setDeepContour(double): Sets the deep contour depth.
  • getSafetyContour(): Returns the safety contour depth in meters.
  • setSafetyContour(double): Sets the safety contour depth.
  • getShallowContour(): Returns the shallow contour depth in meters.
  • setShallowContour(double): Sets the shallow contour depth.
  • isFullLengthSectorLines(): Indicates if full length sector lines should be displayed.
  • setFullLengthSectorLines(boolean): Sets the full length sector lines.
  • isShallowPattern(): Indicates whether shallow pattern rendering is used.
  • setShallowPattern(boolean): Enables the shallow pattern option.
  • isShowS52Text(): Indicates whether S52 rendering will create text.
  • setShowS52Text(boolean): Set to true for S52 rendering to display text.
  • isSimplifiedRendering(): Indicates whether simplified rendering is activated.
  • setSimplifiedRendering(boolean): Indicates whether simplified rendering is activated.
  • isTwoShades(): Indicates if the two shades option is activated.
  • setTwoShades(boolean): Sets the two shades option.


• New fields:
  • S52COLORSETS: The list of the available S52 color sets.

ilog.views.maps.defense.format.s57.IlvS57Reader

• Overview of new features:
  • A utility method and some attribute names are made public for use with the API.
• New methods:
  • findAttributeNameFromLabel(String): A utility method to retrieve the S57 attribute identifier from the attribute label.


• New fields:
  • AGENCY_ATTR: The name of the feature attribute that contains the agency name.
  • CODENAME_ATTR: The name of the feature attribute that contains the S57 object code name.
  • CODE_ATTR: The name of the feature attribute that contains the S57 object code number.
  • GROUP_ATTR: The name of the feature attribute that contains the S57 group number.
  • ID_ATTR: The name of the feature attribute that contains the S57 object id.
  • TYPE_ATTR: The name of the feature attribute that contains the primitive type.

ilog.views.maps.defense.symbology.app6a.IlvApp6aGraphic

• Overview of new features:
  • This graphic now implements methods to precisely position it, regardless of text or graphical modifiers around the icon.
• New methods:
  • getDefinitionRect(): This implementation of IlvDefinitionRectInterface returns the transformed boundaries of the symbol icon.
  • setDefinitionRect(IlvRect): Changes the location and size of the icon and transforms the rest of the symbol accordingly.
  • getDefinitionTransformer(): This implementation of IlvDefinitionRectInterface returns a null transformer.

ilog.views.maps.defense.terrain.IlvComputedRasterReader

• Overview of new features:
  • Ability to limit (possibly with user confirmation) the size of computed images.
• New methods:
  • getWarningImageHeight(): Returns the maximum height acceptable for a computed image before a warning message is shown.
  • setWarningImageHeight(int): Indicates that trying to create images with a greater height than the parameter passed will lead to a warning message being displayed.
  • getWarningImageWidth(): Returns the maximum width acceptable for a computed image before a warning message is shown.
  • getWarningImageWidth(int): Indicates that trying to create images with a greater width than the parameter passed will lead to a warning message being displayed.
  • isAllowMessages(): Returns true if messages should be displayed.
  • setAllowMessages(boolean): Indicates whether messages should be displayed.

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

• Overview of new features:
  • Mainly refactoring.
• New methods:
  • getGeometryFactory(IlvVMAPTable): Returns the appropriate IlvMapGeometry factory for a given feature class table.

ilog.views.maps.defense.format.vmap.IlvVMAPTable

• Overview of new features:
  • Mainly refactoring.
• New methods:
  • readDouble(IlvVMAPDataInput): Method to read a double (8 bytes) from the specified stream, according to the byte order of this table.
  • readFloat(IlvVMAPDataInput): Method to read a float (4 bytes) from the specified stream, according to the byte order of this table.
  • readInt(IlvVMAPDataInput): Reads an integer (4 bytes) from the specified stream, according to the byte order of this table.
  • readLong(IlvVMAPDataInput): Method to read a long (8 bytes) from the specified stream, according to the byte order of this table.
  • readShort(IlvVMAPDataInput): Reads a short (2 bytes) from the specified stream, according to the the byte order of this table.

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

• Overview of new features:
  • Mainly refactoring.
• New methods:
  • getCentroid(): Returns the centroid, that is, the center of gravity of the current terrain.

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

• Overview of new features:
  • Mainly refactoring.
• New methods:
  • drawTile(int, Ilv3DLinearCoordinateConverter, IlvBufferSliceManager, Ilv3DCamera, GL, boolean): Renders the tile in the specified OpenGL context at the current DEM and image level.
  • drawTile(int, Ilv3DLinearCoordinateConverter, IlvBufferSliceManager, Ilv3DCamera, GL, Ilv3DView, boolean): Renders the tile in the specified OpenGL context at the current DEM and image level.
  • getCenter(): Returns the center point of this tile in 3D space coordinates.
  • setSize(Ilv3DDoubleVector, float, float): Sets the bounds of this Ilv3DTile.

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

• Overview of new features:
  • Mainly refactoring.
• New constructors:
  • IlvRasterMappedBuffer3DTile(IlvRasterTileLoader, Ilv3DDoubleVector, float, float, IlvManagerView): Constructs a IlvRasterMappedBuffer3DTile from the specified parameters.

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

• Overview of new features:
  • Mainly refactoring.
• New methods:
  • getLookAtPoint(): Returns the target point of this camera.
  • getOrientation(): Returns the current rotation matrix of this camera.
  • getPosition(): Returns the position of the camera
  • setPosition(Ilv3DDoubleVector): Sets the position of the camera
  • lookAt(Ilv3DDoubleVector, Ilv3DFloatVector): Modifies the orientation of the camera so that it looks at the specified point.

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

• Overview of new features:
  • Added a constructor to choose the underlying component used by the 3d view (a JPanel or a Canvas).
• New constructors:
  • Ilv3DView(Ilv3DModel, boolean): Constructs an Ilv3DView that renders the specified Ilv3DModel.

Example Changes

• Check the new features in the App6a demo.