de.cismet.cismap.commons.tools

Class PFeatureTools

java.lang.Object

de.cismet.cismap.commons.tools.PFeatureTools

public class PFeatureTools
extends Object

DOCUMENT ME!

Version:

$Revision$, $Date$

Author:

thorsten.hell@cismet.de

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PFeatureTools.PFeatureCoordinateInformation DOCUMENT ME!
static class	PFeatureTools.SnappedPoint DOCUMENT ME!

Constructor Summary

Constructors

Constructor and Description
PFeatureTools()

Method Summary

Modifier and Type	Method and Description
static double	area(PFeature pfeature) TODO move to a static geometryutils class.
static List<PFeatureTools.PFeatureCoordinateInformation>	automergeCoordinates(Collection<PFeature> pFeatures, double thresholdInMeters) DOCUMENT ME!
static List<PFeatureTools.PFeatureCoordinateInformation>	automergeCoordinates(List<PFeatureTools.PFeatureCoordinateInformation> groupedInfos) DOCUMENT ME!
static Point2D	centroid(PFeature pfeature) TODO move to a static geometryutils class.
static List<PFeature>	findIntersectingPFeatures(edu.umd.cs.piccolo.PNode node, com.vividsolutions.jts.geom.Geometry geometry) This should be used instead of the findIntersectingNodes method of the PNode class.
static List<edu.umd.cs.piccolo.PNode>	getAllValidObjectsUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent, Class[] validClasses) DOCUMENT ME!
static List<edu.umd.cs.piccolo.PNode>	getFirstObjectsUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent, Class[] validClasses, double halo) DOCUMENT ME!
static edu.umd.cs.piccolo.PNode	getFirstValidObjectUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent, Class[] validClasses) DOCUMENT ME!
static edu.umd.cs.piccolo.PNode	getFirstValidObjectUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent, Class[] validClasses, boolean deepPick) DOCUMENT ME!
static edu.umd.cs.piccolo.PNode	getFirstValidObjectUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent, Class[] validClasses, double halo) DOCUMENT ME!
static edu.umd.cs.piccolo.PNode	getFirstValidObjectUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent, Class[] validClasses, double halo, boolean deepSeek) DOCUMENT ME!
static edu.umd.cs.piccolo.PNode	getFirstValidObjectUnderPointer2(edu.umd.cs.piccolo.event.PInputEvent pInputEvent, Class[] validClasses) DOCUMENT ME!
static edu.umd.cs.piccolo.PNode	getFirstValidObjectUnderPointer2(edu.umd.cs.piccolo.event.PInputEvent pInputEvent, Class[] validClasses, double halo) DOCUMENT ME!
static com.vividsolutions.jts.geom.Geometry	getGeometryFromPBounds(edu.umd.cs.piccolo.util.PBounds bounds, WorldToScreenTransform wtst, String crs) DOCUMENT ME!
static com.vividsolutions.jts.geom.Coordinate	getNearestCoordinateInArea(MappingComponent mc, Point2D canvasPosition, boolean considerVetoObjects, Sirius.util.collections.MultiMap glueCoordinates) Determines the nearest geometry coordinate.
static com.vividsolutions.jts.geom.Coordinate	getNearestCoordinateInArea(MappingComponent mc, Point2D canvasPosition, PFeature vetoPFeature, Sirius.util.collections.MultiMap glueCoordinates) DOCUMENT ME!
static Point2D	getNearestPointInArea(MappingComponent mc, Point2D canvasPosition) DOCUMENT ME!
static PFeatureTools.SnappedPoint	getNearestPointInArea(MappingComponent mc, Point2D canvasPosition, boolean considerVetoObjects, Sirius.util.collections.MultiMap glueCoordinates) DOCUMENT ME!
static Point2D	getNearestPointInArea(MappingComponent mc, Point2D canvasPosition, PFeature vetoPFeature, Sirius.util.collections.MultiMap glueCoordinates) DOCUMENT ME!
static Point2D	getNearestPointInAreaNoVertexRequired(MappingComponent mc, Point2D canvasPosition, PFeature vetoFeature, Sirius.util.collections.MultiMap glueCoordinates) DOCUMENT ME!
static com.vividsolutions.jts.geom.LineSegment	getNearestSegment(com.vividsolutions.jts.geom.Coordinate trigger, PFeature pfeature) DOCUMENT ME!
static PFeature	getPFeatureByChild(ParentNodeIsAPFeature child) DOCUMENT ME!
static PFeature[]	getPFeaturesInArea(MappingComponent mc, com.vividsolutions.jts.geom.Geometry geom) DOCUMENT ME!
static PFeature[]	getPFeaturesInArea(MappingComponent mc, edu.umd.cs.piccolo.util.PBounds bounds) DOCUMENT ME!
static Point2D[]	getPointsInArea(MappingComponent mc, edu.umd.cs.piccolo.util.PBounds bounds, PFeature vetoPFeature, Sirius.util.collections.MultiMap glueFeatureCoordinates) DOCUMENT ME!
static Point2D[]	getPointsInAreaNoVertexRequired(MappingComponent mc, edu.umd.cs.piccolo.util.PBounds bounds, Point2D currentPosition, PFeature vetoFeature, Sirius.util.collections.MultiMap glueFeatureCoordinates) DOCUMENT ME!
static List<edu.umd.cs.piccolo.PNode>	getValidObjectsUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent, Class[] validClasses, double halo) DOCUMENT ME!
static List<edu.umd.cs.piccolo.PNode>	getValidObjectsUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent, Class[] validClasses, double halo, boolean stopAfterFirstValid) DOCUMENT ME!
static List<edu.umd.cs.piccolo.PNode>	getValidObjectsUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent, double xCoor, double yCoord, Class[] validClasses, double halo, boolean stopAfterFirstValid) DOCUMENT ME!
static List<PFeatureTools.PFeatureCoordinateInformation>	identifyMergeableCoordinates(Collection<PFeature> pFeatures, double thresholdInMeters) DOCUMENT ME!

