ilog.views.maps.datasource

Class IlvPolylineMergerDataSource

java.lang.Object

ilog.views.maps.datasource.IlvMapDataSource

ilog.views.maps.datasource.IlvGraphicLayerDataSource

ilog.views.maps.datasource.IlvPolylineMergerDataSource

All Implemented Interfaces:

IlvPersistentObject, IlvFeatureRenderer, IlvMapFeatureIterator, IlvMapReusableFeatureIterator, Serializable

public class IlvPolylineMergerDataSource
extends IlvGraphicLayerDataSource

This class features a utility that merges several polylines into a single polyline.
This can be useful when the API must label the polylines.
For example, roads comprised of many smaller polylines can be labeled several times along their path, but they also cannot be labeled if the Label Manager cannot fit labels on these segments.
Using this utility class can produce cleaner and more efficient labeling of polylines.

Since:

JViews 7.5

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	IlvPolylineMergerDataSource.IlvGraphicIdentifier This interface compares collections of features that are to be merged as a single polyline.

Field Summary

Fields inherited from class ilog.views.maps.datasource.IlvMapDataSource

renderer, usingGeodeticComputation

Constructor Summary

Constructors

Constructor and Description
IlvPolylineMergerDataSource(IlvInputStream stream) Creates a data source by reading its parameters on the stream.
IlvPolylineMergerDataSource(IlvMapDataSource dataSource) Creates a IlvPolylineMergerDataSource on a IlvMapDataSource passed as parameter.
IlvPolylineMergerDataSource(IlvMapDataSource dataSource, IlvPolylineMergerDataSource.IlvGraphicIdentifier identifier) Creates an IlvPolylineMergerDataSource on an IlvMapDataSource passed as parameter, with the specified IlvGraphicIdentifier

Method Summary

Modifier and Type	Method and Description
IlvPolylineMergerDataSource.IlvGraphicIdentifier	getComponentIdentifier() Returns the IlvGraphicIdentifier used by this polyline merger to identify polylines that should be merged together.
boolean	isGeoreferenced() Returns false.
void	setComponentIdentifier(IlvPolylineMergerDataSource.IlvGraphicIdentifier identifier) Sets the IlvGraphicIdentifier used by this polyline merger to identify polylines that should be merged together
void	setMergeDistance(double distance) Sets the criterion distance used when merging polylines.
void	start() Merges together the specified collection of polylines.
void	write(IlvOutputStream stream) Writes an IlvPolylineMergerDataSource into an IlvOutputStream

Methods inherited from class ilog.views.maps.datasource.IlvGraphicLayerDataSource

add, add, clear, dispose, get, getDefaultFeatureRenderer, getFeatureIterator, getLowerRightCorner, getMonitoringData, getNextFeature, getUpperLeftCorner, isPersistent, makeGraphic, remove, restart, setCoordinateSystem, setManager, setMonitoringData, size

Methods inherited from class ilog.views.maps.datasource.IlvMapDataSource

addDataSourceListener, callListeners, createInsertionLayer, getBackupDataSources, getCoordinateSystem, getDescription, getFeatureRenderer, getInsertionLayer, getManager, getMapLayer, getName, getNode, getValidExtentions, hasInsertionLayer, initBackupDataSource, initInsertionLayer, isAttachingAttributes, isGrapherMode, isSaveBackupDataSources, isSourceDataAvailable, isUsingBackupDataSource, isUsingGeodeticComputation, mapIntersects, removeDataSourceListener, reset, setAttachingAttributes, setDescription, setFeatureRenderer, setForceUsingBackupDataSource, setGrapherMode, setInsertionLayer, setName, setSaveBackupDataSources, setValidExtentions, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface ilog.views.maps.IlvMapFeatureIterator

getCoordinateSystem

Constructor Detail

IlvPolylineMergerDataSource

public IlvPolylineMergerDataSource(IlvMapDataSource dataSource)

Creates a IlvPolylineMergerDataSource on a IlvMapDataSource passed as parameter.

Parameters:

dataSource - The IlvMapDataSource producing polylines to merge

IlvPolylineMergerDataSource

public IlvPolylineMergerDataSource(IlvInputStream stream)
                            throws IlvReadFileException

Creates a data source by reading its parameters on the stream.

Parameters:

stream - The stream to read from.

Throws:

IlvReadFileException

IlvPolylineMergerDataSource

public IlvPolylineMergerDataSource(IlvMapDataSource dataSource,
                                   IlvPolylineMergerDataSource.IlvGraphicIdentifier identifier)

Creates an IlvPolylineMergerDataSource on an IlvMapDataSource passed as parameter, with the specified IlvGraphicIdentifier

Parameters:

dataSource - the IlvMapDataSource containing the polylines to merge.

identifier - the IlvGraphicIdentifier used to identify the polylines to merge together (same id)

Method Detail

write

public void write(IlvOutputStream stream)
           throws IOException

Writes an IlvPolylineMergerDataSource into an IlvOutputStream

Specified by:

write in interface IlvPersistentObject

Specified by:

write in interface IlvFeatureRenderer

Overrides:

write in class IlvGraphicLayerDataSource

Parameters:

stream - The stream to write to.

Throws:

IOException

See Also:

IlvFeatureRenderer.write(ilog.views.io.IlvOutputStream)

setComponentIdentifier

public void setComponentIdentifier(IlvPolylineMergerDataSource.IlvGraphicIdentifier identifier)

Sets the IlvGraphicIdentifier used by this polyline merger to identify polylines that should be merged together

Parameters:

identifier - IlvGraphicIdentifier to retrieve the identifier to use.

getComponentIdentifier

public IlvPolylineMergerDataSource.IlvGraphicIdentifier getComponentIdentifier()

Returns the IlvGraphicIdentifier used by this polyline merger to identify polylines that should be merged together.

Returns:

The IlvGraphicIdentifier used by this polyline merger.

setMergeDistance

public void setMergeDistance(double distance)

Sets the criterion distance used when merging polylines. When two polyline extremities are closer than this distance they are merged. Excessive or inadequate merge distances (that is, too big or too small compared to the polyline coordinate range) can result in polylines being merged in an unpredictable way.

Parameters:

distance - The square of the maximum distance between two polygons to merge.

start

public void start()
           throws Exception

Merges together the specified collection of polylines. This is done according to the mergeDistance criterion, and is intended to "weld" almost identical points (start or end) of several polylines. Therefore, high merge distances can result in polylines being merged in an unpredictable way.

Overrides:

start in class IlvGraphicLayerDataSource

Throws:

Exception - when the initial source

See Also:

IlvMapDataSource.start()

isGeoreferenced

public boolean isGeoreferenced()

Returns false.

Specified by:

isGeoreferenced in interface IlvMapFeatureIterator

Overrides:

isGeoreferenced in class IlvGraphicLayerDataSource

Returns:

Returns false.

See Also:

IlvMapFeatureIterator.isGeoreferenced()