PointLocator.h

/**********************************************************************
 *
 * GEOS - Geometry Engine Open Source
 * http://geos.osgeo.org
 *
 * Copyright (C) 2005-2011 Refractions Research Inc.
 * Copyright (C) 2001-2002 Vivid Solutions Inc.
 *
 * This is free software; you can redistribute and/or modify it under
 * the terms of the GNU Lesser General Public Licence as published
 * by the Free Software Foundation.
 * See the COPYING file for more information.
 *
 **********************************************************************
 *
 * Last port: algorithm/PointLocator.java 95fbe34b (JTS-1.15.2-SNAPSHOT)
 *
 **********************************************************************/
 
#pragma once
 
#include <geos/export.h>
#include <geos/geom/Location.h> // for inlines
 
// Forward declarations
namespace geos {
namespace geom {
class CircularString;
class CompoundCurve;
class CoordinateXY;
class Curve;
class Geometry;
class LinearRing;
class LineString;
class Polygon;
class Point;
class Surface;
}
}
 
namespace geos {
namespace algorithm { // geos::algorithm
 
class GEOS_DLL PointLocator {
public:
    PointLocator() {}
    ~PointLocator() {}
 
    geom::Location locate(const geom::CoordinateXY& p, const geom::Geometry* geom);
 
    bool
    intersects(const geom::CoordinateXY& p, const geom::Geometry* geom)
    {
        return locate(p, geom) != geom::Location::EXTERIOR;
    }
 
private:
 
    bool isIn;         // true if the point lies in or on any Geometry element
 
    int numBoundaries;    // the number of sub-elements whose boundaries the point lies in
 
    void computeLocation(const geom::CoordinateXY& p, const geom::Geometry* geom);
 
    void updateLocationInfo(geom::Location loc);
 
    geom::Location locate(const geom::CoordinateXY& p, const geom::Point* pt);
 
    geom::Location locate(const geom::CoordinateXY& p, const geom::LineString* l);
 
    geom::Location locate(const geom::CoordinateXY& p, const geom::CircularString* cs);
 
    geom::Location locate(const geom::CoordinateXY& p, const geom::CompoundCurve* cs);
 
    static geom::Location locateInPolygonRing(const geom::CoordinateXY& p, const geom::Curve* ring);
 
    static geom::Location locate(const geom::CoordinateXY& p, const geom::Surface* poly);
 
};
 
} // namespace geos::algorithm
} // namespace geos