Methods inherited from class java.lang.Object

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

Constructor Detail

PFeatureTools

public PFeatureTools()

Method Detail

getFirstValidObjectUnderPointer2

public static edu.umd.cs.piccolo.PNode getFirstValidObjectUnderPointer2(edu.umd.cs.piccolo.event.PInputEvent pInputEvent,
                                                                        Class[] validClasses)

DOCUMENT ME!

Parameters:

pInputEvent - DOCUMENT ME!

validClasses - DOCUMENT ME!

Returns:

DOCUMENT ME!

getFirstValidObjectUnderPointer2

public static edu.umd.cs.piccolo.PNode getFirstValidObjectUnderPointer2(edu.umd.cs.piccolo.event.PInputEvent pInputEvent,
                                                                        Class[] validClasses,
                                                                        double halo)

DOCUMENT ME!

Parameters:

pInputEvent - DOCUMENT ME!

validClasses - DOCUMENT ME!

halo - DOCUMENT ME!

Returns:

DOCUMENT ME!

getFirstObjectsUnderPointer

public static List<edu.umd.cs.piccolo.PNode> getFirstObjectsUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent,
                                                                         Class[] validClasses,
                                                                         double halo)

DOCUMENT ME!

Parameters:

pInputEvent - DOCUMENT ME!

validClasses - DOCUMENT ME!

halo - DOCUMENT ME!

Returns:

DOCUMENT ME!

getValidObjectsUnderPointer

public static List<edu.umd.cs.piccolo.PNode> getValidObjectsUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent,
                                                                         Class[] validClasses,
                                                                         double halo)

DOCUMENT ME!

Parameters:

pInputEvent - DOCUMENT ME!

validClasses - DOCUMENT ME!

halo - DOCUMENT ME!

Returns:

DOCUMENT ME!

getValidObjectsUnderPointer

public static List<edu.umd.cs.piccolo.PNode> getValidObjectsUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent,
                                                                         Class[] validClasses,
                                                                         double halo,
                                                                         boolean stopAfterFirstValid)

DOCUMENT ME!

Parameters:

pInputEvent - mc DOCUMENT ME!

validClasses - DOCUMENT ME!

halo - DOCUMENT ME!

stopAfterFirstValid - DOCUMENT ME!

Returns:

DOCUMENT ME!

getValidObjectsUnderPointer

public static List<edu.umd.cs.piccolo.PNode> getValidObjectsUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent,
                                                                         double xCoor,
                                                                         double yCoord,
                                                                         Class[] validClasses,
                                                                         double halo,
                                                                         boolean stopAfterFirstValid)

DOCUMENT ME!

Parameters:

pInputEvent - mc DOCUMENT ME!

xCoor - DOCUMENT ME!

yCoord - DOCUMENT ME!

validClasses - DOCUMENT ME!

halo - DOCUMENT ME!

stopAfterFirstValid - DOCUMENT ME!

Returns:

DOCUMENT ME!

getPFeaturesInArea

public static PFeature[] getPFeaturesInArea(MappingComponent mc,
                                            edu.umd.cs.piccolo.util.PBounds bounds)

DOCUMENT ME!

Parameters:

mc - DOCUMENT ME!

bounds - DOCUMENT ME!

Returns:

DOCUMENT ME!

getPFeaturesInArea

public static PFeature[] getPFeaturesInArea(MappingComponent mc,
                                            com.vividsolutions.jts.geom.Geometry geom)

DOCUMENT ME!

Parameters:

mc - DOCUMENT ME!

geom - bounds DOCUMENT ME!

Returns:

DOCUMENT ME!

