/********************************************************************** * * GEOS - Geometry Engine Open Source * http://geos.osgeo.org * * Copyright (C) 2006 Refractions Research 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. * **********************************************************************/ #pragma once #include #include // for DoubleNotANumber #include #include #include // for typedefs #include #include #ifdef _MSC_VER #pragma warning(push) #pragma warning(disable: 4251) // warning C4251: needs to have dll-interface to be used by clients of class #endif namespace geos { namespace geom { // geos.geom struct CoordinateLessThen; /** * \class Coordinate geom.h geos.h * * \brief * Coordinate is the lightweight class used to store coordinates. * * It is distinct from Point, which is a subclass of Geometry. * Unlike objects of type Point (which contain additional * information such as an envelope, a precision model, and spatial * reference system information), a Coordinate only contains * ordinate values and accessor methods. * * Coordinate objects are two-dimensional points, with an additional * z-ordinate. JTS does not support any operations on the z-ordinate except * the basic accessor functions. * * Constructed coordinates will have a z-ordinate of DoubleNotANumber. * The standard comparison functions will ignore the z-ordinate. * */ // Define the following to make assignments and copy constructions // NON-(will let profilers report usages) //#define PROFILE_COORDINATE_COPIES 1 class GEOS_DLL Coordinate { private: static Coordinate _nullCoord; public: /// A set of const Coordinate pointers typedef std::set ConstSet; /// A vector of const Coordinate pointers typedef std::vector ConstVect; /// A stack of const Coordinate pointers typedef std::stack ConstStack; /// A vector of Coordinate objects (real object, not pointers) typedef std::vector Vect; /// x-coordinate double x; /// y-coordinate double y; /// z-coordinate double z; /// Output function GEOS_DLL friend std::ostream& operator<< (std::ostream& os, const Coordinate& c); /// Equality operator for Coordinate. 2D only. GEOS_DLL friend bool operator==(const Coordinate& a, const Coordinate& b) { return a.equals2D(b); }; /// Inequality operator for Coordinate. 2D only. GEOS_DLL friend bool operator!=(const Coordinate& a, const Coordinate& b) { return ! a.equals2D(b); }; Coordinate() : x(0.0) , y(0.0) , z(DoubleNotANumber) {}; Coordinate(double xNew, double yNew, double zNew = DoubleNotANumber) : x(xNew) , y(yNew) , z(zNew) {}; void setNull() { x = DoubleNotANumber; y = DoubleNotANumber; z = DoubleNotANumber; }; static Coordinate& getNull(); bool isNull() const { return (std::isnan(x) && std::isnan(y) && std::isnan(z)); }; bool isValid() const { return std::isfinite(x) && std::isfinite(y); }; bool equals2D(const Coordinate& other) const { if(x != other.x) { return false; } if(y != other.y) { return false; } return true; }; bool equals2D(const Coordinate& other, double tolerance) const { if (std::abs(x - other.x) > tolerance) { return false; } if (std::abs(y - other.y) > tolerance) { return false; } return true; }; /// 2D only bool equals(const Coordinate& other) const { return equals2D(other); }; /// TODO: deprecate this, move logic to CoordinateLessThen instead int compareTo(const Coordinate& other) const { if(x < other.x) { return -1; } if(x > other.x) { return 1; } if(y < other.y) { return -1; } if(y > other.y) { return 1; } return 0; }; /// 3D comparison bool equals3D(const Coordinate& other) const { return (x == other.x) && (y == other.y) && ((z == other.z) || (std::isnan(z) && std::isnan(other.z))); }; /// Returns a string of the form (x,y,z) . std::string toString() const; /// TODO: obsoleted this, can use PrecisionModel::makePrecise(Coordinate*) /// instead //void makePrecise(const PrecisionModel *pm); double distance(const Coordinate& p) const { double dx = x - p.x; double dy = y - p.y; return std::sqrt(dx * dx + dy * dy); }; double distanceSquared(const Coordinate& p) const { double dx = x - p.x; double dy = y - p.y; return dx * dx + dy * dy; }; struct GEOS_DLL HashCode { std::size_t operator()(const Coordinate & c) const { size_t h = std::hash{}(c.x); h ^= std::hash{}(c.y) << 1; // z ordinate ignored for consistency with operator== return h; }; }; }; /// Strict weak ordering Functor for Coordinate struct GEOS_DLL CoordinateLessThen { bool operator()(const Coordinate* a, const Coordinate* b) const { if(a->compareTo(*b) < 0) { return true; } else { return false; } }; bool operator()(const Coordinate& a, const Coordinate& b) const { if(a.compareTo(b) < 0) { return true; } else { return false; } }; }; /// Strict weak ordering operator for Coordinate inline bool operator<(const Coordinate& a, const Coordinate& b) { return CoordinateLessThen()(a, b); } } // namespace geos.geom } // namespace geos #ifdef _MSC_VER #pragma warning(pop) #endif