GEOS  3.8.0
LocationIndexedLine.h
1 /**********************************************************************
2  *
3  * GEOS - Geometry Engine Open Source
4  * http://geos.osgeo.org
5  *
6  * Copyright (C) 2011 Sandro Santilli <strk@kbt.io>
7  *
8  * This is free software; you can redistribute and/or modify it under
9  * the terms of the GNU Lesser General Public Licence as published
10  * by the Free Software Foundation.
11  * See the COPYING file for more information.
12  *
13  **********************************************************************
14  *
15  * Last port: linearref/LocationIndexedLine.java r466
16  *
17  **********************************************************************/
18 
19 #ifndef GEOS_LINEARREF_LOCATIONINDEXEDLINE_H
20 #define GEOS_LINEARREF_LOCATIONINDEXEDLINE_H
21 
22 #include <geos/export.h>
23 #include <geos/geom/Coordinate.h>
24 #include <geos/geom/Geometry.h>
25 #include <geos/linearref/LinearLocation.h>
26 #include <geos/linearref/LocationIndexOfPoint.h>
27 #include <geos/linearref/LocationIndexOfLine.h>
28 #include <geos/util/IllegalArgumentException.h>
29 
30 namespace geos {
31 namespace linearref { // geos::linearref
32 
39 class GEOS_DLL LocationIndexedLine {
40 private:
41  const geom::Geometry* linearGeom;
42 
43  void
44  checkGeometryType()
45  {
46  if(!linearGeom->isLineal()) {
47  throw util::IllegalArgumentException("Input geometry must be linear");
48  }
49  }
50 
51 public:
52 
60  LocationIndexedLine(const geom::Geometry* p_linearGeom)
61  : linearGeom(p_linearGeom)
62  {
63  checkGeometryType();
64  }
65 
79  geom::Coordinate
80  extractPoint(const LinearLocation& index) const
81  {
82  return index.getCoordinate(linearGeom);
83  }
84 
85 
104  geom::Coordinate
105  extractPoint(const LinearLocation& index,
106  double offsetDistance) const
107  {
109  index.getSegment(linearGeom)->pointAlongOffset(
110  index.getSegmentFraction(), offsetDistance, ret
111  );
112  return ret;
113  }
114 
127  std::unique_ptr<geom::Geometry>
128  extractLine(const LinearLocation& startIndex,
129  const LinearLocation& endIndex) const
130  {
131  return ExtractLineByLocation::extract(linearGeom, startIndex, endIndex);
132  }
133 
134 
151  indexOf(const geom::Coordinate& pt) const
152  {
153  return LocationIndexOfPoint::indexOf(linearGeom, pt);
154  }
155 
181  indexOfAfter(const geom::Coordinate& pt,
182  const LinearLocation& minIndex) const
183  {
184  return LocationIndexOfPoint::indexOfAfter(linearGeom, pt, &minIndex);
185  }
186 
198  LinearLocation*
199  indicesOf(const geom::Geometry* subLine) const
200  {
201  return LocationIndexOfLine::indicesOf(linearGeom, subLine);
202  }
203 
204 
217  project(const geom::Coordinate& pt) const
218  {
219  return LocationIndexOfPoint::indexOf(linearGeom, pt);
220  }
221 
228  LinearLocation
229  getStartIndex() const
230  {
231  return LinearLocation();
232  }
233 
241  getEndIndex() const
242  {
243  return LinearLocation::getEndLocation(linearGeom);
244  }
245 
253  bool
254  isValidIndex(const LinearLocation& index) const
255  {
256  return index.isValid(linearGeom);
257  }
258 
259 
267  LinearLocation
268  clampIndex(const LinearLocation& index) const
269  {
270  LinearLocation loc = index;
271  loc.clamp(linearGeom);
272  return loc;
273  }
274 };
275 
276 } // geos::linearref
277 } // geos
278 #endif
geos::linearref::LinearLocation
Represents a location along a LineString or MultiLineString.
Definition: LinearLocation.h:80
geos
Basic namespace for all GEOS functionalities.
Definition: IndexedNestedRingTester.h:25
geos::linearref::LocationIndexOfLine::indicesOf
static LinearLocation * indicesOf(const geom::Geometry *linearGeom, const geom::Geometry *subLine)
Determines the location of a subline along a linear Geometry.
geos::linearref::LinearLocation::getEndLocation
static LinearLocation getEndLocation(const geom::Geometry *linear)
Gets a location which refers to the end of a linear Geometry.
geos::geom::Coordinate
Coordinate is the lightweight class used to store coordinates.
Definition: Coordinate.h:84
geos::geom::Geometry
Basic implementation of Geometry, constructed and destructed by GeometryFactory.
Definition: Geometry.h:188
geos::linearref::ExtractLineByLocation::extract
static std::unique_ptr< geom::Geometry > extract(const geom::Geometry *line, const LinearLocation &start, const LinearLocation &end)
Computes the subline of a LineString between two LinearLocations on the line.