getGeometryFromPBounds

public static com.vividsolutions.jts.geom.Geometry getGeometryFromPBounds(edu.umd.cs.piccolo.util.PBounds bounds,
                                                                          WorldToScreenTransform wtst,
                                                                          String crs)

DOCUMENT ME!

Parameters:

bounds - a PBounds object, that should contain screen coordinates. (See the class WorldToScreenTransform)

wtst - DOCUMENT ME!

crs - DOCUMENT ME!

Returns:

a Geometry object that represents the given PBounds object.

findIntersectingPFeatures

public static List<PFeature> findIntersectingPFeatures(edu.umd.cs.piccolo.PNode node,
                                                       com.vividsolutions.jts.geom.Geometry geometry)

This should be used instead of the findIntersectingNodes method of the PNode class. The differences between this methods and the findIntersectingNodes method are, that this method only finds PFeature objects and this method works properly.

Parameters:

node - The node, the PFeatures should be find in

geometry - the search geometry

Returns:

DOCUMENT ME!

getPointsInArea

public static Point2D[] getPointsInArea(MappingComponent mc,
                                        edu.umd.cs.piccolo.util.PBounds bounds,
                                        PFeature vetoPFeature,
                                        Sirius.util.collections.MultiMap glueFeatureCoordinates)

DOCUMENT ME!

Parameters:

mc - DOCUMENT ME!

bounds - DOCUMENT ME!

vetoPFeature - DOCUMENT ME!

glueFeatureCoordinates - DOCUMENT ME!

Returns:

DOCUMENT ME!

getNearestPointInArea

public static Point2D getNearestPointInArea(MappingComponent mc,
                                            Point2D canvasPosition)

DOCUMENT ME!

Parameters:

mc - DOCUMENT ME!

canvasPosition - DOCUMENT ME!

Returns:

DOCUMENT ME!

getNearestPointInArea

public static PFeatureTools.SnappedPoint getNearestPointInArea(MappingComponent mc,
                                                               Point2D canvasPosition,
                                                               boolean considerVetoObjects,
                                                               Sirius.util.collections.MultiMap glueCoordinates)

DOCUMENT ME!

Parameters:

mc - DOCUMENT ME!

canvasPosition - DOCUMENT ME!

considerVetoObjects - veto objects are objects, which should be ignored from the snapping mechanism. This can be the currently modifying feature.

glueCoordinates - DOCUMENT ME!

Returns:

DOCUMENT ME!

getNearestPointInAreaNoVertexRequired

public static Point2D getNearestPointInAreaNoVertexRequired(MappingComponent mc,
                                                            Point2D canvasPosition,
                                                            PFeature vetoFeature,
                                                            Sirius.util.collections.MultiMap glueCoordinates)

DOCUMENT ME!

Parameters:

mc - DOCUMENT ME!

canvasPosition - DOCUMENT ME!

vetoFeature - DOCUMENT ME!

glueCoordinates - DOCUMENT ME!

Returns:

DOCUMENT ME!

getPointsInAreaNoVertexRequired

public static Point2D[] getPointsInAreaNoVertexRequired(MappingComponent mc,
                                                        edu.umd.cs.piccolo.util.PBounds bounds,
                                                        Point2D currentPosition,
                                                        PFeature vetoFeature,
                                                        Sirius.util.collections.MultiMap glueFeatureCoordinates)

DOCUMENT ME!

Parameters:

mc - DOCUMENT ME!

bounds - DOCUMENT ME!

currentPosition - DOCUMENT ME!

vetoFeature - DOCUMENT ME!

glueFeatureCoordinates - DOCUMENT ME!

Returns:

DOCUMENT ME!

getNearestSegment

public static com.vividsolutions.jts.geom.LineSegment getNearestSegment(com.vividsolutions.jts.geom.Coordinate trigger,
                                                                        PFeature pfeature)

DOCUMENT ME!

Parameters:

trigger - DOCUMENT ME!

pfeature - DOCUMENT ME!

Returns:

DOCUMENT ME!

getNearestPointInArea

public static Point2D getNearestPointInArea(MappingComponent mc,
                                            Point2D canvasPosition,
                                            PFeature vetoPFeature,
                                            Sirius.util.collections.MultiMap glueCoordinates)

DOCUMENT ME!

Parameters:

mc - DOCUMENT ME!

canvasPosition - DOCUMENT ME!

vetoPFeature - DOCUMENT ME!

glueCoordinates - DOCUMENT ME!

Returns:

DOCUMENT ME!

getFirstValidObjectUnderPointer

public static edu.umd.cs.piccolo.PNode getFirstValidObjectUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent,
                                                                       Class[] validClasses)

DOCUMENT ME!

Parameters:

pInputEvent - DOCUMENT ME!

validClasses - DOCUMENT ME!

Returns:

