enum.qbk 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295
  1. [/============================================================================
  2. Boost.Geometry (aka GGL, Generic Geometry Library)
  3. Copyright (c) 2007-2013 Barend Gehrels, Amsterdam, the Netherlands.
  4. Copyright (c) 2008-2013 Bruno Lalande, Paris, France.
  5. Copyright (c) 2009-2013 Mateusz Loskot, London, UK.
  6. Use, modification and distribution is subject to the Boost Software License,
  7. Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
  8. http://www.boost.org/LICENSE_1_0.txt)
  9. =============================================================================/]
  10. [/ Generated by doxygen_xml2qbk 1.1.1, don't change, will be overwritten automatically]
  11. [/ Generated from doxy/doxygen_output/xml/group__enum.xml]
  12. [section:buffer_side_selector buffer_side_selector]
  13. '''<indexterm><primary>buffer_side_selector</primary></indexterm>'''
  14. '''<indexterm><primary>buffer_side_left</primary></indexterm>'''
  15. '''<indexterm><primary>buffer_side_right</primary></indexterm>'''
  16. Enumerates options for side of buffer (left/right w.r.t. directed segment)
  17. [heading Description]
  18. Around a linestring, a buffer can be defined left or right. Around a polygon, assumed clockwise internally, a buffer is either on the left side (inflates the polygon), or on the right side (deflates the polygon)
  19. [heading Synopsis]
  20. ``enum buffer_side_selector {buffer_side_left, buffer_side_right};``
  21. [heading Values]
  22. [table
  23. [[Value] [Description] ]
  24. [[buffer_side_left] []]
  25. [[buffer_side_right] []]
  26. ]
  27. [heading Header]
  28. `#include <boost/geometry/strategies/buffer.hpp>`
  29. [endsect]
  30. [section:closure_selector closure_selector]
  31. '''<indexterm><primary>closure_selector</primary></indexterm>'''
  32. '''<indexterm><primary>open</primary></indexterm>'''
  33. '''<indexterm><primary>closed</primary></indexterm>'''
  34. '''<indexterm><primary>closure_undertermined</primary></indexterm>'''
  35. Enumerates options for defining if polygons are open or closed.
  36. [heading Description]
  37. The enumeration closure\u005fselector describes options for if a polygon is open or closed. In a closed polygon the very first point (per ring) should be equal to the very last point. The specific closing property of a polygon type is defined by the closure metafunction. The closure metafunction defines a value, which is one of the values enumerated in the closure\u005fselector
  38. [heading Synopsis]
  39. ``enum closure_selector {open = 0, closed = 1, closure_undertermined = -1};``
  40. [heading Values]
  41. [table
  42. [[Value] [Description] ]
  43. [[open] [Rings are open: first point and last point are different, algorithms close them explicitly on the fly ]]
  44. [[closed] [Rings are closed: first point and last point must be the same. ]]
  45. [[closure_undertermined] [(Not yet implemented): algorithms first figure out if ring must be closed on the fly ]]
  46. ]
  47. [heading Header]
  48. Either
  49. `#include <boost/geometry.hpp>`
  50. Or
  51. `#include <boost/geometry/core/closure.hpp>`
  52. [heading See also]
  53. [link geometry.reference.core.closure The closure metafunction]
  54. [endsect]
  55. [section:join_selector join_selector]
  56. '''<indexterm><primary>join_selector</primary></indexterm>'''
  57. '''<indexterm><primary>join_convex</primary></indexterm>'''
  58. '''<indexterm><primary>join_concave</primary></indexterm>'''
  59. '''<indexterm><primary>join_continue</primary></indexterm>'''
  60. '''<indexterm><primary>join_spike</primary></indexterm>'''
  61. Enumerates types of joins.
  62. [heading Synopsis]
  63. ``enum join_selector {join_convex, join_concave, join_continue, join_spike};``
  64. [heading Values]
  65. [table
  66. [[Value] [Description] ]
  67. [[join_convex] []]
  68. [[join_concave] []]
  69. [[join_continue] []]
  70. [[join_spike] []]
  71. ]
  72. [heading Header]
  73. `#include <boost/geometry/strategies/buffer.hpp>`
  74. [endsect]
  75. [section:order_selector order_selector]
  76. '''<indexterm><primary>order_selector</primary></indexterm>'''
  77. '''<indexterm><primary>clockwise</primary></indexterm>'''
  78. '''<indexterm><primary>counterclockwise</primary></indexterm>'''
  79. '''<indexterm><primary>order_undetermined</primary></indexterm>'''
  80. Enumerates options for the order of points within polygons.
  81. [heading Description]
  82. The enumeration order\u005fselector describes options for the order of points within a polygon. Polygons can be ordered either clockwise or counterclockwise. The specific order of a polygon type is defined by the point\u005forder metafunction. The point\u005forder metafunction defines a value, which is one of the values enumerated in the order\u005fselector
  83. [heading Synopsis]
  84. ``enum order_selector {clockwise = 1, counterclockwise = 2, order_undetermined = 0};``
  85. [heading Values]
  86. [table
  87. [[Value] [Description] ]
  88. [[clockwise] [Points are ordered clockwise. ]]
  89. [[counterclockwise] [Points are ordered counter clockwise. ]]
  90. [[order_undetermined] [Points might be stored in any order, algorithms will determine it on the fly (not yet supported) ]]
  91. ]
  92. [heading Header]
  93. Either
  94. `#include <boost/geometry.hpp>`
  95. Or
  96. `#include <boost/geometry/core/point_order.hpp>`
  97. [heading See also]
  98. [link geometry.reference.core.point_order The point_order metafunction]
  99. [endsect]
  100. [section:piece_type piece_type]
  101. '''<indexterm><primary>piece_type</primary></indexterm>'''
  102. '''<indexterm><primary>buffered_segment</primary></indexterm>'''
  103. '''<indexterm><primary>buffered_join</primary></indexterm>'''
  104. '''<indexterm><primary>buffered_round_end</primary></indexterm>'''
  105. '''<indexterm><primary>buffered_flat_end</primary></indexterm>'''
  106. '''<indexterm><primary>buffered_point</primary></indexterm>'''
  107. '''<indexterm><primary>buffered_concave</primary></indexterm>'''
  108. '''<indexterm><primary>piece_type_unknown</primary></indexterm>'''
  109. Enumerates types of pieces (parts of buffer) around geometries.
  110. [heading Synopsis]
  111. ``enum piece_type
  112. {
  113. buffered_segment,
  114. buffered_join,
  115. buffered_round_end,
  116. buffered_flat_end,
  117. buffered_point,
  118. buffered_concave,
  119. piece_type_unknown
  120. };``
  121. [heading Values]
  122. [table
  123. [[Value] [Description] ]
  124. [[buffered_segment] []]
  125. [[buffered_join] []]
  126. [[buffered_round_end] []]
  127. [[buffered_flat_end] []]
  128. [[buffered_point] []]
  129. [[buffered_concave] []]
  130. [[piece_type_unknown] []]
  131. ]
  132. [heading Header]
  133. `#include <boost/geometry/strategies/buffer.hpp>`
  134. [endsect]
  135. [section:result_code result_code]
  136. '''<indexterm><primary>result_code</primary></indexterm>'''
  137. '''<indexterm><primary>result_normal</primary></indexterm>'''
  138. '''<indexterm><primary>result_error_numerical</primary></indexterm>'''
  139. '''<indexterm><primary>result_no_output</primary></indexterm>'''
  140. Enumerates types of result codes from buffer strategies.
  141. [heading Synopsis]
  142. ``enum result_code {result_normal, result_error_numerical, result_no_output};``
  143. [heading Values]
  144. [table
  145. [[Value] [Description] ]
  146. [[result_normal] []]
  147. [[result_error_numerical] []]
  148. [[result_no_output] []]
  149. ]
  150. [heading Header]
  151. `#include <boost/geometry/strategies/buffer.hpp>`
  152. [endsect]
  153. [section:validity_failure_type validity_failure_type]
  154. '''<indexterm><primary>validity_failure_type</primary></indexterm>'''
  155. '''<indexterm><primary>no_failure</primary></indexterm>'''
  156. '''<indexterm><primary>failure_few_points</primary></indexterm>'''
  157. '''<indexterm><primary>failure_wrong_topological_dimension</primary></indexterm>'''
  158. '''<indexterm><primary>failure_spikes</primary></indexterm>'''
  159. '''<indexterm><primary>failure_duplicate_points</primary></indexterm>'''
  160. '''<indexterm><primary>failure_not_closed</primary></indexterm>'''
  161. '''<indexterm><primary>failure_self_intersections</primary></indexterm>'''
  162. '''<indexterm><primary>failure_wrong_orientation</primary></indexterm>'''
  163. '''<indexterm><primary>failure_interior_rings_outside</primary></indexterm>'''
  164. '''<indexterm><primary>failure_nested_interior_rings</primary></indexterm>'''
  165. '''<indexterm><primary>failure_disconnected_interior</primary></indexterm>'''
  166. '''<indexterm><primary>failure_intersecting_interiors</primary></indexterm>'''
  167. '''<indexterm><primary>failure_wrong_corner_order</primary></indexterm>'''
  168. '''<indexterm><primary>failure_invalid_coordinate</primary></indexterm>'''
  169. Enumerates the possible validity failure types for a geometry.
  170. [heading Description]
  171. The enumeration validity\u005ffailure\u005ftype enumerates the possible reasons for which a geometry may be found as invalid by the is\u005fvalid algorithm. Besides the values that indicate invalidity, there is an additional value (no\u005ffailure) that indicates validity.
  172. [heading Synopsis]
  173. ``enum validity_failure_type
  174. {
  175. no_failure = 0,
  176. failure_few_points = 10,
  177. failure_wrong_topological_dimension = 11,
  178. failure_spikes = 12,
  179. failure_duplicate_points = 13,
  180. failure_not_closed = 20,
  181. failure_self_intersections = 21,
  182. failure_wrong_orientation = 22,
  183. failure_interior_rings_outside = 30,
  184. failure_nested_interior_rings = 31,
  185. failure_disconnected_interior = 32,
  186. failure_intersecting_interiors = 40,
  187. failure_wrong_corner_order = 50,
  188. failure_invalid_coordinate = 60
  189. };``
  190. [heading Values]
  191. [table
  192. [[Value] [Description] ]
  193. [[no_failure] [The geometry is valid ]]
  194. [[failure_few_points] [The geometry has a very small number of points, e.g., less than 2 for linestrings, less than 3 for open rings, a closed multi-polygon that contains a polygon with less than 4 points, etc. (applies to linestrings, rings, polygons, multi-linestrings and multi-polygons) ]]
  195. [[failure_wrong_topological_dimension] [The topological dimension of the geometry is smaller than its dimension, e.g., a linestring with 3 identical points, an open polygon with an interior ring consisting of 3 collinear points, etc. (applies to linear and areal geometries, including segments and boxes) ]]
  196. [[failure_spikes] [The geometry contains spikes (applies to linear and areal geometries) ]]
  197. [[failure_duplicate_points] [The geometry has (consecutive) duplicate points (applies to areal geometries only) ]]
  198. [[failure_not_closed] [The geometry is defined as closed, the starting/ending points are not equal (applies to areal geometries only) ]]
  199. [[failure_self_intersections] [The geometry has invalid self-intersections. (applies to areal geometries only) ]]
  200. [[failure_wrong_orientation] [The actual orientation of the geometry is different from the one defined (applies to areal geometries only) ]]
  201. [[failure_interior_rings_outside] [The geometry contains interior rings that lie outside the exterior ring (applies to polygons and multi-polygons only) ]]
  202. [[failure_nested_interior_rings] [The geometry has nested interior rings (applies to polygons and multi-polygons only) ]]
  203. [[failure_disconnected_interior] [The interior of the geometry is disconnected (applies to polygons and multi-polygons only) ]]
  204. [[failure_intersecting_interiors] [The multi-polygon contains polygons whose interiors are not disjoint (applies to multi-polygons only) ]]
  205. [[failure_wrong_corner_order] [The top-right corner of the box is lexicographically smaller than its bottom-left corner (applies to boxes only) ]]
  206. [[failure_invalid_coordinate] [The geometry has at least one point with an invalid coordinate (for example, the coordinate is a NaN) ]]
  207. ]
  208. [heading Header]
  209. `#include <boost/geometry/algorithms/validity_failure_type.hpp>`
  210. [heading See also]
  211. [link geometry.reference.algorithms.is_valid The is_valid
  212. algorithm taking a reference to validity_failure_type as second argument]
  213. [endsect]