ilog.cpl.graph.background

Class IlpShapeBackground

java.lang.Object

ilog.cpl.graph.background.IlpAbstractBackground

ilog.cpl.graph.background.IlpAbstractMapDataSourceBackground

ilog.cpl.graph.background.IlpShapeBackground

All Implemented Interfaces:

IlpBackground, IlpMapDataSourceBackground, IlvBatchable

public class IlpShapeBackground
extends IlpAbstractMapDataSourceBackground

Provides support for using ESRI .shp Shape files as background.

This background loader reads:

• the main shape file, with extension .shp.
• the attributes file, with extension .dbf (optional),
• for load-on-demand: the ESRI index file, with extension .shx, and the Perforce JViews spatial index file, with extension .idx (optional).

See also: the Perforce JViews demo demos/maps/esri, which can be used to create the spatial index (.idx) files, and the Perforce JViews package ilog.views.maps.format.shapefile.

Since:

JViews 7.5

Field Summary

Fields inherited from class ilog.cpl.graph.background.IlpAbstractBackground

managerLayers

Fields inherited from interface ilog.cpl.graph.background.IlpBackground

LOAD_ON_DEMAND_PROPERTY, THREADED_PROPERTY, URL_PROPERTY, VISIBLE_PROPERTY

Constructor Summary

Constructors

Constructor and Description
IlpShapeBackground() Instantiates a new background.

Method Summary

Modifier and Type	Method and Description
IlvMapDataSource	createMapDataSource(IlpViewsView view) Creates an ilog.views.maps.datasource.IlvTiledShapeDataSource if load-on-demand is enabled or an ilog.views.maps.datasource.IlvShapeDataSource otherwise.
protected IlvMapStyle	createMapStyle() If no style is already being defined in the IlvMapDataSource, it by default creates an IlvGraphicPathStyle.

Methods inherited from class ilog.cpl.graph.background.IlpAbstractMapDataSourceBackground

create, createRenderer, customizeMapStyle, dispose, getMapDataSource, getMapStyle

Methods inherited from class ilog.cpl.graph.background.IlpAbstractBackground

addLayer, addLayers, addPropertyChangeListener, endBatch, getManagerLayer, getManagerLayers, getManagerLayersCount, getProperties, getProperty, getUrl, isLoadOnDemand, isThreaded, isVisible, removeLayer, removeLayers, removePropertyChangeListener, setLoadOnDemand, setProperty, setThreaded, setUrl, setVisible, startBatch

Methods inherited from class java.lang.Object

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

Methods inherited from interface ilog.cpl.graph.background.IlpBackground

addPropertyChangeListener, getManagerLayer, getManagerLayers, getManagerLayersCount, getProperty, removePropertyChangeListener, setProperty

Constructor Detail

IlpShapeBackground

public IlpShapeBackground()

Instantiates a new background.

Method Detail

createMapDataSource

public IlvMapDataSource createMapDataSource(IlpViewsView view)
                                     throws IlpBackgroundHandlingException

Creates an ilog.views.maps.datasource.IlvTiledShapeDataSource if load-on-demand is enabled or an ilog.views.maps.datasource.IlvShapeDataSource otherwise.

Parameters:

view - the IlpViewsView being used

Returns:

an IlvMapDataSource

Throws:

IlpBackgroundHandlingException - in case that there is problem handling this operation.

See Also:

IlpMapDataSourceBackground.createMapDataSource(ilog.cpl.graphic.views.IlpViewsView)

createMapStyle

protected IlvMapStyle createMapStyle()
                              throws IlpBackgroundHandlingException

If no style is already being defined in the IlvMapDataSource, it by default creates an IlvGraphicPathStyle.

Overrides:

createMapStyle in class IlpAbstractMapDataSourceBackground

Returns:

the ilog.views.maps.graphic.style.IlvMapStyle to be used by this background's ilog.views.maps.datasource.IlvMapDataSource.

Throws:

IlpBackgroundHandlingException - if a problem occurs.

See Also:

IlpAbstractMapDataSourceBackground.createMapStyle()