DOCUMENT ME!

getFirstValidObjectUnderPointer

public static edu.umd.cs.piccolo.PNode getFirstValidObjectUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent,
                                                                       Class[] validClasses,
                                                                       boolean deepPick)

DOCUMENT ME!

Parameters:

pInputEvent - DOCUMENT ME!

validClasses - DOCUMENT ME!

deepPick - DOCUMENT ME!

Returns:

DOCUMENT ME!

getNearestCoordinateInArea

public static com.vividsolutions.jts.geom.Coordinate getNearestCoordinateInArea(MappingComponent mc,
                                                                                Point2D canvasPosition,
                                                                                boolean considerVetoObjects,
                                                                                Sirius.util.collections.MultiMap glueCoordinates)

Determines the nearest geometry coordinate.

Parameters:

mc - DOCUMENT ME!

canvasPosition - DOCUMENT ME!

considerVetoObjects - veto objects are objects, which should be ignored from the snapping mechanism. This can be the currently modifying feature.

glueCoordinates - DOCUMENT ME!

Returns:

DOCUMENT ME!

See Also:

getNearestPointInArea(final MappingComponent mc, final Point2D canvasPosition, final Point2D vetoPoint)

getNearestCoordinateInArea

public static com.vividsolutions.jts.geom.Coordinate getNearestCoordinateInArea(MappingComponent mc,
                                                                                Point2D canvasPosition,
                                                                                PFeature vetoPFeature,
                                                                                Sirius.util.collections.MultiMap glueCoordinates)

DOCUMENT ME!

Parameters:

mc - DOCUMENT ME!

canvasPosition - DOCUMENT ME!

vetoPFeature - vetoPointIndex DOCUMENT ME!

glueCoordinates - DOCUMENT ME!

Returns:

DOCUMENT ME!

getFirstValidObjectUnderPointer

public static edu.umd.cs.piccolo.PNode getFirstValidObjectUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent,
                                                                       Class[] validClasses,
                                                                       double halo)

DOCUMENT ME!

Parameters:

pInputEvent - DOCUMENT ME!

validClasses - DOCUMENT ME!

halo - DOCUMENT ME!

Returns:

DOCUMENT ME!

getFirstValidObjectUnderPointer

public static edu.umd.cs.piccolo.PNode getFirstValidObjectUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent,
                                                                       Class[] validClasses,
                                                                       double halo,
                                                                       boolean deepSeek)

DOCUMENT ME!

Parameters:

pInputEvent - DOCUMENT ME!

validClasses - DOCUMENT ME!

halo - DOCUMENT ME!

deepSeek - DOCUMENT ME!

Returns:

DOCUMENT ME!

getAllValidObjectsUnderPointer

public static List<edu.umd.cs.piccolo.PNode> getAllValidObjectsUnderPointer(edu.umd.cs.piccolo.event.PInputEvent pInputEvent,
                                                                            Class[] validClasses)

DOCUMENT ME!

Parameters:

pInputEvent - DOCUMENT ME!

validClasses - DOCUMENT ME!

Returns:

DOCUMENT ME!

getPFeatureByChild

public static PFeature getPFeatureByChild(ParentNodeIsAPFeature child)

DOCUMENT ME!

Parameters:

child - DOCUMENT ME!

Returns:

DOCUMENT ME!

Throws:

IllegalArgumentException - DOCUMENT ME!

centroid

public static Point2D centroid(PFeature pfeature)

TODO move to a static geometryutils class.

Parameters:

pfeature - DOCUMENT ME!

Returns:

DOCUMENT ME!

area

public static double area(PFeature pfeature)

TODO move to a static geometryutils class.

Parameters:

pfeature - DOCUMENT ME!

Returns:

DOCUMENT ME!

identifyMergeableCoordinates

public static List<PFeatureTools.PFeatureCoordinateInformation> identifyMergeableCoordinates(Collection<PFeature> pFeatures,
                                                                                             double thresholdInMeters)

DOCUMENT ME!

Parameters:

pFeatures - DOCUMENT ME!

thresholdInMeters - DOCUMENT ME!

Returns:

DOCUMENT ME!

automergeCoordinates

public static List<PFeatureTools.PFeatureCoordinateInformation> automergeCoordinates(Collection<PFeature> pFeatures,
                                                                                     double thresholdInMeters)

DOCUMENT ME!

Parameters:

pFeatures - DOCUMENT ME!

thresholdInMeters - DOCUMENT ME!

Returns:

DOCUMENT ME!

automergeCoordinates

public static List<PFeatureTools.PFeatureCoordinateInformation> automergeCoordinates(List<PFeatureTools.PFeatureCoordinateInformation> groupedInfos)

DOCUMENT ME!

Parameters:

groupedInfos - pFeatures DOCUMENT ME!

Returns:

DOCUMENT ME!