assign.qbk 7.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279
  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__assign.xml]
  12. [section:assign assign]
  13. '''<indexterm><primary>assign</primary></indexterm>'''
  14. Assigns one geometry to another geometry.
  15. [heading Description]
  16. The assign algorithm assigns one geometry, e.g. a BOX, to another geometry, e.g. a RING. This only works if it is possible and applicable.
  17. [heading Synopsis]
  18. ``template<typename Geometry1, typename Geometry2>
  19. void assign(Geometry1 & geometry1, Geometry2 const & geometry2)``
  20. [heading Parameters]
  21. [table
  22. [[Type] [Concept] [Name] [Description] ]
  23. [[Geometry1 &] [Any type fulfilling a Geometry Concept ] [geometry1] [A model of the specified concept (target) ]]
  24. [[Geometry2 const &] [Any type fulfilling a Geometry Concept ] [geometry2] [A model of the specified concept (source)]]
  25. ]
  26. [heading Header]
  27. Either
  28. `#include <boost/geometry.hpp>`
  29. Or
  30. `#include <boost/geometry/algorithms/assign.hpp>`
  31. [heading Example]
  32. [assign] [assign_output]
  33. [heading See also]
  34. * [link geometry.reference.algorithms.convert convert]
  35. [endsect]
  36. [section:assign_inverse assign_inverse]
  37. '''<indexterm><primary>assign_inverse</primary></indexterm>'''
  38. assign to a box inverse infinite
  39. [heading Description]
  40. The assign\u005finverse function initialize a 2D or 3D box with large coordinates, the min corner is very large, the max corner is very small. This is a convenient starting point to collect the minimum bounding box of a geometry.
  41. [heading Synopsis]
  42. ``template<typename Geometry>
  43. void assign_inverse(Geometry & geometry)``
  44. [heading Parameters]
  45. [table
  46. [[Type] [Concept] [Name] [Description] ]
  47. [[Geometry &] [Any type fulfilling a Geometry Concept ] [geometry] [A model of the specified concept]]
  48. ]
  49. [heading Header]
  50. Either
  51. `#include <boost/geometry.hpp>`
  52. Or
  53. `#include <boost/geometry/algorithms/assign.hpp>`
  54. [heading Example]
  55. [assign_inverse] [assign_inverse_output]
  56. [heading See also]
  57. * [link geometry.reference.algorithms.make.make_inverse make_inverse]
  58. [endsect]
  59. [section:assign_points assign_points]
  60. '''<indexterm><primary>assign_points</primary></indexterm>'''
  61. Assign a range of points to a linestring, ring or polygon.
  62. [heading Synopsis]
  63. ``template<typename Geometry, typename Range>
  64. void assign_points(Geometry & geometry, Range const & range)``
  65. [heading Parameters]
  66. [table
  67. [[Type] [Concept] [Name] [Description] ]
  68. [[Geometry &] [Any type fulfilling a Geometry Concept ] [geometry] [A model of the specified concept ]]
  69. [[Range const &] [Any type fulfilling a Range Concept where it range_value type fulfills the Point Concept ] [range] [A range containg points fulfilling range and point concepts]]
  70. ]
  71. [heading Header]
  72. Either
  73. `#include <boost/geometry.hpp>`
  74. Or
  75. `#include <boost/geometry/algorithms/assign.hpp>`
  76. [heading Notes]
  77. [note Assign automatically clears the geometry before assigning (use append if you don't want that)]
  78. [heading Example]
  79. [assign_points] [assign_points_output]
  80. [heading See also]
  81. * [link geometry.reference.algorithms.append append]
  82. [endsect]
  83. [section:assign_values_3_2_coordinate_values assign_values (2 coordinate values)]
  84. '''<indexterm><primary>assign_values</primary></indexterm>'''
  85. Assign two coordinates to a geometry (usually a 2D point)
  86. [heading Synopsis]
  87. ``template<typename Geometry, typename Type>
  88. void assign_values(Geometry & geometry, Type const & c1, Type const & c2)``
  89. [heading Parameters]
  90. [table
  91. [[Type] [Concept] [Name] [Description] ]
  92. [[Geometry &] [Any type fulfilling a Geometry Concept ] [geometry] [A model of the specified concept ]]
  93. [[Type const &] [numerical type (int, double, ttmath, ...) to specify the coordinates ] [c1] [First coordinate (usually x-coordinate) ]]
  94. [[Type const &] [numerical type (int, double, ttmath, ...) to specify the coordinates ] [c2] [Second coordinate (usually y-coordinate)]]
  95. ]
  96. [heading Header]
  97. Either
  98. `#include <boost/geometry.hpp>`
  99. Or
  100. `#include <boost/geometry/algorithms/assign.hpp>`
  101. [heading Example]
  102. [assign_2d_point] [assign_2d_point_output]
  103. [heading See also]
  104. * [link geometry.reference.algorithms.make.make_2_2_coordinate_values make]
  105. [endsect]
  106. [section:assign_values_4_3_coordinate_values assign_values (3 coordinate values)]
  107. '''<indexterm><primary>assign_values</primary></indexterm>'''
  108. Assign three values to a geometry (usually a 3D point)
  109. [heading Synopsis]
  110. ``template<typename Geometry, typename Type>
  111. void assign_values(Geometry & geometry, Type const & c1, Type const & c2,
  112. Type const & c3)``
  113. [heading Parameters]
  114. [table
  115. [[Type] [Concept] [Name] [Description] ]
  116. [[Geometry &] [Any type fulfilling a Geometry Concept ] [geometry] [A model of the specified concept ]]
  117. [[Type const &] [numerical type (int, double, ttmath, ...) to specify the coordinates ] [c1] [First coordinate (usually x-coordinate) ]]
  118. [[Type const &] [numerical type (int, double, ttmath, ...) to specify the coordinates ] [c2] [Second coordinate (usually y-coordinate) ]]
  119. [[Type const &] [numerical type (int, double, ttmath, ...) to specify the coordinates ] [c3] [Third coordinate (usually z-coordinate)]]
  120. ]
  121. [heading Header]
  122. Either
  123. `#include <boost/geometry.hpp>`
  124. Or
  125. `#include <boost/geometry/algorithms/assign.hpp>`
  126. [heading Example]
  127. [assign_3d_point] [assign_3d_point_output]
  128. [heading See also]
  129. * [link geometry.reference.algorithms.make.make_3_3_coordinate_values make]
  130. [endsect]
  131. [section:assign_values_5_4_coordinate_values assign_values (4 coordinate values)]
  132. '''<indexterm><primary>assign_values</primary></indexterm>'''
  133. Assign four values to a geometry (usually a box or segment)
  134. [heading Synopsis]
  135. ``template<typename Geometry, typename Type>
  136. void assign_values(Geometry & geometry, Type const & c1, Type const & c2,
  137. Type const & c3, Type const & c4)``
  138. [heading Parameters]
  139. [table
  140. [[Type] [Concept] [Name] [Description] ]
  141. [[Geometry &] [Any type fulfilling a Geometry Concept ] [geometry] [A model of the specified concept ]]
  142. [[Type const &] [numerical type (int, double, ttmath, ...) to specify the coordinates ] [c1] [First coordinate (usually x1) ]]
  143. [[Type const &] [numerical type (int, double, ttmath, ...) to specify the coordinates ] [c2] [Second coordinate (usually y1) ]]
  144. [[Type const &] [numerical type (int, double, ttmath, ...) to specify the coordinates ] [c3] [Third coordinate (usually x2) ]]
  145. [[Type const &] [numerical type (int, double, ttmath, ...) to specify the coordinates ] [c4] [Fourth coordinate (usually y2)]]
  146. ]
  147. [heading Header]
  148. Either
  149. `#include <boost/geometry.hpp>`
  150. Or
  151. `#include <boost/geometry/algorithms/assign.hpp>`
  152. [endsect]
  153. [section:assign_zero assign_zero]
  154. '''<indexterm><primary>assign_zero</primary></indexterm>'''
  155. assign zero values to a box, point
  156. [heading Description]
  157. The assign\u005fzero function initializes a 2D or 3D point or box with coordinates of zero
  158. [heading Synopsis]
  159. ``template<typename Geometry>
  160. void assign_zero(Geometry & geometry)``
  161. [heading Parameters]
  162. [table
  163. [[Type] [Concept] [Name] [Description] ]
  164. [[Geometry &] [Any type fulfilling a Geometry Concept ] [geometry] [A model of the specified concept ]]
  165. ]
  166. [heading Header]
  167. Either
  168. `#include <boost/geometry.hpp>`
  169. Or
  170. `#include <boost/geometry/algorithms/assign.hpp>`
  171. [endsect]