Package org.gvsig.fmap.mapcontext.layers.operations

Interface InfoByPoint

All Known Subinterfaces:

GraphicLayer, RasterLayer, VectorLayer

All Known Implementing Classes:

DefaultGraphicLayer, FLayers, FLyrVect

public interface InfoByPoint

Interface that must be implemented by layers which support the operation "information by point".

That operation allows get meta-information from a point and an area around, of a layer.

Method Summary

Modifier and Type	Method	Description
org.gvsig.tools.dynobject.DynObjectSet	getInfo(Point p, double tolerance, org.gvsig.tools.task.Cancellable cancel)	Executes a consultation about information of a point on the layer.
org.gvsig.tools.dynobject.DynObjectSet	getInfo(Point p, double tolerance, org.gvsig.tools.task.Cancellable cancel, boolean fast)	Executes a consultation about information of a point on the layer.
org.gvsig.tools.dynobject.DynObjectSet	getInfo(org.gvsig.fmap.geom.primitive.Point p, double tolerance)	Executes a consultation about information of a point on the layer.

Method Details

getInfo

org.gvsig.tools.dynobject.DynObjectSet getInfo(Point p,
 double tolerance,
 org.gvsig.tools.task.Cancellable cancel)
                                        throws LoadLayerException,
org.gvsig.fmap.dal.exception.DataException

Executes a consultation about information of a point on the layer.

There is an area around the point where will got the information.

Parameters:

p - point where is the consultation

tolerance - permissible margin around the coordinates of the point where the method will got the information. Each singular implementation of this method would use it in a different way. The coordinates also depend on the implementation.

cancel - shared object that determines if this layer can continue being drawn

Returns:

a DynObjectSet. If the InfoByPoint Object is a vector layer it should return a FeatureSet.

Throws:

org.gvsig.fmap.dal.exception.DataException - TODO

LoadLayerException - any exception produced using the driver.

getInfo

org.gvsig.tools.dynobject.DynObjectSet getInfo(Point p,
 double tolerance,
 org.gvsig.tools.task.Cancellable cancel,
 boolean fast)
                                        throws LoadLayerException,
org.gvsig.fmap.dal.exception.DataException

Executes a consultation about information of a point on the layer.

There is an area around the point where will got the information.

Parameters:

p - point where is the consultation

tolerance - permissible margin around the coordinates of the point where the method will got the information. Each singular implementation of this method would use it in a different way. The coordinates also depend on the implementation.

cancel - shared object that determines if this layer can continue being drawn

fast - if true try to reuse objects as much as possible to make the object iteration faster. If true, DynObjects got through the returned set must not be stored unless cloned.

Returns:

a DynObjectSet. If the InfoByPoint Object is a vector layer it should return a FeatureSet.

Throws:

org.gvsig.fmap.dal.exception.DataException - TODO

LoadLayerException - any exception produced using the driver.

getInfo

org.gvsig.tools.dynobject.DynObjectSet getInfo(org.gvsig.fmap.geom.primitive.Point p,
 double tolerance)
                                        throws LoadLayerException,
org.gvsig.fmap.dal.exception.DataException

Executes a consultation about information of a point on the layer.

There is an area around the point where will got the information.

Parameters:

p - point in map coordinates where is the consultation

tolerance - permissible margin around the coordinates of the point where the method will got the information. Each singular implementation of this method would use it in a different way. The unit are in map coordinates.

Throws:

LoadLayerException

org.gvsig.fmap.dal.exception.DataException