ilog.views.maps

Class IlvDefaultFeatureRenderer

java.lang.Object

ilog.views.maps.IlvDefaultFeatureRenderer

All Implemented Interfaces:

IlvPersistentObject, IlvFeatureRenderer

Direct Known Subclasses:

IlvMapCSSRenderer, IlvMIFFeatureRenderer

public class IlvDefaultFeatureRenderer
extends Object
implements IlvFeatureRenderer

This feature renderer can translate all the predefined geometries of Rogue Wave JViews into graphic objects. It dispatches the makeGraphic calls to a specialized feature renderer depending on the geometry of the map feature. Each specialized feature renderer is initialized with a default value, but it can be changed.

Constructor Summary

Constructors

Constructor and Description
IlvDefaultFeatureRenderer() Initializes an instance of the renderer.
IlvDefaultFeatureRenderer(IlvInputStream stream) Reads the renderer from an IlvInputStream.

Method Summary

Modifier and Type	Method and Description
protected IlvGraphic	dispatch(IlvMapFeature mapFeature, IlvCoordinateTransformation tr) Dispatches a map feature to the renderer specialized to render the feature geometry.
IlvFeatureRenderer	getAreaRenderer() Returns the graphic renderer used to translate polygons into graphic objects.
IlvFeatureRenderer	getCurveRenderer() Returns the graphic renderer used to translate curves into graphic objects.
IlvFeatureRenderer	getImageRenderer() Returns the graphic renderer used to translate images into graphic objects.
IlvFeatureRenderer	getMultiPointRenderer() Returns the renderer used to translate multipoints into graphic objects.
IlvFeatureRenderer	getPointRenderer() Returns the renderer used to translate points into graphic objects.
IlvFeatureRenderer	getRasterRenderer() Returns the graphic renderer used to translate rasters into graphic objects.
IlvFeatureRenderer	getTextRenderer() Returns the graphic renderer used to translate georeferenced text into graphic objects.
boolean	isPersistent() Returns true if the object must be saved.
IlvGraphic	makeGraphic(IlvMapFeature mapFeature, IlvCoordinateTransformation tr) Makes an IlvGraphic from a map feature.
protected IlvGraphic	makeGraphicFromCollection(IlvMapFeature feature, IlvCoordinateTransformation tr) This method is called by dispatch() for the map features whose geometries are Collections of subgeometries.
void	setAreaRenderer(IlvFeatureRenderer areaRenderer) Sets the graphic renderer used to translate polygons into graphic objects.
void	setCurveRenderer(IlvFeatureRenderer curveRenderer) Sets the graphic renderer used to translate curves into graphic objects.
void	setImageRenderer(IlvFeatureRenderer imageRenderer) Sets the graphic renderer used to translate images into graphic objects.
void	setMultiPointRenderer(IlvFeatureRenderer multiPointRenderer) Sets the graphic renderer used to translate multipoints into graphic objects.
void	setPointRenderer(IlvFeatureRenderer pointRenderer) Sets the graphic renderer used to translate points into graphic objects.
void	setRasterRenderer(IlvFeatureRenderer rasterRenderer) Sets the graphic renderer used to translate rasters into graphic objects.
void	setTextRenderer(IlvFeatureRenderer textRenderer) Sets the graphic renderer used to translate georeferenced text into graphic objects.
void	write(IlvOutputStream stream) Writes the renderer to an IlvOutputStream.

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvDefaultFeatureRenderer

public IlvDefaultFeatureRenderer()

Initializes an instance of the renderer.

IlvDefaultFeatureRenderer

public IlvDefaultFeatureRenderer(IlvInputStream stream)
                          throws IlvReadFileException

Reads the renderer from an IlvInputStream.

Throws:

IlvReadFileException - if the format is not correct.

Method Detail

makeGraphic

public IlvGraphic makeGraphic(IlvMapFeature mapFeature,
                              IlvCoordinateTransformation tr)
                       throws IlvCoordinateTransformationException,
                              IlvMapRenderException

Makes an IlvGraphic from a map feature. Note that this method has been changed since Rogue Wave JViews 5.0. The old method was makeGraphic(IlvMapFeature, IlvProjection). In case you have overridden the old makeGraphic method, you have to rewrite your method in order to migrate to JViews 5.0.

Specified by:

makeGraphic in interface IlvFeatureRenderer

Parameters:

mapFeature - The map feature to translate.

tr - The destination Coordinate System of the map feature.

Throws:

IlvMapRenderException - if the renderer cannot process the map feature.

IlvCoordinateTransformationException - if an error occurs during the coordinate transformation.

Since:

JViews 5.0

dispatch

protected IlvGraphic dispatch(IlvMapFeature mapFeature,
                              IlvCoordinateTransformation tr)
                       throws IlvCoordinateTransformationException,
                              IlvMapRenderException

Dispatches a map feature to the renderer specialized to render the feature geometry. Note that this method has been changed since Rogue Wave JViews 5.0. The old method was dispatch(IlvMapFeature, IlvProjection). In case you have overridden the old dispatch method, you have to rewrite your method in order to migrate to JViews 5.0.

Parameters:

mapFeature - The map feature.

tr - The destination Coordinate System of the map feature.

Throws:

IlvMapRenderException - If the renderer cannot process the map feature.

IlvCoordinateTransformationException - If an error occurs during the coordinate transformation.

Since:

JViews 5.0

See Also:

