• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1[/============================================================================
2  Boost.Geometry (aka GGL, Generic Geometry Library)
3
4  Copyright (c) 2007-2013 Barend Gehrels, Amsterdam, the Netherlands.
5  Copyright (c) 2008-2013 Bruno Lalande, Paris, France.
6  Copyright (c) 2009-2013 Mateusz Loskot, London, UK.
7
8  Use, modification and distribution is subject to the Boost Software License,
9  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
10  http://www.boost.org/LICENSE_1_0.txt)
11=============================================================================/]
12
13
14[/ Generated by doxygen_xml2qbk 1.1.1, don't change, will be overwritten automatically]
15[/ Generated from doxy/doxygen_output/xml/group__covered__by.xml]
16[section:covered_by_2 covered_by]
17
18'''<indexterm><primary>covered_by</primary></indexterm>'''
19Checks if the first geometry is inside or on border the second geometry.
20
21[heading Description]
22The free function covered\u005fby checks if the first geometry is inside or on border the second geometry.
23
24[heading Synopsis]
25``template<typename Geometry1, typename Geometry2>
26bool covered_by(Geometry1 const & geometry1, Geometry2 const & geometry2)``
27
28[heading Parameters]
29
30[table
31[[Type] [Concept] [Name] [Description] ]
32[[Geometry1 const &] [Any type fulfilling a Geometry Concept ] [geometry1] [A model of the specified concept which might be inside or on the border of the second geometry ]]
33[[Geometry2 const &] [Any type fulfilling a Geometry Concept ] [geometry2] [A model of the specified concept which might cover the first geometry ]]
34]
35
36
37[heading Returns]
38true if geometry1 is inside of or on the border of geometry2, else false
39
40[heading Header]
41Either
42
43`#include <boost/geometry.hpp>`
44
45
46Or
47
48`#include <boost/geometry/algorithms/covered_by.hpp>`
49
50[include reference/algorithms/covered_by.qbk]
51[heading Examples]
52[covered_by]
53[covered_by_output]
54
55
56[endsect]
57
58[section:covered_by_3_with_strategy covered_by (with strategy)]
59
60'''<indexterm><primary>covered_by</primary></indexterm>'''
61Checks if the first geometry is inside or on border the second geometry using the specified strategy.
62
63[heading Description]
64The free function covered\u005fby checks if the first geometry is inside or on border the second geometry, using the specified strategy. Reasons to specify a strategy include: use another coordinate system for calculations; construct the strategy beforehand (e.g. with the radius of the Earth); select a strategy when there are more than one available for a calculation.
65
66[heading Synopsis]
67``template<typename Geometry1, typename Geometry2, typename Strategy>
68bool covered_by(Geometry1 const & geometry1, Geometry2 const & geometry2, Strategy const & strategy)``
69
70[heading Parameters]
71
72[table
73[[Type] [Concept] [Name] [Description] ]
74[[Geometry1 const &] [Any type fulfilling a Geometry Concept ] [geometry1] [A model of the specified concept which might be inside or on the border of the second geometry ]]
75[[Geometry2 const &] [Any type fulfilling a Geometry Concept ] [geometry2] [A model of the specified concept which might cover the first geometry ]]
76[[Strategy const &] [] [strategy] [strategy to be used ]]
77]
78
79
80[heading Returns]
81true if geometry1 is inside of or on the border of geometry2, else false
82
83[heading Header]
84Either
85
86`#include <boost/geometry.hpp>`
87
88
89Or
90
91`#include <boost/geometry/algorithms/covered_by.hpp>`
92
93[include reference/algorithms/covered_by.qbk]
94
95
96[endsect]
97
98