GEOS  3.6.1
LinearLocation.h
1 /**********************************************************************
2  *
3  * GEOS - Geometry Engine Open Source
4  * http://geos.osgeo.org
5  *
6  * Copyright (C) 2011 Sandro Santilli <strk@keybit.net>
7  * Copyright (C) 2005-2006 Refractions Research Inc.
8  * Copyright (C) 2001-2002 Vivid Solutions Inc.
9  *
10  * This is free software; you can redistribute and/or modify it under
11  * the terms of the GNU Lesser General Public Licence as published
12  * by the Free Software Foundation.
13  * See the COPYING file for more information.
14  *
15  **********************************************************************
16  *
17  * Last port: linearref/LinearLocation.java r463
18  *
19  **********************************************************************/
20 
21 #ifndef GEOS_LINEARREF_LINEARLOCATION_H
22 #define GEOS_LINEARREF_LINEARLOCATION_H
23 
24 #include <string>
25 #include <memory> // for std::auto_ptr
26 
27 #include <geos/geom/Coordinate.h>
28 #include <geos/geom/Geometry.h>
29 #include <geos/geom/LineSegment.h>
30 
31 namespace geos {
32 namespace linearref { // geos::linearref
33 
34 
44 {
45 private:
46  unsigned int componentIndex;
47  unsigned int segmentIndex;
48  double segmentFraction;
49 
57  void normalize();
58 
59 public:
65  static LinearLocation getEndLocation(const geom::Geometry* linear);
66 
82  static geom::Coordinate pointAlongSegmentByFraction(const geom::Coordinate& p0, const geom::Coordinate& p1, double frac);
83 
84 
88  LinearLocation(unsigned int segmentIndex = 0, double segmentFraction = 0.0);
89 
90  LinearLocation(unsigned int componentIndex, unsigned int segmentIndex, double segmentFraction);
91 
97  void clamp(const geom::Geometry* linear);
98 
107  void snapToVertex(const geom::Geometry* linearGeom, double minDistance);
108 
116  double getSegmentLength(const geom::Geometry* linearGeom) const;
117 
124  void setToEnd(const geom::Geometry* linear);
125 
131  unsigned int getComponentIndex() const;
132 
138  unsigned int getSegmentIndex() const;
139 
145  double getSegmentFraction() const;
146 
152  bool isVertex() const;
153 
162  geom::Coordinate getCoordinate(const geom::Geometry* linearGeom) const;
163 
171  std::auto_ptr<geom::LineSegment> getSegment(const geom::Geometry* linearGeom) const;
172 
180  bool isValid(const geom::Geometry* linearGeom) const;
181 
190  int compareTo(const LinearLocation& other) const;
191 
201  int compareLocationValues(unsigned int componentIndex1, unsigned int segmentIndex1, double segmentFraction1) const;
202 
216  static int compareLocationValues(
217  unsigned int componentIndex0, unsigned int segmentIndex0, double segmentFraction0,
218  unsigned int componentIndex1, unsigned int segmentIndex1, double segmentFraction1);
219 
227  bool isOnSameSegment(const LinearLocation& loc) const;
228 
237  bool isEndpoint(const geom::Geometry& linearGeom) const;
238 
239  friend std::ostream& operator<< (std::ostream& out, const LinearLocation& obj );
240 
241 };
242 
243 
244 } // namespace geos.linearref
245 } // namespace geos
246 
247 #endif
double getSegmentLength(const geom::Geometry *linearGeom) const
Coordinate is the lightweight class used to store coordinates.
Definition: Coordinate.h:60
void clamp(const geom::Geometry *linear)
unsigned int getComponentIndex() const
Basic implementation of Geometry, constructed and destructed by GeometryFactory.
Definition: Geometry.h:167
bool isOnSameSegment(const LinearLocation &loc) const
unsigned int getSegmentIndex() const
Represents a location along a LineString or MultiLineString.
Definition: LinearLocation.h:43
int compareLocationValues(unsigned int componentIndex1, unsigned int segmentIndex1, double segmentFraction1) const
static geom::Coordinate pointAlongSegmentByFraction(const geom::Coordinate &p0, const geom::Coordinate &p1, double frac)
Basic namespace for all GEOS functionalities.
Definition: IndexedNestedRingTester.h:25
int compareTo(const LinearLocation &other) const
static LinearLocation getEndLocation(const geom::Geometry *linear)
std::auto_ptr< geom::LineSegment > getSegment(const geom::Geometry *linearGeom) const
bool isEndpoint(const geom::Geometry &linearGeom) const
Tests whether this location is an endpoint of the linear component it refers to.
LinearLocation(unsigned int segmentIndex=0, double segmentFraction=0.0)
void setToEnd(const geom::Geometry *linear)
geom::Coordinate getCoordinate(const geom::Geometry *linearGeom) const
void snapToVertex(const geom::Geometry *linearGeom, double minDistance)
bool isValid(const geom::Geometry *linearGeom) const