setImageRenderer(ilog.views.maps.IlvFeatureRenderer), setAreaRenderer(ilog.views.maps.IlvFeatureRenderer), setCurveRenderer(ilog.views.maps.IlvFeatureRenderer), setMultiPointRenderer(ilog.views.maps.IlvFeatureRenderer), setPointRenderer(ilog.views.maps.IlvFeatureRenderer), setRasterRenderer(ilog.views.maps.IlvFeatureRenderer), setTextRenderer(ilog.views.maps.IlvFeatureRenderer)

makeGraphicFromCollection

protected IlvGraphic makeGraphicFromCollection(IlvMapFeature feature,
                                               IlvCoordinateTransformation tr)
                                        throws IlvCoordinateTransformationException,
                                               IlvMapRenderException

This method is called by dispatch() for the map features whose geometries are Collections of subgeometries. Note that this method has been changed since Rogue Wave JViews 5.0. The old method was makeGraphicFromCollection(IlvMapFeature, IlvProjection). In case you have overridden the previous form of this method, you have to rewrite your method in order to migrate to JViews 5.0.

Parameters:

feature - The map feature to be translated.

tr - The destination Coordinate System of the map feature.

Returns:

The created IlvGraphic.

Throws:

IlvMapRenderException - If the renderer cannot process the map feature.

IlvCoordinateTransformationException - If an error occurs during the coordinate transformation.

Since:

JViews 5.0

setPointRenderer

public void setPointRenderer(IlvFeatureRenderer pointRenderer)

Sets the graphic renderer used to translate points into graphic objects.

Parameters:

pointRenderer - The point renderer.

See Also:

IlvMapPoint, IlvDefaultPointRenderer

getPointRenderer

public IlvFeatureRenderer getPointRenderer()

Returns the renderer used to translate points into graphic objects.

See Also:

IlvMapPoint, IlvDefaultPointRenderer

setMultiPointRenderer

public void setMultiPointRenderer(IlvFeatureRenderer multiPointRenderer)

Sets the graphic renderer used to translate multipoints into graphic objects.

Parameters:

multiPointRenderer - The multipoint renderer.

See Also:

IlvMapMultiPoint, IlvDefaultMultiPointRenderer

getMultiPointRenderer

public IlvFeatureRenderer getMultiPointRenderer()

Returns the renderer used to translate multipoints into graphic objects.

See Also:

IlvMapMultiPoint, IlvDefaultMultiPointRenderer

setRasterRenderer

public void setRasterRenderer(IlvFeatureRenderer rasterRenderer)

Sets the graphic renderer used to translate rasters into graphic objects.

Parameters:

rasterRenderer - The raster renderer.

See Also:

IlvMapRaster, IlvDefaultRasterRenderer

getRasterRenderer

public IlvFeatureRenderer getRasterRenderer()

Returns the graphic renderer used to translate rasters into graphic objects.

See Also:

IlvMapRaster, IlvDefaultRasterRenderer

setTextRenderer

public void setTextRenderer(IlvFeatureRenderer textRenderer)

Sets the graphic renderer used to translate georeferenced text into graphic objects.

Parameters:

textRenderer - The text renderer.

See Also:

IlvMapText, IlvDefaultTextRenderer

getTextRenderer

public IlvFeatureRenderer getTextRenderer()

Returns the graphic renderer used to translate georeferenced text into graphic objects.

See Also:

IlvMapText, IlvDefaultTextRenderer

setCurveRenderer

public void setCurveRenderer(IlvFeatureRenderer curveRenderer)

Sets the graphic renderer used to translate curves into graphic objects.

Parameters:

curveRenderer - The curve renderer.

Since:

JViews 3.5

See Also:

IlvMapCurve, IlvDefaultCurveRenderer

getCurveRenderer

public IlvFeatureRenderer getCurveRenderer()

Returns the graphic renderer used to translate curves into graphic objects.

See Also:

IlvMapCurve, IlvDefaultCurveRenderer

setAreaRenderer

public void setAreaRenderer(IlvFeatureRenderer areaRenderer)

Sets the graphic renderer used to translate polygons into graphic objects.

Parameters:

areaRenderer - The polygon renderer.

Since:

JViews 3.5

See Also:

IlvMapPolygon, IlvDefaultAreaRenderer

getAreaRenderer

public IlvFeatureRenderer getAreaRenderer()

Returns the graphic renderer used to translate polygons into graphic objects.

Since:

JViews 3.5

See Also:

IlvMapPolygon, IlvDefaultAreaRenderer

setImageRenderer

public void setImageRenderer(IlvFeatureRenderer imageRenderer)

Sets the graphic renderer used to translate images into graphic objects.

Parameters:

imageRenderer - The image renderer.

See Also:

IlvMapImage, IlvDefaultImageRenderer

getImageRenderer

public IlvFeatureRenderer getImageRenderer()

Returns the graphic renderer used to translate images into graphic objects.

See Also:

IlvMapImage, IlvDefaultImageRenderer

write

public void write(IlvOutputStream stream)
           throws IOException

Writes the renderer to an IlvOutputStream.

Specified by:

write in interface IlvPersistentObject

Specified by:

write in interface IlvFeatureRenderer

Parameters:

stream - the output stream

Throws:

IOException - thrown when an exception occurs during the write operation for this object.

isPersistent

public boolean isPersistent()

Returns true if the object must be saved.

Specified by:

isPersistent in interface IlvFeatureRenderer