length.qbk 2.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  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__length.xml]
  12. [section:length_1 length]
  13. '''<indexterm><primary>length</primary></indexterm>'''
  14. Calculates the length of a geometry.
  15. [heading Description]
  16. The free function length calculates the length (the sum of distances between consecutive points) of a geometry. It uses the default strategy, based on the coordinate system of the geometry.
  17. [heading Synopsis]
  18. ``template<typename Geometry>
  19. default_length_result<Geometry>::type length(Geometry const & geometry)``
  20. [heading Parameters]
  21. [table
  22. [[Type] [Concept] [Name] [Description] ]
  23. [[Geometry const &] [Any type fulfilling a Geometry Concept ] [geometry] [A model of the specified concept ]]
  24. ]
  25. [heading Returns]
  26. The calculated length
  27. [heading Header]
  28. Either
  29. `#include <boost/geometry.hpp>`
  30. Or
  31. `#include <boost/geometry/algorithms/length.hpp>`
  32. [include reference/algorithms/length.qbk]
  33. [length] [length_output]
  34. [endsect]
  35. [section:length_2_with_strategy length (with strategy)]
  36. '''<indexterm><primary>length</primary></indexterm>'''
  37. Calculates the length of a geometry using the specified strategy.
  38. [heading Description]
  39. The free function length calculates the length (the sum of distances between consecutive points) of a 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.
  40. [heading Synopsis]
  41. ``template<typename Geometry, typename Strategy>
  42. default_length_result<Geometry>::type length(Geometry const & geometry, Strategy const & strategy)``
  43. [heading Parameters]
  44. [table
  45. [[Type] [Concept] [Name] [Description] ]
  46. [[Geometry const &] [Any type fulfilling a Geometry Concept ] [geometry] [A model of the specified concept ]]
  47. [[Strategy const &] [Any type fulfilling a distance Strategy Concept ] [strategy] [The strategy which will be used for distance calculations ]]
  48. ]
  49. [heading Returns]
  50. The calculated length
  51. [heading Header]
  52. Either
  53. `#include <boost/geometry.hpp>`
  54. Or
  55. `#include <boost/geometry/algorithms/length.hpp>`
  56. [include reference/algorithms/length.qbk]
  57. [length_with_strategy] [length_with_strategy_output]
  58. [endsect]